Method: forms.responses.list

Lister les réponses à 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 les réponses sont à répertorier.

Paramètres de requête

Paramètres
filter

string

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

timestamp > N

ce qui signifie que toutes les réponses au formulaire envoyées après le code temporel N (mais pas à) *

timestamp >= N

ce qui signifie qu'il s'agit d'obtenir toutes les réponses envoyées à l'aide du code temporel N et après.

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 aucune valeur n'est spécifiée ou qu'elle n'est pas spécifiée, 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 identiques à ceux de 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 à une 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 du 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 option est définie, il y a plus de réponses. Pour obtenir la page de réponses suivante, indiquez pageToken dans une prochaine requête.

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 relatif aux autorisations.