Method: tasklists.list
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
عرض جميع قوائم المهام للمستخدم الذي تم مصادقة بياناته يمكن للمستخدم إنشاء ما يصل إلى 2,000 قائمة في الوقت نفسه.
طلب HTTP
GET https://tasks.googleapis.com/tasks/v1/users/@me/lists
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات طلب البحث
| المعلمات |
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/taskshttps://www.googleapis.com/auth/tasks.readonly
لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.
TaskLists
| تمثيل 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 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة 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. |"]]
