Method: files.watch

נרשמת לשינויים בקובץ.

בקשת HTTP

POST https://www.googleapis.com/drive/v3/files/{fileId}/watch

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

פרמטרים של נתיב

פרמטרים
fileId

string

מזהה הקובץ.

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

פרמטרים
supportsAllDrives

boolean

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

boolean

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

boolean

האם המשתמש מאשר את הסיכון בהורדת תוכנה זדונית ידועה או קבצים פוגעניים אחרים. הדבר רלוונטי רק כאשר alt=media.
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

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