Method: forms.responses.list

Formularantworten auflisten.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
formId

string

Erforderlich. ID des Formulars, dessen Antworten aufgelistet werden sollen

Abfrageparameter

Parameter
filter

string

Welche Formularantworten zurückgegeben werden sollen. Derzeit werden nur folgende Filter unterstützt:

timestamp > N

Das bedeutet, dass alle Formularantworten nach (aber nicht zum) Zeitstempel N gesendet werden. *

timestamp >= N

Das bedeutet, dass alle Formularantworten am und nach dem Zeitstempel N gesendet werden.

Für beide unterstützten Filter muss der Zeitstempel im Format RFC3339 UTC „Zulu“ formatiert sein. Beispiele: „2014-10-02T15:01:23Z“ und „2014-10-02T15:01:23.045123456Z“.
pageSize

integer

Die maximale Anzahl von Antworten, die zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn sie nicht angegeben oder null ist, werden höchstens 5.000 Antworten zurückgegeben.
pageToken

string

Ein Seitentoken, das von einer vorherigen Listenantwort zurückgegeben wurde. Wenn dieses Feld festgelegt ist, müssen das Formular und die Werte des Filters mit denen der ursprünglichen Anfrage übereinstimmen.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwort auf eine ListFormResponsesRequest

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "responses": [
    {
      object (FormResponse)
    }
  ],
  "nextPageToken": string
}
Felder
responses[]

object (FormResponse)

Die zurückgegebenen Formularantworten. Hinweis: Das Feld formId wird für Listenanfragen im Objekt FormResponse nicht zurückgegeben.
nextPageToken

string

Wenn festgelegt, sind mehr Antworten vorhanden. Wenn Sie die nächste Seite mit Antworten erhalten möchten, geben Sie dies in einer zukünftigen Anfrage als pageToken an.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/forms.responses.readonly

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.