Method: revisions.list

لیست ویرایش‌های یک فایل را نمایش می‌دهد.

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

درخواست HTTP

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

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

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

پارامترها
fileId

string

شناسه فایل.

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

پارامترها
maxResults

integer

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

pageToken

string

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

درخواست بدنه

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

بدنه پاسخ

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

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

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

object ( Revision )

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

nextPageToken

string

نشانه صفحه برای صفحه بعدی اصلاحات. اگر به انتهای لیست اصلاحات رسیده باشید، این فیلد وجود نخواهد داشت. اگر نشانه به هر دلیلی رد شود، باید کنار گذاشته شود و صفحه‌بندی باید از صفحه اول نتایج دوباره شروع شود.

kind

string

این همیشه drive#revisionList است.

etag

string

برچسب ET لیست.

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

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

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