Method: tasks.list

傳回指定工作清單中的所有工作。每個清單使用者最多可建立 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

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

boolean

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

boolean

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

string

工作上次修改時間的下限 (以 RFC 3339 時間戳記表示)，要做為篩選依據。選用設定。在預設情況下，系統不會按照上次修改時間進行篩選。

要求主體

要求主體必須為空白。

回應主體

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

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)

工作集合。