Method: changes.list

Liste les modifications apportées à un utilisateur ou à un Drive partagé.

Requête HTTP

GET https://www.googleapis.com/drive/v2/changes

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de requête

Paramètres
driveId

string

Drive partagé à partir duquel les modifications seront renvoyées. Si des ID de modification sont spécifiés, ils reflètent le Drive partagé. Utilisez l'ID de Drive et l'ID de modification combinés comme identifiant.
includeCorpusRemovals

boolean

Indique si les modifications doivent inclure la ressource de fichier si l'utilisateur peut toujours y accéder au moment de la requête, même si le fichier a été supprimé de la liste des modifications et qu'il n'y aura plus d'entrées de modification pour ce fichier.
includeDeleted

boolean

Indique si les modifications indiquant que des éléments ont été supprimés de la liste des modifications doivent être incluses (par exemple, en cas de suppression ou de perte d'accès).
includeItemsFromAllDrives

boolean

Indique si les éléments de Mon Drive et des Drive partagés doivent être inclus dans les résultats.
includeSubscribed

boolean

Indique si les modifications en dehors de la hiérarchie "Mon Drive" doivent être incluses dans le résultat. Si la valeur est définie sur "false", les modifications apportées aux fichiers, tels que ceux du dossier "Application Data" ou les fichiers partagés qui n'ont pas été ajoutés à Mon Drive, seront omises des résultats.
includeTeamDriveItems
(deprecated)

boolean

Obsolète : utilisez plutôt includeItemsFromAllDrives.
maxResults

integer

Nombre maximal de modifications à renvoyer.
pageToken

string

Jeton permettant de poursuivre une requête de liste précédente sur la page suivante. Cette valeur doit être définie sur la valeur de nextPageToken de la réponse précédente ou sur la réponse de la méthode getStartPageToken.
spaces

string

Liste des espaces à interroger, séparés par une virgule. Les valeurs acceptées sont drive, appDataFolder et photos.
startChangeId
(deprecated)

string (int64 format)

Obsolète : utilisez plutôt pageToken.
supportsAllDrives

boolean

Indique si l'application à l'origine de la requête est compatible avec Mon Drive et les Drive partagés.
supportsTeamDrives
(deprecated)

boolean

Obsolète : utilisez plutôt supportsAllDrives.
teamDriveId
(deprecated)

string

Obsolète : utilisez plutôt driveId.
includePermissionsForView

string

Spécifie les autorisations de vues supplémentaires à inclure dans la réponse. Seule l'option published est acceptée.
includeLabels

string

Liste d'ID de libellés séparés par une virgule, à inclure dans la partie labelInfo de la réponse.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Liste des modifications apportées par un utilisateur.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "items": [
    {
      object (Change)
    }
  ],
  "largestChangeId": string,
  "nextPageToken": string,
  "kind": string,
  "etag": string,
  "newStartPageToken": string,
  "selfLink": string,
  "nextLink": string
}
Champs
items[]

object (Change)

Liste des modifications. Si nextPageToken est renseigné, il est possible que cette liste soit incomplète et qu'une page de résultats supplémentaire doive être récupérée.
largestChangeId

string (int64 format)

ID de modification le plus élevé actuel.
nextPageToken

string

Jeton de page pour la page suivante des modifications. Cette valeur est absente si la fin de la liste des modifications a été atteinte. Si le jeton est refusé pour une raison quelconque, il doit être supprimé et la pagination doit être redémarrée à partir de la première page de résultats.
kind

string

Cette valeur est toujours drive#changeList.
etag

string

ETag de la liste.
newStartPageToken

string

Jeton de page de début pour les futures modifications. Cette option ne s'affiche que si la fin de la liste des modifications actuelles a été atteinte.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/docs
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.apps.readonly
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

Certains sont soumis à des restrictions et nécessitent une évaluation de sécurité pour que votre application puisse les utiliser. Pour en savoir plus, consultez le guide d'autorisation.