BoxWorks 2024でコンテンツとAIの可能性について紹介します。

詳細を表示

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

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>"
TypeScript Gen
await client.taskAssignments.getTaskAssignments(task.id!);
Python Gen
client.task_assignments.get_task_assignments(task.id)
.NET Gen
await client.TaskAssignments.GetTaskAssignmentsAsync(taskId: NullableUtils.Unwrap(task.Id));
Java
BoxTask task = new BoxTask(api, "id");
task.getAssignments();
.NET
BoxCollection<BoxTaskAssignment> assignments = await client.TasksManager
    .GetAssignmentsAsync(taskId: "11111");
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
}