Google Tasks API V1(Java)を使用して、
タスクリストを作成・更新・削除する方法
についてご紹介します。
タスクリストはタイトルのみ更新できます。
Googleカレンダーからのタスク参照では、
画面左下にあるリストの情報が取得できます。
APIを利用する環境の準備から始める場合や、コードを実行する際は、
⧉[Google Tasks API(V1)] JavaでTasks APIを使う
を参照ください。
| No | 目次 | |
|---|---|---|
| 1 | タスクリストを作成 | |
| 1 | スコープ | |
| 2 | 実行 | |
| 3 | レスポンスの内容 | |
| 2 | タスクリストを上書き | |
| 1 | スコープ | |
| 2 | 実行 | |
| 3 | レスポンスの内容 | |
| 3 | タスクリストを更新 | |
| 1 | スコープ | |
| 2 | 実行 | |
| 3 | レスポンスの内容 | |
| 4 | タスクリストを削除 | |
| 1 | スコープ | |
| 2 | 実行 | |
| 3 | レスポンスの内容 |
1. タスクリストを作成
新しくタスクリストを作成して、タスクリストに追加します。
1.1. スコープ
このAPIを実行するには、以下のスコープを指定してください。
TasksScopes.TASKS
⧉[Google Tasks API(V1)] JavaでTasks APIを使う(2.2 Tasksインスタンスを取得)
でスコープを指定してください。
1.2. 実行
public static void main(String[] args) throws Exception{
Tasks tasks = getTasks();
Tasks.Tasklists tasklists = tasks.tasklists();
TaskList content = new TaskList();
Tasks.Tasklists.Insert insert = tasklists.insert(content);
TaskList res = insert.execute();
System.out.println(res);
}
1.2.1. HTTPリクエスト
POST: https://tasks.googleapis.com/tasks/v1/users/@me/lists
が実行されます。
1.2.2. クエリパラメータ
クエリパラメータはありません。
1.2.3. リクエストボディ
TaskListのsetメソッドにより、リクエストボディを追加できます。
| メソッド | 引数 | 説明 |
|---|---|---|
| setId | String | タスクリストID |
| setTitle | String | タスクリストのタイトル |
1.3. レスポンスの内容
TaskList
| メソッド | 戻り値 | 説明 |
|---|---|---|
| getKind | String | リソースの種類 固定文字列："tasks#taskList" |
| getId | String | タスクリストID |
| getEtag | String | Eタグ |
| getTitle | String | タスクリストのタイトル |
| getUpdated | String | タスクリストの最終更新日時 |
| getSelfLink | String | このタスクリストを指すURL |
2. タスクリストを上書き
指定したタスクリストを上書きします。
2.2.3. リクエストボディ(TaskList)のsetId()は必須です。
タスクリストIDを2度指定することになりますが、指定がないと例外になります。
3. タスクリストを更新と違うところは、
指定した存在するタスクリストをタスクリストに置き換えます。
2.1. スコープ
このAPIを実行するには、以下のスコープを指定してください。
TasksScopes.TASKS
⧉[Google Tasks API(V1)] JavaでTasks APIを使う(2.2 Tasksインスタンスを取得)
でスコープを指定してください。
2.2. 実行
public static void main(String[] args) throws Exception{
Tasks tasks = getTasks();
Tasks.Tasklists tasklists = tasks.tasklists();
TaskList content = new TaskList();
content.setId("タスクリストID");
Tasks.Tasklists.Update update = tasklists.update("タスクリストID",content);
TaskList res = update.execute();
System.out.println(res);
}
2.2.1. HTTPリクエスト
PUT: https://tasks.googleapis.com/tasks/v1/users/@me/lists/{タスクリストID}
が実行されます。
2.2.2. クエリパラメータ
クエリパラメータはありません。
2.2.3. リクエストボディ
TaskListのsetメソッドにより、リクエストボディを追加できます。
1.2.3. リクエストボディと同じです。
2.3. レスポンスの内容
TaskList
1.3. レスポンスの内容(TaskList)と同じです。
3. タスクリストを更新
指定したタスクリストを更新します。
2. タスクリストを上書きと違うところは、
指定した存在するタスクリストを更新します。
3.1. スコープ
このAPIを実行するには、以下のスコープを指定してください。
TasksScopes.TASKS
⧉[Google Tasks API(V1)] JavaでTasks APIを使う(2.2 Tasksインスタンスを取得)
でスコープを指定してください。
3.2. 実行
public static void main(String[] args) throws Exception{
Tasks tasks = getTasks();
Tasks.Tasklists tasklists = tasks.tasklists();
TaskList content = new TaskList();
Tasks.Tasklists.Patch patch = tasklists.patch("タスクリストID",content);
TaskList res = patch.execute();
System.out.println(res);
}
3.2.1. HTTPリクエスト
PATCH: https://tasks.googleapis.com/tasks/v1/users/@me/lists/{タスクリストID}
が実行されます。
3.2.2. クエリパラメータ
クエリパラメータはありません。
3.2.3. リクエストボディ
TaskListのsetメソッドにより、リクエストボディを追加できます。
1.2.3. リクエストボディと同じです。
3.3. レスポンスの内容
TaskList
1.3. レスポンスの内容(TaskList)と同じです。
4. タスクリストを削除
指定したタスクリストを削除します。
4.1. スコープ
このAPIを実行するには、以下のスコープを指定してください。
TasksScopes.TASKS
⧉[Google Tasks API(V1)] JavaでTasks APIを使う(2.2 Tasksインスタンスを取得)
でスコープを指定してください。
4.2. 実行
public static void main(String[] args) throws Exception{
Tasks tasks = getTasks();
Tasks.Tasklists tasklists = tasks.tasklists();
Tasks.Tasklists.Delete delete = tasklists.delete("タスクリストID");
delete.execute();
}
4.2.1. HTTPリクエスト
DELETE: https://tasks.googleapis.com/tasks/v1/users/@me/lists/{タスクリストID}
が実行されます。
4.2.2. クエリパラメータ
クエリパラメータはありません。
4.2.3. リクエストボディ
リクエスボディはありません。
4.3. レスポンスの内容
レスポンスはありません。
削除に失敗した場合、例外が発生します。
おしまい。。