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 é limitado a 4 MB.

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

Essa API está disponível nas seguintes implantações de nuvem nacional.

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 com privilégios mínimos. 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

Para atualizar a foto de perfil de um grupo

Para atualizar a foto de perfil de uma equipe

Para atualizar a foto de perfil de um usuário

Solicitação HTTP

Para atualizar a 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 de grupo:

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

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

Para atualizar uma foto da equipe:

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

Para atualizar a 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

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

const options = {
	authProvider,
};

const client = Client.init(options);

const stream = Binary data for the image;

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

Import-Module Microsoft.Graph.Users

$params = Binary data for the image

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

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 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

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')
	.put(stream);

Import-Module Microsoft.Graph.Teams

$params = Binary data for the image

Set-MgTeamPhotoContent -TeamId $teamId -BodyParameter $params

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 204 No Content