Method: tasks.list

Muestra todas las tareas de la lista de tareas especificada. De forma predeterminada, no devuelve las tareas asignadas (desde Documentos o espacios de Chat). Un usuario puede tener hasta 20,000 tareas no ocultas por lista y hasta 100,000 tareas en total a la vez.

Solicitud HTTP

GET https://tasks.googleapis.com/tasks/v1/lists/{tasklist}/tasks

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

Parámetros de ruta

Parámetros
tasklist

string

Es el identificador de la lista de tareas.

Parámetros de consulta

Parámetros
completedMax

string

Opcional. Es el límite superior de la fecha de finalización de una tarea (como una marca de tiempo RFC 3339) por la que se filtrará. La opción predeterminada es no filtrar por fecha de finalización.

completedMin

string

Opcional. Es el límite inferior de la fecha de finalización de una tarea (como una marca de tiempo RFC 3339) por la que se filtrará. La opción predeterminada es no filtrar por fecha de finalización.

dueMax

string

Opcional. Es el límite superior de la fecha límite de una tarea (como una marca de tiempo RFC 3339) por la que se filtrará. De forma predeterminada, no se filtra por fecha límite.

dueMin

string

Opcional. Es el límite inferior de la fecha límite de una tarea (como una marca de tiempo RFC 3339) por la que se filtrará. La opción predeterminada es no filtrar por fecha límite.

maxResults

integer

Opcional. Es la cantidad máxima de tareas que se devuelven en una página. El valor predeterminado es 20 (máximo permitido: 100).

pageToken

string

Opcional. Es el token que especifica la página de resultados que se devolverá.

showCompleted

boolean

Opcional. Marca que indica si se devuelven las tareas completadas en el resultado. Ten en cuenta que showHidden también debe ser True para mostrar las tareas completadas en clientes propios, como la IU web y las apps para dispositivos móviles de Google. El valor predeterminado es True.

showDeleted

boolean

Opcional. Es una marca que indica si las tareas borradas se devuelven en el resultado. El valor predeterminado es False.

showHidden

boolean

Opcional. Es una marca que indica si se devuelven tareas ocultas en el resultado. El valor predeterminado es False.

updatedMin

string

Opcional. Es el límite inferior de la hora de la última modificación de una tarea (como una marca de tiempo RFC 3339) por la que se filtrará. La opción predeterminada es no filtrar por hora de última modificación.

showAssigned

boolean

Opcional. Es una marca que indica si las tareas asignadas al usuario actual se devuelven en el resultado. El valor predeterminado es False.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Si el proceso es satisfactorio, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación JSON
{
  "kind": string,
  "etag": string,
  "nextPageToken": string,
  "items": [
    {
      object (Task)
    }
  ]
}
Campos
kind

string

Tipo de recurso. Siempre es "tasks#tasks".

etag

string

Es la ETag del recurso.

nextPageToken

string

Es el token que se usa para acceder a la siguiente página de este resultado.

items[]

object (Task)

Colección de tareas.

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

  • https://www.googleapis.com/auth/tasks
  • https://www.googleapis.com/auth/tasks.readonly

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

Tareas

Representación JSON
{
  "kind": string,
  "etag": string,
  "nextPageToken": string,
  "items": [
    {
      object (Task)
    }
  ]
}
Campos
kind

string

Tipo de recurso. Siempre es "tasks#tasks".

etag

string

Es la ETag del recurso.

nextPageToken

string

Es el token que se usa para acceder a la siguiente página de este resultado.

items[]

object (Task)

Colección de tareas.