Method: changes.list

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

درخواست HTTP

GET https://www.googleapis.com/drive/v3/changes

این 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 پاسخ قرار گیرند.

درخواست بدنه

بدنه درخواست باید خالی باشد.

بدنه پاسخ

فهرستی از تغییرات برای یک کاربر.

در صورت موفقیت، بدنه پاسخ شامل داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "changes": [
    {
      object (Change)
    }
  ],
  "kind": string,
  "nextPageToken": string,
  "newStartPageToken": string
}
فیلدها
changes[]

object ( Change )

فهرست تغییرات. اگر nextPageToken پر شده باشد، ممکن است این فهرست ناقص باشد و باید یک صفحه اضافی از نتایج واکشی شود.

kind

string

نوع منبع را مشخص می‌کند. مقدار: رشته‌ی ثابت "drive#changeList" .

nextPageToken

string

نشانه صفحه برای صفحه بعدی تغییرات. اگر به انتهای لیست تغییرات رسیده باشیم، این نشانه وجود نخواهد داشت. نشانه صفحه منقضی نمی‌شود.

newStartPageToken

string

نشانه صفحه شروع برای تغییرات آینده. این نشانه فقط در صورتی وجود خواهد داشت که به انتهای لیست تغییرات فعلی رسیده باشیم. نشانه صفحه منقضی نمی‌شود.

دامنه‌های مجوز

به یکی از حوزه‌های 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

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