Method: forms.watches.create

Crea un reloj nuevo. Si se proporciona un ID de reloj, este no debe estar en uso. Para cada proyecto de invocación, el límite por formulario es de un objeto de supervisión por Watch.EventType. Un objeto de supervisión vence siete días después de su creación (consulta Watch.expire_time).

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
formId

string

Es obligatorio. Es el ID del formulario que se supervisará.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "watch": {
    object (Watch)
  },
  "watchId": string
}
Campos
watch

object (Watch)

Es obligatorio. El objeto de vigilancia. No se debe establecer ningún ID en este objeto. En su lugar, usa watchId.
watchId

string

Es el ID que se usará para el reloj. Si se especifica, el ID no debe estar en uso. Si no se especifica, se genera un ID. Este valor debe tener entre 4 y 63 caracteres, y los caracteres válidos son /[a-z][0-9]-/.

Cuerpo de la respuesta

Si el proceso se realiza de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada de Watch.

Permisos de autorización

Se necesita uno de los siguientes permisos de 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

Para obtener más información, consulta la Guía de autorización.