Method: files.accessproposals.list

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

درخواست HTTP

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

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

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

پارامترها
file Id

string

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

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

پارامترها
page Token

string

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

page Size

integer

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

درخواست بدن

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

بدن پاسخگو

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

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

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

object ( AccessProposal )

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

next Page Token

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

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

AccessProposal

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

نمایندگی JSON 
{
  "fileId": string,
  "proposalId": string,
  "requesterEmailAddress": string,
  "recipientEmailAddress": string,
  "rolesAndViews": [
    {
      object (RoleAndView)
    }
  ],
  "requestMessage": string,
  "createTime": string
}
فیلدها
file Id

string

شناسه فایلی که پیشنهاد دسترسی در آن است

proposal Id

string

شناسه پیشنهاد دسترسی

requester Email Address

string

آدرس ایمیل کاربر درخواست کننده

recipient Email Address

string

آدرس ایمیل کاربری که در صورت پذیرش مجوز دریافت می کند

roles And Views[]

object ( RoleAndView )

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

request Message

string

پیامی که درخواست کننده به پروپوزال اضافه کرده است

create Time

string ( Timestamp format)

زمان ایجاد

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

RoleAndView

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

نمایندگی JSON 
{
  "role": string,
  "view": string
}
فیلدها
role

string

نقشی که توسط درخواست کننده پیشنهاد شد ممکن است در آینده مقادیر جدیدی اضافه شود، اما موارد زیر در حال حاضر امکان پذیر است: * writer * commenter * reader

view

string

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