Method: approvals.list

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

בקשת HTTP

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

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

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

פרמטרים
fileId

string

חובה. המזהה של הקובץ שבו נמצא האישור.

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

פרמטרים
pageSize

integer

מספר האישורים המקסימלי שיוחזרו. אם לא מציינים ערך, יוחזרו עד 100 אישורים.
pageToken

string

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

גוף הבקשה

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

גוף התשובה

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

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

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

string

הערך הזה תמיד יהיה drive#approvalList
items[]

object (Approval)

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

string

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

היקפי הרשאה

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

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

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