Method: changes.watch

S'abonner aux modifications d'un utilisateur

Requête HTTP

POST https://www.googleapis.com/drive/v2/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. Si vous spécifiez un ID de modification, celui-ci correspondra au Drive partagé. Utilisez à la fois l'ID du Drive et 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 demande, même lorsqu'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.

includeDeleted

boolean

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

includeItemsFromAllDrives

boolean

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

includeSubscribed

boolean

Permet d'inclure ou non dans le résultat les modifications apportées en dehors de la hiérarchie Mon Drive. Lorsque cette règle est définie sur "false", les modifications apportées aux fichiers tels que ceux du dossier "Données de l'application" ou des 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 demande de liste précédente sur la page suivante. Elle 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 d'espaces séparés par une virgule à interroger. 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émentaire à inclure dans la réponse. Seule la fonctionnalité published est prise en charge.

includeLabels

string

Liste des ID des étiquettes à inclure dans la partie labelInfo de la réponse, séparés par une virgule.

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/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.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 relatif aux autorisations.