Method: revisions.list

רשימת הגרסאות של קובץ. מידע נוסף זמין במאמר בנושא ניהול גרסאות של קבצים.

חשוב: רשימת הגרסאות שמוחזרת על ידי השיטה הזו עשויה להיות לא מלאה עבור קבצים עם היסטוריית גרסאות גדולה, כולל קבצים ב-Google Docs, ב-Sheets וב-Slides שנערכים לעיתים קרובות. יכול להיות שגרסאות ישנות יותר לא ייכללו בתשובה, כלומר הגרסה הראשונה שתחזור לא תהיה הגרסה הכי ישנה שקיימת. יכול להיות שהיסטוריית השינויים שמוצגת בממשק המשתמש של עורך Workspace תהיה מלאה יותר מהרשימה שמוחזרת על ידי ה-API.

בקשת HTTP

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

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

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

פרמטרים
fileId

string

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

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

פרמטרים
pageSize

integer

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

אם לא מציינים ערך, יוחזרו לכל היותר 200 גרסאות.

הערך המקסימלי הוא 1,000. ערכים גבוהים יותר יומרו ל-1,000.
pageToken

string

הטוקן להמשך בקשה קודמת של רשימה בדף הבא. הערך שצריך להגדיר כאן הוא הערך של nextPageToken מהתגובה הקודמת.

גוף הבקשה

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

גוף התשובה

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

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

ייצוג JSON 
{
  "revisions": [
    {
      object (Revision)
    }
  ],
  "nextPageToken": string,
  "kind": string
}
שדות
revisions[]

object (Revision)

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

string

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

string

מזהה את סוג המשאב. הערך: המחרוזת הקבועה "drive#revisionList".

היקפי הרשאות

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

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