Atualizar perfilPhoto

  • Artigo

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