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

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