傳回指定工作清單中的所有工作。預設不會傳回已指派的工作 (來自 Google 文件和 Chat 聊天室)。使用者每份清單最多可有 20,000 個非隱藏工作,一次最多可有 100,000 個工作。
HTTP 要求
GET https://tasks.googleapis.com/tasks/v1/lists/{tasklist}/tasks
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
tasklist |
工作清單 ID。 |
查詢參數
參數 | |
---|---|
completed |
工作完成日期的上限 (以 RFC 3339 時間戳記表示),用於篩選。選用設定。預設不會依完成日期篩選。 |
completed |
工作完成日期的下限 (以 RFC 3339 時間戳記表示),用於篩選。選用設定。預設不會依完成日期篩選。 |
due |
任務截止日期的上限 (以 RFC 3339 時間戳記表示),用於篩選。選用設定。預設情況下不會依截止日期篩選。 |
due |
任務截止日期的下限 (以 RFC 3339 時間戳記表示),用於篩選。選用設定。預設情況下不會依截止日期篩選。 |
max |
單頁傳回的任務數量上限。選用設定。預設值為 20 (允許上限:100)。 |
page |
符記,用於指定要傳回的結果頁面。選填。 |
show |
此標記可指出結果中是否會傳回已完成的工作。請注意,如果要顯示第一方用戶端 (例如網頁使用者介面和 Google 行動應用程式) 中已完成的工作,showHidden 也必須設為 True。選用設定。預設值為 True。 |
show |
此標記可指出結果中是否會傳回已刪除的工作。選用設定。預設值為 False。 |
updated |
工作上次修改時間的下限 (以 RFC 3339 時間戳記格式表示),用於篩選。選用設定。預設不會依上次修改時間篩選。 |
show |
選用設定。此標記可指出結果中是否會傳回指派給目前使用者的任務。選用設定。預設值為 False。 |
要求主體
要求主體必須為空白。
回應主體
如果成功,回應主體即會包含具有以下結構的資料:
JSON 表示法 |
---|
{
"kind": string,
"etag": string,
"nextPageToken": string,
"items": [
{
object ( |
欄位 | |
---|---|
kind |
資源類型。這個值一律為「tasks#tasks」。 |
etag |
資源的 ETag。 |
next |
用於存取此結果下一頁的符記。 |
items[] |
工作集合。 |
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/tasks
https://www.googleapis.com/auth/tasks.readonly
詳情請參閱授權指南。
工作
JSON 表示法 |
---|
{
"kind": string,
"etag": string,
"nextPageToken": string,
"items": [
{
object ( |
欄位 | |
---|---|
kind |
資源類型。這個值一律為「tasks#tasks」。 |
etag |
資源的 ETag。 |
next |
用於存取此結果下一頁的符記。 |
items[] |
工作集合。 |