Method: tasks.list

指定されたタスクリストのすべてのタスクを返します。デフォルトでは、割り当てられたタスク(ドキュメント、Chat スペースから)は返されません。ユーザーは、リストごとに最大 20,000 件の非公開タスクを、一度に最大 100,000 件のタスクを作成できます。

HTTP リクエスト

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

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

パスパラメータ

パラメータ
tasklist

string

タスクリストの ID。

クエリ パラメータ

パラメータ
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

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

showDeleted

boolean

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

showHidden

boolean

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

updatedMin

string

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

showAssigned

boolean

省略可。現在のユーザーに割り当てられたタスクが結果に返されるかどうかを示すフラグ。省略可。デフォルトは False です。

リクエストの本文

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

レスポンスの本文

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

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)

タスクのコレクション。