- درخواست HTTP
- پارامترهای مسیر
- پارامترهای پرس و جو
- درخواست بدن
- بدن پاسخگو
- محدوده مجوز
- وظایف
- آن را امتحان کنید!
تمام وظایف موجود در لیست وظایف مشخص شده را برمی گرداند. یک کاربر می تواند تا 20000 کار غیر پنهان در هر لیست و تا 100000 کار در مجموع در یک زمان داشته باشد.
درخواست HTTP
GET https://tasks.googleapis.com/tasks/v1/lists/{tasklist}/tasks
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
مولفه های | |
---|---|
tasklist | شناسه لیست وظایف |
پارامترهای پرس و جو
مولفه های | |
---|---|
completedMax | کران بالایی برای تاریخ اتمام یک کار (به عنوان مهر زمانی RFC 3339) برای فیلتر کردن بر اساس. اختیاری. پیش فرض این است که بر اساس تاریخ تکمیل فیلتر نشود. |
completedMin | کران پایین برای تاریخ تکمیل یک کار (به عنوان مهر زمانی RFC 3339) برای فیلتر کردن بر اساس. اختیاری. پیش فرض این است که بر اساس تاریخ تکمیل فیلتر نشود. |
dueMax | کران بالایی برای تاریخ سررسید یک کار (به عنوان مهر زمانی RFC 3339) برای فیلتر کردن بر اساس. اختیاری. پیشفرض این است که براساس موعد مقرر فیلتر نشود. |
dueMin | کران پایین برای سررسید یک کار (به عنوان مهر زمانی RFC 3339) برای فیلتر کردن بر اساس. اختیاری. پیشفرض این است که براساس موعد مقرر فیلتر نشود. |
maxResults | حداکثر تعداد وظایف برگردانده شده در یک صفحه. اختیاری. پیش فرض 20 است (حداکثر مجاز: 100). |
pageToken | نشانه ای که صفحه نتیجه را برای بازگشت مشخص می کند. اختیاری. |
showCompleted | پرچمی که نشان می دهد آیا وظایف تکمیل شده در نتیجه برگردانده می شوند یا خیر. اختیاری. پیش فرض True است. توجه داشته باشید که showHidden نیز باید True باشد تا وظایف تکمیلشده در کلاینتهای شخص اول، مانند رابط کاربری وب و برنامههای تلفن همراه Google را نشان دهد. |
showDeleted | پرچم را نشان می دهد که آیا وظایف حذف شده در نتیجه برگردانده می شوند یا خیر. اختیاری. حالت پیش فرض غلط است. |
updatedMin | کران پایین برای آخرین زمان اصلاح یک کار (به عنوان مهر زمانی RFC 3339) برای فیلتر کردن بر اساس. اختیاری. پیش فرض این است که بر اساس آخرین زمان اصلاح فیلتر نشود. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"kind": string,
"etag": string,
"nextPageToken": string,
"items": [
{
object ( |
زمینه های | |
---|---|
kind | نوع منبع این همیشه "وظایف#تکلیف" است. |
etag | ETag منبع |
nextPageToken | رمز برای دسترسی به صفحه بعدی این نتیجه استفاده می شود. |
items[] | مجموعه وظایف. |
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/tasks
-
https://www.googleapis.com/auth/tasks.readonly
برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.
وظایف
نمایندگی JSON |
---|
{
"kind": string,
"etag": string,
"nextPageToken": string,
"items": [
{
object ( |
زمینه های | |
---|---|
kind | نوع منبع این همیشه "وظایف#تکلیف" است. |
etag | ETag منبع |
nextPageToken | رمز برای دسترسی به صفحه بعدی این نتیجه استفاده می شود. |
items[] | مجموعه وظایف. |