Method: changes.watch

הרשמה לקבלת עדכונים לגבי משתמש.

בקשת HTTP

POST https://www.googleapis.com/drive/v2/changes/watch

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

פרמטרים של שאילתה

פרמטרים
driveId

string

האחסון השיתופי שממנו יוחזרו השינויים. אם ציינתם את מזהי השינויים, הם ישקפו את האחסון השיתופי. צריך להשתמש במזהה האחסון המשולב ולשנות את המזהה בתור מזהה.
includeCorpusRemovals

boolean

האם השינויים צריכים לכלול את משאב הקובץ אם המשתמש עדיין יכול לגשת לקובץ בזמן הבקשה, גם אם קובץ הוסר מרשימת השינויים ולא יהיו רשומות שינויים נוספות בקובץ הזה.
includeDeleted

boolean

האם לכלול שינויים שמעידים על כך שפריטים הוסרו מרשימת השינויים, לדוגמה מחיקה או אובדן גישה.
includeItemsFromAllDrives

boolean

אם צריך לכלול בתוצאות גם פריטים בתיקייה 'האחסון שלי' וגם פריטים באחסון השיתופי.
includeSubscribed

boolean

האם לכלול בתוצאה שינויים מחוץ להיררכיה של 'האחסון שלי'. אם המדיניות מוגדרת כ-False, שינויים בקבצים כמו אלה שבתיקייה 'נתוני אפליקציות' או קבצים משותפים שלא נוספו אל 'האחסון שלי' יוסרו מהתוצאה.
includeTeamDriveItems
(deprecated)

boolean

הוצא משימוש: במקומו צריך להשתמש ברכיב includeItemsFromAllDrives.
maxResults

integer

מספר השינויים המקסימלי שיש להחזיר.
pageToken

string

האסימון להמשך בקשת רשימה קודמת בדף הבא. צריך להגדיר אותו לערך של nextPageToken מהתגובה הקודמת או לתשובה מהשיטה getStartPageToken.
spaces

string

רשימה מופרדת בפסיקים של רווחים לשאילתה. הערכים הנתמכים הם drive, appDataFolder ו-photos.
startChangeId
(deprecated)

string (int64 format)

הוצא משימוש: במקומו צריך להשתמש ברכיב pageToken.
supportsAllDrives

boolean

האם האפליקציה ששלחה את הבקשה תומכת גם בתיקייה 'האחסון שלי' וגם בתיקיות אחסון שיתופי.
supportsTeamDrives
(deprecated)

boolean

הוצא משימוש: במקומו צריך להשתמש ברכיב supportsAllDrives.
teamDriveId
(deprecated)

string

הוצא משימוש: במקומו צריך להשתמש ברכיב driveId.
includePermissionsForView

string

מציינת אילו הרשאות תצוגה נוספות לכלול בתשובה. יש תמיכה רק ב-published.
includeLabels

string

רשימה מופרדת בפסיקים של מזהים של תוויות שיש לכלול בחלק labelInfo של התשובה.

גוף הבקשה

גוף הבקשה מכיל מופע של 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.meet.readonly
  • 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

חלק מההיקפים מוגבלים וצריך לבצע בדיקת אבטחה כדי להשתמש בהם באפליקציה. מידע נוסף זמין במדריך להרשאות.