Miniaturansichten für ein DriveItem auflistenList thumbnails for a DriveItem

Hier erklären wir Ihnen, wie Sie eine Liste der ThumbnailSet-Ressourcen einer DriveItem-Ressource abrufen können.Retrieve a collection of ThumbnailSet resources for a DriveItem resource.

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.A DriveItem can be represented by zero or more ThumbnailSet resources. Each thumbnailSet can have one or more thumbnail objects, which are images that represent the item. For example, a thumbnailSet may include thumbnail objects, such as common ones including small, medium, or large.

Es gibt viele Möglichkeiten, auf OneDrive mit Miniaturansichten zu arbeiten. Die häufigsten:There are many ways to work with thumbnails on OneDrive. Here are the most common ones:

  • Enumerieren der für ein Element verfügbaren MiniaturansichtenEnumerate available thumbnails for an item
  • Abrufen einer einzelnen Miniaturansicht für ein ElementRetrieve a single thumbnail for an item
  • Abrufen von MiniaturansichtinhaltenRetrieve thumbnail content
  • Abrufen von Miniaturansichten für mehrere Elemente in einer einzigen AnforderungRetrieve thumbnails for multiple items in a single request
  • Abrufen von benutzerdefinierten MiniaturansichtgrößenRetrieve custom thumbnail sizes
  • Hochladen einer benutzerdefinierten Miniaturansicht für ein ElementUpload a custom thumbnail for an item
  • Ermitteln, ob eine benutzerdefinierte Miniaturansicht hochgeladen wurdeDetermine if a custom uploaded thumbnail exists

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.

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) Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.AllFiles.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.AllFiles.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All
AnwendungApplication Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.AllFiles.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

HTTP-AnforderungHTTP request

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 AbfrageparameterOptional query parameters

Diese Methode unterstützt die $select OData-Abfrageparameter zur Anpassung der Antwort.This method supports the $select OData puery parameter to customize the response.

AntwortResponse

Bei Erfolg gibt diese Methode einen Antwortcode des Typs 200 OK und eine Sammlung von ThumbnailSet-Objekten im Antworttext zurück.If successful, this method returns a 200 OK response code and collection of ThumbnailSet objects in the response body.

BeispielExample

Hier ist ein Beispiel für die Anforderung, die verfügbare Miniaturansichten für ein Element im OneDrive des aktuellen Benutzers abruft.Here is an example of the request which retrieves available thumbnails for an item in the current user's OneDrive.

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

Diese gibt ein Array von verfügbaren thumbnailSets für das Element zurück.This returns an array of available thumbnailSets for the item. Ein beliebiges Element auf einem Laufwerk kann Null oder mehr Miniaturansichten aufweisen.Any item in a drive can have zero or more thumbnails.

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.Note: You can use the select query string parameter to control which thumbnail sizes are returned in the ThumbnailSet. For example, /thumbnails?select=medium retrieves only the medium sized thumbnails.

AntwortResponse

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 MiniaturansichtGet a single thumbnail

Sie können die Metadaten einer einzelnen Miniaturansicht sowie ihre Größe abrufen, indem Sie sie in einer Anforderung direkt adressieren.Retrieve the metadata for a single thumbnail and size by addressing it directly in a request.

HTTP-AnforderungHTTP request

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

PfadparameterPath parameters

NameName TypType BeschreibungDescription
item-iditem-id stringstring Der eindeutige Bezeichner für das referenzierte ElementThe unique identifier for the item referenced.
thumb-idthumb-id numbernumber Der Index der Miniaturansicht, in der Regel 0 bis 4. Wenn es eine benutzerdefinierte Miniaturansicht gibt, ist ihr Index 0.The index of the thumbnail, usually 0-4. If there is a custom thumbnail, its index is 0.
sizesize stringstring Die Größe der angeforderten Miniaturansicht.The size of the thumbnail requested. Dabei kann es sich um eine der nachfolgend aufgeführten Standardgrößen oder um eine benutzerdefinierte Größe handeln.This can be one of the standard sizes listed below or a custom size.
HTTP/1.1 200 OK
Content-Type: application/json

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

Abrufen von binären MiniaturansichtinhaltenRetrieve thumbnail binary content

Sie können den Inhalt einer Miniaturansicht direkt abrufen, indem Sie die Eigenschaft content der Miniaturansicht anfordern.You can directly retrieve the content of the thumbnail by requesting the content property of the thumbnail.

HTTP-AnforderungHTTP request

GET /me/drive/items/{item-id}/thumbnails/{thumb-id}/{size}/content

AntwortResponse

Der Dienst antwortet mit einer Umleitung auf die Miniaturansicht-URL.The service responds with a redirect to the thumbnail URL.

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

Miniaturansicht-URLs sind cachesicher.Thumbnail URLs are cache-safe. Die URL ändert sich, wenn sich das Element derart ändert, dass eine neue Miniaturansicht generiert werden muss.The URL will change, if the item changes in a way that requires a new thumbnail to be generated.

Abrufen von Miniaturansichten beim Auflisten von DriveItemsGetting thumbnails while listing 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.If you are retrieving a list of DriveItem resources to display, you can use the $expand query string parameter to also include the thumbnails for those resources. Dadurch kann Ihre App Miniaturansichten und Elemente in einer einzelnen Anforderung abrufen, statt viele Anforderungen auszuführen.This enables your app to retrieve thumbnails and items in a single request, instead of issuing many requests.

HTTP-AnforderungHTTP request

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

AntwortResponse

Die Dienstantworten mit der Liste der DriveItems und ihren Miniaturansichten.The service responses with the list of DriveItems and their thumbnails.

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ößenoptionenSize options

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:This table defines the possible thumbnail sizes. While you can request any arbitrary thumbnail size, the defined values are likely to exist and return a value quickly:

NameName AuflösungResolution SeitenverhältnisAspect Ratio BeschreibungDescription
small 96 longest
96 longest OriginalOriginal Kleine, stark komprimierte Miniaturansicht, zugeschnitten auf ein quadratisches SeitenverhältnisSmall, highly compressed thumbnail cropped to a square aspect ratio.
medium 176 longest176 longest OriginalOriginal Zugeschnitten auf die standardmäßige Elementgröße für die OneDrive-WebansichtCropped to the standard item size for the OneDrive web view.
large 800 longest
800 longest OriginalOriginal Miniaturansicht, bei der die längste Kante auf 800 Pixel skaliert wurdeThumbnail with the longest edge resized to 800 pixels.
smallSquare 96x9696x96 Quadratisches ZuschneidenSquare Crop Kleines Quadrat (Miniaturansicht)Small square thumbnail
mediumSquare 176x176176x176 Quadratisches ZuschneidenSquare Crop Kleines Quadrat (Miniaturansicht)Small square thumbnail
largeSquare 800x800800x800 Quadratisches ZuschneidenSquare Crop Großes Quadrat (Miniaturansicht)Large square thumbnail

Anfordern von benutzerdefinierten MiniaturansichtgrößenRequesting custom thumbnail sizes

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.In addition to the defined sizes, your app can request a custom thumbnail size by specifying the dimensions of the thumbnail prefixed with c. 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:For example if your app needs thumbnails that are 300x400, it can request that size like this:

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

Die Antwort ist die benutzerdefinierte Miniaturansichtsgröße:Which responds with just the custom thumbnail size selected:

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:You can specify the following options after the size of the thumbnail requested:

Beispiele für benutzerdefinierte BezeichnerExamples of custom identifiers

Miniaturansicht-IDThumbnail identifier AuflösungResolution SeitenverhältnisAspect ratio BeschreibungDescription
c300x400c300x400 Begrenzt durch 300 x 400-FeldBounded by 300x400 box OriginalOriginal Generiert eine Miniaturansicht, die in ein Feld von 300 x 400 Pixel passt; dabei wird das Seitenverhältnis beibehaltenGenerate a thumbnail that fits inside a 300x400 pixel box, maintaining aspect ratio
c300x400_Cropc300x400_Crop 300x400300x400 ZugeschnittenCropped 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.Generate a thumbnail that is 300x400 pixels. This works by resizing the image to fill the 300x400 box and cropping whatever spills outside the box.

Hinweis: Die zurückgegebenen Miniaturansicht stimmt möglicherweise nicht exakt mit den angeforderten Pixel-Abmessungen überein, , das Seitenverhältnis stimmt jedoch.Note: The thumbnail returned may not exactly match the pixel dimensions that was requested, but will match the aspect ratio. 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.In some cases, a larger thumbnail may be returned than was requested, if the thumbnail already exists and can easily be scaled to match the requested resolution.

HinweiseRemarks

Hinweis: Für OneDrive for Business und SharePoint gilt:Note In OneDrive for Business and SharePoint:

Die folgenden Aufrufe können nicht zur Erweiterung der Miniaturansichtsammlung verwendet werden:Using these calls to expand the thumbnails collection will not work:

  • 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.Thumbnails are not supported on SharePoint Server 2016.

FehlerantwortenError responses

Weitere Informationen dazu, wie Fehler zurückgegeben werden, finden Sie unter Fehlerantworten.See Error Responses for more info about how errors are returned.