REST Resource: tasks

リソース: Task

JSON 表現
{
  "kind": string,
  "id": string,
  "etag": string,
  "title": string,
  "updated": string,
  "selfLink": string,
  "parent": string,
  "position": string,
  "notes": string,
  "status": string,
  "due": string,
  "completed": string,
  "deleted": boolean,
  "hidden": boolean,
  "links": [
    {
      "type": string,
      "description": string,
      "link": string
    }
  ],
  "webViewLink": string
}
フィールド
kind

string

出力専用。リソースのタイプ。常に「tasks#task」になります。

id

string

タスク ID。

etag

string

リソースの ETag。

title

string

タスクのタイトル。最大文字数: 1,024 文字。

updated

string

出力専用。タスクの最終更新日時(RFC 3339 タイムスタンプ形式)。

parent

string

出力専用。親タスクの識別子。トップレベル タスクの場合、このフィールドは省略されます。このフィールドは読み取り専用です。タスクを別の親の下やトップレベルに移動するには、move メソッドを使用します。

position

string

出力専用。同じ親タスクまたはトップレベルにある兄弟タスクの中でのタスクの位置を示す文字列。この文字列が、辞書順に従って別のタスクの対応する位置文字列よりも大きい場合、そのタスクは同じ親タスクの下で(またはトップレベル)他のタスクの後に配置します。タスクを別の位置に移動するには、move メソッドを使用します。

notes

string

タスクに関するメモ。省略可。最大文字数: 8,192 文字。

status

string

タスクのステータス。これは「needsAction」または「completed」です。

due

string

タスクの期限(RFC 3339 タイムスタンプ)。省略可。期限には日付情報のみが記録されます。期限を設定すると、タイムスタンプの時刻部分は破棄されます。API を使用してタスクの期限を読み書きすることはできません。

completed

string

タスクの完了日(RFC 3339 タイムスタンプ形式)。タスクが完了していない場合、このフィールドは省略されます。

deleted

boolean

タスクが削除されたかどうかを示すフラグ。デフォルトは False です。

hidden

boolean

タスクが非表示かどうかを示すフラグ。これは、タスクリストが最後にクリアされたときに、タスクが完了としてマークされている場合に該当します。デフォルトは False です。このフィールドは読み取り専用です。

links[].type

string

リンクのタイプ(「email」など)。

links[].description

string

説明。HTML では、<a> と </a> の間にあるすべての内容を表現します。

links[].link

string

URL。

メソッド

clear

指定したタスクリストから、完了したすべてのタスクをクリアします。

delete

指定したタスクをタスクリストから削除します。

get

指定されたタスクを返します。

insert

指定したタスクリストに新しいタスクを作成します。

list

指定されたタスクリストのすべてのタスクを返します。

move

指定したタスクをタスクリスト内の別の位置に移動します。

patch

指定したタスクを更新します。

update

指定したタスクを更新します。