Foto abrufen

Rufen Sie das angegebene profilePhoto oder die Metadaten (profilePhoto-Eigenschaften) ab.

Ein GET-Vorgang sucht nach dem angegebenen Foto im Postfach des Benutzers in Exchange Online.

Hinweis Dieser Vorgang in Version 1.0 unterstützt nur Geschäfts- oder Schulpostfächer eines Benutzers, keine persönlichen Postfächer.

Voraussetzungen

Einer der folgenden Bereiche ist erforderlich, um diese API auszuführen:

  • Profilfotos aller Benutzer im Mandanten einschließlich des angemeldeten Benutzers – User.ReadBasic.All; User.Read.All; User.ReadWrite.All
  • Profilfoto des angemeldeten Benutzers – User.Read, User.ReadWrite; User.ReadBasic.All; User.Read.All; User.ReadWrite.All
  • Profilfoto einer Gruppe - Group.Read.All; Group.ReadWrite.All
  • Foto eines Kontakts - Contacts.Read; Contacts.ReadWrite

HTTP-Anforderung zum Abrufen des Fotos

GET /me/photo/$value
GET /users/{id | userPrincipalName}/photo/$value
GET /groups/{id}/photo/$value
GET /me/contacts/{id}/photo/$value
GET /users/{id | userPrincipalName}/contacts/{id}/photo/$value
GET /me/contactfolders/{contactFolderId}/contacts/{id}/photo/$value
GET /users/{id | userPrincipalName}/contactfolders/{contactFolderId}/contacts/{id}/photo/$value

HTTP-Anforderung zum Abrufen von Metadaten des Fotos

GET /me/photo
GET /users/{id | userPrincipalName}/photo
GET /groups/{id}/photo
GET /me/contacts/{id}/photo
GET /users/{id | userPrincipalName}/contacts/{id}/photo
GET /me/contactfolders/{contactFolderId}/contacts/{id}/photo
GET /users/{id | userPrincipalName}/contactfolders/{contactFolderId}/contacts/{id}/photo

Optionale Abfrageparameter

Diese Methode unterstützt die OData-Abfrageparameter zur Anpassung der Antwort.

Anforderungsheader

Name Typ Beschreibung
Authorization string Bearer {token}. Erforderlich.

Anforderungstext

Geben Sie für diese Methode keinen Anforderungstext an.

Antwort für Abrufen des Fotos

Wenn die Methode erfolgreich verläuft, werden der Antwortcode 200 OK und binäre Daten des angeforderten Fotos zurückgegeben. Wenn kein Foto vorhanden ist, gibt der Vorgang 404 Not Found zurück.

Antwort für Abrufen der Metadaten des Fotos

Wenn die Methode erfolgreich verläuft, werden der Antwortcode 200 OK und das profilePhoto-Objekt im Antworttext zurückgegeben.

Beispiel

Anforderung 1

Diese Anforderung ruft das Foto des angemeldeten Benutzers mit der größten verfügbaren Größe ab.

GET https://graph.microsoft.com/v1.0/me/photo/$value
Antwort 1

Enthält die binären Daten des angeforderten Fotos. Der HTTP-Antwortcode ist 200.

Anforderung 2

Diese Anforderung ruft die Metadaten des Benutzerfotos des angemeldeten Benutzers.

GET https://graph.microsoft.com/v1.0/me/photo
Antwort 2

Die folgenden Antwortdaten zeigen die Metadaten des Fotos. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten.

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Me/photo/$entity",
    "@odata.id": "https://graph.microsoft.com/v1.0/users('ddfcd489-628b-7d04-b48b-20075df800e5@1717622f-1d94-c0d4-9d74-f907ad6677b4')/photo",
    "@odata.mediaContentType": "image/jpeg",
    "@odata.mediaEtag": "\"BA09D118\"",
    "id": "240X240",
    "width": 240,
    "height": 240
}

Die folgenden Antwortdaten zeigen die Inhalte einer Antwort, wenn für den Benutzer noch kein Foto hochgeladen wurde. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten.

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Me/photo/$entity",
    "@odata.id": "https://graph.microsoft.com/v1.0/users('ddfcd489-628b-7d04-b48b-20075df800e5@1717622f-1d94-c0d4-9d74-f907ad6677b4')/photo",
    "@odata.mediaContentType": "image/gif",
    "@odata.mediaEtag": "",
    "id": "1X1",
    "width": 1,
    "height": 1
}