Obtenir documentSetVersion

Cette page est-elle utile ?

D'autres commentaires ?

Les commentaires seront envoyés à Microsoft : en appuyant sur le bouton envoyer, vos commentaires seront utilisés pour améliorer les produits et services Microsoft. Politique de confidentialité.

Espace de noms: microsoft.graph

Important

Les API sous /beta la version dans Microsoft Graph sont sujettes à modification. 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 la version 1.0, utilisez le sélecteur de version.

Lisez les propriétés et les relations d’un objet documentSetVersion .

Autorisations

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation	Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire)	Sites.Read.All, Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All
Déléguée (compte Microsoft personnel)	Non prise en charge.
Application	Sites.Read.All, Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All, Sites.Selected

Requête HTTP

GET /sites/{siteId}/lists/{listId}/items/{itemId}/documentSetVersions/{documentSetVersionId}

Paramètres facultatifs de la requête

Cette méthode prend en charge les paramètres de requête OData pour vous aider à personnaliser la réponse. Pour des informations générales, consultez paramètres de la requête OData.

En-têtes de demande

Nom	Description
Autorisation	Porteur {token}. Obligatoire.

Corps de la demande

N’indiquez pas le corps de la demande pour cette méthode.

Réponse

Si elle réussit, cette méthode renvoie un 200 OK code de réponse et un objet documentSetVersion dans le corps de la réponse.

Exemples

Demande

Voici un exemple de requête.

HTTP

GET https://graph.microsoft.com/beta/sites/root/lists/Documents/items/2/documentSetVersions/1

C#

GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var documentSetVersion = await graphClient.Sites["{site-id}"].Lists["{list-id}"].Items["{listItem-id}"].DocumentSetVersions["{documentSetVersion-id}"]
    .Request()
    .GetAsync();

Important

Les SDK Microsoft Graph utilisent la version v1.0 de l’API par défaut et ne sont 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, voir Utiliser les SDK Microsoft Graph avec l’API bêta.

Lisez la documentation du SDK pour plus d’informations sur l’ajout du SDK à votre projet et la création d’une instance authProvider.

JavaScript

const options = {
    authProvider,
};

const client = Client.init(options);

let documentSetVersion = await client.api('/sites/root/lists/Documents/items/2/documentSetVersions/1')
    .version('beta')
    .get();

Important

Les SDK Microsoft Graph utilisent la version v1.0 de l’API par défaut et ne sont 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, voir Utiliser les SDK Microsoft Graph avec l’API bêta.

Lisez la documentation du SDK pour plus d’informations sur l’ajout du SDK à votre projet et la création d’une instance authProvider.

Objective-C

MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];

NSString *MSGraphBaseURL = @"https://graph.microsoft.com/beta/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/sites/root/lists/Documents/items/2/documentSetVersions/1"]]];
[urlRequest setHTTPMethod:@"GET"];

MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest 
    completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {

        MSGraphDocumentSetVersion *documentSetVersion = [[MSGraphDocumentSetVersion alloc] initWithData:data error:&nserror];

}];

[meDataTask execute];

Important

Les SDK Microsoft Graph utilisent la version v1.0 de l’API par défaut et ne sont 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, voir Utiliser les SDK Microsoft Graph avec l’API bêta.

Lisez la documentation du SDK pour plus d’informations sur l’ajout du SDK à votre projet et la création d’une instance authProvider.

Java

GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

DocumentSetVersion documentSetVersion = graphClient.sites("root").lists("Documents").items("2").documentSetVersions("1")
    .buildRequest()
    .get();

Important

Les SDK Microsoft Graph utilisent la version v1.0 de l’API par défaut et ne sont 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, voir Utiliser les SDK Microsoft Graph avec l’API bêta.

Lisez la documentation du SDK pour plus d’informations sur l’ajout du SDK à votre projet et la création d’une instance authProvider.

Activer

//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)

siteId := "site-id"
listId := "list-id"
listItemId := "listItem-id"
documentSetVersionId := "documentSetVersion-id"
result, err := graphClient.SitesById(&siteId).ListsById(&listId).ItemsById(&listItemId).DocumentSetVersionsById(&documentSetVersionId).Get()

Important

Les SDK Microsoft Graph utilisent la version v1.0 de l’API par défaut et ne sont 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, voir Utiliser les SDK Microsoft Graph avec l’API bêta.

Lisez la documentation du SDK pour plus d’informations sur l’ajout du SDK à votre projet et la création d’une instance authProvider.

Réponse

Voici un exemple de réponse.

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

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

{
    "id": "1",
    "lastModifiedDateTime": "2022-04-05T04:53:42Z",
    "comment": "v1",
    "createdDateTime": "2022-04-05T04:53:42Z",
    "shouldCaptureMinorVersion": false,
    "lastModifiedBy": {
        "user": {
            "displayName": "Tenant Admin User",
            "email": "admin@contoso.sharepoint.com"
        }
    },
    "items": [
        {
            "itemId": "a5d83ae7-8c3e-4a2c-bc3e-8f276db857bf",
            "versionId": "1.0"
        }
    ],
    "createdBy": {
        "user": {
            "displayName": "Tenant Admin User",
            "email": "admin@contoso.sharepoint.com"
        }
    }
}