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.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

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