Method: revisions.list

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

مهم: فهرست ویرایش‌های برگردانده شده توسط این روش ممکن است برای فایل‌هایی با سابقه ویرایش طولانی، از جمله Google Docs، Sheets و Slides که مرتباً ویرایش می‌شوند، ناقص باشد. ویرایش‌های قدیمی‌تر ممکن است از پاسخ حذف شوند، به این معنی که اولین ویرایش برگردانده شده ممکن است قدیمی‌ترین ویرایش موجود نباشد. تاریخچه ویرایش قابل مشاهده در رابط کاربری ویرایشگر Workspace ممکن است کامل‌تر از فهرست برگردانده شده توسط API باشد.

درخواست HTTP

GET https://www.googleapis.com/drive/v3/files/{fileId}/revisions

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

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

پارامترها
fileId

string

شناسه فایل.

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

پارامترها
pageSize

integer

حداکثر تعداد ویرایش‌هایی که باید در هر صفحه برگردانده شود.

pageToken

string

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

درخواست بدنه

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

بدنه پاسخ

فهرستی از ویرایش‌های یک فایل.

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

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

object ( Revision )

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

nextPageToken

string

نشانه صفحه برای صفحه بعدی اصلاحات. اگر به انتهای لیست اصلاحات رسیده باشید، این نشانه وجود نخواهد داشت. اگر نشانه به هر دلیلی رد شود، باید کنار گذاشته شود و صفحه‌بندی باید از صفحه اول نتایج دوباره آغاز شود. نشانه صفحه معمولاً برای چند ساعت معتبر است. با این حال، اگر موارد جدیدی اضافه یا حذف شوند، نتایج مورد انتظار شما ممکن است متفاوت باشد.

kind

string

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

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

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

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