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.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

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