از پارامترهای Tasks استفاده کنید
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
علاوه بر پارامترهای پرس و جوی استاندارد که می توانند با اکثر API های Google استفاده شوند، مجموعه ای از پارامترهای Tasks نیز وجود دارد.
پارامترهای درخواستی که فقط برای عملیات خاص در Google Tasks API اعمال می‌شوند در جدول زیر خلاصه شده‌اند. همه مقادیر پارامتر باید URL کدگذاری شوند.
| پارامتر | معنی | یادداشت | قابلیت کاربرد |
|---|
completedMax | کران بالایی برای تاریخ اتمام یک کار (به عنوان مهر زمانی RFC 3339) برای فیلتر کردن بر اساس. | - پیش فرض:
completedMax=2031-01-01 - از قالب RFC 3339 timestamp استفاده کنید. به عنوان مثال:
2010-08-09T10:57:00.000-08:00
| |
completedMin | کران پایین برای تاریخ اتمام یک کار (به عنوان مهر زمانی RFC 3339) برای فیلتر کردن بر اساس. | - پیش فرض:
completedMin=1970-01-01 - از قالب RFC 3339 timestamp استفاده کنید. به عنوان مثال:
2010-08-09T10:57:00.000-08:00
| |
dueMax | کران بالایی برای تاریخ سررسید یک کار (به عنوان مهر زمانی RFC 3339) برای فیلتر کردن بر اساس. | - پیش فرض:
dueMax=2031-01-01 - از قالب RFC 3339 timestamp استفاده کنید. به عنوان مثال:
2010-08-09T10:57:00.000-08:00
| |
dueMin | کران پایین برای سررسید یک کار (به عنوان مهر زمانی RFC 3339) برای فیلتر کردن بر اساس. | - پیش فرض:
dueMin=1970-01-01 - از قالب RFC 3339 timestamp استفاده کنید. به عنوان مثال:
2010-08-09T10:57:00.000-08:00
| |
maxResults | حداکثر تعداد عناصر برای بازگشت با این درخواست. | - پیش فرض:
maxResults=20 - حداکثر مقدار مجاز:
maxResults=100.
| - بازیابی لیست وظایف کاربر
- بازیابی وظایف
|
pageToken | نشانه ای که صفحه نتیجه را برای بازگشت مشخص می کند. | - پیش فرض برگرداندن صفحه اول است.
| - بازیابی لیست وظایف کاربر
- بازیابی وظایف
|
parent | شناسه وظیفه والد کار را مشخص کنید. | - هیچ پارامتری نشان‌دهنده درج یا حرکت به سطح بالای فهرست کار نیست.
| - ایجاد یک کار
- سفارش یک کار
|
previous | شناسه وظیفه قبلی کار را مشخص کنید. | - هیچ پارامتری نشان‌دهنده درج یا حرکت به موقعیت اول در فهرست فرعی نیست.
| - ایجاد یک کار
- سفارش یک کار
|
showCompleted | مشخص کنید که وظایف تکمیل شده نشان داده شود یا خیر. | - پیش فرض:
showCompleted=true
| |
showDeleted | مشخص کنید که وظایف حذف شده نمایش داده شود یا خیر. | - پیش فرض:
showDeleted=false
| |
showHidden | مشخص کنید که وظایف مخفی نمایش داده شود یا خیر. | | |
updatedMin | کران پایین برای آخرین زمان اصلاح یک کار (به عنوان مهر زمانی RFC 3339) برای فیلتر کردن بر اساس. | - از قالب RFC 3339 timestamp استفاده کنید. به عنوان مثال:
2010-08-09T10:57:00.000-08:00Z . - پیش فرض این است که بر اساس آخرین زمان اصلاح فیلتر نشود.
| |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده 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 |"]]
