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

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