Method: files.watch

訂閱檔案變更。

HTTP 要求

POST https://www.googleapis.com/drive/v2/files/{fileId}/watch

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
fileId

string

相關檔案的 ID。

查詢參數

參數
supportsAllDrives

boolean

要求的應用程式是否支援「我的雲端硬碟」和共用雲端硬碟。
supportsTeamDrives
(deprecated)

boolean

已淘汰：請改用 supportsAllDrives。
acknowledgeAbuse

boolean

使用者是否已承認下載已知惡意軟體或其他濫用檔案的風險。只有在 alt 參數設為 media，且使用者是檔案所在共用雲端硬碟的擁有者或管理者時，才適用這種做法。
includePermissionsForView

string

指定要在回應中加入哪些其他檢視表權限。系統僅支援 published。
revisionId

string

指定應下載的修訂版本 ID。除非已指定 alt=media，否則會遭到忽略。
updateViewedDate
(deprecated)

boolean

已淘汰：使用 files.update 和 modifyDateBehavior=noChange、updateViewedDate=true 和空白的要求主體。
projection
(deprecated)

enum (Projection)

已淘汰：此參數沒有任何函式。
includeLabels

string

要加入回應 labelInfo 部分的標籤 ID 清單 (以半形逗號分隔)。

要求主體

要求主體包含 Channel 的例項。

回應主體

如果成功，回應主體會包含 Channel 的執行例項。

授權範圍

需要下列其中一種 OAuth 範圍：

  • 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

部分範圍受到限制，必須接受安全性評估，應用程式才能使用這些範圍。詳情請參閱授權指南。