Method: changes.watch

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

בקשת HTTP

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

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

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

פרמטרים
driveId

string

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

boolean

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

boolean

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

boolean

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

boolean

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

integer

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

string

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

boolean

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

string

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

boolean

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

boolean

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

string

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

string

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

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