Method: accessproposals.list

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

توجه: فقط تأییدکنندگان می‌توانند پیشنهادهای دسترسی را در یک فایل فهرست کنند. اگر کاربر تایید کننده نباشد، خطای 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 )

لیست پیشنهادات دسترسی این فیلد فقط در Drive API v3 پر شده است.

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

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