בתיבת הדו-שיח הזו מפורטים השינויים שבוצעו בחשבון של משתמש או באחסון שיתופי.
בקשת HTTP
GET https://www.googleapis.com/drive/v2/changes
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של שאילתה
פרמטרים | |
---|---|
driveId |
האחסון השיתופי שממנו יוחזרו השינויים. אם צוין, מזהי השינויים ישקפו את האחסון השיתופי. צריך להשתמש במזהה האחסון המשולב ולשנות את המזהה כמזהה. |
includeCorpusRemovals |
האם השינויים צריכים לכלול את משאב הקובץ אם הקובץ עדיין נגיש למשתמש בזמן הבקשה, גם אם קובץ הוסר מרשימת השינויים ולא יהיו רשומות שינויים נוספות בקובץ הזה. |
includeDeleted |
האם לכלול שינויים שמציינים שפריטים הוסרו מרשימת השינויים, למשל בעקבות מחיקה או אובדן גישה. |
includeItemsFromAllDrives |
אם הפריטים 'האחסון שלי' וגם פריטים באחסון השיתופי צריכים להיכלל בתוצאות. |
includeSubscribed |
האם לכלול בתוצאה שינויים מחוץ להיררכיה של 'האחסון שלי'. אם המדיניות מוגדרת כ-False, המערכת תתעלם משינויים בקבצים כמו בתיקיית 'נתוני האפליקציה' או בקבצים משותפים שלא נוספו אל 'האחסון שלי'. |
includeTeamDriveItems |
הוצאה משימוש: יש להשתמש במקום זאת ב- |
maxResults |
מספר השינויים המקסימלי להחזרה. |
pageToken |
האסימון להמשך בקשה קודמת לרשימה בדף הבא. יש להגדיר את הערך הזה לערך |
spaces |
רשימה מופרדת בפסיקים של רווחים לשאילתה. הערכים הנתמכים הם |
startChangeId |
הוצאה משימוש: יש להשתמש במקום זאת ב- |
supportsAllDrives |
האם האפליקציה שביקשה תמיכה תומכת גם בתיקייה 'האחסון שלי' וגם בתיקיות אחסון שיתופי. |
supportsTeamDrives |
הוצאה משימוש: יש להשתמש במקום זאת ב- |
teamDriveId |
הוצאה משימוש: יש להשתמש במקום זאת ב- |
includePermissionsForView |
ההגדרה קובעת אילו הרשאות של תצוגות מפורטות נוספות ייכללו בתגובה. יש תמיכה רק ב- |
includeLabels |
רשימה של מזהי התוויות שצריך לכלול בחלק |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התגובה
רשימת שינויים למשתמש.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:
ייצוג JSON |
---|
{
"largestChangeId": string,
"nextPageToken": string,
"kind": string,
"etag": string,
"newStartPageToken": string,
"selfLink": string,
"nextLink": string,
"items": [
{
object ( |
שדות | |
---|---|
largestChangeId |
מזהה השינוי הגדול ביותר הנוכחי. |
nextPageToken |
אסימון הדף של דף השינויים הבא. הערך הזה לא יופיע אם רשימת השינויים כבר לא מלאה. אם האסימון יידחה מסיבה כלשהי, יש לבטל אותו ולהתחיל את העימוד מחדש מהדף הראשון של תוצאות החיפוש. |
kind |
הערך הוא תמיד |
etag |
ה-ETag של הרשימה. |
newStartPageToken |
אסימון דף הפתיחה לשינויים עתידיים. יוצג רק אם הרשימה של השינויים הנוכחית מסתיימת. |
selfLink |
קישור בחזרה לרשימה זו. |
nextLink |
קישור לדף השינויים הבא. |
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.apps.readonly
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
חלק מההיקפים מוגבלים ומחייבים בדיקת אבטחה כדי שהאפליקציה תוכל להשתמש בהם. למידע נוסף, ניתן לעיין במדריך ההרשאות.