عرض جميع المهام في قائمة المهام المحددة يمكن أن يكون لدى المستخدم ما يصل إلى 20,000 مهمة غير مخفية لكل قائمة وما يصل إلى 100,000 مهمة إجمالاً في المرة الواحدة.
طلب HTTP
GET https://tasks.googleapis.com/tasks/v1/lists/{tasklist}/tasks
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات المسار
المَعلمات | |
---|---|
tasklist |
معرِّف قائمة المهام |
معلمات طلب البحث
المَعلمات | |
---|---|
completedMax |
الحد الأعلى لتاريخ اكتمال المهمة (كطابع زمني RFC 3339) للفلترة وفقًا له. اختياريّ. وفقًا للإعدادات التلقائية، لا تتم الفلترة حسب تاريخ الانتهاء. |
completedMin |
الحد الأدنى لتاريخ اكتمال المهمة (كطابع زمني RFC 3339) للفلترة وفقًا له. اختياريّ. وفقًا للإعدادات التلقائية، لا تتم الفلترة حسب تاريخ الانتهاء. |
dueMax |
الحد الأقصى لتاريخ استحقاق المهمة (كطابع زمني RFC 3339) للفلترة وفقًا لها. اختياريّ. الخيار التلقائي ليس الفلترة حسب تاريخ التسليم. |
dueMin |
الحد الأدنى لتاريخ استحقاق المهمة (كطابع زمني RFC 3339) للفلترة وفقًا له. اختياريّ. الخيار التلقائي ليس الفلترة حسب تاريخ التسليم. |
maxResults |
الحد الأقصى لعدد المهام التي يتم عرضها في صفحة واحدة. اختياريّ. القيمة التلقائية هي 20 (الحد الأقصى المسموح به: 100). |
pageToken |
رمز مميّز يحدّد صفحة النتائج المطلوب عرضها اختياريّ. |
showCompleted |
علامة تشير إلى ما إذا كان يتم عرض المهام المكتملة في النتيجة أم لا. اختياريّ. والقيمة التلقائية هي "صحيح". تجدر الإشارة إلى أنّ قيمة showإخفاء يجب أن تكون "True" أيضًا لعرض المهام المكتملة في برامج الطرف الأول، مثل واجهة مستخدم الويب وتطبيقات Google المتوافقة مع الأجهزة الجوّالة. |
showDeleted |
علامة تشير إلى ما إذا كان يتم عرض المهام المحذوفة في النتيجة أم لا. اختياريّ. والقيمة التلقائية هي "خطأ". |
updatedMin |
الحد الأدنى لوقت آخر تعديل لمهمة (كطابع زمني RFC 3339) للفلترة وفقًا له. اختياريّ. الإعداد التلقائي هو عدم الفلترة حسب وقت آخر تعديل. |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"kind": string,
"etag": string,
"nextPageToken": string,
"items": [
{
object ( |
الحقول | |
---|---|
kind |
نوع المورد. دائمًا ما يكون ذلك "tasks#tasks". |
etag |
علامة ETag للمورد. |
nextPageToken |
الرمز المميّز المستخدَم للوصول إلى الصفحة التالية من هذه النتيجة |
items[] |
مجموعة من المهام |
نطاقات التفويض
يتطلب استخدام أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/tasks
https://www.googleapis.com/auth/tasks.readonly
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.
المهام
تمثيل JSON |
---|
{
"kind": string,
"etag": string,
"nextPageToken": string,
"items": [
{
object ( |
الحقول | |
---|---|
kind |
نوع المورد. دائمًا ما يكون ذلك "tasks#tasks". |
etag |
علامة ETag للمورد. |
nextPageToken |
الرمز المميّز المستخدَم للوصول إلى الصفحة التالية من هذه النتيجة |
items[] |
مجموعة من المهام |