Method: forms.watches.create

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

בקשת HTTP

POST https://forms.googleapis.com/v1/forms/{formId}/watches

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

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

פרמטרים
formId

string

חובה. המזהה של הטופס שרוצים לצפות בו.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "watch": {
    object (Watch)
  },
  "watchId": string
}
שדות
watch

object (Watch)

חובה. אובייקט השעון. אין להגדיר מזהה באובייקט הזה. במקום זאת, צריך להשתמש ב-watchId.
watchId

string

המזהה שישמש את השעון. אם מציינים מזהה, אסור שהוא כבר יהיה בשימוש. אם לא יצוין מזהה, המערכת תיצור מזהה. הערך צריך להיות באורך של 4 עד 63 תווים, והתווים התקינים הם /[a-z][0-9]-/.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע חדש של Watch.

היקפי הרשאה

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/forms.body
  • https://www.googleapis.com/auth/forms.body.readonly
  • https://www.googleapis.com/auth/forms.responses.readonly

מידע נוסף זמין במדריך ההרשאות.