Method: approvals.list

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

درخواست HTTP

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

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

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

پارامترها
fileId

string

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

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

پارامترها
pageSize

integer

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

pageToken

string

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

درخواست بدنه

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

بدنه پاسخ

پاسخ درخواست فهرست تأییدیه‌ها.

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

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

string

این همیشه drive#approvalList است

items[]

object ( Approval )

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

nextPageToken

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.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.readonly

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