Method: tasklists.list

عرض جميع قوائم المهام الخاصة بالمستخدم الذي تم مصادقة بياناته يمكن للمستخدم إنشاء ما يصل إلى 2,000 قائمة في الوقت نفسه.

طلب HTTP

GET https://tasks.googleapis.com/tasks/v1/users/@me/lists

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات طلب البحث

المعلمات
maxResults

integer

الحد الأقصى لعدد قوائم المهام التي يتم عرضها في صفحة واحدة اختيارية: الإعداد التلقائي هو 20 (الحد الأقصى المسموح به: 100).

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

لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.

TaskLists

تمثيل JSON
{
  "kind": string,
  "etag": string,
  "nextPageToken": string,
  "items": [
    {
      object (TaskList)
    }
  ]
}
الحقول
kind

string

نوع المورد تكون هذه القيمة دائمًا "tasks#taskLists".

etag

string

علامة ETag للمورد

nextPageToken

string

رمز مميّز يمكن استخدامه لطلب الصفحة التالية من هذه النتيجة.

items[]

object (TaskList)

مجموعة من قوائم المهام