Method: tasks.move

指定したタスクを、宛先タスクリスト内の別の位置に移動します。宛先リストが指定されていない場合、タスクは現在のリスト内で移動されます。たとえば、新しい親の下に子タスクとして配置したり、兄弟タスク間で異なる位置に移動したりできます。タスクごとに最大 2,000 個のサブタスクを作成できます。

HTTP リクエスト

POST https://tasks.googleapis.com/tasks/v1/lists/{tasklist}/tasks/{task}/move

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

パスパラメータ

パラメータ
tasklist

string

タスクリストの ID。

task

string

タスク ID。

クエリ パラメータ

パラメータ
parent

string

新しい親タスクの識別子。タスクをトップレベルに移動した場合、このパラメータは省略されます。割り当てられたタスクを親タスクとして設定する(サブタスクを持つ)ことも、親タスクの下に移動(サブタスクになる)することもできません。省略可。

previous

string

以前の新しい兄弟タスクの識別子。タスクが兄弟要素の中で最初の位置に移動された場合、このパラメータは省略されます。省略可。

destinationTasklist

string

省略可。宛先タスクリストの ID。設定すると、タスクは tasklist から destinationTasklist に移動されます。それ以外の場合は、タスクが現在のリスト内で移動されます。現在、繰り返しタスクはリスト間で移動できません。省略可。

リクエスト本文

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

レスポンスの本文

成功した場合、レスポンスの本文には Task のインスタンスが含まれます。

認可スコープ

次の OAuth スコープが必要です。

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

詳細については、承認ガイドをご覧ください。