Method: accessproposals.list

AccessProposals را روی یک فایل فهرست کنید. توجه: فقط تأییدکنندگان می‌توانند AccessProposals را در یک فایل فهرست کنند. اگر کاربر تایید کننده نباشد، 403 را برمی گرداند.

درخواست HTTP

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

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

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

پارامترها
fileId

string

مورد نیاز. شناسه موردی که درخواست روی آن است.

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

پارامترها
pageToken

string

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

pageSize

integer

اختیاری. تعداد نتایج در هر صفحه

درخواست بدن

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

بدن پاسخگو

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

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

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

object ( AccessProposal )

لیست پیشنهادات دسترسی این فیلد فقط در نسخه 3 و 3 بتا پر شده است.

nextPageToken

string

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

محدوده مجوز

به یکی از حوزه های OAuth زیر نیاز دارد:

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

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