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

此標記可指出結果中是否會傳回已完成的工作。請注意,如果要顯示第一方用戶端 (例如網頁使用者介面和 Google 行動應用程式) 中已完成的工作,showHidden 也必須設為 True。選用設定。預設值為 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)

工作集合。