Method: forms.responses.list

Muestra una lista de 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

Es obligatorio. Es el ID del formulario cuyas respuestas se mostrarán en la lista.

Parámetros de consulta

Parámetros
filter

string

Qué respuestas de formulario se mostrarán. Actualmente, los únicos filtros admitidos son los siguientes:

timestamp > N

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

timestamp >= N

lo que significa que se obtienen todas las respuestas del formulario enviadas en la marca de tiempo N y después de ella.

Para ambos filtros admitidos, la marca de tiempo debe tener el formato RFC3339 UTC “Zulu”. Ejemplos: “2014-10-02T15:01:23Z” y “2014-10-02T15:01:23.045123456Z”.

pageSize

integer

Es la cantidad máxima de respuestas que se mostrarán. El servicio puede mostrar menos que este valor. Si no se especifica o se define en cero, se devuelven 5,000 respuestas como máximo.

pageToken

string

Es un token de página que muestra una respuesta de lista anterior. Si se establece este campo, el formulario y los valores del filtro deben ser los mismos que los de 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 se establece, hay más respuestas. Para obtener la siguiente página de respuestas, proporciona esto como pageToken en una solicitud futura.

Permisos 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.