Method: tasks.list

عرض جميع المهام في قائمة المهام المحددة يمكن أن يكون لدى المستخدم ما يصل إلى 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

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

boolean

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

boolean

علامة تشير إلى عرض المهام المخفية في النتيجة اختياريّ. والقيمة التلقائية هي "خطأ".
updatedMin

string

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

نص الطلب

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

نص الاستجابة

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

تمثيل 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

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

المهام

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

string

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

string

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

string

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

object (Task)

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