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