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