Method: permissions.list

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

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של 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

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