Atualizar perfilPhoto
Namespace: microsoft.graph
Importante
As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
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.
| Serviço global | US Government L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Permissões
Para atualizar a foto de perfil de um contato
| Tipo de permissão | Permissões com menos privilégios | Permissões com privilégios superiores |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | Contacts.ReadWrite | Sem suporte. |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
| Aplicativo | Contacts.ReadWrite | Sem suporte. |
Para atualizar a foto 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 |
Para atualizar o foto de perfil de uma equipa
| Tipo de permissão | Permissões com menos privilégios | Permissões com privilégios superiores |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | TeamSettings.ReadWrite.All | Group.ReadWrite.All |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
| Application | TeamSettings.ReadWrite.All | Group.ReadWrite.All |
Para atualizar a foto de perfil de um utilizador
| 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 |
Observação
- As permissões marcadas com * são suportadas apenas para retrocompatibilidade. Atualize as suas soluções para utilizar uma permissão alternativa e evite utilizar estas permissões no futuro.
- Os utilizadores com funções de administrador, como Administradores de utilizadores, podem atualizar a fotografia de qualquer utilizador na organização através de permissões delegadas. Esta operação também é suportada com permissões de aplicação. Atualizar a fotografia de qualquer utilizador na organização requer a permissão ProfilePhoto.ReadWrite.All ou User.ReadWrite.All . Atualizar a fotografia do utilizador com sessão iniciada só requer a permissão User.ReadWrite .
- A atualização da fotografia de um utilizador com o Microsoft API do Graph não é atualmente suportada nos inquilinos do Azure AD B2C.
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:
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:
PUT /me/photo/$value
PUT /users/{id | userPrincipalName}/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. |
| Content-Type | Por exemplo, imagem/jpeg. Obrigatório. |
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 foto de perfil de um utilizador
Solicitação
O exemplo a seguir mostra uma solicitação.
PUT https://graph.microsoft.com/beta/me/photo/$value
Content-type: image/jpeg
Binary data for the image
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/beta/teams/172b0cce-e65d-44ce-9a49-91d9f2e8491e/photo/$value
Content-type: image/jpeg
Binary data for the image
Resposta
O exemplo a seguir mostra a resposta.
HTTP/1.1 204 No Content