使用工作參數
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
除了可與大部分 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 和/或其關聯企業的註冊商標。
上次更新時間:2025-08-29 (世界標準時間)。
[null,null,["上次更新時間:2025-08-29 (世界標準時間)。"],[],[],null,["# Use Tasks Parameters\n\nIn addition to the standard query parameters that can be used with most Google APIs, there is a set of Tasks parameters.\n\nRequest parameters that apply only to specific operations in the Google Tasks API are summarized in the following table. All parameter values need to be URL encoded.\n\n| Parameter | Meaning | Notes | Applicability |\n|-----------------|------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------|\n| `completedMax` | Upper bound for a task's completion date (as an RFC 3339 timestamp) to filter by. | - Default: `completedMax=2031-01-01` - Use the RFC 3339 timestamp format. For example: `2010-08-09T10:57:00.000-08:00` | - Retrieving tasks |\n| `completedMin` | Lower bound for a task's completion date (as an RFC 3339 timestamp) to filter by. | - Default: `completedMin=1970-01-01` - Use the RFC 3339 timestamp format. For example: `2010-08-09T10:57:00.000-08:00` | - Retrieving tasks |\n| `dueMax` | Upper bound for a task's due date (as an RFC 3339 timestamp) to filter by. | - Default: `dueMax=2031-01-01` - Use the RFC 3339 timestamp format. For example: `2010-08-09T10:57:00.000-08:00` | - Retrieving tasks |\n| `dueMin` | Lower bound for a task's due date (as an RFC 3339 timestamp) to filter by. | - Default: `dueMin=1970-01-01` - Use the RFC 3339 timestamp format. For example: `2010-08-09T10:57:00.000-08:00` | - Retrieving tasks |\n| `maxResults` | The maximum number of elements to return with this request. | - Default: `maxResults=20` - Maximum allowable value: `maxResults=100.` | - Retrieving a user's task lists - Retrieving tasks |\n| `pageToken` | Token specifying the result page to return. | - The default is to return the first page. | - Retrieving a user's task lists - Retrieving tasks |\n| `parent` | Specify the task's parent task ID. | - No parameter indicates an insertion or a move to the top level of the task list. | - Creating a task - Ordering a task |\n| `previous` | Specify the task's previous task ID. | - No parameter indicates an insertion or a move to the first position in the sublist. | - Creating a task - Ordering a task |\n| `showCompleted` | Specify whether or not to show completed tasks. | - Default: `showCompleted=true` | - Retrieving tasks |\n| `showDeleted` | Specify whether or not to show deleted tasks. | - Default: `showDeleted=false` | - Retrieving tasks |\n| `showHidden` | Specify whether or not to show hidden tasks. | - Default: `showHidden=true` | - Retrieving tasks |\n| `updatedMin` | Lower bound for a task's last modification time (as an RFC 3339 timestamp) to filter by. | - Use the RFC 3339 timestamp format. For example: `2010-08-09T10:57:00.000-08:00Z`. - The default is not to filter by last modification time. | - Retrieving tasks |"]]