Miniaturansichten für ein DriveItem auflisten

Artikel
04/08/2023

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

Ein DriveItem kann durch null oder mehr ThumbnailSet-Ressourcen dargestellt werden. Jedes thumbnailSet kann ein oder mehrere Miniaturansichtsobjekte aufweisen. Dabei handelt es sich um Bilder, die das Element darstellen. Beispielsweise kann ein thumbnailSetMiniaturansichtsobjekte enthalten, z. B. gängige Objekte wie small, mediumoder large.

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

Berechtigungen

Eine der folgenden Berechtigungen ist erforderlich, um diese API aufzurufen. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.

Berechtigungstyp	Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto)	Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)	Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All
Anwendung	Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

HTTP-Anforderung

GET /drives/{drive-id}/items/{item-id}/thumbnails
GET /groups/{group-id}/drive/items/{item-id}/thumbnails
GET /me/drive/items/{item-id}/thumbnails
GET /sites/{site-id}/drive/items/{item-id}/thumbnails
GET /users/{user-id}/drive/items/{item-id}/thumbnails

Optionale Abfrageparameter

Diese Methode unterstützt den $selectOData-Abfrageparameter , um die Antwort anzupassen.

Antwort

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

Beispiel

Hier ist ein Beispiel für die Anforderung, die verfügbare Miniaturansichten für ein Element im OneDrive des aktuellen Benutzers abruft.

GET /me/drive/items/{item-id}/thumbnails

Diese gibt ein Array von verfügbaren thumbnailSets für das Element zurück. Ein beliebiges Element auf einem Laufwerk kann Null oder mehr Miniaturansichten aufweisen.

Hinweis: Sie können den select-Abfragezeichenfolgenparameter verwenden, um zu steuern, welche Miniaturansichtgrößen im ThumbnailSet zurückgegeben werden. /thumbnails?select=medium ruft beispielsweise nur die mittelgroßen Miniaturansichten ab.

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 /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. Wenn es eine benutzerdefinierte Miniaturansicht gibt, ist ihr Index 0.
size	string	Die Größe der angeforderten Miniaturansicht. Dabei kann es sich um eine der nachfolgend aufgeführten Standardgrößen oder um eine benutzerdefinierte Größe handeln.

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

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

Abrufen von binären Miniaturansichtinhalten

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

HTTP-Anforderung

GET /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

Miniaturansicht-URLs sind cachesicher. Die URL ändert sich, wenn sich das Element derart ändert, dass eine neue Miniaturansicht generiert werden muss.

Abrufen von Miniaturansichten beim Auflisten von DriveItems

Wenn Sie eine Liste der anzuzeigenden DriveItem-Ressourcen abrufen, können Sie mit dem $expand-Abfragezeichenfolge-Parameter außerdem die Miniaturansichten für diese Ressourcen aufnehmen. Dadurch kann Ihre App Miniaturansichten und Elemente in einer einzelnen Anforderung abrufen, statt viele Anforderungen auszuführen.

HTTP-Anforderung

GET /me/drive/items/{item-id}/children?$expand=thumbnails

Antwort

Die Dienstantworten mit der Liste der DriveItems und ihren Miniaturansichten.

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

{
  "value": [
    {
      "id": "182331E8-2788-4932-B52A-A6550577043F",
      "name": "my photo.jpg",
      "thumbnails": [
        {
          "small": { "width": 96,
                     "height": 96,
                     "url": "https://sn3302files..."
                   }
        }
      ]
    },
    {
      "id": "2D223953-A56B-4D9B-ADF3-13E7820673A2",
      "name": "presentation.pptx",
      "thumbnails": [
        {
          "small": { "width": 96,
                     "height": 96,
                     "url": "https://sn3302files..."
                   }
        }
      ]
    }
  ]
}

Größenoptionen

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
`smallSquare`	96x96	Quadratisches Zuschneiden	Kleines Quadrat (Miniaturansicht)
`mediumSquare`	176x176	Quadratisches Zuschneiden	Kleines Quadrat (Miniaturansicht)
`largeSquare`	800x800	Quadratisches Zuschneiden	Großes Quadrat (Miniaturansicht)

Anfordern von benutzerdefinierten Miniaturansichtgrößen

Zusätzlich zu den definierten Größen kann Ihre App eine benutzerdefinierte Miniaturansichtsgröße anfordern, indem die Dimensionen der Miniaturansicht mit dem Präfix c angegeben werden. Wenn Ihre App zum Beispiel Miniaturansichten mit einer Größe von 300 x 400 benötigt, können Sie diese Größe wie folgt anfordern:

GET /me/drive/items/{item-id}/thumbnails?select=c300x400_Crop

Die Antwort ist die benutzerdefinierte Miniaturansichtsgröße:

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

{
  "value": [
    {
      "id": "0",
      "c300x400_Crop": { "height": 300, "width": 400, "url": "https://sn3302files.onedrive.com/123"},
    }
  ]
}

Sie können die folgenden Optionen nach der Größe der angeforderten Miniaturansicht angeben:

Beispiele für benutzerdefinierte Bezeichner

Miniaturansicht-ID	Auflösung	Seitenverhältnis	Beschreibung
c300x400	Begrenzt durch 300 x 400-Feld	Original	Generiert eine Miniaturansicht, die in ein Feld von 300 x 400 Pixel passt; dabei wird das Seitenverhältnis beibehalten
c300x400_Crop	300x400	Zugeschnitten	Erstellt eine Miniaturansicht mit 300 x 400 Pixel. Dies funktioniert, indem Sie die Größe des Bilds so ändern, dass das Feld von 300 x 400 Pixel gefüllt wird, und alles zuschneiden, was über dieses Feld hinausgeht.

Hinweis: Die zurückgegebenen Miniaturansicht stimmt möglicherweise nicht exakt mit den angeforderten Pixel-Abmessungen überein, , das Seitenverhältnis stimmt jedoch. In einigen Fällen wird möglicherweise eine größere Miniaturansicht zurückgegeben als angefordert wurde, wenn die Miniaturansicht bereits vorhanden ist und einfach skaliert werden kann, damit sie der angeforderten Auflösung entspricht.

Hinweise

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

Miniaturansichten werden unter SharePoint Server 2016 nicht unterstützt.

Fehlerantworten

Weitere Informationen dazu, wie Fehler zurückgegeben werden, finden Sie unter Fehlerantworten.

Miniaturansichten für ein DriveItem auflisten

Berechtigungen

HTTP-Anforderung

Optionale Abfrageparameter

Antwort

Beispiel

Antwort

Abrufen einer einzelnen Miniaturansicht

HTTP-Anforderung

Pfadparameter

Abrufen von binären Miniaturansichtinhalten

HTTP-Anforderung

Antwort

Abrufen von Miniaturansichten beim Auflisten von DriveItems

HTTP-Anforderung

Antwort

Größenoptionen

Anfordern von benutzerdefinierten Miniaturansichtgrößen

Beispiele für benutzerdefinierte Bezeichner

Hinweise

Fehlerantworten

Zusätzliche Ressourcen