Method: forms.responses.list

Listar 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 cujas respostas serão listadas.

Parâmetros de consulta

Parâmetros
filter

string

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

timestamp > N

o que significa receber todas as respostas do formulário enviadas após o carimbo de data/hora N, mas não até ele. *

timestamp >= N

o 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 especificado ou zero, no máximo 5.000 respostas são retornadas.

pageToken

string

Um token de página retornado por uma resposta de lista anterior. Se esse 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 a 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 retornadas do formulário. Observação: o campo formId não é retornado no objeto FormResponse para solicitações de lista.

nextPageToken

string

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

Escopos de autorização

Requer um dos seguintes escopos do 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.