Method: revisions.list

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

درخواست HTTP

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

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

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

پارامترها
fileId

string

شناسه فایل

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

پارامترها
pageSize

integer

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

pageToken

string

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

درخواست بدن

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

بدن پاسخگو

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

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

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

string

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

kind

string

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

revisions[]

object ( Revision )

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

محدوده مجوز

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

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