Method: revisions.list

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

בקשת HTTP

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

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

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

פרמטרים
fileId

string

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

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

פרמטרים
maxResults

integer

המספר המקסימלי של הגרסאות שיוחזרו.
pageToken

string

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

גוף הבקשה

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

גוף התשובה

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

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

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

object (Revision)

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

string

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

string

הנתיב הזה תמיד drive#revisionList.
etag

string

תג ה-ETag של הרשימה.

היקפי הרשאה

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

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