更新配置文件Photo
命名空间：microsoft.graph
更新租户中指定联系人、组、团队或用户的照片。 可以更新到的照片的大小限制为 4 MB。
可以使用 PATCH 或 PUT 执行此操作。
此 API 可用于以下国家级云部署。
| 全局服务 | 美国政府 L4 | 美国政府 L5 (DOD) | 由世纪互联运营的中国 |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
权限
下表显示了对每种受支持的资源类型调用此 API 所需的最低特权权限。 请遵循 最佳做法 来请求最低特权权限。 有关委派权限和应用程序权限的详细信息，请参阅权限类型。 要了解有关这些权限的详细信息，请参阅 权限参考。
要更新联系人的个人资料照片
| 权限类型 | 最低特权权限 | 更高特权权限 |
|---|---|---|
| 委派（工作或学校帐户） | Contacts.ReadWrite | 不支持。 |
| 委派（个人 Microsoft 帐户） | 不支持。 | 不支持。 |
| 应用程序 | Contacts.ReadWrite | 不支持。 |
要更新组的个人资料照片
| 权限类型 | 最低特权权限 | 更高特权权限 |
|---|---|---|
| 委派（工作或学校帐户） | ProfilePhoto.ReadWrite.All | Group.ReadWrite.All |
| 委派（个人 Microsoft 帐户） | 不支持。 | 不支持。 |
| 应用程序 | ProfilePhoto.ReadWrite.All | Group.ReadWrite.All |
更新团队个人资料照片
| 权限类型 | 最低特权权限 | 更高特权权限 |
|---|---|---|
| 委派（工作或学校帐户） | TeamSettings.ReadWrite.All | 不支持。 |
| 委派（个人 Microsoft 帐户） | 不支持。 | 不支持。 |
| 应用程序 | 不支持。 | 不支持。 |
更新用户的个人资料照片
| 权限类型 | 最低特权权限 | 更高特权权限 |
|---|---|---|
| 委派（工作或学校帐户） | ProfilePhoto.ReadWrite.All | User.ReadWrite、User.ReadWrite.All |
| 委派（个人 Microsoft 帐户） | User.ReadWrite | 不支持。 |
| 应用程序 | ProfilePhoto.ReadWrite.All | User.ReadWrite.All |
注意
- 具有管理员角色（例如用户管理员）的用户可以使用委派的权限更新组织中任何用户的照片。 应用程序权限也支持此操作。 更新组织中任何用户的照片需要 ProfilePhoto.ReadWrite.All 或 User.ReadWrite.All 权限。 更新已登录用户的照片只需要 User.ReadWrite 权限。
- Azure AD B2C 租户目前不支持使用Microsoft 图形 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