Compartilhar via


Eliminar perfilPhoto

Namespace: microsoft.graph

Elimine a fotografia do utilizador com sessão iniciada ou do grupo especificado.

Observação

A operação de eliminação suporta apenas fotografias de utilizador ou grupo, mas não o contacto do Outlook nem as fotografias do Teams.

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

Serviço global US Government L4 US Government L5 (DOD) China operada pela 21Vianet

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 as 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 eliminar a fotografia de perfil do utilizador com sessão iniciada

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

Para eliminar a fotografia de perfil de um grupo

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

Observação

  • Os administradores globais e de utilizadores podem eliminar a fotografia de qualquer utilizador na organização com permissões delegadas. Esta operação também suporta permissões de aplicação. Eliminar a fotografia de qualquer utilizador na organização requer permissões ProfilePhoto.ReadWrite.All ou User.ReadWrite.All . Eliminar a fotografia do utilizador com sessão iniciada só requer permissões User.ReadWrite .

Solicitação HTTP

Para eliminar a fotografia de perfil de um utilizador:

DELETE /me/photo/$value
DELETE /users/{id | userPrincipalName}/photo/$value

Para eliminar uma fotografia de grupo:

DELETE /groups/{id}/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.

Corpo da solicitação

Não forneça um corpo de solicitação para esse método.

Resposta

Se tiver êxito, este método retornará um código de resposta 200 OK.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação.

DELETE https://graph.microsoft.com/beta/me/photo/$value

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 200 OK