Method: changes.watch

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

בקשת HTTP

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

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

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

פרמטרים
driveId

string

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

boolean

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

boolean

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

boolean

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

boolean

הוצא משימוש: במקומו, צריך להשתמש ב-includeItemsFromAllDrives.
pageSize

integer

מספר השינויים המקסימלי שיוחזרו. יכול להיות שהשירות יחזיר פחות מהערך הזה.

אם לא מציינים ערך, יוחזרו לכל היותר 100 שינויים.

הערך המקסימלי הוא 1,000. ערכים גבוהים יותר יומרו ל-1,000.
pageToken

string

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

boolean

האם להגביל את התוצאות לשינויים בהיררכיה של 'האחסון שלי'. השינויים האלה לא כוללים שינויים בקבצים כמו אלה שבתיקיית נתוני האפליקציה או קבצים משותפים שלא נוספו לתיקיית 'האחסון שלי'.
spaces

string

רשימה מופרדת בפסיקים של מרחבים לחיפוש בתוך מאגרי המידע. הערכים הנתמכים הם drive ו-appDataFolder.
supportsAllDrives

boolean

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

boolean

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

string

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

string

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

string

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

גוף הבקשה

גוף הבקשה מכיל מופע של Channel.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע של Channel.

היקפי הרשאות

נדרש אחד מהיקפי ההרשאות הבאים של 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.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

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