חידוש של שעון קיים למשך שבעה ימים. state בשעון לאחר החידוש הוא ACTIVE, וה-expireTime יחלוף שבעה ימים ממועד החידוש. חידוש שעון במצב שגיאה (למשל SUSPENDED) יצליח אם השגיאה כבר לא קיימת, אבל ייכשל אחרת. אחרי שתוקף השעון פג, Watch.renew מחזיר NOT_FOUND.
בקשת HTTP
POST https://forms.googleapis.com/v1beta/forms/{formId}/watches/{watchId}:renew
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של נתיב
| פרמטרים | |
|---|---|
formId |
חובה. מזהה הטופס. |
watchId |
חובה. מזהה השעון לחידוש. |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התגובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול מופע של Watch.
היקפי הרשאות
כדי להשתמש בתכונה הזו יש צורך באחד מההיקפים הבאים של OAuth:
https://www.googleapis.com/auth/drivehttps://www.googleapis.com/auth/drive.filehttps://www.googleapis.com/auth/drive.readonlyhttps://www.googleapis.com/auth/forms.bodyhttps://www.googleapis.com/auth/forms.body.readonlyhttps://www.googleapis.com/auth/forms.responses.readonly
למידע נוסף, ניתן לעיין במדריך ההרשאות.