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。タスクが最上位に移動された場合、このパラメータは省略されます。親として設定されたタスクはタスクリスト内に存在する必要があり、非表示にすることはできません。

例外: 1. 割り当てられたタスクを親タスクとして設定したり、親タスクの下に移動してサブタスクにしたりすることはできません。2. 完了済みかつ非表示のタスクはネストできないため、親フィールドは空にする必要があります。
previous

string

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

例外: 1. 完了済みかつ非表示のタスクは、位置 0 にのみ移動できるため、前のフィールドは空にする必要があります。
destinationTasklist

string

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

リクエストの本文

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

レスポンスの本文

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

認可スコープ

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

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

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