Method: approvals.list

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

به طور پیش‌فرض، این روش یک پاسخ حداقلی را برمی‌گرداند که ممکن است شامل آرایه items نباشد. برای بازیابی جزئیات تأیید، باید فیلدهای مورد نظر خود را با استفاده از پارامتر جستجوی fields به طور صریح مشخص کنید. برای بازگرداندن فیلدهای دقیق مورد نیاز، به Return specific fields مراجعه کنید.

درخواست 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

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