Method: revisions.list

בתיבת הדו-שיח הזו מפורטים גרסאות קודמות של קובץ.

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

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

פרמטרים
fileId

string

המזהה של הקובץ.

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

פרמטרים
pageSize

integer

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

string

האסימון להמשך בקשת רשימה קודמת בדף הבא. יש להגדיר אותו לערך של 'nextPageToken' מהתגובה הקודמת.

גוף הבקשה

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

גוף התשובה

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

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

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

string

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

string

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

object (Revision)

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

היקפי ההרשאות

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

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