Method: changes.watch

נרשם כמנוי לשינויים של משתמש.

בקשת HTTP

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

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

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

פרמטרים
driveId

string

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

includeCorpusRemovals

boolean

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

includeItemsFromAllDrives

boolean

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

includeRemoved

boolean

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

includeTeamDriveItems
(deprecated)

boolean

הוצאה משימוש: יש להשתמש במקום זאת ב-includeItemsFromAllDrives.

pageSize

integer

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

pageToken

string

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

restrictToMyDrive

boolean

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

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

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