Method: permissions.list

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

בקשת HTTP

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

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

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

פרמטרים
fileId

string

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

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

פרמטרים
pageSize

integer

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

string

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

boolean

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

boolean

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

boolean

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

string

מציינת אילו הרשאות תצוגה נוספות לכלול בתשובה. יש תמיכה רק בערך 'פורסם'.

גוף הבקשה

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

גוף התשובה

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

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

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

string

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

string

מזהה מה סוג המשאב הזה. ערך: המחרוזת הקבועה "drive#permissionList".
permissions[]

object (Permission)

רשימת ההרשאות. אם nextPageToken מאוכלס, יכול להיות שהרשימה הזו חלקית וצריך לאחזר דף נוסף של תוצאות.

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

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • 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

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