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.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly

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