Method: forms.watches.create

Créez une montre. Si un ID de montre est fourni, il ne doit pas être utilisé. Pour chaque projet appelant, la limite par formulaire est d'une surveillance par Watch.EventType. Une montre expire sept jours après sa création (voir Watch.expire_time).

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
formId

string

Obligatoire. ID du formulaire à surveiller.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON
{
  "watch": {
    object (Watch)
  },
  "watchId": string
}
Champs
watch

object (Watch)

Obligatoire. Objet watch Aucun identifiant ne doit être défini pour cet objet. utilisez plutôt watchId.

watchId

string

ID à utiliser pour la montre. S'il est spécifié, l'ID ne doit pas déjà être utilisé. S'il n'est pas spécifié, un ID est généré. Cette valeur doit contenir entre 4 et 63 caractères, et les caractères valides sont /[a-z][0-9]-/.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une nouvelle instance de Watch.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • 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

Pour en savoir plus, consultez le Guide relatif aux autorisations.