使用工作參數
除了可與大部分 Google API 搭配使用的標準查詢參數外,還提供一組 Tasks 參數。
下表匯總了僅適用於 Google Tasks API 中特定作業的要求參數。所有參數值都必須經過網址編碼。
參數 |
意義 |
Notes |
適用性 |
completedMax |
待篩選工作的完成日期 (作為 RFC 3339 時間戳記) 的最大值。 |
- 預設:
completedMax=2031-01-01
- 請使用 RFC 3339 時間戳記格式。例如:
2010-08-09T10:57:00.000-08:00
|
|
completedMin |
工作篩選日期的下限 (以 RFC 3339 時間戳記表示)。 |
- 預設:
completedMin=1970-01-01
- 請使用 RFC 3339 時間戳記格式。例如:
2010-08-09T10:57:00.000-08:00
|
|
dueMax |
要篩選工作的到期日 (以 RFC 3339 時間戳記表示)。 |
- 預設:
dueMax=2031-01-01
- 請使用 RFC 3339 時間戳記格式。例如:
2010-08-09T10:57:00.000-08:00
|
|
dueMin |
工作到期日的下限 (以 RFC 3339 時間戳記表示)。 |
- 預設:
dueMin=1970-01-01
- 請使用 RFC 3339 時間戳記格式。例如:
2010-08-09T10:57:00.000-08:00
|
|
maxResults |
此要求傳回的元素數量上限。 |
- 預設:
maxResults=20
- 允許的最大值:
maxResults=100.
|
|
pageToken |
指定要傳回結果頁面的符記。 |
|
|
parent |
指定工作的父項工作 ID。 |
|
|
previous |
指定工作先前的工作 ID。 |
|
|
showCompleted |
指定是否顯示已完成的工作。 |
|
|
showDeleted |
指定是否顯示已刪除的工作。 |
|
|
showHidden |
指定是否顯示隱藏的工作。 |
|
|
updatedMin |
工作經過篩選的最後一個修改時間 (作為 RFC 3339 時間戳記) 的下限。 |
- 請使用 RFC 3339 時間戳記格式。例如:
2010-08-09T10:57:00.000-08:00Z 。
- 預設設定不會依上次修改時間進行篩選。
|
|
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-09-03 (世界標準時間)。
[null,null,["上次更新時間:2024-09-03 (世界標準時間)。"],[[["In addition to standard query parameters, the Google Tasks API utilizes specific parameters for refined task management."],["These parameters control filtering by due dates, completion dates, modification times, and the visibility of completed, deleted, or hidden tasks."],["Developers can use these parameters to retrieve specific sets of tasks based on various criteria, such as completion status and due dates, using RFC 3339 timestamps for filtering."],["Parameters like `maxResults` and `pageToken` allow for pagination and control over the number of tasks returned in a response."],["The `parent` and `previous` parameters enable developers to manage task hierarchy and ordering within task lists."]]],["The Google Tasks API uses specific parameters for operations, all of which require URL encoding. These parameters filter tasks by `completedMin/Max`, `dueMin/Max`, and `updatedMin` date ranges using RFC 3339 timestamps. `maxResults` limits the number of returned items, and `pageToken` specifies the result page. `parent` and `previous` parameters determine task order, while `showCompleted`, `showDeleted`, and `showHidden` control the visibility of tasks. These parameters apply to retrieving tasks and task lists, creating, and ordering tasks.\n"]]