Method: files.accessproposals.list

הצגת רשימה של הצעות הגישה בקובץ. הערה: רק גורמים שאישרו את הבקשה יכולים לצרף בקשות גישה לקובץ. אם המשתמש לא הוא איש האישור, המערכת מחזירה את הערך 403.

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

פרמטרים של נתיב

פרמטרים
fileId

string

חובה. המזהה של הפריט שאליו מתייחסת הבקשה.

פרמטרים של שאילתה

פרמטרים
pageToken

string

זה שינוי אופציונלי. אסימון ההמשך ברשימת בקשות הגישה.

pageSize

integer

זה שינוי אופציונלי. מספר התוצאות בכל דף

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התשובה

התשובה לבקשת רשימה של הצעות גישה.

אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:

ייצוג ב-JSON
{
  "accessProposals": [
    {
      object (AccessProposal)
    }
  ],
  "nextPageToken": string
}
שדות
accessProposals[]

object (AccessProposal)

רשימה של הצעות גישה. השדה הזה מאוכלס רק בגרסה 3 ובגרסה 3beta.

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

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

AccessProposal

המשאב Access Proposal עבור הצעות גישה פתוחות לקובץ

ייצוג ב-JSON
{
  "fileId": string,
  "proposalId": string,
  "requesterEmailAddress": string,
  "recipientEmailAddress": string,
  "rolesAndViews": [
    {
      object (RoleAndView)
    }
  ],
  "requestMessage": string,
  "createTime": string
}
שדות
fileId

string

מזהה הקובץ שבו נמצאת ההצעה לגישה

proposalId

string

המזהה של הצעת הגישה

requesterEmailAddress

string

כתובת האימייל של המשתמש ששלח את הבקשה

recipientEmailAddress

string

כתובת האימייל של המשתמש שיקבל את ההרשאות אם הוא יאושר

rolesAndViews[]

object (RoleAndView)

wrapper לתפקיד ולתצוגה של הצעת גישה.

requestMessage

string

ההודעה שמגיש הבקשה הוסיף להצעה

createTime

string (Timestamp format)

שעת היצירה

חותמת זמן בפורמט 'Zulu' בפורמט RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות אחרי הנקודה. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

RoleAndView

wrapper לתפקיד ולתצוגה של הצעת גישה.

ייצוג JSON
{
  "role": string,
  "view": string
}
שדות
role

string

התפקיד שהמגיש הציע. ייתכן שערכים חדשים יתווספו בעתיד, אבל אלה הערכים האפשריים כרגע: * writer * commenter * reader

view

string

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