Method: tasks.list

تمام وظایف موجود در لیست وظایف مشخص شده را برمی گرداند. یک کاربر می تواند تا 20000 کار غیر پنهان در هر لیست و تا 100000 کار در مجموع در یک زمان داشته باشد.

درخواست HTTP

GET https://tasks.googleapis.com/tasks/v1/lists/{tasklist}/tasks

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
tasklist

string

شناسه لیست وظایف

پارامترهای پرس و جو

مولفه های
completedMax

string

کران بالایی برای تاریخ اتمام یک کار (به عنوان مهر زمانی RFC 3339) برای فیلتر کردن بر اساس. اختیاری. پیش فرض این است که بر اساس تاریخ تکمیل فیلتر نشود.

completedMin

string

کران پایین برای تاریخ تکمیل یک کار (به عنوان مهر زمانی RFC 3339) برای فیلتر کردن بر اساس. اختیاری. پیش فرض این است که بر اساس تاریخ تکمیل فیلتر نشود.

dueMax

string

کران بالایی برای تاریخ سررسید یک کار (به عنوان مهر زمانی RFC 3339) برای فیلتر کردن بر اساس. اختیاری. پیش‌فرض این است که براساس موعد مقرر فیلتر نشود.

dueMin

string

کران پایین برای سررسید یک کار (به عنوان مهر زمانی RFC 3339) برای فیلتر کردن بر اساس. اختیاری. پیش‌فرض این است که براساس موعد مقرر فیلتر نشود.

maxResults

integer

حداکثر تعداد وظایف برگردانده شده در یک صفحه. اختیاری. پیش فرض 20 است (حداکثر مجاز: 100).

pageToken

string

نشانه ای که صفحه نتیجه را برای بازگشت مشخص می کند. اختیاری.

showCompleted

boolean

پرچمی که نشان می دهد آیا وظایف تکمیل شده در نتیجه برگردانده می شوند یا خیر. اختیاری. پیش فرض True است. توجه داشته باشید که showHidden نیز باید True باشد تا وظایف تکمیل‌شده در کلاینت‌های شخص اول، مانند رابط کاربری وب و برنامه‌های تلفن همراه Google را نشان دهد.

showDeleted

boolean

پرچم را نشان می دهد که آیا وظایف حذف شده در نتیجه برگردانده می شوند یا خیر. اختیاری. حالت پیش فرض غلط است.

showHidden

boolean

پرچمی که نشان می دهد آیا وظایف پنهان در نتیجه برگردانده می شوند یا خیر. اختیاری. حالت پیش فرض غلط است.

updatedMin

string

کران پایین برای آخرین زمان اصلاح یک کار (به عنوان مهر زمانی RFC 3339) برای فیلتر کردن بر اساس. اختیاری. پیش فرض این است که بر اساس آخرین زمان اصلاح فیلتر نشود.

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "kind": string,
  "etag": string,
  "nextPageToken": string,
  "items": [
    {
      object (Task)
    }
  ]
}
زمینه های
kind

string

نوع منبع این همیشه "وظایف#تکلیف" است.

etag

string

ETag منبع

nextPageToken

string

رمز برای دسترسی به صفحه بعدی این نتیجه استفاده می شود.

items[]

object ( Task )

مجموعه وظایف.

محدوده مجوز

به یکی از حوزه های OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/tasks
  • https://www.googleapis.com/auth/tasks.readonly

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.

وظایف

نمایندگی JSON
{
  "kind": string,
  "etag": string,
  "nextPageToken": string,
  "items": [
    {
      object (Task)
    }
  ]
}
زمینه های
kind

string

نوع منبع این همیشه "وظایف#تکلیف" است.

etag

string

ETag منبع

nextPageToken

string

رمز برای دسترسی به صفحه بعدی این نتیجه استفاده می شود.

items[]

object ( Task )

مجموعه وظایف.