Method: forms.responses.list

Antworten auf ein Formular 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 die folgenden Filter unterstützt:

timestamp > N

Das bedeutet, dass alle Formularantworten ab dem Zeitstempel N abgerufen werden. *

timestamp >= N

Das bedeutet, dass alle Formularantworten ab dem Zeitstempel N abgerufen werden.

Bei beiden unterstützten Filtern 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 der Antworten, die zurückgegeben werden sollen. 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 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 bei Listenanfragen nicht im FormResponse-Objekt zurückgegeben.
nextPageToken

string

Wenn dieser Wert festgelegt ist, gibt es weitere Antworten. Wenn Sie die nächste Seite mit Antworten abrufen möchten, geben Sie diesen Wert 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.