בתיבת הדו-שיח הזו מפורטים הגרסאות הקודמות של הקובץ.
בקשת HTTP
GET https://www.googleapis.com/drive/v2/files/{fileId}/revisions
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
fileId |
מזהה הקובץ. |
פרמטרים של שאילתה
פרמטרים | |
---|---|
maxResults |
המספר המקסימלי של תיקונים שיש להחזיר. |
pageToken |
אסימון דף לתיקונים. כדי לקבל את דף התוצאות הבא, צריך להגדיר את הפרמטר הזה לערך של 'nextPageToken' מהתגובה הקודמת. |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התגובה
רשימת גרסאות קודמות של קובץ.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:
ייצוג JSON |
---|
{
"nextPageToken": string,
"kind": string,
"etag": string,
"selfLink": string,
"items": [
{
object ( |
שדות | |
---|---|
nextPageToken |
אסימון הדף של הדף הבא של הגרסאות הקודמות. שדה זה יהיה חסר אם הגעת לסוף רשימת התיקונים. אם האסימון יידחה מסיבה כלשהי, יש לבטל אותו ולהתחיל את העימוד מחדש מהדף הראשון של תוצאות החיפוש. |
kind |
הערך הוא תמיד |
etag |
ה-ETag של הרשימה. |
selfLink |
קישור בחזרה לרשימה זו. |
items[] |
רשימת הגרסאות הקודמות. אם השדה 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
חלק מההיקפים מוגבלים ומחייבים בדיקת אבטחה כדי שהאפליקציה תוכל להשתמש בהם. למידע נוסף, ניתן לעיין במדריך ההרשאות.