REST Resource: tasks

منبع: وظیفه

نمایندگی JSON
{
  "kind": string,
  "id": string,
  "etag": string,
  "title": string,
  "updated": string,
  "selfLink": string,
  "parent": string,
  "position": string,
  "notes": string,
  "status": string,
  "due": string,
  "completed": string,
  "deleted": boolean,
  "hidden": boolean,
  "links": [
    {
      "type": string,
      "description": string,
      "link": string
    }
  ],
  "webViewLink": string
}
زمینه های
kind

string

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

id

string

شناسه وظیفه

etag

string

ETag منبع

title

string

عنوان تکلیف حداکثر طول مجاز: 1024 کاراکتر.

updated

string

آخرین زمان تغییر کار (به عنوان مهر زمانی RFC 3339).

parent

string

شناسه وظیفه والد. اگر یک کار سطح بالا باشد، این قسمت حذف می شود. این فیلد فقط خواندنی است. از روش "حرکت" برای انتقال کار تحت والد دیگری یا به سطح بالا استفاده کنید.

position

string

رشته ای که موقعیت تکلیف را در بین وظایف خواهر و برادر تحت همان وظیفه والد یا در سطح بالا نشان می دهد. اگر این رشته بر اساس ترتیب واژگانی، از رشته موقعیت متناظر کار دیگری بزرگتر باشد، وظیفه بعد از کار دیگر در زیر همان وظیفه والد (یا در سطح بالا) قرار می گیرد. این فیلد فقط خواندنی است. از روش "حرکت" برای انتقال کار به موقعیت دیگری استفاده کنید.

notes

string

یادداشت هایی که وظیفه را توصیف می کند. اختیاری. حداکثر طول مجاز: 8192 کاراکتر.

status

string

وضعیت تکلیف این یا "needsAction" است یا "تکمیل شده".

due

string

تاریخ سررسید انجام کار (به عنوان مهر زمانی RFC 3339). اختیاری. تاریخ سررسید فقط اطلاعات تاریخ را ثبت می کند. هنگام تنظیم تاریخ سررسید، بخش زمانی مهر زمانی کنار گذاشته می شود. خواندن یا نوشتن زمان موعد انجام کار از طریق API امکان پذیر نیست.

completed

string

تاریخ تکمیل کار (به عنوان مهر زمانی RFC 3339). اگر کار تکمیل نشده باشد، این قسمت حذف می شود.

deleted

boolean

پرچم را نشان می دهد که آیا کار حذف شده است. حالت پیش فرض غلط است.

hidden

boolean

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

links[].type

string

پیوند را تایپ کنید، به عنوان مثال "ایمیل".

links[].description

string

توضیحات در HTML صحبت کنید: همه چیز بین <a> و </a>.

links[].link

string

URL.

مواد و روش ها

clear

تمام کارهای تکمیل شده را از لیست وظایف مشخص شده پاک می کند.

delete

وظیفه مشخص شده را از لیست وظایف حذف می کند.

get

وظیفه مشخص شده را برمی گرداند.

insert

یک کار جدید در لیست وظایف مشخص شده ایجاد می کند.

list

تمام وظایف موجود در لیست وظایف مشخص شده را برمی گرداند.

move

وظیفه مشخص شده را به موقعیت دیگری در لیست کارها منتقل می کند.

patch

وظیفه مشخص شده را به روز می کند.

update

وظیفه مشخص شده را به روز می کند.