Atualizar perfilPhoto
Namespace: microsoft.graph
Atualize a foto para o contato, grupo, equipe ou usuário especificados em um locatário. O tamanho da foto para a qual você pode atualizar é limitado a 4 MB.
Você pode usar PATCH ou PUT para esta operação.
Essa API está disponível nas seguintes implantações nacionais de nuvem.
Serviço global | Governo dos EUA L4 | GOVERNO DOS EUA L5 (DOD) | China operada pela 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Permissões
As tabelas a seguir mostram a permissão ou permissões menos privilegiadas necessárias para chamar essa API em cada tipo de recurso com suporte. Siga as práticas recomendadas para solicitar permissões menos privilegiadas. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
Para atualizar a foto de perfil de um contato
Tipo de permissão | Permissões menos privilegiadas | Permissões privilegiadas mais altas |
---|---|---|
Delegado (conta corporativa ou de estudante) | Contacts.ReadWrite | Sem suporte. |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Aplicativo | Contacts.ReadWrite | Sem suporte. |
Para atualizar a foto de perfil de um grupo
Tipo de permissão | Permissões menos privilegiadas | Permissões privilegiadas mais altas |
---|---|---|
Delegado (conta corporativa ou de estudante) | Group.ReadWrite.All | Sem suporte. |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Aplicativo | Sem suporte. | Sem suporte. |
Para atualizar o foto de perfil de uma equipe
Tipo de permissão | Permissões menos privilegiadas | Permissões privilegiadas mais altas |
---|---|---|
Delegado (conta corporativa ou de estudante) | TeamSettings.ReadWrite.All | Sem suporte. |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Aplicativo | Sem suporte. | Sem suporte. |
Para atualizar o foto de perfil de um usuário
Tipo de permissão | Permissões menos privilegiadas | Permissões privilegiadas mais altas |
---|---|---|
Delegado (conta corporativa ou de estudante) | User.ReadWrite | User.ReadWrite.All |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Aplicativo | User.ReadWrite.All | Sem suporte. |
Observação
- Um aplicativo com apenas permissões de aplicativo não pode atualizar a foto de um grupo.
- O administrador global e o administrador do usuário podem atualizar a foto de qualquer usuário na organização usando permissões delegadas. Essa operação também tem suporte com permissões de aplicativo. Atualizar a foto de qualquer usuário na organização requer permissão User.ReadWrite.All . Atualizar a foto do usuário conectado requer apenas permissão User.ReadWrite .
- Atualmente, não há suporte para atualizar a foto de um usuário usando o microsoft API do Graph em Azure AD locatários B2C.
Solicitação HTTP
Para atualizar o foto de perfil de um contato:
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
Para atualizar uma foto em grupo:
PATCH /groups/{id}/photo/$value
PUT /groups/{id}/photo/$value
Para atualizar uma foto de equipe:
PUT /teams/{id}/photo/$value
Para atualizar o foto de perfil de um usuário:
PATCH /me/photo/$value
PATCH /users/{id | userPrincipalName}/photo/$value
PUT /me/photo/$value
PUT /users/{id | userPrincipalName}/photo/$value
Cabeçalhos de solicitação
Cabeçalho | Valor |
---|---|
Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
Content-Type | image/jpeg. Obrigatório. |
Corpo da solicitação
No corpo da solicitação, inclua os dados binários da foto.
Resposta
Se for bem-sucedido, esse método retornará um 200 OK
código de resposta ou um 204 No Content
código de resposta para atualizar a foto de uma equipe.
Exemplos
Exemplo 1: atualizar a foto de um usuário
Solicitação
O exemplo a seguir mostra uma solicitação.
PUT https://graph.microsoft.com/v1.0/me/photo/$value
Content-type: image/jpeg
Binary data for the image
Resposta
O exemplo a seguir mostra a resposta.
HTTP/1.1 200 OK
Exemplo 2: atualizar a foto de uma equipe
Solicitação
O exemplo a seguir mostra uma solicitação para atualizar uma foto de equipe.
PUT https://graph.microsoft.com/v1.0/teams/172b0cce-e65d-44ce-9a49-91d9f2e8491e/photo/$value
Content-type: image/jpeg
Binary data for the image
Resposta
O exemplo a seguir mostra a resposta.
HTTP/1.1 204 No Content
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de