Method: files.watch
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Dosyadaki değişikliklere abone olur.
HTTP isteği
POST https://www.googleapis.com/drive/v2/files/{fileId}/watch
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
| Parametreler |
fileId |
string
Söz konusu dosyanın kimliği.
|
Sorgu parametreleri
| Parametreler |
supportsAllDrives |
boolean
İstekte bulunan uygulamanın hem Drive'ım hem de ortak Drive'ları destekleyip desteklemediği.
|
supportsTeamDrives
(deprecated) |
boolean
Desteği sonlandırıldı: Bunun yerine supportsAllDrives politikasını kullanın.
|
acknowledgeAbuse |
boolean
Kullanıcının, bilinen kötü amaçlı yazılımları veya kötüye kullanım amaçlı diğer dosyaları indirme riskini kabul edip etmediğini belirtir. Bu yalnızca alt parametresi media olarak ayarlandığında ve kullanıcı dosyanın sahibi veya dosyanın bulunduğu ortak Drive'ın düzenleyicisi olduğunda geçerlidir.
|
includePermissionsForView |
string
Yanıta hangi ek görünümün izinlerinin dahil edileceğini belirtir. Yalnızca published desteklenir.
|
revisionId |
string
İndirilmesi gereken düzeltme kimliğini belirtir. alt=media belirtilmediği sürece yoksayılır.
|
updateViewedDate
(deprecated) |
boolean
Desteği sonlandırıldı: modifiedDateBehavior=noChange, updateViewedDate=true ve boş bir istek gövdesi ile files.update işlevini kullanın.
|
projection
(deprecated) |
enum (Projection)
Desteği sonlandırıldı: Bu parametrenin işlevi yoktur.
|
includeLabels |
string
Yanıtın labelInfo bölümüne dahil edilecek etiketlerin virgülle ayrılmış kimlik listesi.
|
İstek içeriği
İstek metni, Channel öğesinin bir örneğini içerir.
Yanıt gövdesi
Başarılıysa yanıt metni, Channel öğesinin bir örneğini içerir.
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
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.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
Bazı kapsamlar kısıtlıdır ve uygulamanızın bunları kullanabilmesi için güvenlik değerlendirmesi gerekir. Daha fazla bilgi için Yetkilendirme kılavuzuna bakın.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-25 UTC.
[null,null,["Son güncelleme tarihi: 2025-07-25 UTC."],[],[],null,["# Method: files.watch\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n\nSubscribes to changes to a file.\n\n### HTTP request\n\n`POST https://www.googleapis.com/drive/v2/files/{fileId}/watch`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-------------------------------------------|\n| `fileId` | `string` The ID for the file in question. |\n\n### Query parameters\n\n| Parameters ||\n|---------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `supportsAllDrives` | `boolean` Whether the requesting application supports both My Drives and shared drives. |\n| `supportsTeamDrives` **(deprecated)** | `boolean` Deprecated: Use `supportsAllDrives` instead. |\n| `acknowledgeAbuse` | `boolean` Whether the user is acknowledging the risk of downloading known malware or other abusive files. This is only applicable when the `alt` parameter is set to `media` and the user is the owner of the file or an organizer of the shared drive in which the file resides. |\n| `includePermissionsForView` | `string` Specifies which additional view's permissions to include in the response. Only `published` is supported. |\n| `revisionId` | `string` Specifies the Revision ID that should be downloaded. Ignored unless alt=media is specified. |\n| `updateViewedDate` **(deprecated)** | `boolean` Deprecated: Use files.update with modifiedDateBehavior=noChange, updateViewedDate=true and an empty request body. |\n| `projection` **(deprecated)** | `enum (`[Projection](/workspace/drive/api/reference/rest/v2/Projection)`)` Deprecated: This parameter has no function. |\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.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)."]]
