Method: revisions.list

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

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של 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.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

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