ユーザーのニーズや好みに合わせて、タスクを特定の順序で整理できます。タスクは別のタスクの下(parent
タスク)や、別のタスクの後(previous
)に移動できます。
タスクを移動するには、次の特別なパラメータを指定して、認証済みの POST
リクエストを次の URL に送信します。
parent
パラメータ- 新しいタスクを挿入する親タスクの ID を指定します。このパラメータを省略すると、タスクはリストの最上位に配置されます。
previous
パラメータ- 新しいタスクを挿入する前に、タスクの ID を指定します。このパラメータを省略すると、タスクがサブリストの先頭に配置されます。
URL の形式は次のとおりです。
https://www.googleapis.com/tasks/v1/lists/taskListID
/tasks/taskID
/move?parent=parentTaskID
&previous=previousTaskID
taskListID
、taskID
、parentTaskID
、previousTaskID
の代わりに適切な値を使用します。
注: 特別な taskListID
値 @default
を使用すると、認証されたユーザーのデフォルトのタスクリストを参照できます。
成功すると、サーバーは HTTP 200 OK
ステータス コードと新しいタスクデータを返します。
例
プロトコル
リクエスト:
POST /tasks/v1/lists/@default/tasks/taskID
/move?parent=parentTaskID
&previous=previousTaskID
レスポンス:
HTTP/1.1 200 OK { id: "taskID", kind: "tasks#task", selfLink: "https://www.googleapis.com/tasks/v1/lists/@default/tasks/taskID", etag: "newETag", title: "New Task", notes: "Please complete me", updated: "2010-10-15T11:30:00.000Z", ..., parent: "parentTaskID", position: "newPosition", ... }
Java
import com.google.api.services.tasks.v1.Tasks.TasksOperations.Move; ... Move move = service.tasks.move("@default", "taskID"); move.setParent("parentTaskID"); move.setPrevious("previousTaskID"); Task result = move.execute(); // Print the new values. System.out.println(result.getParent()); System.out.println(result.getPosition());
Python
result = service.tasks().move(tasklist='@default', task='taskID', parent='parentTaskID', previous='previousTaskID').execute() # Print the new values. print result['parent'] print result['position']
PHP
$result = $service->moveTasks('taskID', '@default', null, 'parentTaskID', 'previousTaskID'); /* * Print the new values. */ echo $result->getParent(); echo $result->getPosition();
.NET
Task result = service.Tasks.Move("@default", "taskID", parent: "parentTaskID", previous: "previousTaskID").Fetch(); // Print the new values. Console.WriteLine(result.Parent); Console.WriteLine(result.Position);
注: parent
パラメータと previous
パラメータは、新しいタスクの作成時にも使用できます。