profilePhoto を更新する
名前空間: microsoft.graph
テナント内の指定した連絡先、グループ、チーム、またはユーザーの写真を更新します。 更新できる写真のサイズは 4 MB に制限されています。
この操作には PATCH または PUT を使用できます。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
アクセス許可
次の表は、サポートされている各リソースの種類でこの API を呼び出すために必要な最小特権のアクセス許可またはアクセス許可を示しています。 ベスト プラクティスに従って、最小限の特権のアクセス許可を要求します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。
連絡先のプロファイル写真を更新するには
| アクセス許可の種類 | 最小特権アクセス許可 | より高い特権のアクセス許可 |
|---|---|---|
| 委任 (職場または学校のアカウント) | Contacts.ReadWrite | サポートされていません。 |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 | サポートされていません。 |
| アプリケーション | Contacts.ReadWrite | サポートされていません。 |
グループのプロファイル写真を更新するには
| アクセス許可の種類 | 最小特権アクセス許可 | より高い特権のアクセス許可 |
|---|---|---|
| 委任 (職場または学校のアカウント) | ProfilePhoto.ReadWrite.All | Group.ReadWrite.All |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 | サポートされていません。 |
| アプリケーション | ProfilePhoto.ReadWrite.All | Group.ReadWrite.All |
チームのプロフィール写真を更新するには
| アクセス許可の種類 | 最小特権アクセス許可 | より高い特権のアクセス許可 |
|---|---|---|
| 委任 (職場または学校のアカウント) | TeamSettings.ReadWrite.All | サポートされていません。 |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 | サポートされていません。 |
| アプリケーション | TeamSettings.ReadWrite.All | サポートされていません。 |
ユーザーのプロフィール写真を更新するには
| アクセス許可の種類 | 最小特権アクセス許可 | より高い特権のアクセス許可 |
|---|---|---|
| 委任 (職場または学校のアカウント) | ProfilePhoto.ReadWrite.All | User.ReadWrite, User.ReadWrite.All |
| 委任 (個人用 Microsoft アカウント) | User.ReadWrite | サポートされていません。 |
| アプリケーション | ProfilePhoto.ReadWrite.All | User.ReadWrite.All |
注:
- ユーザー管理者などの管理者ロールを持つユーザーは、委任されたアクセス許可を使用して、organization内のすべてのユーザーの写真を更新できます。 この操作は、アプリケーションのアクセス許可でもサポートされています。 organization内の任意のユーザーの写真を更新するには、ProfilePhoto.ReadWrite.All または 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 OK応答コードまたは204 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