Method: tasklists.list
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Muestra todas las listas de tareas del usuario autenticado. Un usuario puede tener hasta 2,000 listas a la vez.
Solicitud HTTP
GET https://tasks.googleapis.com/tasks/v1/users/@me/lists
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de consulta
| Parámetros |
maxResults |
integer
Es la cantidad máxima de listas de tareas que se muestran en una página. Opcional. El valor predeterminado es 1,000 (máximo permitido: 1,000).
|
pageToken |
string
Es un token que especifica la página de resultados que se mostrará. Opcional.
|
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 (TaskList)
}
]
} |
| Campos |
kind |
string
Es el tipo de recurso. Siempre es "tasks#taskLists".
|
etag |
string
ETag del recurso.
|
nextPageToken |
string
Es un token que se puede usar para solicitar la siguiente página de este resultado.
|
items[] |
object (TaskList)
Es una colección de listas de tareas.
|
Permisos de autorización
Se necesita uno de los siguientes permisos de OAuth:
https://www.googleapis.com/auth/taskshttps://www.googleapis.com/auth/tasks.readonly
Para obtener más información, consulta la Guía de autorización.
TaskLists
| Representación JSON |
{
"kind": string,
"etag": string,
"nextPageToken": string,
"items": [
{
object (TaskList)
}
]
} |
| Campos |
kind |
string
Es el tipo de recurso. Siempre es "tasks#taskLists".
|
etag |
string
ETag del recurso.
|
nextPageToken |
string
Es un token que se puede usar para solicitar la siguiente página de este resultado.
|
items[] |
object (TaskList)
Es una colección de listas de tareas.
|
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-25 (UTC)
[null,null,["Última actualización: 2025-07-25 (UTC)"],[],[],null,["# Method: tasklists.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.TaskLists.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [TaskLists](#TaskLists)\n - [JSON representation](#TaskLists.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nReturns all the authenticated user's task lists. A user can have up to 2000 lists at a time.\n\n### HTTP request\n\n`GET https://tasks.googleapis.com/tasks/v1/users/@me/lists`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|--------------|-----------------------------------------------------------------------------------------------------------------|\n| `maxResults` | `integer` Maximum number of task lists returned on one page. Optional. The default is 1000 (max allowed: 1000). |\n| `pageToken` | `string` Token specifying the result page to return. Optional. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"etag\": string, \"nextPageToken\": string, \"items\": [ { object (/workspace/tasks/reference/rest/v1/tasklists#TaskList) } ] } ``` |\n\n| Fields ||\n|-----------------|----------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Type of the resource. This is always \"tasks#taskLists\". |\n| `etag` | `string` ETag of the resource. |\n| `nextPageToken` | `string` Token that can be used to request the next page of this result. |\n| `items[]` | `object (`[TaskList](/workspace/tasks/reference/rest/v1/tasklists#TaskList)`)` Collection of task lists. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/tasks`\n- `https://www.googleapis.com/auth/tasks.readonly`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent).\n\nTaskLists\n---------\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"etag\": string, \"nextPageToken\": string, \"items\": [ { object (/workspace/tasks/reference/rest/v1/tasklists#TaskList) } ] } ``` |\n\n| Fields ||\n|-----------------|----------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Type of the resource. This is always \"tasks#taskLists\". |\n| `etag` | `string` ETag of the resource. |\n| `nextPageToken` | `string` Token that can be used to request the next page of this result. |\n| `items[]` | `object (`[TaskList](/workspace/tasks/reference/rest/v1/tasklists#TaskList)`)` Collection of task lists. |"]]
