Method: changes.watch
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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 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.
|
includeDeleted |
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).
|
includeItemsFromAllDrives |
boolean
Indique si les éléments de Mon Drive et des Drive partagés doivent être inclus dans les résultats.
|
includeSubscribed |
boolean
Indique si les modifications en dehors de la hiérarchie Mon Drive doivent être incluses dans les résultats. Si ce paramètre est défini sur "False", les modifications apportées aux fichiers, comme celles du dossier "Application Data" ou des fichiers partagés qui n'ont pas été ajoutés à Mon Drive, ne sont pas incluses dans le résultat.
|
includeTeamDriveItems
(deprecated) |
boolean
Obsolète: utilisez includeItemsFromAllDrives à la place.
|
maxResults |
integer
Nombre maximal de modifications à renvoyer.
|
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 sur la réponse de la méthode getStartPageToken.
|
spaces |
string
Liste des espaces à interroger, séparés par une virgule. Les valeurs acceptées sont drive, appDataFolder et photos.
|
startChangeId
(deprecated) |
string (int64 format)
Obsolète: utilisez pageToken à la place.
|
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 l'option 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 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/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.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.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 2025/07/25 (UTC)."],[],[],null,["# Method: changes.watch\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n\nSubscribe to changes for a user.\n\n### HTTP request\n\n`POST https://www.googleapis.com/drive/v2/changes/watch`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `driveId` | `string` The shared drive from which changes will be returned. If specified the change IDs will be reflective of the shared drive; use the combined drive ID and change ID as an identifier. |\n| `includeCorpusRemovals` | `boolean` Whether changes should include the file resource if the file is still accessible by the user at the time of the request, even when a file was removed from the list of changes and there will be no further change entries for this file. |\n| `includeDeleted` | `boolean` Whether to include changes indicating that items have been removed from the list of changes, for example by deletion or loss of access. |\n| `includeItemsFromAllDrives` | `boolean` Whether both My Drive and shared drive items should be included in results. |\n| `includeSubscribed` | `boolean` Whether to include changes outside the My Drive hierarchy in the result. When set to false, changes to files such as those in the Application Data folder or shared files which have not been added to My Drive will be omitted from the result. |\n| `includeTeamDriveItems` **(deprecated)** | `boolean` Deprecated: Use `includeItemsFromAllDrives` instead. |\n| `maxResults` | `integer` Maximum number of changes to return. |\n| `pageToken` | `string` The token for continuing a previous list request on the next page. This should be set to the value of `nextPageToken` from the previous response or to the response from the getStartPageToken method. |\n| `spaces` | `string` A comma-separated list of spaces to query. Supported values are `drive`, `appDataFolder` and `photos`. |\n| `startChangeId` **(deprecated)** | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Deprecated: Use `pageToken` instead. |\n| `supportsAllDrives` | `boolean` Whether the requesting application supports both My Drives and shared drives. |\n| `supportsTeamDrives` **(deprecated)** | `boolean` Deprecated: Use `supportsAllDrives` instead. |\n| `teamDriveId` **(deprecated)** | `string` Deprecated: Use `driveId` instead. |\n| `includePermissionsForView` | `string` Specifies which additional view's permissions to include in the response. Only `published` is supported. |\n| `includeLabels` | `string` A comma-separated list of IDs of labels to include in the `labelInfo` part of the response. |\n\n### Request body\n\nThe request body contains an instance of [Channel](/workspace/drive/api/reference/rest/v2/channels#Channel).\n\n### Response body\n\nIf successful, the response body contains an instance of [Channel](/workspace/drive/api/reference/rest/v2/channels#Channel).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/docs`\n- `\n https://www.googleapis.com/auth/drive`\n- `\n https://www.googleapis.com/auth/drive.appdata`\n- `\n https://www.googleapis.com/auth/drive.apps.readonly`\n- `\n https://www.googleapis.com/auth/drive.file`\n- `\n https://www.googleapis.com/auth/drive.meet.readonly`\n- `\n https://www.googleapis.com/auth/drive.metadata`\n- `\n https://www.googleapis.com/auth/drive.metadata.readonly`\n- `\n https://www.googleapis.com/auth/drive.photos.readonly`\n- `\n https://www.googleapis.com/auth/drive.readonly`\n\nSome scopes are restricted and require a security assessment for your app to use them. For more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
