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

親タスクの ID。このフィールドは、トップレベルのタスクの場合省略されます。このフィールドは読み取り専用です。タスクを別の親の配下または最上位に移動するには、「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

リンクの種類(「メール」など)。

links[].description

string

説明。HTML で言うと、<a> と </a> の間のすべてのもの。

links[].link

string

URL。

Methods

clear

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

delete

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

get

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

insert

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

list

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

move

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

patch

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

update

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