傳回指定工作清單中的所有工作。預設不會傳回指派的工作 (從 Google 文件、Chat 聊天室)。使用者一次最多可擁有 20,000 個非隱藏的工作,一次最多 100,000 個工作。
HTTP 要求
GET https://tasks.googleapis.com/tasks/v1/lists/{tasklist}/tasks
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
tasklist |
工作清單 ID。 |
查詢參數
參數 | |
---|---|
completedMax |
工作完成日期的上限 (格式為 RFC 3339 時間戳記)。選用設定。預設值不會依完成日期篩選。 |
completedMin |
工作完成日期的下限 (採用 RFC 3339 時間戳記)選用設定。預設值不會依完成日期篩選。 |
dueMax |
工作到期日上限 (採用 RFC 3339 時間戳記)選用設定。預設設定不會依到期日進行篩選。 |
dueMin |
工作到期日的下限 (採用 RFC 3339 時間戳記)選用設定。預設設定不會依到期日進行篩選。 |
maxResults |
單一頁面傳回的工作數量上限。選用設定。預設值為 20 (上限:100)。 |
pageToken |
用於指定要傳回結果頁面的符記。選填。 |
showCompleted |
此標記可註明結果中是否傳回已完成的工作。請注意,showHidden 值必須也是 True,才能顯示第一方用戶端 (例如網頁使用者介面和 Google 行動應用程式) 中完成的工作。選用設定。預設值為 True。 |
showDeleted |
此標記可註明結果中是否傳回已刪除的工作。選用設定。預設值為 False。 |
updatedMin |
工作上次修改時間的下限 (採用 RFC 3339 時間戳記) 做為篩選依據。選用設定。預設設定不會依上次修改時間進行篩選。 |
showAssigned |
選用設定。此標記可指出結果中是否要傳回指派給目前使用者的工作。選用設定。預設值為 False。 |
要求主體
要求主體必須為空白。
回應主體
如果成功,回應主體即會包含具有以下結構的資料:
JSON 表示法 |
---|
{
"kind": string,
"etag": string,
"nextPageToken": string,
"items": [
{
object ( |
欄位 | |
---|---|
kind |
資源類型。這一律為「tasks#tasks」。 |
etag |
資源的 ETag。 |
nextPageToken |
存取此結果下一頁的權杖。 |
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。 |
nextPageToken |
存取此結果下一頁的權杖。 |
items[] |
工作集合。 |