Method: tasks.list

تعرِض جميع المهام في قائمة المهام المحدّدة. لا تعرض تلقائيًا المهام المُسنَدة (من "مستندات Google" ومساحات Chat). يمكن أن يكون لدى المستخدم ما يصل إلى 20,000 مهمة غير مخفية في كل قائمة وما يصل إلى 100,000 مهمة إجمالاً في المرة الواحدة.

طلب HTTP

GET https://tasks.googleapis.com/tasks/v1/lists/{tasklist}/tasks

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

مَعلمات المسار

المعلمات
tasklist

string

معرّف قائمة المهام

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

المعلمات
completedMax

string

الحدّ الأقصى لتاريخ إكمال المهمة (كطابع زمني RFC 3339) للفلترة حسبه اختياريّ. الإعداد التلقائي هو عدم الفلترة حسب تاريخ الانتهاء.

completedMin

string

الحدّ الأدنى لتاريخ إكمال المهمة (بتنسيق طابع زمني RFC 3339) للفلترة حسبه اختياريّ. الإعداد التلقائي هو عدم الفلترة حسب تاريخ الانتهاء.

dueMax

string

الحدّ الأقصى لتاريخ استحقاق المهمة (كطابع زمني وفقًا لمعيار RFC 3339) للفلترة حسبه اختياريّ. الإعداد التلقائي هو عدم الفلترة حسب تاريخ الاستحقاق.

dueMin

string

الحدّ الأدنى لتاريخ استحقاق المهمة (كطابع زمني RFC 3339) للفلترة حسبه اختياريّ. الإعداد التلقائي هو عدم الفلترة حسب تاريخ الاستحقاق.

maxResults

integer

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

pageToken

string

رمز مميّز يحدّد صفحة النتائج التي سيتم عرضها. اختياريّ.

showCompleted

boolean

علامة تشير إلى ما إذا كان يتم عرض المهام المكتملة في النتيجة يُرجى العلم أنّه يجب أيضًا ضبط showHidden على True لعرض المهام المكتملة في عملاء الطرف الأول، مثل واجهة مستخدم الويب وتطبيقات Google المتوافقة مع الأجهزة الجوّالة. اختياريّ. القيمة التلقائية هي True.

showDeleted

boolean

علامة تشير إلى ما إذا كان يتم عرض المهام المحذوفة في النتيجة اختياريّ. القيمة التلقائية هي False.

showHidden

boolean

علامة تشير إلى ما إذا كان يتم عرض المهام المخفية في النتيجة اختياريّ. القيمة التلقائية هي False.

updatedMin

string

الحدّ الأدنى لوقت آخر تعديل للمهمة (كطابع زمني وفقًا لمعيار RFC 3339) للفلترة حسبه اختياريّ. الإعداد التلقائي هو عدم الفلترة حسب وقت آخر تعديل.

showAssigned

boolean

اختياريّ. علامة تشير إلى ما إذا كان يتم عرض المهام المخصّصة للمستخدم الحالي في النتيجة اختياريّ. القيمة التلقائية هي False.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

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

string

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

etag

string

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

nextPageToken

string

الرمز المميّز المستخدَم للوصول إلى الصفحة التالية من هذه النتيجة

items[]

object (Task)

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

نطاقات التفويض

يتطلب أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/tasks
  • https://www.googleapis.com/auth/tasks.readonly

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

مهام Google

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

string

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

etag

string

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

nextPageToken

string

الرمز المميّز المستخدَم للوصول إلى الصفحة التالية من هذه النتيجة

items[]

object (Task)

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