- Requête HTTP
- Paramètres de requête
- Corps de la requête
- Corps de la réponse
- Niveaux d'accès des autorisations
S'abonne aux modifications apportées à un utilisateur. Pour en savoir plus, consultez Notifications pour les modifications de ressources.
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 des ID de modification sont spécifiés, ils reflètent le Drive partagé. Utilisez l'ID de Drive et l'ID de modification combinés comme identifiant. |
includeCorpusRemovals |
Indique si les modifications doivent inclure la ressource de fichier si l'utilisateur peut toujours y accéder au moment de la requête, même si le 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 de Mon Drive et des Drive partagés doivent être inclus dans les résultats. |
includeRemoved |
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 |
Obsolète : utilisez plutôt |
pageSize |
Nombre maximal de modifications à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 100 modifications au maximum sont renvoyées. La valeur maximale est 1 000. Les valeurs supérieures sont réduites à 1 000. |
pageToken |
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 sur la réponse de la méthode getStartPageToken. |
restrictToMyDrive |
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 ne sont pas incluses. |
spaces |
Liste des espaces à interroger dans les corpus, séparés par une virgule. Les valeurs acceptées sont "drive" et "appDataFolder". |
supportsAllDrives |
Indique si l'application à l'origine de la requête 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 vues supplémentaires à inclure dans la réponse. Seule la valeur "published" est acceptée. |
includeLabels |
Liste d'ID de libellés séparés par une virgule, à inclure dans la partie |
Corps de la requête
Le corps de la requête contient une instance de 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/drivehttps://www.googleapis.com/auth/drive.appdatahttps://www.googleapis.com/auth/drive.filehttps://www.googleapis.com/auth/drive.meet.readonlyhttps://www.googleapis.com/auth/drive.metadatahttps://www.googleapis.com/auth/drive.metadata.readonlyhttps://www.googleapis.com/auth/drive.photos.readonlyhttps://www.googleapis.com/auth/drive.readonly
Certains 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.