Atualizar perfilPhoto

Namespace: microsoft.graph

Atualize a fotografia do contacto, grupo, equipa ou utilizador especificado num inquilino. O tamanho da fotografia para a qual pode atualizar está limitado a 4 MB.

Pode utilizar PATCH ou PUT para esta operação.

Esta API está disponível nas seguintes implementações de cloud nacionais.

Permissões

As tabelas seguintes mostram as permissões ou permissões com menos privilégios necessárias para chamar esta API em cada tipo de recurso suportado. Siga as melhores práticas para pedir permissões com menos privilégios. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja 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 o foto de perfil de uma equipa

Para atualizar a foto de perfil de um utilizador

Solicitação HTTP

Para atualizar o foto de perfil de um contacto:

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 fotografia de grupo:

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

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

Para atualizar uma fotografia de equipa:

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

Para atualizar o foto de perfil de um utilizador:

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, este método devolve um 200 OK código de resposta ou um 204 No Content código de resposta para atualizar a fotografia de uma equipa.

Exemplos

Exemplo 1: Atualizar a fotografia de um utilizador

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

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

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 fotografia de uma equipa

Solicitação

O exemplo seguinte mostra um pedido para atualizar uma fotografia de equipa.

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

Binary data for the image

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

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