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