REST Resource: tasks

{
  "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
}

string

僅供輸出。資源類型。這一律為「tasks#task」。

string

工作 ID。

string

資源的 ETag。

string

工作的標題。長度上限為 1024 個半形字元。

string

僅供輸出。工作上次修改時間 (以 RFC 3339 時間戳記表示)。

string

僅供輸出。指向這個工作的網址。用於擷取、更新或刪除這項工作。

string

僅供輸出。父項工作 ID。如果是頂層工作，則省略這個欄位。這是唯讀欄位。使用「移動」方法，即可將工作移至其他父項或頂層。

string

僅供輸出。字串，表示任務在相同父項工作下或頂層的同層級工作中的位置。如果此字串大於其他工作 (依字典編列順序) 的對應位置字串，則工作會置於相同父項工作中 (或頂層) 的其他工作之後。使用「移動」方法將工作移至其他位置。

string

說明工作的附註。選用設定。長度上限為 8,192 個字元。

string

工作狀態。系統可為「needsAction」或「completed」

string

工作截止日期 (以 RFC 3339 時間戳記表示)。選用設定。截止日只會記錄日期資訊；設定到期日時，系統會捨棄時間戳記的時間部分。您無法透過 API 讀取或寫入工作到期的時間。

string

工作的完成日期 (以 RFC 3339 時間戳記表示)。如果工作尚未完成，則會省略這個欄位。

boolean

此標記用於註明工作是否已刪除。預設值為 False。

boolean

此標記用於註明是否要隱藏工作。在工作清單上次清除時，工作就已經標示為完成。預設值為 False。這是唯讀欄位。

object

僅供輸出。連結集合。這項集合處於唯讀狀態。

string

連結的類型，例如「電子郵件」。

string

說明。使用 HTML 時：<a> 和 </a> 之間的所有內容。

string

網址。

string

僅供輸出。Google Tasks 網頁版 UI 中的工作絕對連結。