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 les réponses doivent être répertoriées.

Paramètres de requête

Paramètres
filter

string

Réponses du formulaire à afficher. Actuellement, les seuls filtres pris en charge sont les suivants:

timestamp > N

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

timestamp >= N

ce qui signifie obtenir toutes les réponses envoyées avec le code temporel N et après.

Pour les deux filtres compatibles, l'horodatage doit respecter le 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 si elle est égale à zéro, un maximum de 5 000 réponses est renvoyé.

pageToken

string

Jeton de page renvoyé par une réponse "list" 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 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 ce champ est défini, il y a davantage 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.