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/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)

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