Google Tasks API V1(Java)を使用して、
タスクリスト内のタスクの順序変更や親タスクを設定する方法
についてご紹介します。

なお、このAPIでは同一タスクリスト内のみ移動が可能です。

APIを利用する環境の準備から始める場合や、コードを実行する際は、
⧉[Google Tasks API(V1)] JavaでTasks APIを使う
を参照ください。

No		目次
1		タスクを移動
	1	スコープ
	2	実行
	3	レスポンスの内容
2		親タスクの指定
	1	スコープ
	2	実行
	3	レスポンスの内容

1. タスクを移動

指定したタスクを指定したタスクリストに移動します。

1.1. スコープ

このAPIを実行するには、以下のスコープを指定してください。

TasksScopes.TASKS

⧉[Google Tasks API(V1)] JavaでTasks APIを使う(2.2 Tasksインスタンスを取得)
でスコープを指定してください。

1.2. 実行

setPreviousで指定した「兄としたいタスクID」の次にタスクが移動します。

public static void main(String[] args) throws Exception{
    Tasks tasks = getTasks();
    Tasks.TasksOperations op = tasks.tasks();
    
    Tasks.TasksOperations.Move move = op.move("タスクリストID","タスクID");
    move.setPrevious("兄としたいタスクID");
    
    Task res = move.execute();
    System.out.println(res);
}

1.2.1. HTTPリクエスト

POST:　https://tasks.googleapis.com/tasks/v1/lists/{タスクリストID}/tasks/{タスクID}/move
が実行されます。

1.2.2. クエリパラメータ

Tasks.TasksOperations.Moveのsetメソッドにより、クエリパラメータを追加できます。

メソッド	引数	説明
setPrevious	String	兄としたいタスクID ここで指定したタスクIDの下に移動します

1.2.3. リクエストボディ

リクエスボディはありません。

1.3. レスポンスの内容

Task

(com.google.api.services.tasks.model.Tasks)

メソッド	戻り値	説明
getKind	String	リソースの種類固定文字列："tasks#task"
getId	String	タスクID
getEtag	String	Eタグ
getTitle	String	タスクのタイトル
getUpdated	String	タスクの最終更新日時
getSelfLink	String	このタスクを指すURL
getParent	String	親のタスクID
getPosition	String	同じ親タスクの下または最上位にある兄弟タスク間のタスクの位置
getNotes	String	タスクについてのメモ
getStatus	String	タスクのステータス "needsAction"、"completed"
getDue	String	タスクの期限
getCompleted	String	タスクの完了日
getDeleted	Boolean	タスクが削除されたか
getHidden	Boolean	タスクが非表示か
getLinks	List<Linkes	リンク情報
getWebViewLink	String	GoogleToDoリストのタスクURL

Linkes

メソッド	戻り値	説明
getType	String	リンクの種類
getDescription	String	説明文(HTML)
link	String	URL

2. 親タスクの指定

指定したタスクを指定したタスクの子にします。

2.1. スコープ

1.1. スコープと同じです。

1.2. 実行

setParentで指定した「親にしたいタスクID」の子にタスクが移動します。

public static void main(String[] args) throws Exception{
    Tasks tasks = getTasks();
    Tasks.TasksOperations op = tasks.tasks();
    
    Tasks.TasksOperations.Move move = op.move("タスクリストID","タスクID");
    move.setParent("親にしたいタスクID");
    
    Task res = move.execute();
    System.out.println(res);
}

2.2.1. HTTPリクエスト

1.2.1. HTTPリクエストと同じです。

1.2.2. クエリパラメータ

Tasks.TasksOperations.Moveのsetメソッドにより、クエリパラメータを追加できます。

メソッド	引数	説明
setParent	String	親にしたいタスクID ここで指定したタスクIDの子に移動します

1.2.3. リクエストボディ

リクエスボディはありません。

2.3. レスポンスの内容

Task

1.3. レスポンスの内容(Task)と同じです。

おしまい。。