Renew an existing watch for seven days. The state
of the watch after renewal is ACTIVE
, and the expireTime
is seven days from the renewal. Renewing a watch in an error state (e.g. SUSPENDED
) succeeds if the error is no longer present, but fail otherwise. After a watch has expired, watches.renew returns NOT_FOUND
.
HTTP request
POST https://forms.googleapis.com/v1beta/forms/{formId}/watches/{watchId}:renew
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters | |
|---|---|
formId
|
Required. The ID of the Form. |
watchId
|
Required. The ID of the Watch to renew. |
Request body
The request body must be empty.
Response body
If successful, the response body contains an instance of Watch
.
Authorization Scopes
Requires one of the following OAuth scopes:
-
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
For more information, see the Authorization guide .

