Method: forms.responses.list

Wyświetlanie listy odpowiedzi formularza.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
formId

string

Wymagane. Identyfikator formularza, którego odpowiedzi mają być wyświetlane.

Parametry zapytania

Parametry
filter

string

Które odpowiedzi z formularza zwracać. Obecnie obsługiwane są tylko te filtry:

timestamp > N

Oznacza to, że wszystkie odpowiedzi na pytania przesłane po sygnaturze czasowej N będą przesłane (ale nie w tym momencie). *

timestamp >= N

Oznacza to, że wszystkie odpowiedzi na pytania z formularza zostały przesłane z sygnaturą czasową N i po niej.

W przypadku obu obsługiwanych filtrów sygnatura czasowa musi być sformatowana w formacie RFC3339 UTC „Zulu” . Przykłady: „2014-10-02T15:01:23Z” i „2014-10-02T15:01:23.045123456Z”.

pageSize

integer

Maksymalna liczba odpowiedzi do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli wartość nie jest określona lub wynosi zero, zwracanych jest maksymalnie 5000 odpowiedzi.

pageToken

string

Token strony zwrócony przez poprzednią odpowiedź z listą. Jeśli to pole jest ustawione, formularz i wartości filtra muszą być takie same jak w pierwotnym żądaniu.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź na żądanie ListFormResponsesRequest.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON
{
  "responses": [
    {
      object (FormResponse)
    }
  ],
  "nextPageToken": string
}
Pola
responses[]

object (FormResponse)

zwrócone odpowiedzi na pytania z formularza. Uwaga: pole formId nie jest zwracane w obiekcie FormResponse w przypadku żądań list.

nextPageToken

string

Jeśli jest skonfigurowana, będzie dostępnych więcej odpowiedzi. Aby wyświetlić następną stronę odpowiedzi, podaj w przyszłej prośbie ten adres jako pageToken.

Zakresy autoryzacji

Wymaga jednego z tych zakresów protokołu OAuth:

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

Więcej informacji znajdziesz w przewodniku na temat autoryzacji.