Method: files.watch

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

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

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

פרמטרים
fileId

string

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

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

פרמטרים
supportsAllDrives

boolean

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

boolean

האפשרות הזו הוצאה משימוש. במקום זאת, צריך להשתמש ב-supportsAllDrives.
acknowledgeAbuse

boolean

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

string

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

string

מזהה הגרסה שרוצים להוריד. המערכת תתעלם מהמאפיין הזה, אלא אם צוין alt=media.
updateViewedDate
(deprecated)

boolean

הוצא משימוש: צריך להשתמש ב-files.update עם modifiedDateBehavior=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

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