Method: tasks.list

Muestra todas las tareas de la lista de tareas especificada. No muestra las tareas asignadas como predeterminadas (desde Documentos, 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 de acceso

Parámetros
tasklist

string

Identificador de la lista de tareas.

Parámetros de consulta

Parámetros
completedMax

string

Límite superior de la fecha de finalización de una tarea (como una marca de tiempo RFC 3339) para filtrar. Opcional. La configuración predeterminada no es filtrar por fecha de finalización.

completedMin

string

Límite inferior de la fecha de finalización de una tarea (como una marca de tiempo RFC 3339) para filtrar. Opcional. La configuración predeterminada no es filtrar por fecha de finalización.

dueMax

string

Límite superior de la fecha límite de una tarea (como una marca de tiempo RFC 3339) para filtrar. Opcional. La opción predeterminada es no filtrar por fecha límite.

dueMin

string

Límite inferior de la fecha límite de una tarea (como una marca de tiempo RFC 3339) para filtrar. Opcional. La opción predeterminada es no filtrar por fecha límite.

maxResults

integer

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

pageToken

string

Token que especifica la página de resultados que se mostrará. Opcional.

showCompleted

boolean

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

showDeleted

boolean

Marca que indica si las tareas borradas se muestran en el resultado. Opcional. El valor predeterminado es False.

showHidden

boolean

Marca que indica si las tareas ocultas se muestran en el resultado. Opcional. El valor predeterminado es False.

updatedMin

string

Límite inferior de la hora de la última modificación de una tarea (como una marca de tiempo RFC 3339) para filtrar. Opcional. La configuración predeterminada no es filtrar por la hora de la última modificación.

showAssigned

boolean

Opcional. Marca que indica si las tareas asignadas al usuario actual se muestran en el resultado. Opcional. 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 del recurso. Siempre es "tareas#tareas".

etag

string

ETag del recurso.

nextPageToken

string

Token utilizado para acceder a la siguiente página de este resultado.

items[]

object (Task)

Colección de tareas.

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

Tasks

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

string

Tipo del recurso. Siempre es "tareas#tareas".

etag

string

ETag del recurso.

nextPageToken

string

Token utilizado para acceder a la siguiente página de este resultado.

items[]

object (Task)

Colección de tareas.