更新配置文件Photo

项目
11/14/2024

命名空间：microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。不支持在生产应用程序中使用这些 API。若要确定 API 是否在 v1.0 中可用，请使用版本选择器。

更新租户中指定联系人、组、团队或用户的照片。可以更新到的照片的大小限制为 4 MB。

可以使用 PATCH 或 PUT 执行此作。

全局服务	美国政府 L4	美国政府 L5 (DOD)	由世纪互联运营的中国
✅	✅	✅	✅

权限

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

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

要更新组的个人资料照片

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

更新团队个人资料照片

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

更新用户的个人资料照片

权限类型	最低特权权限	更高特权权限
委派（工作或学校帐户）	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

若要更新组照片，请执行以下作：

PUT /groups/{id}/photo/$value

若要更新团队照片，请执行以下作：

PUT /teams/{id}/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/beta/me/photo/$value
Content-type: image/jpeg

Binary data for the image



mgc-beta users photo content put --user-id {user-id}

重要

Microsoft Graph SDK 默认使用 v1.0 版本的 API，并且不支持 beta 版本中提供的所有类型、属性和 API。有关使用 SDK 访问 beta API 的详细信息，请参阅将 Microsoft Graph SDK 与 beta API 配合使用。

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


const options = {
	authProvider,
};

const client = Client.init(options);

const stream = Binary data for the image;

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

重要

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


Import-Module Microsoft.Graph.Beta.Users

$params = Binary data for the image

# A UPN can also be used as -UserId.
Set-MgBetaUserPhotoContent -UserId $userId -BodyParameter $params

重要

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

响应

以下示例显示了相应的响应。

HTTP/1.1 200 OK

示例 2：更新团队的照片

请求

以下示例显示了更新团队照片的请求。

PUT https://graph.microsoft.com/beta/teams/172b0cce-e65d-44ce-9a49-91d9f2e8491e/photo/$value
Content-type: image/jpeg

Binary data for the image



mgc-beta teams photo content put --team-id {team-id}

重要

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


const options = {
	authProvider,
};

const client = Client.init(options);

const stream = Binary data for the image;

await client.api('/teams/172b0cce-e65d-44ce-9a49-91d9f2e8491e/photo/$value')
	.version('beta')
	.put(stream);

重要

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


Import-Module Microsoft.Graph.Beta.Teams

$params = Binary data for the image

Set-MgBetaTeamPhotoContent -TeamId $teamId -BodyParameter $params

重要

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

响应

以下示例显示了相应的响应。

HTTP/1.1 204 No Content

通过

更新配置文件Photo

权限

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

要更新组的个人资料照片

更新团队个人资料照片

更新用户的个人资料照片

HTTP 请求

请求标头

请求正文

响应

示例

示例 1：更新用户的个人资料照片

请求

响应

示例 2：更新团队的照片

请求

响应

反馈

其他资源