Method: tasklists.list
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Gibt alle Aufgabenlisten des authentifizierten Nutzers zurück. Ein Nutzer kann bis zu 2.000 Listen gleichzeitig haben.
HTTP-Anfrage
GET https://tasks.googleapis.com/tasks/v1/users/@me/lists
Die URL verwendet die Syntax der gRPC-Transcodierung.
Abfrageparameter
Parameter |
maxResults |
integer
Maximale Anzahl von Aufgabenlisten, die auf einer Seite zurückgegeben werden. Optional. Der Standardwert ist 1.000 (maximal zulässig: 1.000).
|
pageToken |
string
Token, das die zurückzugebende Ergebnisseite angibt. Optional.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:
JSON-Darstellung |
{
"kind": string,
"etag": string,
"nextPageToken": string,
"items": [
{
object (TaskList )
}
]
} |
Felder |
kind |
string
Der Typ der Ressource. Dies ist immer „tasks#taskLists“.
|
etag |
string
ETag der Ressource.
|
nextPageToken |
string
Token, mit dem die nächste Seite dieses Ergebnisses angefordert werden kann.
|
items[] |
object (TaskList )
Sammlung von Aufgabenlisten.
|
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/tasks
https://www.googleapis.com/auth/tasks.readonly
Weitere Informationen finden Sie im Leitfaden zur Autorisierung.
TaskLists
JSON-Darstellung |
{
"kind": string,
"etag": string,
"nextPageToken": string,
"items": [
{
object (TaskList )
}
]
} |
Felder |
kind |
string
Der Typ der Ressource. Dies ist immer „tasks#taskLists“.
|
etag |
string
ETag der Ressource.
|
nextPageToken |
string
Token, mit dem die nächste Seite dieses Ergebnisses angefordert werden kann.
|
items[] |
object (TaskList )
Sammlung von Aufgabenlisten.
|
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 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. |"]]