Method: changes.watch

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

בקשת HTTP

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

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

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

פרמטרים
driveId

string

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

boolean

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

boolean

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

boolean

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

boolean

האם לכלול בתוצאה שינויים מחוץ להיררכיה של 'האחסון שלי'. כשהערך מוגדר כ-false, שינויים בקבצים כמו קבצים בתיקיית Application Data או קבצים משותפים שלא נוספו לתיקיית 'האחסון שלי' לא ייכללו בתוצאה.
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

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