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)と同じです。
おしまい。。