Method: tasks.list

Muestra todas las tareas de la lista de tareas especificada. No muestra las tareas asignadas de forma predeterminada (desde Documentos y 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

Es el 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 es no 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 es no 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 configuració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 configuració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

Es un token que especifica la página de resultados que se mostrará. Opcional.
showCompleted

boolean

Marca que indica si se muestran tareas completadas en el resultado. Ten en cuenta que showHidden también debe ser verdadero para mostrar las 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 se muestran las tareas borradas en el resultado. Opcional. El valor predeterminado es False.
showHidden

boolean

Marca que indica si se muestran tareas ocultas 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 opción predeterminada es no filtrar por hora de ú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

Es el tipo de recurso. Siempre es "tasks#tasks".
etag

string

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.

Tasks

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

string

Es el tipo de recurso. Siempre es "tasks#tasks".
etag

string

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.