ToDo リスト パラメータを使用する
ほとんどの Google API で使用可能な標準のクエリ パラメータに加えて、Task パラメータのセットがあります。
Google Tasks API の特定のオペレーションにのみ適用されるリクエスト パラメータは、次の表のようになります。パラメータの値はすべて URL エンコードする必要があります。
パラメータ |
意味 |
備考 |
適用対象判断 |
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 |
完了したタスクを表示するかどうかを指定します。 |
- デフォルト:
showCompleted=true
|
|
showDeleted |
削除済みのタスクを表示するかどうかを指定します。 |
|
|
showHidden |
非表示のタスクを表示するかどうかを指定します。 |
|
|
updatedMin |
フィルタの最終条件のタスクの最終更新日時(RFC 3339 のタイムスタンプとして)。 |
- RFC 3339 のタイムスタンプ形式を使用します。例:
2010-08-09T10:57:00.000-08:00Z 。
- デフォルトでは、最終更新日時でフィルタされません。
|
|
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2024-09-03 UTC。
[null,null,["最終更新日 2024-09-03 UTC。"],[[["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"]]