Foto abrufenGet photo

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

Rufen Sie das angegebene profilePhoto oder die Metadaten (profilePhoto-Eigenschaften) ab.Get the specified profilePhoto or its metadata (profilePhoto properties).

Ein erster Versuch der Methode „GET photo“ zum Abrufen des angegebenen Fotos aus Office 365.A GET photo method first attempts to retrieve the specified photo from Office 365. Wenn das Foto nicht in Office 365 verfügbar ist, versucht die API, das Foto aus Azure Active Directory abzurufen.If the photo is not available in Office 365, the API attempts to retrieve the photo from Azure Active Directory.

Die unterstützten Größen der HD-Fotos in Office 365 sind wie folgt: 48x48, 64x64, 96x96, 120x120, 240x240, 360x360, 432x432, 504x504 und 648x648.The supported sizes of HD photos in Office 365 are as follows: 48x48, 64x64, 96x96, 120x120, 240x240, 360x360, 432x432, 504x504, and 648x648. Fotos können eine beliebige Größe aufweisen, wenn sie in Azure Active Directory gespeichert sind.Photos can be any dimension if they are stored in Azure Active Directory.

Sie können die Metadaten des größten verfügbaren Fotos abrufen oder eine Größe angeben, um die Metadaten für diese Fotogröße abzurufen.You can get the metadata of the largest available photo, or specify a size to get the metadata for that photo size. Wenn die angeforderte Größe nicht verfügbar ist, können Sie immer noch eine kleinere Größe abrufen, die der Benutzer hochgeladen und zur Verfügung gestellt hat.If the size you request is not available, you can still get a smaller size that the user has uploaded and made available. Wenn der Benutzer beispielsweise ein Foto mit 504x504 Pixeln hochlädt, sind alle Fotogrößen bis auf 648x648 zum Download verfügbar.For example, if the user uploads a photo that is 504x504 pixels, all but the 648x648 size of the photo will be available for download. Wenn die angegebene Größe nicht im Postfach des Benutzers oder in Azure Active Directory verfügbar ist, wird die Größe 1x1 mit den restlichen Metadaten zurückgegeben.If the specified size is not available in the user's mailbox or in Azure Active Directory, the size 1x1 is returned with the rest of the metadata.

BerechtigungenPermissions

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.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Hinweis Die Methode „GET photo“ in der Betaversion unterstützt das private Konto sowie das Geschäfts- und Schulkonto eines Benutzers.Note: The GET photo method in beta supports a user's work, school, or personal accounts. Die Methode „GET photo metadata“ unterstützt jedoch nur Geschäfts- oder Schulkonten eines Benutzers, keine persönlichen Konten.The GET photo metadata method, however, supports only the user's work or school accounts and not personal accounts.

BerechtigungstypPermission type Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)Permissions (from least to most privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) Für user-Ressource:For user resource:
User.Read, User.ReadBasic.All, User.Read.All, User.ReadWrite, User.ReadWrite.AllUser.Read, User.ReadBasic.All, User.Read.All, User.ReadWrite, User.ReadWrite.All

Für group-Ressource:For group resource:
Group.Read.All, Group.ReadWrite.AllGroup.Read.All, Group.ReadWrite.All

Für contact-Ressource:For contact resource:
Contacts.Read, Contacts.ReadWriteContacts.Read, Contacts.ReadWrite
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account)
Hinweis:Der Vorgang wird nicht unterstützt.Note: Metadata operation is not supported.
Für user-Ressource:For user resource:
User.Read, User.ReadWriteUser.Read, User.ReadWrite

Für contact-Ressource:For contact resource:
Contacts.Read, Contacts.ReadWriteContacts.Read, Contacts.ReadWrite
ApplicationApplication Für user-Ressource:For user resource:
User.Read.All, User.ReadWrite.AllUser.Read.All, User.ReadWrite.All

Für group-Ressource:For group resource:
Group.Read.All, Group.ReadWrite.AllGroup.Read.All, Group.ReadWrite.All

Für contact-Ressource:For contact resource:
Contacts.Read, Contacts.ReadWriteContacts.Read, Contacts.ReadWrite

HTTP-AnforderungHTTP request

Abrufen des FotosGet the photo

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

Abrufen von Metadaten des FotosGet the metadata of the photo

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

Abrufen der Metadaten für eine bestimmte FotogrößeGet the metadata for a specific photo size

GET /me/photos/{size}
GET /users/{id | userPrincipalName}/photos/{size}
GET /groups/{id}/photos/{size}

PfadparameterPath parameters

ParameterParameter TypType BeschreibungDescription
sizesize StringString Eine Fotogröße.A photo size. Die unterstützten Größen der HD-Fotos in Office 365 sind wie folgt: 48x48, 64x64, 96x96, 120x120, 240x240, 360x360, 432x432, 504x504 und 648x648.The supported sizes of HD photos on Office 365 are as follows: 48x48, 64x64, 96x96, 120x120, 240x240, 360x360, 432x432, 504x504, and 648x648. Fotos können eine beliebige Größe aufweisen, wenn sie in Azure Active Directory gespeichert sind.Photos can be any dimension if they are stored in Azure Active Directory.

Optionale AbfrageparameterOptional query parameters

Diese Methode unterstützt die OData-Abfrageparameter zur Anpassung der Antwort.This method supports the OData query parameters to help customize the response.

AnforderungsheaderRequest headers

NameName TypType BeschreibungDescription
AuthorizationAuthorization stringstring Bearer {token}. Erforderlich.Bearer {token}. Required.

AnforderungstextRequest body

Geben Sie für diese Methode keinen Anforderungstext an.Do not supply a request body for this method.

AntwortResponse

Antwort für Abrufen des FotosResponse for getting the photo

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.If successful, this method returns a 200 OK response code and binary data of the requested photo. If no photo exists, the operation returns 404 Not Found.

Antwort für Abrufen der Metadaten des FotosResponse for getting the metadata of the photo

Wenn die Methode erfolgreich verläuft, werden der Antwortcode 200 OK und ein profilePhoto-Objekt im Antworttext zurückgegeben.If successful, this method returns a 200 OK response code and a profilePhoto object in the response body.

BeispieleExamples

Beispiel 1: Abrufen des Fotos des angemeldeten Benutzers in der größten verfügbaren GrößeExample 1: Get the photo of the signed-in user in the largest available size

AnforderungRequest
GET https://graph.microsoft.com/beta/me/photo/$value
Content-Type: image/jpg
AntwortResponse

Enthält die binären Daten des angeforderten Fotos.Contains the binary data of the requested photo. Der HTTP-Antwortcode ist 200.The HTTP response code is 200.

Beispiel 2: Abrufen des 48x48-Fotos für den angemeldeten BenutzerExample 2: Get the 48x48 photo for the signed-in user

AnforderungRequest
GET https://graph.microsoft.com/beta/me/photos/48x48/$value
Content-Type: image/jpg
AntwortResponse

Enthält die binären Daten des angeforderten 48x48-Fotos.Contains the binary data of the requested 48x48 photo. Der HTTP-Antwortcode ist 200.The HTTP response code is 200.

Beispiel 3: Abrufen der Metadaten des Benutzerfotos des angemeldeten BenutzersExample 3: Get the metadata of the user photo of the signed-in user

AnforderungRequest
GET https://graph.microsoft.com/beta/me/photo
AntwortResponse

Die folgenden Antwortdaten zeigen die Metadaten des Fotos.The following response data shows the photo metadata.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.Note: The response object shown here might be shortened for readability.

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#Me/photo/$entity",
    "@odata.id": "https://graph.microsoft.com/beta/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.The following response data shows the contents of a response when a photo hasn't already been uploaded for the user.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.Note: The response object shown here might be shortened for readability.

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

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

Verwenden der Binärdaten des angeforderten FotosUsing the binary data of the requested photo

Wenn Sie den /photo/$value-Endpunkt zum Abrufen der Binärdaten für ein Profilfoto verwenden, müssen Sie die Daten in eine Base-64-Zeichenfolge konvertieren, damit sie als E-Mail-Anlage hinzugefügt werden können.When you use the /photo/$value endpoint to get the binary data for a profile photo, you'll need to convert the data into a base-64 string in order to add it as an email attachment. Das folgende JavaScript-Beispiel zeigt das Erstellen eines Arrays, das Sie als Wert des Attachments-Parameters einer Outlook-Nachricht übergeben können.The following JavaScript example shows how to create an array that you can pass as the value of the Attachments parameter of an Outlook message.

  const attachments = [{
    '@odata.type': '#microsoft.graph.fileAttachment',
    ContentBytes: file.toString('base64'),
    Name: 'mypic.jpg'
  }];

Unter Microsoft Graph Connect-Beispiel für Node.js finden Sie eine Implementierung dieses Beispiels.See the Microsoft Graph Connect Sample for Node.js for an implementation of this example.

Wenn Sie das Bild auf einer Webseite anzeigen möchten, erstellen Sie ein Objekt im Arbeitsspeicher aus dem Bild, und verwenden Sie das Objekt als Quelle eines Bildelements.If you want to display the image on a web page, create an in-memory object from the image and make that object the source of an image element. Hier ist ein Beispiel in JavaScript für diesen Vorgang.Here is an example in JavaScript of this operation.

const url = window.URL || window.webkitURL;
const blobUrl = url.createObjectURL(image.data);
document.getElementById(imageElement).setAttribute("src", blobUrl);