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

علامة تشير إلى ما إذا كانت المهام المكتملة سيتم عرضها في النتيجة أم لا. يُرجى العِلم أنّه يجب أيضًا ضبط قيمة showالصور على "صحيح" لعرض المهام المكتملة في برامج الطرف الأول، مثل واجهة مستخدم الويب وتطبيقات 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

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

المهام

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

string

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

string

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

string

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

object (Task)

جمع المهام.