Method: forms.responses.list

Enumera las respuestas de un formulario.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
formId

string

Obligatorio. ID del formulario cuyas respuestas a la lista.

Parámetros de consulta

Parámetros
filter

string

Qué respuestas del formulario se deben mostrar. Actualmente, los únicos filtros admitidos son los siguientes:

timestamp > N

lo que significa que se deben obtener todas las respuestas del formulario enviadas después (pero no en la) marca de tiempo N. *

timestamp >= N

lo que significa que se deben obtener todas las respuestas del formulario enviadas a partir de la marca de tiempo N.

Para ambos filtros compatibles, la marca de tiempo debe tener el formato RFC3339 UTC “Zulú” de un conjunto de datos tengan un formato común. Ejemplos: “2014-10-02T15:01:23Z” y “2014-10-02T15:01:23.045123456Z”.

pageSize

integer

La cantidad máxima de respuestas que se mostrarán. El servicio puede mostrar menos que este valor. Si no se especifica o si son cero, se muestran 5,000 respuestas como máximo.

pageToken

string

Un token de página que muestra una respuesta de lista anterior. Si se configura este campo, el formulario y los valores del filtro deben ser los mismos que para la solicitud original.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Respuesta a una ListFormResponsesRequest.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON
{
  "responses": [
    {
      object (FormResponse)
    }
  ],
  "nextPageToken": string
}
Campos
responses[]

object (FormResponse)

Las respuestas del formulario que se muestran. Nota: El campo formId no se muestra en el objeto FormResponse para las solicitudes de lista.

nextPageToken

string

Si la estableces, habrá más respuestas. Para obtener la siguiente página de respuestas, proporciona esto como pageToken en una solicitud futura.

Alcances de autorización

Se necesita uno de los siguientes permisos de OAuth:

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

Para obtener más información, consulta la Guía de autorización.