از پارامترهای 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 و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2024-10-30 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2024-10-30 بهوقت ساعت هماهنگ جهانی."],[[["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"]]
