Method: forms.responses.list

Lister les réponses d'un formulaire

Requête HTTP

GET https://forms.googleapis.com/v1/forms/{formId}/responses

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
formId

string

Obligatoire. ID du formulaire dont vous souhaitez lister les réponses.

Paramètres de requête

Paramètres
filter

string

Réponses au formulaire à renvoyer. Actuellement, seuls les filtres suivants sont acceptés:

timestamp > N

ce qui signifie que vous devez obtenir toutes les réponses envoyées après (mais pas à) l'horodatage N. *

timestamp >= N

ce qui signifie que vous devez obtenir toutes les réponses envoyées au moment du code temporel N et après celui-ci.

Pour les deux filtres compatibles, l'horodatage doit être au format RFC3339 UTC "Zulu". Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
pageSize

integer

Nombre maximal de réponses à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si ce paramètre n'est pas spécifié ou est défini sur zéro, 5 000 réponses au maximum sont renvoyées.
pageToken

string

Jeton de page renvoyé par une réponse de liste précédente. Si ce champ est défini, le formulaire et les valeurs du filtre doivent être les mêmes que pour la requête d'origine.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Réponse pour ListFormResponsesRequest.

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

Représentation JSON 
{
  "responses": [
    {
      object (FormResponse)
    }
  ],
  "nextPageToken": string
}
Champs
responses[]

object (FormResponse)

Réponses au formulaire renvoyées. Remarque: Le champ formId n'est pas renvoyé dans l'objet FormResponse pour les requêtes de liste.
nextPageToken

string

Si cette valeur est définie, il y a plus de réponses. Pour obtenir la page de réponses suivante, indiquez-le en tant que pageToken dans une requête ultérieure.

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.responses.readonly

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