Miniatures de liste pour un driveItem

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Récupérez une collection de ressources thumbnailSet pour une ressource driveItem .

Zéro ou plusieurs ressources ThumbnailSet peuvent représenter un élément de lecteur. Chaque élément thumbnailSet peut posséder un ou plusieurs objets thumbnail, qui sont des images représentant l’élément. Par exemple, un élément thumbnailSet peut également inclure des objets thumbnail, notamment les plus courants, y compris small, medium ou large.

Il existe de nombreuses façons d’utiliser des miniatures sur OneDrive. Voici les plus courantes :

Énumérer les miniatures disponibles pour un élément
Récupérer une seule miniature pour un élément
Extraire le contenu des miniatures
Récupérer les miniatures de plusieurs éléments dans une seule requête
Récupérer des tailles de miniatures personnalisées
Charger la miniature personnalisée d’un élément
Déterminer s’il existe une miniature chargée personnalisée

Cette API est disponible dans les déploiements cloud nationaux suivants.

Service global	Gouvernement américain L4	Gouvernement américain L5 (DOD)	Chine exploitée par 21Vianet
✅	✅	✅	✅

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme étant les moins privilégiées pour cette API. Utilisez une ou plusieurs autorisations privilégiées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, voir Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez la référence des autorisations.

Type d’autorisation	Autorisations les moins privilégiées	Autorisations à privilèges plus élevés
Déléguée (compte professionnel ou scolaire)	Files.Read	Files. Read.All, Files. ReadWrite, Files. ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Déléguée (compte Microsoft personnel)	Files.Read	Files. Read.All, Files. ReadWrite, Files. ReadWrite.All
Application	Files.Read.All	Files. ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

Remarque

SharePoint Embedded nécessite l’autorisation FileStorageContainer.Selected pour accéder au contenu du conteneur. Cette autorisation est différente de celles mentionnées précédemment. Outre les autorisations Microsoft Graph, votre application doit disposer des autorisations de type conteneur nécessaires pour appeler cette API. Pour plus d’informations, consultez Authentification et autorisation SharePoint Embedded.

Requête HTTP

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

Paramètres facultatifs de la requête

Cette méthode prend en charge le paramètre de $selectrequête OData pour personnaliser la réponse.

En outre, cette méthode prend en charge la récupération de la miniature avec la valeur EXIF d’orientation d’origine et sans la rotation appliquée en ajoutant le paramètre de originalOrientation=true requête. Il n’est actuellement pris en charge que sur OneDrive Personnel.

Réponse

En cas de réussite, cette méthode renvoie un code de réponse 200 OK et une collection d’objets ThumbnailSet dans le corps de la réponse.

Exemple

L’exemple suivant montre une demande qui récupère les miniatures disponibles pour un élément dans le OneDrive de l’utilisateur actuel.

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


// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Drives["{drive-id}"].Items["{driveItem-id}"].Thumbnails.GetAsync();

Importante

Microsoft Graph SDK utilisent la version v1.0 de l’API par défaut et ne prennent pas en charge tous les types, propriétés et API disponibles dans la version bêta. Pour plus d’informations sur l’accès à l’API bêta avec le SDK, consultez Utiliser les kits de développement logiciel (SDK) Microsoft Graph avec l’API bêta.

Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).



// Code snippets are only available for the latest major version. Current major version is $v0.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
	  //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
thumbnails, err := graphClient.Drives().ByDriveId("drive-id").Items().ByDriveItemId("driveItem-id").Thumbnails().Get(context.Background(), nil)

Importante


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

ThumbnailSetCollectionResponse result = graphClient.drives().byDriveId("{drive-id}").items().byDriveItemId("{driveItem-id}").thumbnails().get();

Importante


const options = {
	authProvider,
};

const client = Client.init(options);

let thumbnails = await client.api('/me/drive/items/{item-id}/thumbnails')
	.version('beta')
	.get();

Importante


<?php
use Microsoft\Graph\Beta\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$result = $graphServiceClient->drives()->byDriveId('drive-id')->items()->byDriveItemId('driveItem-id')->thumbnails()->get()->wait();

Importante


Import-Module Microsoft.Graph.Beta.Files

Get-MgBetaDriveItemThumbnail -DriveId $driveId -DriveItemId $driveItemId

Importante


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

result = await graph_client.drives.by_drive_id('drive-id').items.by_drive_item_id('driveItem-id').thumbnails.get()

Importante

Elle renvoie un tableau des jeux de miniatures disponibles pour l’élément. Tous les éléments d’un lecteur peuvent avoir zéro, une ou plusieurs miniature(s).

Remarque : vous pouvez utiliser le paramètre de chaîne de requête select pour contrôler la taille des miniatures renvoyées dans l’objet ThumbnailSet. Par exemple, /thumbnails?select=medium récupère uniquement les miniatures de taille moyenne.

Réponse

L’exemple suivant illustre la réponse.

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..."}
    }
  ]
}

Récupérer une seule miniature

Vous pouvez récupérer les métadonnées d’une seule miniature et la taille en envoyant une demande.

Requête HTTP

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

Snippet not available

Importante

Snippet not available

Importante

Snippet not available

Importante


const options = {
	authProvider,
};

const client = Client.init(options);

let response = await client.api('/me/drive/items/{item-id}/thumbnails/{thumb-id}/{size}')
	.version('beta')
	.get();

Importante

Snippet not available

Importante

Snippet not available

Importante

Snippet not available

Importante

Paramètres du chemin d’accès

Nom	Type	Description
item-id	chaîne	Identificateur unique de l’élément référencé.
thumb-id	number	Index de la miniature, généralement 0-4. S’il existe une miniature personnalisée, son index est 0.
size	chaîne	Taille de la miniature demandée. Il peut s’agir d’une des tailles standard répertoriées ci-dessous ou d’une taille personnalisée.

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

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

Récupérer le contenu binaire d’une miniature

Vous pouvez récupérer directement le contenu de la miniature en demandant la propriété content de la miniature.

Requête HTTP

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

Snippet not available

Importante

Snippet not available

Importante

Snippet not available

Importante


const options = {
	authProvider,
};

const client = Client.init(options);

let content = await client.api('/me/drive/items/{item-id}/thumbnails/{thumb-id}/{size}/content')
	.version('beta')
	.get();

Importante

Snippet not available

Importante

Snippet not available

Importante

Snippet not available

Importante

Réponse

Le service répond avec une redirection vers l’URL de la miniature.

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

Les URL des miniatures sont des URL de cache sécurisées. L’URL change si l’élément change d’une manière qui nécessite la génération d’une nouvelle miniature.

Obtention de miniatures lors de la liste de driveItems

Si vous récupérez une liste de ressources driveItem à afficher, vous pouvez utiliser le paramètre de chaîne de requête $expand pour inclure également les miniatures de ces ressources. Cela permet à votre application de récupérer des miniatures et des éléments en une seule requête, au lieu d’émettre de nombreuses requêtes.

Requête HTTP

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


// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Drives["{drive-id}"].Items["{driveItem-id}"].Children.GetAsync((requestConfiguration) =>
{
	requestConfiguration.QueryParameters.Expand = new string []{ "thumbnails" };
});

Importante



// Code snippets are only available for the latest major version. Current major version is $v0.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
	  graphdrives "github.com/microsoftgraph/msgraph-beta-sdk-go/drives"
	  //other-imports
)

requestParameters := &graphdrives.ItemItemsItemChildrenRequestBuilderGetQueryParameters{
	Expand: [] string {"thumbnails"},
}
configuration := &graphdrives.ItemItemsItemChildrenRequestBuilderGetRequestConfiguration{
	QueryParameters: requestParameters,
}

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
children, err := graphClient.Drives().ByDriveId("drive-id").Items().ByDriveItemId("driveItem-id").Children().Get(context.Background(), configuration)

Importante


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

DriveItemCollectionResponse result = graphClient.drives().byDriveId("{drive-id}").items().byDriveItemId("{driveItem-id}").children().get(requestConfiguration -> {
	requestConfiguration.queryParameters.expand = new String []{"thumbnails"};
});

Importante


const options = {
	authProvider,
};

const client = Client.init(options);

let children = await client.api('/me/drive/items/{item-id}/children')
	.version('beta')
	.expand('thumbnails')
	.get();

Importante


<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Drives\Item\Items\Item\Children\ChildrenRequestBuilderGetRequestConfiguration;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestConfiguration = new ChildrenRequestBuilderGetRequestConfiguration();
$queryParameters = ChildrenRequestBuilderGetRequestConfiguration::createQueryParameters();
$queryParameters->expand = ["thumbnails"];
$requestConfiguration->queryParameters = $queryParameters;


$result = $graphServiceClient->drives()->byDriveId('drive-id')->items()->byDriveItemId('driveItem-id')->children()->get($requestConfiguration)->wait();

Importante


Import-Module Microsoft.Graph.Beta.Files

Get-MgBetaDriveItemChild -DriveId $driveId -DriveItemId $driveItemId -ExpandProperty "thumbnails"

Importante


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.drives.item.items.item.children.children_request_builder import ChildrenRequestBuilder
from kiota_abstractions.base_request_configuration import RequestConfiguration
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
query_params = ChildrenRequestBuilder.ChildrenRequestBuilderGetQueryParameters(
		expand = ["thumbnails"],
)

request_configuration = RequestConfiguration(
query_parameters = query_params,
)

result = await graph_client.drives.by_drive_id('drive-id').items.by_drive_item_id('driveItem-id').children.get(request_configuration = request_configuration)

Importante

Réponse

Voici les réponses du service avec la liste des ressources DriveItem et leurs miniatures.

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..."
                   }
        }
      ]
    }
  ]
}

Valeurs de taille

Ce tableau définit les tailles de miniatures possibles. Bien que vous puissiez demander une taille de miniature arbitraire, les valeurs définies sont plus susceptibles d’exister réellement de renvoyer rapidement une valeur :

Nom	Solution	Proportions	Description
`small`	96 plus long	Original	Miniature de petite taille, fortement compressée, rognée à des proportions carrées.
`medium`	176 plus long	Original	Rognée à la taille d’élément standard pour l’affichage web OneDrive.
`large`	800 plus long	Original	Miniature dont le bord le plus long est redimensionné à 800 pixels.
`smallSquare`	96x96	Rognage carré	Petite miniature carrée
`mediumSquare`	176x176	Rognage carré	Petite miniature carrée
`largeSquare`	800x800	Rognage carré	Grande miniature carrée

Demande des tailles de miniatures personnalisées

En plus des tailles définies, votre application peut demander une taille de miniature personnalisée en spécifiant ses dimensions, précédées de c. Par exemple, si votre application a besoin de miniatures au format 300 x 400, vous pouvez demander cette taille de la manière suivante :

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


// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Drives["{drive-id}"].Items["{driveItem-id}"].Thumbnails.GetAsync((requestConfiguration) =>
{
	requestConfiguration.QueryParameters.Select = new string []{ "c300x400_crop" };
});

Importante



// Code snippets are only available for the latest major version. Current major version is $v0.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
	  graphdrives "github.com/microsoftgraph/msgraph-beta-sdk-go/drives"
	  //other-imports
)

requestParameters := &graphdrives.ItemItemsItemThumbnailsRequestBuilderGetQueryParameters{
	Select: [] string {"c300x400_crop"},
}
configuration := &graphdrives.ItemItemsItemThumbnailsRequestBuilderGetRequestConfiguration{
	QueryParameters: requestParameters,
}

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
thumbnails, err := graphClient.Drives().ByDriveId("drive-id").Items().ByDriveItemId("driveItem-id").Thumbnails().Get(context.Background(), configuration)

Importante


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

ThumbnailSetCollectionResponse result = graphClient.drives().byDriveId("{drive-id}").items().byDriveItemId("{driveItem-id}").thumbnails().get(requestConfiguration -> {
	requestConfiguration.queryParameters.select = new String []{"c300x400_crop"};
});

Importante


const options = {
	authProvider,
};

const client = Client.init(options);

let thumbnails = await client.api('/me/drive/items/{item-id}/thumbnails?select=c300x400_crop')
	.version('beta')
	.get();

Importante


<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Drives\Item\Items\Item\Thumbnails\ThumbnailsRequestBuilderGetRequestConfiguration;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestConfiguration = new ThumbnailsRequestBuilderGetRequestConfiguration();
$queryParameters = ThumbnailsRequestBuilderGetRequestConfiguration::createQueryParameters();
$queryParameters->select = ["c300x400_crop"];
$requestConfiguration->queryParameters = $queryParameters;


$result = $graphServiceClient->drives()->byDriveId('drive-id')->items()->byDriveItemId('driveItem-id')->thumbnails()->get($requestConfiguration)->wait();

Importante


Import-Module Microsoft.Graph.Beta.Files

Get-MgBetaDriveItemThumbnail -DriveId $driveId -DriveItemId $driveItemId -Property "c300x400_crop"

Importante


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.drives.item.items.item.thumbnails.thumbnails_request_builder import ThumbnailsRequestBuilder
from kiota_abstractions.base_request_configuration import RequestConfiguration
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
query_params = ThumbnailsRequestBuilder.ThumbnailsRequestBuilderGetQueryParameters(
		select = ["c300x400_crop"],
)

request_configuration = RequestConfiguration(
query_parameters = query_params,
)

result = await graph_client.drives.by_drive_id('drive-id').items.by_drive_item_id('driveItem-id').thumbnails.get(request_configuration = request_configuration)

Importante

Qui répond avec la taille de miniature personnalisée sélectionné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"},
    }
  ]
}

Vous pouvez spécifier les options suivantes après la taille de miniature demandée :

Exemples d’identificateurs personnalisés

Identificateur de miniature	Résolution	Proportions	Description
c300x400	Délimité par une zone de 300 x 400	Original	Générer une miniature qui s’adapte à l’intérieur d’une zone de 300 x 400 pixels, en conservant les proportions
c300x400_crop	300x400	Rognée	Générer une miniature de 300 x 400 pixels. Il fonctionne en redimensionnant l’image pour remplir la zone 300x400 et en rognant tout ce qui se répand à l’extérieur de la boîte.

Remarque : La miniature renvoyée peut ne pas correspondre exactement aux dimensions de pixels demandées, mais elle correspond aux proportions. Dans certains cas, une plus grande miniature peut être renvoyée si la miniature existe déjà et peut être facilement adaptée pour obtenir la résolution demandée.

Remarques

Remarque : dans OneDrive Entreprise et SharePoint :

L’utilisation de ces appels pour développer la collection de miniatures ne fonctionne pas :

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

Les miniatures ne sont pas prises en charge sur SharePoint Server 2016.

Réponses d’erreur

Pour plus d’informations sur la façon dont les erreurs sont renvoyées, consultez Réponses d’erreur .

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2025-07-24

Miniatures de liste pour un driveItem

Autorisations

Requête HTTP

Paramètres facultatifs de la requête

Réponse

Exemple

Réponse

Récupérer une seule miniature

Requête HTTP

Paramètres du chemin d’accès

Récupérer le contenu binaire d’une miniature

Requête HTTP

Réponse

Obtention de miniatures lors de la liste de driveItems

Requête HTTP

Réponse

Valeurs de taille

Demande des tailles de miniatures personnalisées

Exemples d’identificateurs personnalisés

Remarques

Réponses d’erreur

Commentaires

Ressources supplémentaires