Method: forms.responses.list

Hiermit listen Sie die Antworten eines Formulars auf.

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 abgerufen werden, die nach dem Zeitstempel N gesendet wurden, jedoch nicht um diesen Zeitstempel. *

timestamp >= N

Das bedeutet, dass alle Formularantworten erfasst werden, die mit dem Zeitstempel N und danach gesendet wurden.

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

integer

Die maximale Anzahl der zurückzugebenden Antworten. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben oder null, werden maximal 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 dem der ursprünglichen Anfrage entsprechen.

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 bei Listenanfragen nicht im Objekt FormResponse zurückgegeben.
nextPageToken

string

Wenn festgelegt, sind weitere Antworten vorhanden. Geben Sie diese in einer zukünftigen Anfrage als pageToken an, um zur nächsten Seite mit Antworten zu gelangen.

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.