Miniaturansichten für ein DriveItem auflisten

Hier erklären wir Ihnen, wie Sie eine Liste der ThumbnailSet-Ressourcen einer DriveItem-Ressource abrufen können.

Ein DriveItem kann durch 0 oder mehr ThumbnailSet-Ressourcen repräsentiert werden. Jedes thumbnailSet kann ein oder mehrere thumbnail-Objekte haben. Dabei handelt es sich um Bilder, die das jeweilige Element darstellen. Beispielsweise könnte ein thumbnailSet gängige thumbnail-Objekte wie small, medium oder large enthalten.

Es gibt viele Möglichkeiten, auf OneDrive mit Miniaturansichten zu arbeiten. Die häufigsten:

  • Enumerieren der für ein Element verfügbaren Miniaturansichten
  • Abrufen einer einzelnen Miniaturansicht für ein Element
  • Abrufen von Miniaturansichtinhalten
  • Abrufen von Miniaturansichten für mehrere Elemente in einer einzigen Anforderung
  • Abrufen von benutzerdefinierten Miniaturansichtgrößen
  • Hochladen einer benutzerdefinierten Miniaturansicht für ein Element
  • Ermitteln, ob eine benutzerdefinierte Miniaturansicht hochgeladen wurde

Voraussetzungen

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

  • Files.Read
  • Files.ReadWrite

HTTP-Anforderung

GET /me/drive/root:/{item-path}:/thumbnails
GET /me/drive/items/{item-id}/thumbnails
GET /groups/{group-id}/drive/items/{item-id}/thumbnails

Optionale Abfrageparameter

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

Anforderungstext

Geben Sie für diese Methode keinen Anforderungstext an.

Antwort

Bei Erfolg gibt diese Methode einen Antwortcode des Typs 200 OK und eine Sammlung von ThumbnailSet-Objekten im Antworttext zurück.

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

GET https://graph.microsoft.com/v1.0/me/drive/items/{item-id}/thumbnails
Antwort

Nachfolgend sehen Sie ein Beispiel der Antwort.

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

{
  "value": [
    {
      "id": "0",
      "small": { "height": 64, "width": 96, "url": "https://sn3302files..."},
      "medium": { "height": 117, "width": 176, "url": "https://sn3302files..."},
      "large": { "height": 533, "width": 800, "url": "https://sn3302files..."}
    }
  ]
}

Abrufen einer einzelnen Miniaturansicht

Sie können die Metadaten einer einzelnen Miniaturansicht sowie ihre Größe abrufen, indem Sie sie in einer Anforderung direkt adressieren.

HTTP-Anforderung

GET https://graph.microsoft.com/v1.0/me/drive/items/{item-id}/thumbnails/{thumb-id}/{size}

Pfadparameter

Name Typ Beschreibung
item-id string Der eindeutige Bezeichner für das referenzierte Element
thumb-id number Der Index der Miniaturansicht, in der Regel 0 bis 4
size string Die Größe der angeforderten Miniaturansicht. Dabei muss es sich um eine der aufgeführten Standardgrößen handeln.
HTTP/1.1 200 OK
Content-Type: application/json

{
  "width": 100,
  "height": 100,
  "url": "http://onedrive.com/asd123a/asdjlkasjdkasdjlk.jpg"
}

Abrufen von Miniaturansichtinhalten

Sie können den Inhalt einer Miniaturansicht direkt abrufen, indem Sie die Eigenschaft content der Miniaturansicht anfordern.

HTTP-Anforderung

GET https://graph.microsoft.com/v1.0/me/drive/items/{item-id}/thumbnails/{thumb-id}/{size}/content

Antwort

Der Dienst antwortet mit einer Umleitung auf die Miniaturansicht-URL.

HTTP/1.1 302 Found
Location: https://b0mpua-by3301.files.1drv.com/y23vmagahszhxzlcvhasdhasghasodfi

URLs zu Miniaturansichtinhalten sind vorab authentifiziert. Der Download eines Autorisierungsheaders ist nicht erforderlich. Diese URLs sind kurzlebig und nur für wenige Stunden gültig. Sie sollten nicht von Apps zwischengespeichert werden.

Größenwerte

In dieser Tabelle sind die möglichen Miniaturansichtgrößen definiert. Zwar können Sie jede beliebige Miniaturansichtgröße anfordern; bei den definierten Werten ist es jedoch wahrscheinlich, dass sie existieren und dass schnell ein Wert zurückgegeben wird:

Name Auflösung Seitenverhältnis Beschreibung
small 96 longest    
Original Kleine, stark komprimierte Miniaturansicht, zugeschnitten auf ein quadratisches Seitenverhältnis    
medium 176 longest Original Zugeschnitten auf die standardmäßige Elementgröße für die OneDrive-Webansicht
large 800 longest    
Original Miniaturansicht, bei der die längste Kante auf 800 Pixel skaliert wurde    

Bemerkungen

Hinweis: Für OneDrive for Business und SharePoint gilt:

  • Die folgenden Aufrufe können nicht zur Erweiterung der Miniaturansichtsammlung verwendet werden: GET /drive/root:/{item-path}?expand=children(expand=thumbnails) GET /drive/items/{item-id}/children?expand=thumbnails