更新 profilephoto

更新登录 用户、指定联系人的照片。由于目前每个 REST 请求的总大小限制为 4 MB,这就要求可添加的照片小于 4 MB。

可以在版本 1.0 中使用 PATCH 或 PUT 执行此操作。

注意:1.0 版本中的操作仅支持用户的工作或学校邮箱,不支持个人邮箱。

先决条件

要针对以下几项执行此 API,需要以下范围之一:

  • 已登录用户 - User.ReadWriteUser.ReadWrite.All 的个人资料照片
  • - Group.ReadWrite.All 的个人资料照片
  • 联系人 - Contacts.ReadWrite 的照片

注意 要更新组织中任何用户的照片,应用必须具有 User.ReadWrite.All 应用程序权限,并以其自己的身份而不是代表用户来调用此 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

请求标头

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

请求正文

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

响应

如果成功,此方法返回 200 OK 响应代码。

示例

请求

下面是一个请求示例。

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

Binary data for the image

响应

下面是一个响应示例。注意:为了简单起见,可能会将此处所示的响应对象截断。将从实际调用中返回所有属性。

HTTP/1.1 200 OK