REST Resource: tasks

資源：Task

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,
  "assignmentInfo": {
    object (AssignmentInfo)
  }
}
欄位
kind

string

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

string

工作 ID。
etag

string

資源的 ETag。
title

string

工作名稱。長度上限為 1024 個字元。
updated

string

僅供輸出。工作上次修改時間 (採用 RFC 3339 時間戳記)。
parent

string

僅供輸出。父項工作 ID。如果是頂層工作，則會省略這個欄位。使用「移動」方法將工作移至其他上層或頂層。父項工作一律無法是已指派的工作 (來自 Chat 聊天室、Google 文件)。這是唯讀欄位。
position

string

僅供輸出。字串，指出工作在同一上層工作或頂層的同層級工作中的位置。如果這個字串根據字典順序大於另一個工作的對應位置字串，則該工作會位於相同上層工作 (或頂層) 下方，排在另一個工作之後。使用「move」方法將工作移至其他位置。
notes

string

描述工作的附註。透過 Google 文件指派的工作無法新增附註。(選用步驟) 長度上限為 8192 個字元。
status

string

工作狀態。這個值為「needsAction」或「completed」。
due

string

工作排定的日期 (RFC 3339 時間戳記)。(選用步驟) 這代表工作應完成的日期，或工作在日曆檢視格中顯示的日期。這並非工作期限。系統只會記錄日期資訊，設定這個欄位時會捨棄時間戳記的時間部分。您無法使用 API 讀取或寫入工作排定的時間。
completed

string

工作完成日期 (採用 RFC 3339 時間戳記)。如果工作尚未完成，系統會省略這個欄位。
deleted

boolean

指出工作是否已刪除的標記。如果是指派的工作，這個欄位為唯讀。只能透過呼叫 tasks.delete 刪除，屆時系統會一併刪除指派的工作和原始工作 (位於 Google 文件或 Chat 聊天室)。如要只刪除指派的工作，請前往指派頁面，然後取消指派工作。預設值為 False。
hidden

boolean

此標記用於指出工作是否已隱藏。如果上次清除工作清單時，工作已標示為完成，就會發生這種情況。預設值為 False。這是唯讀欄位。
links[].type

string

連結類型，例如「email」、「generic」、「chat_message」、「keep_note」。
links[].description

string

說明 (可能為空)。
links[].link

string

網址。
assignmentInfo

object (AssignmentInfo)

僅供輸出。指派工作的背景資訊。工作可以指派給使用者，目前可透過 Google 文件和 Chat 聊天室等途徑指派。這個欄位會填入指派給目前使用者的工作，並指出工作指派來源。這是唯讀欄位。

AssignmentInfo

工作指派來源的相關資訊 (文件、Chat 聊天室)。

JSON 表示法 
{
  "linkToTask": string,
  "surfaceType": enum (ContextType),

  // Union field surface_info can be only one of the following:
  "driveResourceInfo": {
    object (DriveResourceInfo)
  },
  "spaceInfo": {
    object (SpaceInfo)
  }
  // End of list of possible types for union field surface_info.
}
欄位
surfaceType

enum (ContextType)

僅供輸出。指派工作來源的介面類型。目前僅限 DOCUMENT 或 SPACE。
聯集欄位 surface_info。這項工作指派來源的介面資訊 (文件、Chat 聊天室)。surface_info 只能是下列其中一項：
driveResourceInfo

object (DriveResourceInfo)

僅供輸出。這項工作來源的雲端硬碟檔案相關資訊。目前只能是文件。這是唯讀欄位。
spaceInfo

object (SpaceInfo)

僅供輸出。這項工作所屬的 Chat 聊天室相關資訊。這是唯讀欄位。

ContextType

與工作相關聯的產品。

列舉
CONTEXT_TYPE_UNSPECIFIED 這項工作內容的值不明。
GMAIL 這項工作是透過 Gmail 建立。
DOCUMENT 工作是從文件中指派。
SPACE 工作是從 Chat 聊天室指派。

DriveResourceInfo

指派工作時所用的雲端硬碟資源 (文件、試算表等) 相關資訊。

JSON 表示法 
{
  "driveFileId": string,
  "resourceKey": string
}
欄位
driveFileId

string

僅供輸出。Drive API 中的檔案 ID。
resourceKey

string

僅供輸出。如要存取透過共用連結分享的檔案，必須提供資源金鑰。並非所有檔案都必須提供。另請參閱 developers.google.com/drive/api/guides/resource-keys。

SpaceInfo

指派工作時所在的 Chat 聊天室相關資訊。

JSON 表示法 
{
  "space": string
}
欄位
space

string

僅供輸出。這項工作的來源 Chat 聊天室。格式為「spaces/{space}」。

方法

clear

 從指定工作清單中清除所有已完成的工作。

delete

 從工作清單中刪除指定工作。

get

 傳回指定工作。

insert

 在指定工作清單中建立新工作。

list

 傳回指定工作清單中的所有工作。

move

 將指定工作移至目標工作清單中的其他位置。

patch

 更新指定工作。

update

 更新指定工作。