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

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