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

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