Method: forms.watches.renew

חידוש של שעון קיים למשך שבעה ימים. state בשעון לאחר החידוש הוא ACTIVE, וה-expireTime יחלוף שבעה ימים ממועד החידוש. חידוש שעון במצב שגיאה (למשל SUSPENDED) יצליח אם השגיאה כבר לא קיימת, אבל ייכשל אחרת. אחרי שתוקף השעון פג, Watch.renew מחזיר NOT_FOUND.

בקשת HTTP

POST https://forms.googleapis.com/v1/forms/{formId}/watches/{watchId}:renew

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

פרמטרים של נתיב

פרמטרים
formId

string

חובה. מזהה הטופס.

watchId

string

חובה. מזהה השעון לחידוש.

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התגובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול מופע של 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

למידע נוסף, ניתן לעיין במדריך ההרשאות.