Method: changes.list

Répertorie les modifications apportées à un utilisateur ou à un Drive partagé. Pour en savoir plus, consultez Récupérer les modifications.

Requête HTTP

GET https://www.googleapis.com/drive/v3/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 vous le spécifiez, les ID de modification reflèteront 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 y a toujours accès au moment de la requête, même si un fichier a été supprimé de la liste des modifications et qu'il n'y aura plus d'entrées de modification pour ce fichier.
includeItemsFromAllDrives

boolean

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

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).
includeTeamDriveItems
(deprecated)

boolean

Obsolète: utilisez includeItemsFromAllDrives à la place.
pageSize

integer

Nombre maximal de modifications à renvoyer par page.
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 de la réponse de la méthode getStartPageToken.
restrictToMyDrive

boolean

Indique si les résultats doivent être limités aux modifications apportées à la hiérarchie Mon Drive. Les modifications apportées aux fichiers tels que ceux du dossier "Données d'application" ou les fichiers partagés qui n'ont pas été ajoutés à Mon Drive sont ignorées.
spaces

string

Liste des espaces à interroger dans les corpus, séparés par une virgule. Les valeurs acceptées sont "drive" et "appDataFolder".
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 supportsAllDrives à la place.
teamDriveId
(deprecated)

string

Obsolète: utilisez driveId à la place.
includePermissionsForView

string

Spécifie les autorisations de la vue supplémentaire à inclure dans la réponse. Seule la valeur "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 à 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 
{
  "kind": string,
  "nextPageToken": string,
  "newStartPageToken": string,
  "changes": [
    {
      object (Change)
    }
  ]
}
Champs
kind

string

Identifie le type de ressource. Valeur: chaîne fixe "drive#changeList".
nextPageToken

string

Jeton de page pour la page de modifications suivante. Cette valeur n'est pas affichée si vous avez atteint la fin de la liste des modifications. Le jeton de page n'expire pas.
newStartPageToken

string

Jeton de la page de départ pour les futures modifications. Cette option ne s'affiche que si la fin de la liste des modifications actuelles a été atteinte. Le jeton de page n'expire pas.
changes[]

object (Change)

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

Champs d'application des autorisations

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

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • 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 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.