日本時間5月16日のContent Cloud Summitで、カスタムアプリにBox AI APIを活用する方法を紹介します。

詳細を表示

タスク割り当てのリストを取得

get
https://api.box.com/2.0
/tasks/:task_id/assignments

指定したタスクのすべての割り当てのリストを取得します。

リクエスト

bearer [ACCESS_TOKEN]
application/json

パスパラメータ

stringパス内必須
12345

タスクのID。

レスポンス

application/jsonタスク割り当て

ファイルに対するどのようなタスクを誰が誰に割り当てているかを定義するタスク割り当てのコレクションを返します。

タスクが見つからなかった場合、またはタスクが割り当てられているファイルにユーザーがアクセスできない場合はエラーを返します。

リクエストでタスク割り当てIDが省略されている場合はエラーを返します。

予期しないクライアントエラー。

get
タスク割り当てのリストを取得
このドキュメント内で一部のAPIを試せるようになりました。
ログイン

リクエストの例

cURL
curl -i -X GET "https://api.box.com/2.0/tasks/12345/assignments" \
     -H "authorization: Bearer <ACCESS_TOKEN>"
.NET
BoxCollection<BoxTaskAssignment> assignments = await client.TasksManager
    .GetAssignmentsAsync(taskId: "11111");
Java
BoxTask task = new BoxTask(api, "id");
task.getAssignments();
Node
client.tasks.getAssignments('11111')
	.then(assignments => {
		/* assignments -> {
			total_count: 1,
			entries: 
			[ { type: 'task_assignment',
				id: '22222',
				item: 
					{ type: 'file',
					id: '44444',
					sequence_id: '0',
					etag: '0',
					sha1: '0bbd79a105c504f99573e3799756debba4c760cd',
					name: 'box-logo.png' },
				assigned_to: 
					{ type: 'user',
					id: '33333',
					name: 'Example User',
					login: 'user@example.com' } } ] }
		*/
	});

レスポンスの例

{
  "entries": [
    {
      "id": "11446498",
      "type": "task_assignment",
      "item": {
        "id": "12345",
        "etag": "1",
        "type": "file",
        "sequence_id": "3",
        "name": "Contract.pdf",
        "sha1": "85136C79CBF9FE36BB9D05D0639C70C265C18D37",
        "file_version": {
          "id": "12345",
          "type": "file_version",
          "sha1": "134b65991ed521fcfe4724b7d814ab8ded5185dc"
        }
      },
      "assigned_to": {
        "id": "11446498",
        "type": "user",
        "name": "Aaron Levie",
        "login": "ceo@example.com"
      },
      "message": "Please review",
      "completed_at": "2012-12-12T10:53:43-08:00",
      "assigned_at": "2012-12-12T10:53:43-08:00",
      "reminded_at": "2012-12-12T10:53:43-08:00",
      "resolution_state": "incomplete",
      "assigned_by": {
        "id": "11446498",
        "type": "user",
        "name": "Aaron Levie",
        "login": "ceo@example.com"
      }
    }
  ],
  "total_count": 100
}