Box Developerドキュメント
 

    タスクの作成

    ガイド タスク タスクの作成

    タスクの作成

    タスクを作成するには、タスクのactionと、タスクの追加先となるファイルを表すitemを指定してPOST /tasks APIを呼び出す必要があります。

    cURL
    curl -i -X POST "https://api.box.com/2.0/tasks" \
         -H "authorization: Bearer <ACCESS_TOKEN>" \
         -H "content-type: application/json" \
         -d '{
           "item": {
             "id": "11446498",
             "type": "file"
           },
           "action": "review"
         }'

    タスクのアクション

    Boxは現在、action値によって定義される、reviewcompleteという2種類のタスクをサポートしています。

    タスクのタイプによって、タスクがなりうる解決状態と、ウェブアプリおよびモバイルアプリでユーザーに表示されるインターフェースが決まります。

    タスクのアクション考えられる解決状態
    reviewincomplete, approved, rejected
    completeincomplete, complete

    reviewタスクはincomplete状態で開始され、incompleteapproved、またはrejectedとしてマークすることができます。ユーザーインターフェースには、テキストボックスのほか、タスクを承認または拒否する1組のボタンが表示されます。

    completeタスクはincomplete状態で開始され、incompleteまたはcompletedとしてマークすることができます。このタスクが完了としてマークされると、タスクの状態をそれ以上変更することはできなくなります。ユーザーインターフェースには、テキストボックスのほか、タスクを完了としてマークするためのボタンが表示されます。

    完了のルール

    ファイルに関連するタスクは、そのファイルの複数のコラボレータに割り当てることができます。また、タスクのcompletion_ruleを使用すると、タスクを完了する必要があるのはタスクが割り当てられているすべてのユーザー (all_assignees) か1人の担当者のみ (any_assignee) かを定義できます。