استخدام مَعلمات المهام
بالإضافة إلى مَعلمات طلب البحث العادية التي يمكن استخدامها مع معظم Google APIs، تتوفّر مجموعة من مَعلمات "مهام Google".
يتم تلخيص معلمات الطلب التي تنطبق فقط على عمليات محددة في واجهة برمجة تطبيقات مهام Google في الجدول التالي. يلزم تشفير جميع قيم المعلمات بعنوان URL.
| المعلمة |
المعنى |
ملاحظات |
قابلية التطبيق |
completedMax |
الحد الأقصى لتاريخ اكتمال المهمة (كطابع زمني RFC 3339) للفلترة حسبه. |
- عناوين URL التلقائية:
completedMax=2031-01-01
- استخدِم تنسيق الطابع الزمني RFC 3339. على سبيل المثال:
2010-08-09T10:57:00.000-08:00
|
|
completedMin |
الحد الأدنى لتاريخ اكتمال المهمة (كطابع زمني RFC 3339) للتصفية حسبه. |
- عناوين URL التلقائية:
completedMin=1970-01-01
- استخدِم تنسيق الطابع الزمني RFC 3339. على سبيل المثال:
2010-08-09T10:57:00.000-08:00
|
|
dueMax |
الحد الأقصى لتاريخ استحقاق المهمة (كطابع زمني RFC 3339) للفلترة حسبه. |
- عناوين URL التلقائية:
dueMax=2031-01-01
- استخدِم تنسيق الطابع الزمني RFC 3339. على سبيل المثال:
2010-08-09T10:57:00.000-08:00
|
|
dueMin |
الحد الأدنى لتاريخ استحقاق المهمة (كطابع زمني RFC 3339) للتصفية بحسبه. |
- عناوين URL التلقائية:
dueMin=1970-01-01
- استخدِم تنسيق الطابع الزمني RFC 3339. على سبيل المثال:
2010-08-09T10:57:00.000-08:00
|
|
maxResults |
الحد الأقصى لعدد العناصر المطلوب عرضها مع هذا الطلب. |
- عناوين URL التلقائية:
maxResults=20
- الحد الأقصى للقيمة المسموح بها:
maxResults=100.
|
- استرداد قوائم مهام المستخدم
- جارٍ استرداد المهام
|
pageToken |
رمز مميز يحدد صفحة النتائج المراد عرضها. |
- الإعداد الافتراضي هو عرض الصفحة الأولى.
|
- استرداد قوائم مهام المستخدم
- جارٍ استرداد المهام
|
parent |
حدِّد رقم تعريف المهمة الرئيسية للمهمة. |
- لا توجد مَعلمة تشير إلى إدراج أو نقل إلى المستوى الأعلى من قائمة المهام.
|
|
previous |
حدِّد رقم تعريف المهمة السابقة للمهمة. |
- لا توجد معلمة تشير إلى إدراج أو نقل إلى الموضع الأول في القائمة الفرعية.
|
|
showCompleted |
حدد ما إذا كنت تريد عرض المهام المكتملة أم لا. |
- عناوين URL التلقائية:
showCompleted=true
|
|
showDeleted |
حدد ما إذا كنت تريد عرض المهام المحذوفة أم لا. |
- عناوين URL التلقائية:
showDeleted=false
|
|
showHidden |
حدد ما إذا كنت تريد عرض المهام المخفية أم لا. |
- عناوين URL التلقائية:
showHidden=true
|
|
updatedMin |
الحد الأدنى لوقت التعديل الأخير للمهمة (كطابع زمني RFC 3339) للتصفية حسبه. |
- استخدِم تنسيق الطابع الزمني RFC 3339. على سبيل المثال:
2010-08-09T10:57:00.000-08:00Z.
- الإعداد التلقائي هو عدم إجراء الفلترة حسب وقت آخر تعديل.
|
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-09-03 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-09-03 (حسب التوقيت العالمي المتفَّق عليه)"],[[["In addition to standard query parameters, the Google Tasks API utilizes specific parameters for refined task management."],["These parameters control filtering by due dates, completion dates, modification times, and the visibility of completed, deleted, or hidden tasks."],["Developers can use these parameters to retrieve specific sets of tasks based on various criteria, such as completion status and due dates, using RFC 3339 timestamps for filtering."],["Parameters like `maxResults` and `pageToken` allow for pagination and control over the number of tasks returned in a response."],["The `parent` and `previous` parameters enable developers to manage task hierarchy and ordering within task lists."]]],["The Google Tasks API uses specific parameters for operations, all of which require URL encoding. These parameters filter tasks by `completedMin/Max`, `dueMin/Max`, and `updatedMin` date ranges using RFC 3339 timestamps. `maxResults` limits the number of returned items, and `pageToken` specifies the result page. `parent` and `previous` parameters determine task order, while `showCompleted`, `showDeleted`, and `showHidden` control the visibility of tasks. These parameters apply to retrieving tasks and task lists, creating, and ordering tasks.\n"]]
