既存のタスクの変更
既存のタスクの変更
Boxでタスクを更新するには、タスクのIDを指定してPUT /tasks/:task_id APIを呼び出す必要があります。このAPIを使用すると、タスクのactionタイプの変更、messageの追加、期日の変更を行うことができます。
cURL
curl -i -X PUT "https://api.box.com/2.0/tasks/12345" \
-H "authorization: Bearer <ACCESS_TOKEN>" \
-H "content-type: application/json" \
-d '{
"action": "review"
}'Node/TypeScript v10
await client.tasks.updateTaskById(task.id!, {
requestBody: {
message: 'updated message',
} satisfies UpdateTaskByIdRequestBody,
} satisfies UpdateTaskByIdOptionalsInput);Python v10
client.tasks.update_task_by_id(task.id, message="updated message").NET v10
await client.Tasks.UpdateTaskByIdAsync(taskId: NullableUtils.Unwrap(task.Id), requestBody: new UpdateTaskByIdRequestBody() { Message = "updated message" });Swift v10
try await client.tasks.updateTaskById(taskId: task.id!, requestBody: UpdateTaskByIdRequestBody(message: "updated message"))Java v10
client.getTasks().updateTaskById(task.getId(), new UpdateTaskByIdRequestBody.Builder().message("updated message").build()).NET v6
await client.Tasks.UpdateTaskByIdAsync(taskId: NullableUtils.Unwrap(task.Id), requestBody: new UpdateTaskByIdRequestBody() { Message = "updated message" });Node v4
await client.tasks.updateTaskById(task.id!, {
requestBody: {
message: 'updated message',
} satisfies UpdateTaskByIdRequestBody,
} satisfies UpdateTaskByIdOptionalsInput);タスクのアクション
Boxは現在、action値によって定義される、reviewとcompleteという2種類のタスクをサポートしています。
タスクのタイプによって、タスクがなりうる解決状態と、ウェブアプリおよびモバイルアプリでユーザーに表示されるインターフェースが決まります。
| タスクのアクション | 考えられる解決状態 |
|---|---|
review | incomplete, approved, rejected |
complete | incomplete, complete |
reviewタスクはincomplete状態で開始され、incomplete、approved、またはrejectedとしてマークすることができます。ユーザーインターフェースには、テキストボックスのほか、タスクを承認または拒否する1組の ボタンが表示されます。
completeタスクはincomplete状態で開始され、incompleteまたはcompletedとしてマークすることができます。このタスクが完了としてマークされると、タスクの状態をそれ以上変更することはできなくなります。ユーザーインターフェースには、テキストボックスのほか、タスクを完了としてマークするためのボタンが表示されます。
完了のルール
ファイルに関連するタスクは、そのファイルの複数のコラボレータに割り当てることができます。また、タスクのcompletion_ruleを使用すると、タスクを完了する必要があるのはタスクが割り当てられているすべてのユーザー (all_assignees) か1人の担当者のみ (any_assignee) かを定義できます。