Method: permissions.list

בתיבת הדו-שיח הזו מפורטים ההרשאות של קובץ או של אחסון שיתופי.

בקשת HTTP

GET https://www.googleapis.com/drive/v2/files/{fileId}/permissions

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

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

פרמטרים
fileId

string

המזהה של הקובץ או האחסון השיתופי.

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

פרמטרים
maxResults

integer

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

pageToken

string

האסימון להמשך בקשת רשימה קודמת בדף הבא. צריך להגדיר אותו לערך של nextPageToken מהתשובה הקודמת.

supportsAllDrives

boolean

האם האפליקציה ששלחה את הבקשה תומכת גם בתיקייה 'האחסון שלי' וגם בתיקיות אחסון שיתופי.

supportsTeamDrives
(deprecated)

boolean

הוצא משימוש: במקומו צריך להשתמש ברכיב supportsAllDrives.

useDomainAdminAccess

boolean

לשלוח את הבקשה כמנהל דומיין. אם המדיניות מוגדרת כ-True, מגיש הבקשה יקבל גישה אם הפרמטר של מזהה הקובץ מתייחס לאחסון שיתופי, ומגיש הבקשה הוא אדמין של הדומיין שאליו שייך האחסון השיתופי.

includePermissionsForView

string

מציינת אילו הרשאות תצוגה נוספות לכלול בתשובה. יש תמיכה רק ב-published.

גוף הבקשה

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

גוף התשובה

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

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

ייצוג JSON
{
  "nextPageToken": string,
  "kind": string,
  "etag": string,
  "selfLink": string,
  "items": [
    {
      object (Permission)
    }
  ]
}
שדות
nextPageToken

string

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

kind

string

הערך הוא תמיד drive#permissionList.

etag

string

ה-ETag של הרשימה.

items[]

object (Permission)

רשימת ההרשאות.

היקפי ההרשאות

נדרש אחד מהיקפי ההרשאות הבאים של 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.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

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