Method: files.watch

برای تغییرات یک فایل مشترک می شود.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
fileId

string

شناسه فایل مورد نظر.

پارامترهای پرس و جو

مولفه های
supportsAllDrives

boolean

اینکه آیا برنامه درخواست کننده هم از My Drives و هم درایوهای مشترک پشتیبانی می کند.

supportsTeamDrives
(deprecated)

boolean

منسوخ شده: به جای آن از supportsAllDrives استفاده کنید.

acknowledgeAbuse

boolean

این که آیا کاربر خطر دانلود بدافزار شناخته شده یا سایر فایل های توهین آمیز را تأیید می کند. این تنها زمانی قابل اعمال است که پارامتر alt روی media تنظیم شده باشد و کاربر مالک فایل یا سازمان دهنده درایو مشترکی باشد که فایل در آن قرار دارد.

includePermissionsForView

string

مشخص می کند که کدام مجوزهای اضافی در پاسخ گنجانده شود. فقط published پشتیبانی می شود.

revisionId

string

شناسه نسخه ای را که باید دانلود شود را مشخص می کند. نادیده گرفته می شود مگر اینکه alt=media مشخص شده باشد.

updateViewedDate
(deprecated)

boolean

منسوخ شده: از files.update با modifiedDateBehavior=noChange، updateViewedDate=true و بدنه درخواست خالی استفاده کنید.

projection
(deprecated)

enum ( Projection )

Deprecated: این پارامتر عملکردی ندارد.

includeLabels

string

فهرستی از شناسه‌های برچسب‌هایی که با کاما از هم جدا شده‌اند تا در قسمت labelInfo پاسخ قرار داده شوند.

درخواست بدن

بدنه درخواست حاوی نمونه‌ای از 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

برخی از دامنه ها محدود هستند و برای استفاده از برنامه شما به ارزیابی امنیتی نیاز دارند. برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.