ProfilePhoto を更新するUpdate profilephoto

名前空間: microsoft.graphNamespace: microsoft.graph


/betaMicrosoft Graph のバージョンの api は変更される可能性があります。APIs under the /beta version in Microsoft Graph are subject to change. 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。Use of these APIs in production applications is not supported. API が v2.0 で利用できるかどうかを確認するには、 バージョン セレクターを使用します。To determine whether an API is available in v1.0, use the Version selector.

サインインしているユーザー、または指定されたグループまたは連絡先を含む、テナント内の任意のユーザーの写真を更新します。現在、各 REST 要求の合計サイズは8MB に制限されているため、追加できる写真のサイズは8MB 未満に制限されています。Update the photo for any user in the tenant, including the signed-in user or the specified group or contact. Because there is currently a limit of 8MB on the total size of each REST request, the size of the photo you can add is limited to under 8MB.

この操作には PUT のみを使用します。Only use PUT for this operation.

: ユーザー の写真を更新すると、この操作によって Microsoft 365 の写真の更新が最初に試行されます。Note : When updating the user photo, this operation first attempts to update the photo in Microsoft 365. これが失敗すると (ユーザーがメールボックスを持っていないため)、この API は Azure Active Directory の写真を更新しようとします。If that fails (due to the user not having a mailbox), this API will attempt to update the photo in Azure Active Directory.


この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

アクセス許可の種類Permission type アクセス許可 (特権の小さいものから大きいものへ)Permissions (from least to most privileged)
委任 (職場または学校のアカウント)Delegated (work or school account) サインインしている ユーザー のプロファイル写真:Profile photo of the signed-in user :
ユーザー読み取り/書き込みユーザー。User.ReadWrite, User.ReadWrite.All

group リソースの場合:For group resource:

contact リソースの場合:For contact resource:
委任 (個人用 Microsoft アカウント)Delegated (personal Microsoft account) サポートされていません。Not supported.
アプリケーションApplication user リソースの場合:For user resource:

group リソースの場合:For group resource:

contact リソースの場合:For contact resource:

組織内のユーザーの写真を更新するには、アプリにはアプリケーションのアクセス許可 User.ReadWrite.All が必要で、ユーザーの代わりではなく、それ自身の ID でこの API を呼び出す必要があります。Note To update the photo of any user in the organization, your app must have the User.ReadWrite.All application permission and call this API under its own identity, not on behalf of a user. 詳細については、「ユーザーなしでアクセスを取得する」を参照してください。To learn more, see get access without a signed-in user. サインインしているユーザーの写真を更新するには、ユーザー書き込みのアクセス許可のみが必要です。Updating the photo of the signed-in user only requires User.ReadWrite permission.

注: 現在のところ、アプリケーションのアクセス許可を使用するグループの写真へのアクセスに関する「 既知の問題」があります。Note: There is currently a known issue with accessing group photos using application permissions.

HTTP 要求HTTP request

PUT /me/photo/$value
PUT /users/{id | userPrincipalName}/photo/$value
PUT /groups/{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

チームの写真を更新するには、次のようにします。To update the photo for a team:

PUT /groups/{teamId}/photo/$value`

要求ヘッダーRequest headers

ヘッダーHeader Value
AuthorizationAuthorization ベアラー {トークン}。必須。Bearer {token}. Required.
Content-TypeContent-Type image/jpeg。必須。image/jpeg. Required.

要求本文Request body

要求本文に、写真のバイナリ データを含めます。In the request body, include the binary data of the photo in the request body.


成功した場合、このメソッドは 200 OK 応答コードを返します。If successful, this method returns a 200 OK response code.



要求の例を次に示します。The following is an example of the request.

Content-type: image/jpeg

Binary data for the image


応答の例を次に示します。The following is an example of the response.

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。Note: The response object shown here might be shortened for readability.

HTTP/1.1 200 OK