Method: forms.watches.create

Créer 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 montre. Aucun ID ne doit être défini pour cet objet. Utilisez plutôt watchId.
watchId

string

Identifiant à utiliser pour la montre. S'il est spécifié, il ne doit pas être déjà utilisé. S'il n'est pas spécifié, un ID est généré. Cette valeur doit comporter entre 4 et 63 caractères. 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.