Method: tasks.list

指定されたタスクリスト内のすべてのタスクを返します。ユーザーは、リストごとに最大 20,000 個の未完了タスクを保持でき、一度に合計で最大 100,000 個のタスクを保持できます。

HTTP リクエスト

GET https://tasks.googleapis.com/tasks/v1/lists/{tasklist}/tasks

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
tasklist

string

タスクリストの識別子。

クエリ パラメータ

パラメータ
completedMax

string

フィルタに使用するタスクの完了日の上限（RFC 3339 タイムスタンプで指定）。省略可。デフォルトでは、完了日でフィルタされません。
completedMin

string

フィルタに使用するタスクの完了日の下限（RFC 3339 タイムスタンプ）。省略可。デフォルトでは、完了日でフィルタされません。
dueMax

string

フィルタするタスクの期限の上限（RFC 3339 タイムスタンプによる）。省略可。デフォルトでは、期限によるフィルタは行われていません。
dueMin

string

フィルタするタスクの期限の下限（RFC 3339 タイムスタンプ）。省略可。デフォルトでは、期限によるフィルタは行われていません。
maxResults

integer

1 ページで返されるタスクの最大数。省略可。デフォルトは 20 です（最大許容数: 100）。
pageToken

string

返す結果ページを指定するトークン。省略可。
showCompleted

boolean

完了したタスクが結果で返されるかどうかを示すフラグ。省略可。デフォルトは True です。なお、ウェブ UI や Google のモバイルアプリなどのファースト パーティ クライアントで完了したタスクを表示するには、showHidden も True である必要があります。
showDeleted

boolean

削除されたタスクが結果で返されるかどうかを示すフラグ。省略可。デフォルトは False です。
showHidden

boolean

結果で非表示のタスクが返されるかどうかを示すフラグ。省略可。デフォルトは False です。
updatedMin

string

フィルタに使用するタスクの最終更新時間の下限（RFC 3339 タイムスタンプ）。省略可。デフォルトでは、最終更新日時でフィルタされません。

リクエスト本文

リクエストの本文は空にする必要があります。

レスポンスの本文

成功すると、レスポンスの本文に次の構造のデータが含まれます。

JSON 表現 
{
  "kind": string,
  "etag": string,
  "nextPageToken": string,
  "items": [
    {
      object (Task)
    }
  ]
}
フィールド
kind

string

リソースのタイプ。常に「tasks#tasks」です。
etag

string

リソースの ETag。
nextPageToken

string

この結果の次のページにアクセスするために使用されるトークン。
items[]

object (Task)

タスクのコレクション。

承認スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/tasks
  • https://www.googleapis.com/auth/tasks.readonly

詳しくは、承認ガイドをご覧ください。

タスク

JSON 表現 
{
  "kind": string,
  "etag": string,
  "nextPageToken": string,
  "items": [
    {
      object (Task)
    }
  ]
}
フィールド
kind

string

リソースのタイプ。常に「tasks#tasks」です。
etag

string

リソースの ETag。
nextPageToken

string

この結果の次のページにアクセスするために使用されるトークン。
items[]

object (Task)

タスクのコレクション。