استخدام مَعلمات المهام
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
بالإضافة إلى مَعلمات طلب البحث العادية التي يمكن استخدامها مع معظم 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 و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Use Tasks Parameters\n\nIn addition to the standard query parameters that can be used with most Google APIs, there is a set of Tasks parameters.\n\nRequest parameters that apply only to specific operations in the Google Tasks API are summarized in the following table. All parameter values need to be URL encoded.\n\n| Parameter | Meaning | Notes | Applicability |\n|-----------------|------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------|\n| `completedMax` | Upper bound for a task's completion date (as an RFC 3339 timestamp) to filter by. | - Default: `completedMax=2031-01-01` - Use the RFC 3339 timestamp format. For example: `2010-08-09T10:57:00.000-08:00` | - Retrieving tasks |\n| `completedMin` | Lower bound for a task's completion date (as an RFC 3339 timestamp) to filter by. | - Default: `completedMin=1970-01-01` - Use the RFC 3339 timestamp format. For example: `2010-08-09T10:57:00.000-08:00` | - Retrieving tasks |\n| `dueMax` | Upper bound for a task's due date (as an RFC 3339 timestamp) to filter by. | - Default: `dueMax=2031-01-01` - Use the RFC 3339 timestamp format. For example: `2010-08-09T10:57:00.000-08:00` | - Retrieving tasks |\n| `dueMin` | Lower bound for a task's due date (as an RFC 3339 timestamp) to filter by. | - Default: `dueMin=1970-01-01` - Use the RFC 3339 timestamp format. For example: `2010-08-09T10:57:00.000-08:00` | - Retrieving tasks |\n| `maxResults` | The maximum number of elements to return with this request. | - Default: `maxResults=20` - Maximum allowable value: `maxResults=100.` | - Retrieving a user's task lists - Retrieving tasks |\n| `pageToken` | Token specifying the result page to return. | - The default is to return the first page. | - Retrieving a user's task lists - Retrieving tasks |\n| `parent` | Specify the task's parent task ID. | - No parameter indicates an insertion or a move to the top level of the task list. | - Creating a task - Ordering a task |\n| `previous` | Specify the task's previous task ID. | - No parameter indicates an insertion or a move to the first position in the sublist. | - Creating a task - Ordering a task |\n| `showCompleted` | Specify whether or not to show completed tasks. | - Default: `showCompleted=true` | - Retrieving tasks |\n| `showDeleted` | Specify whether or not to show deleted tasks. | - Default: `showDeleted=false` | - Retrieving tasks |\n| `showHidden` | Specify whether or not to show hidden tasks. | - Default: `showHidden=true` | - Retrieving tasks |\n| `updatedMin` | Lower bound for a task's last modification time (as an RFC 3339 timestamp) to filter by. | - Use the RFC 3339 timestamp format. For example: `2010-08-09T10:57:00.000-08:00Z`. - The default is not to filter by last modification time. | - Retrieving tasks |"]]
