profilePhoto を更新する

  • [アーティクル]

名前空間: microsoft.graph

テナント内の指定した連絡先、グループ、チーム、またはユーザーの写真を更新します。 更新できる写真のサイズは 4 MB に制限されています。

この操作には PATCH または PUT を使用できます。

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国
✅ ✅ ✅ ✅

アクセス許可

次の表は、サポートされている各リソースの種類でこの API を呼び出すために必要な最小特権のアクセス許可またはアクセス許可を示しています。 ベスト プラクティスに従って、最小限の特権のアクセス許可を要求します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「 アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、 アクセス許可のリファレンスを参照してください。

連絡先のプロファイル写真を更新するには

アクセス許可の種類 最小特権アクセス許可 特権の高いアクセス許可
委任 (職場または学校のアカウント) Contacts.ReadWrite サポートされていません。
委任 (個人用 Microsoft アカウント) サポートされていません。 サポートされていません。
アプリケーション Contacts.ReadWrite サポートされていません。

グループのプロファイル写真を更新するには

アクセス許可の種類 最小特権アクセス許可 特権の高いアクセス許可
委任 (職場または学校のアカウント) Group.ReadWrite.All サポートされていません。
委任 (個人用 Microsoft アカウント) サポートされていません。 サポートされていません。
アプリケーション サポートされていません。 サポートされていません。

チームのプロフィール写真を更新するには

アクセス許可の種類 最小特権アクセス許可 特権の高いアクセス許可
委任 (職場または学校のアカウント) TeamSettings.ReadWrite.All サポートされていません。
委任 (個人用 Microsoft アカウント) サポートされていません。 サポートされていません。
アプリケーション サポートされていません。 サポートされていません。

ユーザーのプロフィール写真を更新するには

アクセス許可の種類 最小特権アクセス許可 特権の高いアクセス許可
委任 (職場または学校のアカウント) User.ReadWrite User.ReadWrite.All
委任 (個人用 Microsoft アカウント) サポートされていません。 サポートされていません。
アプリケーション User.ReadWrite.All サポートされていません。

注:

  • アプリケーションのアクセス許可のみを持つアプリは、グループの写真を更新できません。
  • グローバル管理者とユーザー管理者は、委任されたアクセス許可を使用して、organization内の任意のユーザーの写真を更新できます。 この操作は、アプリケーションのアクセス許可でもサポートされています。 organization内のすべてのユーザーの写真を更新するには、User.ReadWrite.All アクセス許可が必要です。 サインインしているユーザーの写真を更新するには、 User.ReadWrite アクセス許可のみが必要です。
  • 現在、Azure AD B2C テナントでは、Microsoft Graph APIを使用したユーザーの写真の更新はサポートされていません。

HTTP 要求

連絡先のプロフィール写真を更新するには:

PATCH /me/contacts/{id}/photo/$value
PATCH /users/{id | userPrincipalName}/contacts/{id}/photo/$value
PATCH /me/contactfolders/{contactFolderId}/contacts/{id}/photo/$value
PATCH /users/{id | userPrincipalName}/contactfolders/{contactFolderId}/contacts/{id}/photo/$value

PUT /me/contacts/{id}/photo/$value
PUT /users/{id | userPrincipalName}/contacts/{id}/photo/$value
PUT /me/contactfolders/{contactFolderId}/contacts/{id}/photo/$value
PUT /users/{id | userPrincipalName}/contactfolders/{contactFolderId}/contacts/{id}/photo/$value

グループ写真を更新するには:

PATCH /groups/{id}/photo/$value

PUT /groups/{id}/photo/$value

チーム写真を更新するには:

PUT /teams/{id}/photo/$value

ユーザーのプロフィール写真を更新するには:

PATCH /me/photo/$value
PATCH /users/{id | userPrincipalName}/photo/$value

PUT /me/photo/$value
PUT /users/{id | userPrincipalName}/photo/$value

要求ヘッダー

ヘッダー 値
Authorization ベアラー {token}。 必須です。 認証と承認の詳細については、こちらをご覧ください。
Content-Type image/jpeg。 必須です。

要求本文

要求の本文に、写真のバイナリ データを含めます。

応答

成功した場合、このメソッドはチームの写真を200 OK204 No Content更新するための応答コードまたは応答コードを返します。

例

例 1: ユーザーの写真を更新する

要求

次の例は要求を示しています。

PUT https://graph.microsoft.com/v1.0/me/photo/$value
Content-type: image/jpeg

Binary data for the image

応答

次の例は応答を示しています。

HTTP/1.1 200 OK

例 2: チームの写真を更新する

要求

次の例は、チームの写真を更新する要求を示しています。

PUT https://graph.microsoft.com/v1.0/teams/172b0cce-e65d-44ce-9a49-91d9f2e8491e/photo/$value
Content-type: image/jpeg

Binary data for the image

応答

次の例は応答を示しています。

HTTP/1.1 204 No Content