Atualizar profilePhoto

Namespace: microsoft.graph

Atualize a foto do contato, grupo, equipe ou usuário especificado em um locatário. O tamanho da foto para a qual você pode atualizar deve ter menos de 8 MB.

Devido ao limite atual de 4 MB no tamanho total de cada solicitação REST, o tamanho da foto que você pode adicionar também é limitado a 4 MB. A seguir estão as dimensões com suporte para fotos HD em Exchange Online: 48x48, 64x64, , 96x96, 120x120, 240x240, 432x432``360x360, 504x504e 648x648.

Você pode usar PATCH ou PUT para esta operação.

Nota: Essa operação dá suporte apenas a caixas de correio corporativas ou de estudante de um usuário e não a caixas de correio pessoais.

Permissões

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Para atualizar a foto de perfil de um contato

Tipo de permissão	Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante)	Contacts.ReadWrite
Delegado (conta pessoal da Microsoft)	Sem suporte.
Aplicativo	Contacts.ReadWrite

Para atualizar a foto de perfil de um grupo

Tipo de permissão	Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante)	Group.ReadWrite.All
Delegado (conta pessoal da Microsoft)	Sem suporte.
Aplicativo	Group.ReadWrite.All

Para atualizar a foto de perfil de uma equipe

Tipo de permissão	Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante)	TeamSettingsReadWriteAll
Delegado (conta pessoal da Microsoft)	Sem suporte.
Aplicativo	TeamSettingsReadWriteAll

Para atualizar a foto do perfil do usuário conectado

Tipo de permissão	Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante)	User.ReadWrite, User.ReadWrite.All
Delegado (conta pessoal da Microsoft)	Sem suporte.
Aplicativo	User.ReadWrite.All

Observação

1. Para atualizar a foto de qualquer usuário na organização, seu aplicativo deve ter a permissão de aplicativo User.ReadWrite.All e chamar essa API em sua própria identidade, não em nome de um usuário. Para saber mais, confira obter acesso sem um usuário conectado. Atualizar a foto do usuário conectado requer apenas a permissão User.ReadWrite .
2. Atualmente, há um problema conhecido ao acessar fotos de grupo usando permissões de aplicativos.
3. Atualmente, não há suporte para a atualização da foto de um usuário usando o Microsoft API do Graph em locatários Azure AD B2C.

Solicitação 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
PUT /team/{id}/photo/$value

Cabeçalhos de solicitação

Cabeçalho	Valor
Autorização	{token} de portador. Obrigatório.
Content-Type	image/jpeg. Obrigatório.

Corpo da solicitação

Inclua os dados binários da foto no corpo da solicitação.

Resposta

Se bem-sucedido, este método retorna 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 do usuário

Solicitação

Veja a seguir um exemplo de uma solicitação.

HTTP

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

Binary data for the image

C#

GraphServiceClient graphClient = new GraphServiceClient( authProvider );

using var stream = new System.IO.MemoryStream(Encoding.UTF8.GetBytes(@"Binary data for the image"));

await graphClient.Me.Photo.Content
    .Request()
    .PutAsync(stream);

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider , consulte a documentação do SDK.

JavaScript

const options = {
    authProvider,
};

const client = Client.init(options);

const stream = Binary data for the image;

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

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider , consulte a documentação do SDK.

Java

GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

byte[] stream = Base64.getDecoder().decode("Binary data for the image");
    graphClient.me().photo().content()
    .buildRequest()
    .put(stream);

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider , consulte a documentação do SDK.

Resposta

Este é um exemplo de resposta.

HTTP/1.1 200 OK

Exemplo 2: Atualizar a foto de uma equipe

Solicitação

A seguir está um exemplo de uma solicitação para atualizar uma foto da 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

Este é um exemplo de resposta.

HTTP/1.1 204 No Content