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 com as respostas a serem listadas.

Parâmetros de consulta

Parâmetros
filter

string

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

timestamp > N

Isso significa que todas as respostas enviadas após (mas não em) N serão recebidas. *

timestamp >= N

Isso significa que todas as respostas enviadas no carimbo de data/hora N e depois dele serão recebidas.

Para os dois filtros compatíveis, o carimbo de data/hora precisa estar formatado no formato "Zulu" UTC RFC3339. 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 for 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 esse campo for definido, o formulário e os valores do filtro precisarão ser iguais aos da solicitação original.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Resposta a um ListFormResponses.

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, há mais respostas. Para acessar a próxima página de respostas, informe 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.