大网数据广告活动
Microsoft Graph 接口

更新 profilePhoto

· 52CE 我爱测

更新登录用户或指定组或联系人或团队的照片。

命名空间: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

Note:

  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

历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 kevinbellinger)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / Microsoft Graph 中文文档历史快照
适用范围
历史中文快照 2023-02-03;详见原文产品版本;文档日期 未标明
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。