Method: revisions.list

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

בקשת HTTP

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

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

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

פרמטרים
fileId

string

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

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

פרמטרים
maxResults

integer

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

string

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

גוף הבקשה

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

גוף התשובה

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

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

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

string

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

string

הערך הוא תמיד drive#revisionList.
etag

string

ה-ETag של הרשימה.
items[]

object (Revision)

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

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

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

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

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