יצירת שעון חדש. אם מציינים מזהה שעון, צריך לוודא שהוא לא בשימוש. לכל פרויקט שמוגדר בו אתחול, המגבלה לכל טופס היא צפייה אחת לכל Watch.EventType
. התוקף של שעון פג שבעה ימים לאחר יצירתו (מידע נוסף ב-Watch.expire_time
).
בקשת HTTP
POST https://forms.googleapis.com/v1/forms/{formId}/watches
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
formId |
חובה. המזהה של הטופס לצפייה. |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{
"watch": {
object ( |
שדות | |
---|---|
watch |
חובה. אובייקט השעון. אין להגדיר מזהה לאובייקט הזה. במקומו צריך להשתמש ברכיב |
watchId |
המזהה לשימוש בשעון. אם צוין, המזהה לא יכול להיות כבר בשימוש. אם לא מציינים שום אפשרות, נוצר מזהה. הערך צריך להיות באורך 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
למידע נוסף, ניתן לעיין במדריך ההרשאות.