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

יש היקפי הרשאות מוגבלים שנדרשת הערכת אבטחה כדי להשתמש בהם באפליקציה. מידע נוסף זמין במדריך ההרשאות.