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

新しい親タスク ID。タスクが最上位に移動されている場合、このパラメータは省略されます。親として設定するタスクはタスクリスト内に存在している必要があり、非表示にすることはできません。割り当てられたタスクを親タスクとして設定したり、親タスクの下に移動してサブタスクにしたりすることはできません。省略可。
previous

string

新しい前の兄弟タスク ID。タスクが兄弟の最初の位置に移動する場合、このパラメータは省略されます。前のタスクとして設定するタスクはタスクリストに存在している必要があり、非表示にすることはできません。省略可。
destinationTasklist

string

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

リクエストの本文

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

レスポンスの本文

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

認可スコープ

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

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

詳しくは、認可ガイドをご覧ください。