Method: changes.watch

تغییرات مربوط به یک کاربر را ثبت می‌کند. برای اطلاعات بیشتر، به بخش «اعلان‌های مربوط به تغییرات منابع» مراجعه کنید.

درخواست HTTP

POST https://www.googleapis.com/drive/v3/changes/watch

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

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

پارامترها
driveId

string

درایو مشترکی که تغییرات از آن بازگردانده می‌شوند. در صورت مشخص شدن، شناسه‌های تغییر، منعکس‌کننده‌ی درایو مشترک خواهند بود؛ از شناسه‌ی ترکیبی درایو و شناسه‌ی تغییر به عنوان شناسه استفاده کنید.

includeCorpusRemovals

boolean

اینکه آیا تغییرات باید شامل منبع فایل باشند یا خیر، اگر فایل در زمان درخواست هنوز توسط کاربر قابل دسترسی باشد، حتی اگر فایلی از لیست تغییرات حذف شده باشد و هیچ ورودی تغییر دیگری برای این فایل وجود نداشته باشد.

includeItemsFromAllDrives

boolean

اینکه آیا هم آیتم‌های My Drive و هم آیتم‌های shared drive باید در نتایج گنجانده شوند یا خیر.

includeRemoved

boolean

اینکه آیا تغییراتی که نشان می‌دهد موارد از فهرست تغییرات حذف شده‌اند، مثلاً از طریق حذف یا از دست دادن دسترسی، لحاظ شود یا خیر.

includeTeamDriveItems
(deprecated)

boolean

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

pageSize

integer

حداکثر تعداد تغییراتی که باید برگردانده شود. سرویس ممکن است کمتر از این مقدار را برگرداند.

اگر مشخص نشده باشد، حداکثر ۱۰۰ تغییر برگردانده خواهد شد.

حداکثر مقدار ۱۰۰۰ است؛ مقادیر بالاتر از ۱۰۰۰ به اجبار به ۱۰۰۰ کاهش می‌یابند.

pageToken

string

توکنی برای ادامه‌ی درخواست لیست قبلی در صفحه‌ی بعد. این توکن باید روی مقدار 'nextPageToken' از پاسخ قبلی یا روی پاسخ از متد getStartPageToken تنظیم شود.

restrictToMyDrive

boolean

اینکه آیا نتایج به تغییرات درون سلسله مراتب My Drive محدود شود یا خیر. این کار تغییرات فایل‌هایی مانند فایل‌های موجود در پوشه Application Data یا فایل‌های اشتراکی که به My Drive اضافه نشده‌اند را حذف می‌کند.

spaces

string

فهرستی از فاصله‌ها که با کاما از هم جدا شده‌اند تا درون مجموعه داده‌ها جستجو شوند. مقادیر پشتیبانی‌شده عبارتند از 'drive' و 'appDataFolder'.

supportsAllDrives

boolean

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

supportsTeamDrives
(deprecated)

boolean

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

teamDriveId
(deprecated)

string

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

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

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