profilePhoto aktualisieren

Namespace: microsoft.graph

Aktualisieren Sie das Foto für den angegebenen Kontakt, die gruppe, das Team oder den Benutzer in einem Mandanten. Die Größe des Fotos, das Sie aktualisieren können, muss unter 8 MB betragen.

Aufgrund des aktuellen Grenzwerts von 4 MB für die Gesamtgröße jeder REST-Anforderung ist die Größe des Fotos, das Sie hinzufügen können, ebenfalls auf 4 MB beschränkt. Es folgen die unterstützten Abmessungen für HD-Fotos auf Exchange Online: 48x48, 64x64, 96x96, 120x120, 240x240``360x360, 432x432, , 504x504und 648x648.

Sie können patch oder PUT für diesen Vorgang verwenden.

Hinweis: Dieser Vorgang unterstützt nur die Geschäfts-, Schul- oder Unipostfächer eines Benutzers und keine persönlichen Postfächer.

Berechtigungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.

Um das Profilfoto eines Kontakts zu aktualisieren

Berechtigungstyp	Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto)	Contacts.ReadWrite
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt
Anwendung	Contacts.ReadWrite

Um das Profilfoto einer Gruppe zu aktualisieren

Berechtigungstyp	Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto)	Group.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt
Anwendung	Group.ReadWrite.All

So aktualisieren Sie das Profilfoto eines Teams

Berechtigungstyp	Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto)	TeamSettingsReadWriteAll
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt
Anwendung	TeamSettingsReadWriteAll

Um das Profilfoto des angemeldeten Benutzers zu aktualisieren

Berechtigungstyp	Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto)	User.ReadWrite, User.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt
Anwendung	User.ReadWrite.All

Hinweis

1. Um das Foto eines Benutzers in der Organisation zu aktualisieren, muss Ihre App über die Anwendungsberechtigung User.ReadWrite.All verfügen und diese API unter ihrer eigenen Identität aufrufen, nicht im Namen eines Benutzers. Weitere Informationen hierzu finden Sie unter Zugriff ohne einen angemeldeten Benutzer erlangen. Zum Aktualisieren des Fotos des angemeldeten Benutzers ist nur die Berechtigung "User.ReadWrite " erforderlich.
2. Es gibt derzeit ein bekanntes Problem beim Zugriff auf Gruppenfotos mithilfe von Anwendungsberechtigungen.
3. Das Aktualisieren eines Benutzerfotos mithilfe der Microsoft Graph-API wird derzeit in Azure AD B2C-Mandanten nicht unterstützt.

HTTP-Anforderung

PATCH /me/photo/$value
PATCH /users/{id | userPrincipalName}/photo/$value
PATCH /groups/{id}/photo/$value
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/photo/$value
PUT /users/{id | userPrincipalName}/photo/$value
PUT /groups/{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
PUT /team/{id}/photo/$value

Anforderungsheader

Kopfzeile	Wert
Authorization	Bearer {token}. Erforderlich.
Content-Type	image/jpeg. Erforderlich.

Anforderungstext

Fügen Sie in den Anforderungstext die Binärdaten des Fotos ein.

Antwort

Bei erfolgreicher Ausführung gibt die Methode einen 200 OK Antwortcode oder einen 204 No Content Antwortcode zum Aktualisieren des Fotos eines Teams zurück.

Beispiele

Beispiel 1: Aktualisieren des Fotos des Benutzers

Anforderung

Nachfolgend ist ein Beispiel für eine Anforderung dargestellt.

HTTP

PUT https://graph.microsoft.com/v1.0/me/photo/$value
Content-type: image/jpeg

Binary data for the image

C#

GraphServiceClient graphClient = new GraphServiceClient( authProvider );

using var stream = new System.IO.MemoryStream(Encoding.UTF8.GetBytes(@"Binary data for the image"));

await graphClient.Me.Photo.Content
    .Request()
    .PutAsync(stream);

Ausführliche Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider-Instanz finden Sie in der SDK-Dokumentation.

JavaScript

const options = {
    authProvider,
};

const client = Client.init(options);

const stream = Binary data for the image;

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

Ausführliche Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider-Instanz finden Sie in der SDK-Dokumentation.

Java

GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

byte[] stream = Base64.getDecoder().decode("Binary data for the image");
    graphClient.me().photo().content()
    .buildRequest()
    .put(stream);

Ausführliche Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider-Instanz finden Sie in der SDK-Dokumentation.

Antwort

Nachfolgend sehen Sie ein Beispiel der Antwort.

HTTP/1.1 200 OK

Beispiel 2: Aktualisieren des Fotos eines Teams

Anfrage

Im Folgenden sehen Sie ein Beispiel für eine Anforderung zum Aktualisieren eines Teamfotos.

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

Binary data for the image

Antwort

Nachfolgend sehen Sie ein Beispiel der Antwort.

HTTP/1.1 204 No Content