Method: permissions.list

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

בקשת HTTP

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

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

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

פרמטרים
fileId

string

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

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

פרמטרים
pageSize

integer

המספר המקסימלי של הרשאות שיוחזרו. יכול להיות שהשירות יחזיר פחות מהערך הזה.

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

הערך המקסימלי הוא 100. ערכים גבוהים יותר יומרו ל-100.
pageToken

string

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

boolean

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

boolean

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

boolean

שולחים את הבקשה כאדמין בדומיין.

אם הערך מוגדר כ-true, ואם מתקיימים התנאים הנוספים הבאים, תינתן למבקש גישה:

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

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

string

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

גוף הבקשה

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

גוף התשובה

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

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

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

object (Permission)

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

string

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

string

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

היקפי הרשאות

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

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