Method: forms.responses.list

Liste as respostas de um formulário.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
formId

string

Obrigatório. ID do formulário com as respostas a serem listadas.

Parâmetros de consulta

Parâmetros
filter

string

Quais respostas do formulário devem ser retornadas. No momento, os únicos filtros compatíveis são:

timestamp > N

que significa receber todas as respostas do formulário enviadas depois (mas não no) do carimbo de data/hora N. *

timestamp >= N

que significa receber todas as respostas do formulário enviadas no carimbo de data/hora N e depois.

Para os dois filtros compatíveis, o carimbo de data/hora precisa estar no formato RFC3339 UTC "Zulu". Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
pageSize

integer

O número máximo de respostas a serem retornadas. O serviço pode retornar menos que esse valor. Se não for especificado ou zero, no máximo 5.000 respostas serão retornadas.
pageToken

string

Um token de página retornado por uma resposta de lista anterior. Se este campo estiver definido, o formulário e os valores do filtro precisarão ser os mesmos da solicitação original.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Resposta para um ListFormResponsesRequest.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "responses": [
    {
      object (FormResponse)
    }
  ],
  "nextPageToken": string
}
Campos
responses[]

object (FormResponse)

As respostas do formulário retornadas. Observação: o campo formId não é retornado no objeto FormResponse para solicitações de lista.
nextPageToken

string

Se definido, haverá mais respostas. Para ver a próxima página de respostas, forneça-a como pageToken em uma solicitação futura.

Escopos de autorização

Requer um dos seguintes escopos de OAuth:

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

Para mais informações, consulte o Guia de autorização.