Excluir perfilFoto

Namespace: microsoft.graph

Exclua a foto para o usuário conectado ou o grupo especificado.

Observação

A operação de exclusão dá suporte apenas a fotos de usuário ou grupo, mas não ao contato do Outlook nem às fotos do Teams.

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 excluir o foto de perfil do usuário conectado

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.

Para excluir o 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.

Observação

• Um aplicativo com apenas permissões de aplicativo não pode excluir a foto de um grupo.
• Administradores globais e de usuários podem excluir a foto de qualquer usuário na organização usando permissões delegadas. Essa operação também dá suporte a permissões de aplicativo. Excluir a foto de qualquer usuário na organização requer permissões User.ReadWrite.All . Excluir a foto do usuário conectado requer apenas permissões User.ReadWrite .

Solicitação HTTP

Para excluir o foto de perfil de um usuário:

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

Para excluir uma foto em 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.

HTTP

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

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

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

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

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 200 OK