הרשמה לשינויים של משתמש מסוים.
בקשת HTTP
POST https://www.googleapis.com/drive/v2/changes/watch
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של שאילתה
פרמטרים | |
---|---|
driveId |
האחסון השיתופי שממנו יוחזרו השינויים. אם צוין, מזהי השינויים ישקפו את האחסון השיתופי. צריך להשתמש במזהה האחסון המשולב ולשנות את המזהה כמזהה. |
includeCorpusRemovals |
האם השינויים צריכים לכלול את משאב הקובץ אם הקובץ עדיין נגיש למשתמש בזמן הבקשה, גם אם קובץ הוסר מרשימת השינויים ולא יהיו רשומות שינויים נוספות בקובץ הזה. |
includeDeleted |
האם לכלול שינויים שמציינים שפריטים הוסרו מרשימת השינויים, למשל בעקבות מחיקה או אובדן גישה. |
includeItemsFromAllDrives |
אם הפריטים 'האחסון שלי' וגם פריטים באחסון השיתופי צריכים להיכלל בתוצאות. |
includeSubscribed |
האם לכלול בתוצאה שינויים מחוץ להיררכיה של 'האחסון שלי'. אם המדיניות מוגדרת כ-False, המערכת תתעלם משינויים בקבצים כמו בתיקיית 'נתוני האפליקציה' או בקבצים משותפים שלא נוספו אל 'האחסון שלי'. |
includeTeamDriveItems |
הוצאה משימוש: יש להשתמש במקום זאת ב- |
maxResults |
מספר השינויים המקסימלי להחזרה. |
pageToken |
האסימון להמשך בקשה קודמת לרשימה בדף הבא. יש להגדיר את הערך הזה לערך |
spaces |
רשימה מופרדת בפסיקים של רווחים לשאילתה. הערכים הנתמכים הם |
startChangeId |
הוצאה משימוש: יש להשתמש במקום זאת ב- |
supportsAllDrives |
האם האפליקציה שביקשה תמיכה תומכת גם בתיקייה 'האחסון שלי' וגם בתיקיות אחסון שיתופי. |
supportsTeamDrives |
הוצאה משימוש: יש להשתמש במקום זאת ב- |
teamDriveId |
הוצאה משימוש: יש להשתמש במקום זאת ב- |
includePermissionsForView |
ההגדרה קובעת אילו הרשאות של תצוגות מפורטות נוספות ייכללו בתגובה. יש תמיכה רק ב- |
includeLabels |
רשימה של מזהי התוויות שצריך לכלול בחלק |
גוף הבקשה
גוף הבקשה מכיל מופע של Channel
.
גוף התגובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול מופע של Channel
.
היקפי הרשאות
כדי להשתמש בתכונה הזו יש צורך באחד מההיקפים הבאים של 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
חלק מההיקפים מוגבלים ומחייבים בדיקת אבטחה כדי שהאפליקציה תוכל להשתמש בהם. למידע נוסף, ניתן לעיין במדריך ההרשאות.