指定されたタスクリストのすべてのタスクを返します。デフォルトでは、割り当てられたタスク(ドキュメント、Chat スペースから)は返されません。ユーザーは、リストごとに最大 20,000 件の非公開タスクを、一度に最大 100,000 件のタスクを作成できます。
HTTP リクエスト
GET https://tasks.googleapis.com/tasks/v1/lists/{tasklist}/tasks
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
tasklist |
タスクリストの ID。 |
クエリ パラメータ
パラメータ | |
---|---|
completed |
フィルタするタスクの完了日の上限(RFC 3339 タイムスタンプ)。省略可。デフォルトでは、完了日でフィルタされません。 |
completed |
フィルタするタスクの完了日の下限(RFC 3339 タイムスタンプ)。省略可。デフォルトでは、完了日でフィルタされません。 |
due |
フィルタするタスクの期限の上限(RFC 3339 タイムスタンプ)。省略可。デフォルトでは、期限でフィルタされません。 |
due |
フィルタするタスクの期限の下限(RFC 3339 タイムスタンプ)。省略可。デフォルトでは、期限でフィルタされません。 |
max |
1 ページで返されるタスクの最大数。省略可。デフォルトは 20(最大許容値: 100)です。 |
page |
返される結果ページを指定するトークン。省略可。 |
show |
完了したタスクが結果に返されるかどうかを示すフラグ。ウェブ UI や 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[] |
タスクのコレクション。 |