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