בתיבת הדו-שיח הזו מפורטים השינויים שבוצעו בחשבון של משתמש או באחסון שיתופי.
בקשת HTTP
GET https://www.googleapis.com/drive/v3/changes
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של שאילתה
פרמטרים | |
---|---|
driveId |
האחסון השיתופי שממנו יוחזרו השינויים. אם צוין, מזהי השינויים ישקפו את האחסון השיתופי. צריך להשתמש במזהה האחסון המשולב ולשנות את המזהה כמזהה. |
includeCorpusRemovals |
האם השינויים צריכים לכלול את משאב הקובץ אם הקובץ עדיין נגיש למשתמש בזמן הבקשה, גם אם קובץ הוסר מרשימת השינויים ולא יהיו רשומות שינויים נוספות בקובץ הזה. |
includeItemsFromAllDrives |
אם הפריטים 'האחסון שלי' וגם פריטים באחסון השיתופי צריכים להיכלל בתוצאות. |
includeRemoved |
האם לכלול שינויים שמציינים שפריטים הוסרו מרשימת השינויים, למשל בעקבות מחיקה או אובדן גישה. |
includeTeamDriveItems |
הוצאה משימוש: יש להשתמש במקום זאת ב- |
pageSize |
מספר השינויים המקסימלי שיחזרו בכל דף. |
pageToken |
האסימון להמשך בקשה קודמת לרשימה בדף הבא. צריך להגדיר את הערך הזה לערך 'nextPageToken' מהתגובה הקודמת או לתגובה מ-method getStartPageToken. |
restrictToMyDrive |
האם להגביל את התוצאות לשינויים בתוך ההיררכיה של 'האחסון שלי'. הפעולה הזו תשמיט שינויים בקבצים כמו אלה שבתיקיית נתוני האפליקציה או בקבצים משותפים שלא נוספו אל 'האחסון שלי'. |
spaces |
רשימה מופרדת בפסיקים של רווחים לשאילתה בתוך הקובץ. הערכים הנתמכים הם 'drive' ו-'appDataFolder'. |
supportsAllDrives |
האם האפליקציה שביקשה תמיכה תומכת גם בתיקייה 'האחסון שלי' וגם בתיקיות אחסון שיתופי. |
supportsTeamDrives |
הוצאה משימוש: יש להשתמש במקום זאת ב- |
teamDriveId |
הוצאה משימוש: יש להשתמש במקום זאת ב- |
includePermissionsForView |
ההגדרה קובעת אילו הרשאות של תצוגות מפורטות נוספות ייכללו בתגובה. רק הערך 'פורסם' נתמך. |
includeLabels |
רשימה של מזהי התוויות שצריך לכלול בחלק |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התגובה
רשימת שינויים למשתמש.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:
ייצוג JSON |
---|
{
"kind": string,
"nextPageToken": string,
"newStartPageToken": string,
"changes": [
{
object ( |
שדות | |
---|---|
kind |
מזהה את סוג המשאב הזה. ערך: המחרוזת הקבועה |
nextPageToken |
אסימון הדף של דף השינויים הבא. הערך הזה לא יופיע אם רשימת השינויים כבר לא מלאה. התוקף של אסימון הדף לא פג. |
newStartPageToken |
אסימון דף הפתיחה לשינויים עתידיים. יוצג רק אם הרשימה של השינויים הנוכחית מסתיימת. התוקף של אסימון הדף לא פג. |
changes[] |
רשימת השינויים. אם השדה 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
חלק מההיקפים מוגבלים ומחייבים בדיקת אבטחה כדי שהאפליקציה תוכל להשתמש בהם. למידע נוסף, ניתן לעיין במדריך ההרשאות.