更新 profilePhoto

命名空间：microsoft.graph

更新租户中指定联系人、组、团队或用户的照片。 可更新到的照片大小必须小于 8 MB。

由于每个 REST 请求的总大小当前限制为 4 MB，可以添加的照片大小也限制为 4 MB。 以下是Exchange Online上 HD 照片支持的维度：48x48、、64x64、96x96、240x240``120x120、360x360、432x432``504x504和 648x648。

可以为此操作使用 PATCH 或 PUT。

注意： 此操作仅支持用户的工作或学校邮箱，而不支持个人邮箱。

权限

要调用此 API，需要以下权限之一。要了解详细信息，包括如何选择权限的信息，请参阅权限。

要更新联系人的个人资料照片

权限类型	权限（从最低特权到最高特权）
委派（工作或学校帐户）	Contacts.ReadWrite
委派（个人 Microsoft 帐户）	不支持。
应用程序	Contacts.ReadWrite

要更新组的个人资料照片

权限类型	权限（从最低特权到最高特权）
委派（工作或学校帐户）	Group.ReadWrite.All
委派（个人 Microsoft 帐户）	不支持。
应用程序	Group.ReadWrite.All

更新团队的个人资料照片

权限类型	权限（从最低特权到最高特权）
委派（工作或学校帐户）	TeamSettingsReadWriteAll
委派（个人 Microsoft 帐户）	不支持。
应用程序	TeamSettingsReadWriteAll

要更新已登录用户的个人资料照片

权限类型	权限（从最低特权到最高特权）
委派（工作或学校帐户）	User.ReadWrite、User.ReadWrite.All
委派（个人 Microsoft 帐户）	不支持。
应用程序	User.ReadWrite.All

备注

1. 若要更新组织中任何用户的照片，应用必须具有 User.ReadWrite.All 应用程序权限，并以自己的标识（而不是代表用户）调用此 API。 若要了解详细信息，请参阅在没有已登录用户的情况下进行访问。 更新已登录用户的照片仅需要 User.ReadWrite 权 限。
2. 当前在使用应用权限访问组照片方面存在一个 已知问题。
3. Azure AD B2C 租户目前不支持使用 Microsoft 图形 API 更新用户的照片。

HTTP 请求

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

请求标头

标头	值
Authorization	Bearer {token}。必需。
Content-Type	image/jpeg。必需。

请求正文

在请求正文中，包括请求正文中照片的二进制数据。

响应

如果成功，此方法将返回200 OK用于更新 团队 照片的响应代码或204 No Content响应代码。

示例

示例 1：更新用户的照片

请求

请求示例如下所示。

HTTP

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

Binary data for the image

C#

GraphServiceClient graphClient = new GraphServiceClient( authProvider );

using var stream = new System.IO.MemoryStream(Encoding.UTF8.GetBytes(@"Binary data for the image"));

await graphClient.Me.Photo.Content
    .Request()
    .PutAsync(stream);

有关如何将 SDK 添加 到项目并 创建 authProvider 实例的 详细信息，请参阅 SDK 文档。

JavaScript

const options = {
    authProvider,
};

const client = Client.init(options);

const stream = Binary data for the image;

await client.api('/me/photo/$value')
    .put(stream);

有关如何将 SDK 添加 到项目并 创建 authProvider 实例的 详细信息，请参阅 SDK 文档。

Java

GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

byte[] stream = Base64.getDecoder().decode("Binary data for the image");
    graphClient.me().photo().content()
    .buildRequest()
    .put(stream);

有关如何将 SDK 添加 到项目并 创建 authProvider 实例的 详细信息，请参阅 SDK 文档。

响应

下面展示了示例响应。

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