Method: tasklists.list
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Restituisce tutti gli elenchi di attività dell'utente autenticato. Un utente può avere fino a 2000 elenchi alla volta.
Richiesta HTTP
GET https://tasks.googleapis.com/tasks/v1/users/@me/lists
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri di query
| Parametri |
maxResults |
integer
Numero massimo di elenchi di attività restituiti in una pagina. Facoltativo. Il valore predefinito è 1000 (massimo consentito: 1000).
|
pageToken |
string
Token che specifica la pagina dei risultati da restituire. Facoltativo.
|
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
| Rappresentazione JSON |
{
"kind": string,
"etag": string,
"nextPageToken": string,
"items": [
{
object (TaskList)
}
]
} |
| Campi |
kind |
string
Tipo di risorsa. È sempre "tasks#taskLists".
|
etag |
string
ETag della risorsa.
|
nextPageToken |
string
Token che può essere utilizzato per richiedere la pagina successiva di questo risultato.
|
items[] |
object (TaskList)
Raccolta di elenchi di attività.
|
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/taskshttps://www.googleapis.com/auth/tasks.readonly
Per ulteriori informazioni, consulta la Guida all'autorizzazione.
TaskLists
| Rappresentazione JSON |
{
"kind": string,
"etag": string,
"nextPageToken": string,
"items": [
{
object (TaskList)
}
]
} |
| Campi |
kind |
string
Tipo di risorsa. È sempre "tasks#taskLists".
|
etag |
string
ETag della risorsa.
|
nextPageToken |
string
Token che può essere utilizzato per richiedere la pagina successiva di questo risultato.
|
items[] |
object (TaskList)
Raccolta di elenchi di attività.
|
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[null,null,["Ultimo aggiornamento 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. |"]]
