- Requête HTTP
- Paramètres de requête
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
S'abonne 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 |
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 |
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. |
includeItemsFromAllDrives |
Indique si les éléments Mon Drive et Drive partagés doivent être inclus dans les résultats. |
includeRemoved |
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. |
includeTeamDriveItems |
Obsolète: utilisez plutôt |
pageSize |
Nombre maximal de modifications à renvoyer par page. |
pageToken |
Jeton permettant de poursuivre une demande de liste précédente sur la page suivante. Doit être défini sur la valeur de "nextPageToken" de la réponse précédente ou de la réponse de la méthode getStartPageToken. |
restrictToMyDrive |
Permet de limiter ou non les résultats aux modifications effectuées dans la hiérarchie de Mon Drive. 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 ne sont pas apportées. |
spaces |
Liste d'espaces séparés par une virgule à interroger dans les corpus. Les valeurs acceptées sont "drive" et "appDataFolder". |
supportsAllDrives |
Indique si l'application à l'origine de la demande est compatible avec Mon Drive et les Drive partagés. |
supportsTeamDrives |
Obsolète: utilisez plutôt |
teamDriveId |
Obsolète: utilisez plutôt |
includePermissionsForView |
Spécifie les autorisations de vue supplémentaire à inclure dans la réponse. Seul l'état "Publié" est accepté. |
includeLabels |
Liste des ID des étiquettes à inclure dans la partie |
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 relatif aux autorisations.