Method: forms.setPublishSettings

Met à jour les paramètres de publication d'un formulaire.

Les anciens formulaires ne sont pas acceptés, car ils ne comportent pas le champ publishSettings.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
formId

string

Obligatoire. ID du formulaire. Vous pouvez obtenir l'ID à partir du champ Form.form_id.

Corps de la requête

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

Représentation JSON 
{
  "publishSettings": {
    object (PublishSettings)
  },
  "updateMask": string
}
Champs
publishSettings

object (PublishSettings)

Obligatoire. Paramètres de publication souhaités à appliquer au formulaire.
updateMask

string (FieldMask format)

Facultatif. Champs publishSettings à mettre à jour. Ce masque de champ accepte les valeurs suivantes:

  • publishState: met à jour ou remplace tous les paramètres publishState.
  • "*": met à jour ou remplace tous les champs publishSettings.

Il s'agit d'une liste de noms de champs complets séparés par une virgule. Exemple : "user.displayName,photo"

Corps de la réponse

Réponse d'une requête forms.setPublishSettings.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "formId": string,
  "publishSettings": {
    object (PublishSettings)
  }
}
Champs
formId

string

Obligatoire. ID du formulaire. Cette valeur est identique à celle du champ Form.form_id.
publishSettings

object (PublishSettings)

Paramètres de publication du formulaire.

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/forms.body

Pour en savoir plus, consultez le guide d'autorisation.