指定されたタスクリスト内のすべてのタスクを返します。非表示でないタスクは、リストごとに最大 20,000 件、合計で一度に 100,000 件まで設定できます。
HTTP リクエスト
GET https://tasks.googleapis.com/tasks/v1/lists/{tasklist}/tasks
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
tasklist |
タスクリストの識別子。 |
クエリ パラメータ
パラメータ | |
---|---|
completedMax |
フィルタに使用するタスクの完了日の上限(RFC 3339 タイムスタンプで指定)。省略可。デフォルトでは、完了日でフィルタされません。 |
completedMin |
フィルタに使用するタスクの完了日の下限(RFC 3339 タイムスタンプ)。省略可。デフォルトでは、完了日でフィルタされません。 |
dueMax |
フィルタするタスクの期限の上限(RFC 3339 タイムスタンプによる)。省略可。デフォルトでは、期限によるフィルタは行われていません。 |
dueMin |
フィルタするタスクの期限の下限(RFC 3339 タイムスタンプ)。省略可。デフォルトでは、期限によるフィルタは行われていません。 |
maxResults |
1 ページで返されるタスクの最大数。省略可。デフォルトは 20 です(最大許容数: 100)。 |
pageToken |
返す結果ページを指定するトークン。省略可。 |
showCompleted |
完了したタスクが結果で返されるかどうかを示すフラグ。省略可。デフォルトは True です。なお、ウェブ UI や Google のモバイルアプリなどのファースト パーティ クライアントで完了したタスクを表示するには、showHidden も True である必要があります。 |
showDeleted |
削除されたタスクが結果で返されるかどうかを示すフラグ。省略可。デフォルトは False です。 |
updatedMin |
フィルタに使用するタスクの最終更新時間の下限(RFC 3339 タイムスタンプ)。省略可。デフォルトでは、最終更新日時でフィルタされません。 |
リクエスト本文
リクエストの本文は空にする必要があります。
レスポンスの本文
成功すると、レスポンスの本文に次の構造のデータが含まれます。
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[] |
タスクのコレクション。 |