Method: forms.watches.create

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

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת 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

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