最新バージョン
ファイルに対するタスクのリストを取得
APIバージョン 2024.0
そのファイルに関連するすべてのタスクのリストを取得します。このエンドポイントはページ割りをサポートしていません。
リクエスト
bearer [ACCESS_TOKEN]
application/json
パスパラメータ
stringパス内必須
12345ファイルを表す一意の識別子。
ファイルIDを確認するには、ウェブアプリケーションでファイルにアクセスして、URLからIDをコピーします。たとえば、URLがhttps://*.app.box.com/files/123の場合、file_idは123です。
レスポンス
application/jsonTasks
ファイルに関連するタスクのリストを返します。
このファイルに関連するタスクが存在しない場合は、空のコレクションが返されます。
application/jsonクライアントエラー
ファイルが見つからない場合、またはユーザーがファイルにアクセスで きない場合はエラーを返します。
application/jsonクライアントエラー
file_idが指定されていない場合はエラーを返します。
application/jsonクライアントエラー
IDが0のファイルのタスクを取得しようとした場合はエラーを返します。
application/jsonクライアントエラー
予期しないクライアントエラー。
リクエストの例
cURL
curl -i -X GET "https://api.box.com/2.0/files/12345/tasks" \
-H "authorization: Bearer <ACCESS_TOKEN>"TypeScript Gen
await client.tasks.getFileTasks(file.id);Python Gen
client.tasks.get_file_tasks(file.id).NET Gen
await client.Tasks.GetFileTasksAsync(fileId: file.Id);Java
BoxFile file = new BoxFile(api, "id");
List<BoxTask.Info> tasks = file.getTasks();Python
tasks = client.file(file_id='11111').get_tasks()
for task in tasks:
print(f'Task ID is {task.id} and the type is {task.type}').NET
BoxCollection<BoxTask> tasks = await client.FilesManager.FilesManager.GetFileTasks("11111");Node
client.files.getTasks('11111')
.then(tasks => {
/* tasks -> {
total_count: 1,
entries:
[ { type: 'task',
id: '22222',
item:
{ type: 'file',
id: '11111',
sequence_id: '6',
etag: '6',
sha1: '81cc829fb8366fcfc108aa6c5a9bde01a6a10c16',
name: 'box-logo.png' },
due_at: null } ] }
*/
});iOS
let iterator = client.files.listTasks(forFile: "11111")
iterator.next { results in
switch results {
case let .success(page):
for task in page.entries {
print("Task messsage: \(task.message)")
}
case let .failure(error):
print(error)
}
}レスポンスの例
{
"entries": [
{
"action": "review",
"completion_rule": "all_assignees",
"created_at": "2012-12-12T10:53:43-08:00",
"created_by": {
"id": "11446498",
"type": "user",
"login": "ceo@example.com",
"name": "Aaron Levie"
},
"due_at": "2012-12-12T10:53:43-08:00",
"id": "11446498",
"is_completed": true,
"item": {
"etag": "1",
"id": "12345",
"type": "file",
"file_version": {
"id": "12345",
"type": "file_version",
"sha1": "134b65991ed521fcfe4724b7d814ab8ded5185dc"
},
"name": "Contract.pdf",
"sequence_id": "3",
"sha1": "85136C79CBF9FE36BB9D05D0639C70C265C18D37"
},
"message": "Legal review",
"task_assignment_collection": {
"entries": [
{
"assigned_at": "2012-12-12T10:53:43-08:00",
"assigned_by": {
"id": "11446498",
"type": "user",
"login": "ceo@example.com",
"name": "Aaron Levie"
},
"assigned_to": {
"id": "11446498",
"type": "user",
"login": "ceo@example.com",
"name": "Aaron Levie"
},
"completed_at": "2012-12-12T10:53:43-08:00",
"id": "11446498",
"item": {
"etag": "1",
"id": "12345",
"type": "file",
"file_version": {
"id": "12345",
"type": "file_version",
"sha1": "134b65991ed521fcfe4724b7d814ab8ded5185dc"
},
"name": "Contract.pdf",
"sequence_id": "3",
"sha1": "85136C79CBF9FE36BB9D05D0639C70C265C18D37"
},
"message": "Please review",
"reminded_at": "2012-12-12T10:53:43-08:00",
"resolution_state": "incomplete",
"type": "task_assignment"
}
],
"total_count": 100
},
"type": "task"
}
],
"total_count": 5000
}