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

To pole jest wymagane. Identyfikator formularza, którego odpowiedzi należy wyświetlić.

Parametry zapytania

Parametry
filter

string

które odpowiedzi formularza mają być zwracane. Obecnie jedyne obsługiwane filtry to:

timestamp > N

oznacza to, że otrzymujesz wszystkie odpowiedzi przesłane po sygnaturze czasowej N (ale nie później). *

timestamp >= N

oznacza to, że otrzymasz wszystkie odpowiedzi przesłane po sygnaturze czasowej N.

W przypadku obu obsługiwanych filtrów sygnatura czasowa musi być 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ć mniejszą wartość od tej wartości. Jeśli wartość nie jest określona lub wynosi zero, zwracanych jest maksymalnie 5000 odpowiedzi.

pageToken

string

Token strony zwrócony przez poprzednią odpowiedź związaną 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 z formularza. Uwaga: w przypadku żądań listy pole formId nie jest zwracane w obiekcie FormResponse.

nextPageToken

string

Jeśli go skonfigurujesz, pojawi się więcej odpowiedzi. Aby wyświetlić następną stronę odpowiedzi, w kolejnej prośbie podaj tę wartość jako pageToken.

Zakresy autoryzacji

Wymaga jednego z tych zakresów 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 po autoryzacji.