指定したタスクを、宛先タスクリスト内の別の位置に移動します。宛先リストが指定されていない場合、タスクは現在のリスト内で移動されます。たとえば、新しい親の下に子タスクとして配置したり、兄弟タスク間で異なる位置に移動したりできます。タスクごとに最大 2,000 個のサブタスクを作成できます。
HTTP リクエスト
POST https://tasks.googleapis.com/tasks/v1/lists/{tasklist}/tasks/{task}/move
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
tasklist |
タスクリストの ID。 |
task |
タスク ID。 |
クエリ パラメータ
パラメータ | |
---|---|
parent |
新しい親タスクの識別子。タスクをトップレベルに移動した場合、このパラメータは省略されます。割り当てられたタスクを親タスクとして設定する(サブタスクを持つ)ことも、親タスクの下に移動(サブタスクになる)することもできません。省略可。 |
previous |
以前の新しい兄弟タスクの識別子。タスクが兄弟要素の中で最初の位置に移動された場合、このパラメータは省略されます。省略可。 |
destinationTasklist |
省略可。宛先タスクリストの ID。設定すると、タスクは tasklist から destinationTasklist に移動されます。それ以外の場合は、タスクが現在のリスト内で移動されます。現在、繰り返しタスクはリスト間で移動できません。省略可。 |
リクエスト本文
リクエストの本文は空にする必要があります。
レスポンスの本文
成功した場合、レスポンスの本文には Task
のインスタンスが含まれます。
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/tasks
詳細については、承認ガイドをご覧ください。