Method: changes.watch

Abonnement aux modifications d'un utilisateur.

Requête HTTP :

POST https://www.googleapis.com/drive/v3/changes/watch

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'il est spécifié, les ID des modifications reflètent le Drive partagé. Utilisez l'ID de Drive combiné et l'ID de modification comme identifiants.
includeCorpusRemovals

boolean

Indique si les modifications doivent inclure la ressource du fichier si l'utilisateur y a toujours accès au moment de la demande, même lorsqu'un fichier a été supprimé de la liste. Il n'y aura plus d'entrées de modification pour ce fichier.
includeItemsFromAllDrives

boolean

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

boolean

Permet d'inclure ou non les modifications indiquant que des éléments ont été supprimés de la liste (par exemple, en les supprimant ou en en perdant l'accès).
includeTeamDriveItems
(deprecated)

boolean

Obsolète: utilisez plutôt includeItemsFromAllDrives.
pageSize

integer

Nombre maximal de modifications à afficher par page.
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" de la réponse précédente ou sur la réponse de la méthode "getStartPageToken".
restrictToMyDrive

boolean

Restreindre les résultats aux modifications apportées à la hiérarchie Mon Drive. Cette action omet les modifications apportées aux fichiers tels que ceux du dossier des données d'application ou des fichiers partagés qui n'ont pas été ajoutés à Mon Drive.
spaces

string

Liste d'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 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 supplémentaires de la vue à inclure dans la réponse. Seul "publié" est accepté.
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 contient une instance Channel.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Channel.

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.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 limités et nécessitent une évaluation de sécurité pour que votre application puisse les utiliser. Pour en savoir plus, consultez le guide sur les autorisations.