Method: files.watch
Подписывается на изменения в файле.
HTTP-запрос
POST https://www.googleapis.com/drive/v3/files/{fileId}/watch
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
| Параметры |
|---|
fileId | string Идентификатор файла. |
Параметры запроса
| Параметры |
|---|
supportsAllDrives | boolean Поддерживает ли запрашивающее приложение как «Мои диски», так и общие диски. |
supportsTeamDrives
(deprecated) | boolean Устарело: вместо этого используйте supportsAllDrives . |
acknowledgeAbuse | boolean Признает ли пользователь риск загрузки известного вредоносного ПО или других оскорбительных файлов. Это применимо только в том случае, если для параметра alt установлено media , а пользователь является владельцем файла или организатором общего диска, на котором находится файл. |
includePermissionsForView | string Указывает, какие дополнительные разрешения представления следует включить в ответ. Поддерживается только «опубликовано». |
includeLabels | string Разделенный запятыми список идентификаторов меток, которые необходимо включить в часть ответа labelInfo . |
Тело запроса
Тело запроса содержит экземпляр Channel .
Тело ответа
В случае успеха тело ответа содержит экземпляр Channel .
Области авторизации
Требуется одна из следующих областей OAuth:
-
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.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
Некоторые области ограничены, и для их использования требуется оценка безопасности вашего приложения. Дополнительную информацию см. в руководстве по авторизации .
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2024-10-30 UTC.
[null,null,["Последнее обновление: 2024-10-30 UTC."],[[["Subscribes to changes to a file using the `POST https://www.googleapis.com/drive/v3/files/{fileId}/watch` endpoint, where `{fileId}` represents the ID of the file."],["Request body and successful response body both contain an instance of [Channel](/drive/api/reference/rest/v3/channels#Channel), enabling subscription to file changes."],["Accepts various query parameters like `supportsAllDrives`, `acknowledgeAbuse`, `includePermissionsForView`, and `includeLabels` to customize the subscription request."],["Requires authorization with one of the listed OAuth scopes, such as `https://www.googleapis.com/auth/drive` or `https://www.googleapis.com/auth/drive.file`, to access and subscribe to file changes."]]],["This outlines how to subscribe to file changes using a `POST` request to `https://www.googleapis.com/drive/v3/files/{fileId}/watch`. Key actions include setting the `fileId` in the path and using query parameters like `supportsAllDrives`, `acknowledgeAbuse`, `includePermissionsForView`, and `includeLabels`. The request and response bodies both use a `Channel` instance. The request requires specific authorization scopes, such as `drive`, `drive.file`, or `drive.readonly`. Some scopes have restrictions.\n"]]
