Method: tasklists.list
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
تمام لیست وظایف کاربر احراز هویت شده را برمی گرداند. یک کاربر می تواند تا 2000 لیست را در یک زمان داشته باشد.
درخواست HTTP
GET https://tasks.googleapis.com/tasks/v1/users/@me/lists
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای پرس و جو
| پارامترها |
|---|
maxResults | integer حداکثر تعداد لیست وظایف در یک صفحه بازگردانده شده است. اختیاری. پیش فرض 1000 است (حداکثر مجاز: 1000). |
pageToken | string نشانه ای که صفحه نتیجه را برای بازگشت مشخص می کند. اختیاری. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
| نمایندگی JSON |
|---|
{
"kind": string,
"etag": string,
"nextPageToken": string,
"items": [
{
object (TaskList)
}
]
} |
| فیلدها |
|---|
kind | string نوع منبع این همیشه "tasks#tasklists" است. |
etag | string ETag منبع |
nextPageToken | string رمزی که می تواند برای درخواست صفحه بعدی این نتیجه استفاده شود. |
items[] | object ( TaskList ) مجموعه ای از لیست وظایف |
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/tasks -
https://www.googleapis.com/auth/tasks.readonly
برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.
لیست وظایف
| نمایندگی JSON |
|---|
{
"kind": string,
"etag": string,
"nextPageToken": string,
"items": [
{
object (TaskList)
}
]
} |
| فیلدها |
|---|
kind | string نوع منبع این همیشه "tasks#tasklists" است. |
etag | string ETag منبع |
nextPageToken | string رمزی که می تواند برای درخواست صفحه بعدی این نتیجه استفاده شود. |
items[] | object ( TaskList ) مجموعه ای از لیست وظایف |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[],[],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. |"]]
