Method: tasks.list

傳回指定工作清單中的所有工作。預設不會傳回指派的工作 (從 Google 文件、Chat 聊天室)。使用者一次最多可擁有 20,000 個非隱藏的工作，一次最多 100,000 個工作。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
tasklist

string

工作清單 ID。

查詢參數

參數
completedMax

string

工作完成日期的上限 (格式為 RFC 3339 時間戳記)。選用設定。預設值不會依完成日期篩選。
completedMin

string

工作完成日期的下限 (採用 RFC 3339 時間戳記)選用設定。預設值不會依完成日期篩選。
dueMax

string

工作到期日上限 (採用 RFC 3339 時間戳記)選用設定。預設設定不會依到期日進行篩選。
dueMin

string

工作到期日的下限 (採用 RFC 3339 時間戳記)選用設定。預設設定不會依到期日進行篩選。
maxResults

integer

單一頁面傳回的工作數量上限。選用設定。預設值為 20 (上限：100)。
pageToken

string

用於指定要傳回結果頁面的符記。選填。
showCompleted

boolean

此標記可註明結果中是否傳回已完成的工作。請注意，showHidden 值必須也是 True，才能顯示第一方用戶端 (例如網頁使用者介面和 Google 行動應用程式) 中完成的工作。選用設定。預設值為 True。
showDeleted

boolean

此標記可註明結果中是否傳回已刪除的工作。選用設定。預設值為 False。
showHidden

boolean

此標記可註明結果中是否傳回隱藏的工作。選用設定。預設值為 False。
updatedMin

string

工作上次修改時間的下限 (採用 RFC 3339 時間戳記) 做為篩選依據。選用設定。預設設定不會依上次修改時間進行篩選。
showAssigned

boolean

選用設定。此標記可指出結果中是否要傳回指派給目前使用者的工作。選用設定。預設值為 False。

要求主體

要求主體必須為空白。

回應主體

如果成功，回應主體即會包含具有以下結構的資料：

JSON 表示法 
{
  "kind": string,
  "etag": string,
  "nextPageToken": string,
  "items": [
    {
      object (Task)
    }
  ]
}
欄位
kind

string

資源類型。這一律為「tasks#tasks」。
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

資源類型。這一律為「tasks#tasks」。
etag

string

資源的 ETag。
nextPageToken

string

存取此結果下一頁的權杖。
items[]

object (Task)

工作集合。