Auflisten von Miniaturansichten für ein driveItem-Objekt

  • Artikel

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Abrufen einer Auflistung von thumbnailSet-Ressourcen für eine driveItem-Ressource .

Null oder mehr thumbnailSet-Ressourcen können ein driveItem darstellen. 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, mit Miniaturansichten auf OneDrive 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

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Globaler Dienst US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet
✅ ✅ ✅ ✅

Berechtigungen

Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) Files.Read Files.Read.All, Files.ReadWrite, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Delegiert (persönliches Microsoft-Konto) Files.Read Files.Read.All, Files.ReadWrite, Files.ReadWrite.All
App 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.

Darüber hinaus unterstützt diese Methode das Abrufen der Miniaturansicht mit dem exif-Wert der ursprünglichen Ausrichtung und ohne die angewendete Drehung durch Anfügen des originalOrientation=true Abfrageparameters. Dies wird derzeit nur auf OneDrive Personal unterstützt.

Antwort

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

Beispiel

Das folgende Beispiel zeigt eine Anforderung, die verfügbare Miniaturansichten für ein Element im OneDrive des aktuellen Benutzers abruft.

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

Es wird ein Array verfügbarer thumbnailSets für das Element zurückgegeben. 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

Das folgende Beispiel zeigt die 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 eine benutzerdefinierte Miniaturansicht vorhanden ist, ist der Index 0.
size string Die Größe der angeforderten Miniaturansicht. Dies kann eine der unten aufgeführten Standardgrößen oder eine benutzerdefinierte Größe sein. 
HTTP/1.1 200 OK
Content-Type: application/json

{
  "width": 100,
  "height": 100,
  "url": "https://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 so ä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 den parameter $expand Abfragezeichenfolge verwenden, um auch die Miniaturansichten für diese Ressourcen einzuschließen. Dadurch kann Ihre App Miniaturansichten und Elemente in einer einzelnen Anforderung abrufen, anstatt viele Anforderungen auszugeben.

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öß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
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. Es funktioniert, indem die Größe des Bilds geändert wird, um das 300 x 400-Feld auszufüllen, und alles zuschneiden, was außerhalb des Kastens verschüttet wird.

Hinweis: Die zurückgegebene Miniaturansicht stimmt möglicherweise nicht genau mit den angeforderten Pixelabmessungen überein, stimmt aber mit dem Seitenverhältnis überein. 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 Verwendung dieser Aufrufe zum Erweitern der Miniaturansichtensammlung funktioniert nicht:

  • GET /drive/root:/{item-path}?expand=children(expand=thumbnails)
  • GET /drive/items/{item-id}/children?expand=thumbnails

Miniaturansichten werden in SharePoint Server 2016 nicht unterstützt.

Fehlerantworten

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