- طلب HTTP
- مَعلمات المسار
- معامِلات طلب البحث
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- مهام Google
- جرِّبه الآن
تعرِض جميع المهام في قائمة المهام المحدّدة. لا تعرض تلقائيًا المهام المُسنَدة (من "مستندات Google" ومساحات Chat). يمكن أن يكون لدى المستخدم ما يصل إلى 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 |
علامة تشير إلى ما إذا كان يتم عرض المهام المكتملة في النتيجة يُرجى العلم أنّه يجب أيضًا ضبط showHidden على True لعرض المهام المكتملة في عملاء الطرف الأول، مثل واجهة مستخدم الويب وتطبيقات Google المتوافقة مع الأجهزة الجوّالة. اختياريّ. القيمة التلقائية هي True. |
showDeleted |
علامة تشير إلى ما إذا كان يتم عرض المهام المحذوفة في النتيجة اختياريّ. القيمة التلقائية هي False. |
updatedMin |
الحدّ الأدنى لوقت آخر تعديل للمهمة (كطابع زمني وفقًا لمعيار RFC 3339) للفلترة حسبه اختياريّ. الإعداد التلقائي هو عدم الفلترة حسب وقت آخر تعديل. |
showAssigned |
اختياريّ. علامة تشير إلى ما إذا كان يتم عرض المهام المخصّصة للمستخدم الحالي في النتيجة اختياريّ. القيمة التلقائية هي False. |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل 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
لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.
مهام Google
تمثيل JSON |
---|
{
"kind": string,
"etag": string,
"nextPageToken": string,
"items": [
{
object ( |
الحقول | |
---|---|
kind |
نوع المورد يكون هذا العنوان دائمًا "tasks#tasks". |
etag |
علامة ETag للمورد |
nextPageToken |
الرمز المميّز المستخدَم للوصول إلى الصفحة التالية من هذه النتيجة |
items[] |
مجموعة من المهام |