ユーザーの変更の通知を受け取ります。
HTTP リクエスト
POST https://www.googleapis.com/drive/v3/changes/watch
この URL は gRPC Transcoding 構文を使用します。
クエリ パラメータ
パラメータ | |
---|---|
driveId |
変更の戻り元となる共有ドライブ。指定した場合、変更 ID は共有ドライブを反映します。ドライブ ID と変更 ID の組み合わせを識別子として使用します。 |
includeCorpusRemovals |
リクエスト時にユーザーがファイルにアクセスできる場合に、変更のリストからファイルが削除され、このファイルの変更エントリがなくなる場合でも、変更にファイル リソースを含めるかどうか。 |
includeItemsFromAllDrives |
マイドライブと共有ドライブの両方のアイテムを結果に含めるかどうか。 |
includeRemoved |
アイテムの削除やアクセス権の喪失など、アイテムが変更リストから削除されたことを示す変更を含めるかどうかを指定します。 |
includeTeamDriveItems |
非推奨: 代わりに |
pageSize |
ページごとに返される変更の最大数。 |
pageToken |
次のページで前の list リクエストを続行するためのトークン。これは、前のレスポンスの「nextPageToken」の値、または getStartPageToken メソッドからのレスポンスに設定する必要があります。 |
restrictToMyDrive |
結果をマイドライブ階層内の変更に制限するかどうか。[Application Data] フォルダ内のファイルや、[マイドライブ] に追加されていない共有ファイルへの変更は除外されます。 |
spaces |
コーパス内でクエリするスペースのカンマ区切りのリスト。サポートされている値は「drive」と「appDataFolder」です。 |
supportsAllDrives |
リクエスト元のアプリケーションがマイドライブと共有ドライブの両方をサポートしているかどうか。 |
supportsTeamDrives |
非推奨: 代わりに |
teamDriveId |
非推奨: 代わりに |
includePermissionsForView |
レスポンスに含める追加のビューの権限を指定します。「公開済み」のみがサポートされています。 |
includeLabels |
レスポンスの |
リクエスト本文
リクエストの本文には 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
一部のスコープには制限があり、アプリでそれらを使用するにはセキュリティ評価が必要です。詳細については、承認ガイドをご覧ください。