Method: permissions.list

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

בקשת HTTP

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

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

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

פרמטרים
fileId

string

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

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

פרמטרים
maxResults

integer

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

string

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

boolean

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

boolean

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

boolean

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

string

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

גוף הבקשה

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

גוף התשובה

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

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

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

object (Permission)

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

string

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

string

הנתיב הזה תמיד drive#permissionList.
etag

string

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

היקפי הרשאה

נדרש אחד מהיקפי ההרשאות הבאים של 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

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