Method: approvals.list

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

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

בקשת HTTP

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

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

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

פרמטרים
fileId

string

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

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

פרמטרים
pageSize

integer

מספר האישורים המקסימלי שיוחזרו. אם לא מציינים ערך, ה-API יחזיר עד 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

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