Method: changes.list

Liste les modifications pour 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. S'ils sont spécifiés, les ID de modification refléteront le Drive partagé. utilisez l'ID de Drive combiné avec l'ID de modification comme identifiant.

includeCorpusRemovals

boolean

Indique si les modifications doivent inclure la ressource du fichier si le fichier est toujours accessible par l'utilisateur au moment de la requête, même lorsqu'un fichier a été supprimé de la liste des modifications et qu'il n'y a plus d'entrées de modification pour ce fichier.

includeDeleted

boolean

Permet d'inclure ou non les modifications indiquant que les éléments ont été retirés de la liste des modifications (par exemple, en cas de suppression ou de perte d'accès).

includeItemsFromAllDrives

boolean

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

includeSubscribed

boolean

Permet d'inclure ou non les modifications effectuées en dehors de la hiérarchie de Mon Drive dans le résultat. Si cette règle est définie sur "False", les modifications apportées aux fichiers tels que ceux du dossier "Données d'application" ou aux fichiers partagés qui n'ont pas été ajoutés à Mon Drive sont omises du résultat.

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. Il doit être défini sur la valeur de nextPageToken à partir de la réponse précédente ou sur celle de 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 demande 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 vue supplémentaires à inclure dans la réponse. Seule la fonctionnalité published est prise en charge.

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 pour 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
{
  "largestChangeId": string,
  "nextPageToken": string,
  "kind": string,
  "etag": string,
  "newStartPageToken": string,
  "selfLink": string,
  "nextLink": string,
  "items": [
    {
      object (Change)
    }
  ]
}
Champs
largestChangeId

string (int64 format)

ID actuel de modification la plus importante.

nextPageToken

string

Jeton de page pour la page de modifications suivante. Ce champ est absent si la fin de la liste des modifications est 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

Il s'agit toujours de drive#changeList.

etag

string

ETag de la liste.

newStartPageToken

string

Jeton de la page de démarrage pour les modifications ultérieures. Cet élément ne s'affiche que si la liste des modifications en cours est terminée.

items[]

object (Change)

Liste des modifications. Si nextPageToken est renseigné, cette liste peut être incomplète et une page de résultats supplémentaire devra être extraite.

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 champs d'application sont restreints et nécessitent une évaluation de sécurité pour que votre application puisse les utiliser. Pour en savoir plus, consultez le Guide relatif aux autorisations.