Archiver les modifications apportées à une ressource DriveItem

  • Article
  • 2 minutes de lecture

Découvrez comment archiver une ressource DriveItem extraite pour mettre la version du document à la disposition d’autres utilisateurs.

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 moins de privilèges à celle qui en offre le plus)
Déléguée (compte professionnel ou scolaire) Files.ReadWrite, Files.ReadWrite.All, Sites.ReadWrite.All
Déléguée (compte Microsoft personnel) Files.ReadWrite, Files.ReadWrite.All
Application Files.ReadWrite.All, Sites.ReadWrite.All

Requête HTTP

POST /drives/{driveId}/items/{itemId}/checkin
POST /groups/{groupId}/drive/items/{itemId}/checkin
POST /me/drive/items/{item-id}/checkin
POST /sites/{siteId}/drive/items/{itemId}/checkin
POST /users/{userId}/drive/items/{itemId}/checkin

Corps de la demande

Dans le corps de la demande, fournissez un objet JSON avec les paramètres suivants.

Nom Valeur Description
checkInAs string Optionnel. État souhaité du document une fois l’opération d’archivage terminée. Peut être published ou non spécifié.
comment string Commentaire d’archivage associé à la version.

Exemple

Cet exemple permet d’archiver un fichier défini par la valeur {item-id}.

POST /drives/{drive-id}/items/{item-id}/checkin
Content-Type: application/json

{
  "comment": "Updating the latest guidelines"
}

Réponse

En cas de réussite, l’appel d’API renvoie une réponse 204 No Content.

HTTP/1.1 204 No Content

Remarques