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' מהתגובה הקודמת או לתגובה משיטת 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.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

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