Method: files.watch

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

בקשת HTTP

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

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

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

פרמטרים
fileId

string

המזהה של הקובץ הרלוונטי.

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

פרמטרים
supportsAllDrives

boolean

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

supportsTeamDrives
(deprecated)

boolean

הוצא משימוש: במקומו צריך להשתמש ברכיב supportsAllDrives.

acknowledgeAbuse

boolean

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

includePermissionsForView

string

מציינת אילו הרשאות תצוגה נוספות לכלול בתשובה. יש תמיכה רק ב-published.

revisionId

string

מציינת את מזהה הגרסה שרוצים להוריד. המערכת תתעלם, אלא אם צוין Alt=media.

updateViewedDate
(deprecated)

boolean

הוצא משימוש: יש להשתמש ב-file.update עם changedDateBehavior=noChange, updateViewedDate=true וגוף בקשה ריק.

projection
(deprecated)

enum (Projection)

הוצא משימוש: לפרמטר הזה אין פונקציה.

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

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