电子邮件联系我们
  1. bob客服端下载获取API V2文档
  2. 项目的API
  3. 项目任务分配

项目任务分配

需要管理员或项目经理权限。

任务分配对象

属性 类型 描述
id 整数 任务分配的唯一ID。
项目 对象 包含关联项目的id、名称和代码的对象。
任务 对象 包含关联任务的id和名称的对象。
is_active 布尔 任务分配是活动的还是存档的。
计费 布尔 任务分配是否可计费。例如:如果设置为true，在此项目上为相关任务跟踪的所有时间将标记为可计费的。
hourly_rate 小数 项目时使用的费率bill_by是任务．
预算 小数 预算用于项目进行时budget_by是任务或task_fees．
created_at datetime 创建任务分配的日期和时间。
updated_at datetime 最后更新任务分配的日期和时间。

列出所有任务分配

返回任务分配的列表。任务分配按创建日期排序返回，最近创建的任务分配出现在前面。

响应包含一个对象task_assignments属性，该属性包含最多到的数组per_page任务分配。数组中的每个条目都是一个单独的任务分配对象。如果没有更多可用的任务分配，则结果数组将为空。响应中包含了几个额外的分页属性，以简化任务分配的分页。

获得/ v2 / task_assignments
参数 类型 描述
is_active 布尔 通过真正的仅返回活动任务分配和假返回非活动的任务分配。
updated_since datetime 只返回自给定日期和时间以来更新过的任务分配。
页面 整数 在分页中使用的页码。例如，如果您提出一个列表请求并收到2000条记录，您的后续呼叫可以包括页面= 2检索列表的下一页。(默认值:1)
per_page 整数 每页要返回的记录数。取值范围为1 ~ 2000。(默认:2000)

示例请求:

curl "https://api.bob客服端下载harvestapp.com/v2/task_assignments" \ -H "授权:持有者$ACCESS_TOKEN" \ -H "收获帐户id: $ACCOUNT_ID" \ -H "User-Agent: MyApp (yourname@example.com)"

示例响应:

｛“task_assignments”:【｛“id”:160726647，“计费”:假，“is_active”:真正的，“created_at”:“2017 - 08 - 22 - t17:36:54z”，“updated_at”:“2017 - 08 - 22 - t17:36:54z”，“hourly_rate”:100.0，“预算”:零，“项目”: {“id”:14808188，“名称”:“工作组”，“代码”:“助教”}，“任务”: {“id”:8083369，“名称”:“研究”｝}，｛“id”:160726646，“计费”:真正的，“is_active”:真正的，“created_at”:“2017 - 08 - 22 - t17:36:54z”，“updated_at”:“2017 - 08 - 22 - t17:36:54z”，“hourly_rate”:100.0，“预算”:零，“项目”: {“id”:14808188，“名称”:“工作组”，“代码”:“助教”}，“任务”: {“id”:8083368，“名称”:“项目管理”｝}，｛“id”:160726645，“计费”:真正的，“is_active”:真正的，“created_at”:“2017 - 08 - 22 - t17:36:54z”，“updated_at”:“2017 - 08 - 22 - t17:36:54z”，“hourly_rate”:100.0，“预算”:零，“项目”: {“id”:14808188，“名称”:“工作组”，“代码”:“助教”}，“任务”: {“id”:8083366，“名称”:“编程”｝}，｛“id”:160726644，“计费”:真正的，“is_active”:真正的，“created_at”:“2017 - 08 - 22 - t17:36:54z”，“updated_at”:“2017 - 08 - 22 - t17:36:54z”，“hourly_rate”:100.0，“预算”:零，“项目”: {“id”:14808188，“名称”:“工作组”，“代码”:“助教”}，“任务”: {“id”:8083365，“名称”:“平面设计”｝}，｛“id”:155505153，“计费”:假，“is_active”:真正的，“created_at”:“2017 - 06 - 26 t21:53:20z”，“updated_at”:“2017 - 06 - 26 t21:54:31z”，“hourly_rate”:100.0，“预算”:零，“项目”: {“id”:14307913，“名称”:“营销网站”，“代码”:“瓦”}，“任务”: {“id”:8083369，“名称”:“研究”｝}，｛“id”:155505016，“计费”:假，“is_active”:真正的，“created_at”:“2017 - 06 - 26 t21:52:18z”，“updated_at”:“2017 - 06 - 26 t21:54:06z”，“hourly_rate”:100.0，“预算”:零，“项目”: {“id”:14308069，“名称”:“网上商店-第一期”，“代码”:“OS1”}，“任务”: {“id”:8083369，“名称”:“研究”｝}，｛“id”:155505015，“计费”:真正的，“is_active”:真正的，“created_at”:“2017 - 06 - 26 t21:52:18z”，“updated_at”:“2017 - 06 - 26 t21:52:18z”，“hourly_rate”:100.0，“预算”:零，“项目”: {“id”:14308069，“名称”:“网上商店-第一期”，“代码”:“OS1”}，“任务”: {“id”:8083368，“名称”:“项目管理”｝}，｛“id”:155505014，“计费”:真正的，“is_active”:真正的，“created_at”:“2017 - 06 - 26 t21:52:18z”，“updated_at”:“2017 - 06 - 26 t21:52:18z”，“hourly_rate”:100.0，“预算”:零，“项目”: {“id”:14308069，“名称”:“网上商店-第一期”，“代码”:“OS1”}，“任务”: {“id”:8083366，“名称”:“编程”｝}，｛“id”:155505013，“计费”:真正的，“is_active”:真正的，“created_at”:“2017 - 06 - 26 t21:52:18z”，“updated_at”:“2017 - 06 - 26 t21:52:18z”，“hourly_rate”:100.0，“预算”:零，“项目”: {“id”:14308069，“名称”:“网上商店-第一期”，“代码”:“OS1”}，“任务”: {“id”:8083365，“名称”:“平面设计”｝}，｛“id”:155502711，“计费”:真正的，“is_active”:真正的，“created_at”:“2017 - 06 - 26 t21:36:23z”，“updated_at”:“2017 - 06 - 26 t21:36:23z”，“hourly_rate”:100.0，“预算”:零，“项目”: {“id”:14307913，“名称”:“营销网站”，“代码”:“瓦”}，“任务”: {“id”:8083368，“名称”:“项目管理”｝}，｛“id”:155502710，“计费”:真正的，“is_active”:真正的，“created_at”:“2017 - 06 - 26 t21:36:23z”，“updated_at”:“2017 - 06 - 26 t21:36:23z”，“hourly_rate”:100.0，“预算”:零，“项目”: {“id”:14307913，“名称”:“营销网站”，“代码”:“瓦”}，“任务”: {“id”:8083366，“名称”:“编程”｝}，｛“id”:155502709，“计费”:真正的，“is_active”:真正的，“created_at”:“2017 - 06 - 26 t21:36:23z”，“updated_at”:“2017 - 06 - 26 t21:36:23z”，“hourly_rate”:100.0，“预算”:零，“项目”: {“id”:14307913，“名称”:“营销网站”，“代码”:“瓦”}，“任务”: {“id”:8083365，“名称”:“平面设计”｝｝),“per_page”:2000，“total_pages”:1，“total_entries”:12，“next_page”:零，“previous_page”:零，“页面”:1，“链接”: {“第一”:“https://api.bob客服端下载harvestapp.com/v2/task_assignments?page=1&per_page=2000”，“下一个”:零，“以前”:零，“最后一次”:“https://api.bob客服端下载harvestapp.com/v2/task_assignments?page=1&per_page=2000”｝｝

列出一个特定项目的所有任务分配

返回所标识的项目的任务分配列表PROJECT_ID．任务分配按创建日期排序返回，最近创建的任务分配出现在前面。

响应包含一个对象task_assignments属性，该属性包含最多到的数组per_page任务分配。数组中的每个条目都是一个单独的任务分配对象。如果没有更多可用的任务分配，则结果数组将为空。响应中包含了几个额外的分页属性，以简化任务分配的分页。

GET / v2 /项目/ {PROJECT_ID} / task_assignments
参数 类型 描述
is_active 布尔 通过真正的仅返回活动任务分配和假返回非活动的任务分配。
updated_since datetime 只返回自给定日期和时间以来更新过的任务分配。
页面 整数 在分页中使用的页码。例如，如果您提出一个列表请求并收到2000条记录，您的后续呼叫可以包括页面= 2检索列表的下一页。(默认值:1)
per_page 整数 每页要返回的记录数。取值范围为1 ~ 2000。(默认:2000)

示例请求:

curl "https://api.bob客服端下载harvestapp.com/v2/projects/14308069/task_assignments" \ -H "授权:持有者$ACCESS_TOKEN" \ -H "收获帐户id: $ACCOUNT_ID" \ -H "User-Agent: MyApp (yourname@example.com)"

示例响应:

｛“task_assignments”:【｛“id”:155505016，“计费”:假，“is_active”:真正的，“created_at”:“2017 - 06 - 26 t21:52:18z”，“updated_at”:“2017 - 06 - 26 t21:54:06z”，“hourly_rate”:100.0，“预算”:零，“项目”: {“id”:14308069，“名称”:“网上商店-第一期”，“代码”:“OS1”}，“任务”: {“id”:8083369，“名称”:“研究”｝}，｛“id”:155505015，“计费”:真正的，“is_active”:真正的，“created_at”:“2017 - 06 - 26 t21:52:18z”，“updated_at”:“2017 - 06 - 26 t21:52:18z”，“hourly_rate”:100.0，“预算”:零，“项目”: {“id”:14308069，“名称”:“网上商店-第一期”，“代码”:“OS1”}，“任务”: {“id”:8083368，“名称”:“项目管理”｝}，｛“id”:155505014，“计费”:真正的，“is_active”:真正的，“created_at”:“2017 - 06 - 26 t21:52:18z”，“updated_at”:“2017 - 06 - 26 t21:52:18z”，“hourly_rate”:100.0，“预算”:零，“项目”: {“id”:14308069，“名称”:“网上商店-第一期”，“代码”:“OS1”}，“任务”: {“id”:8083366，“名称”:“编程”｝}，｛“id”:155505013，“计费”:真正的，“is_active”:真正的，“created_at”:“2017 - 06 - 26 t21:52:18z”，“updated_at”:“2017 - 06 - 26 t21:52:18z”，“hourly_rate”:100.0，“预算”:零，“项目”: {“id”:14308069，“名称”:“网上商店-第一期”，“代码”:“OS1”}，“任务”: {“id”:8083365，“名称”:“平面设计”｝｝),“per_page”:2000，“total_pages”:1，“total_entries”:4，“next_page”:零，“previous_page”:零，“页面”:1，“链接”: {“第一”:“https://api.bob客服端下载harvestapp.com/v2/projects/14308069/task_assignments?page=1&per_page=2000”，“下一个”:零，“以前”:零，“最后一次”:“https://api.bob客服端下载harvestapp.com/v2/projects/14308069/task_assignments?page=1&per_page=2000”｝｝

检索任务分配

检索具有给定ID的任务分配。返回任务分配对象和200好了提供有效标识符时的响应代码。

GET / v2 /项目/ {PROJECT_ID} / task_assignments / {TASK_ASSIGNMENT_ID}

示例请求:

curl "https://api.bob客服端下载harvestapp.com/v2/projects/14308069/task_assignments/155505016" \ -H "授权:持有者$ACCESS_TOKEN" \ -H "收获帐户id: $ACCOUNT_ID" \ -H "User-Agent: MyApp (yourname@example.com)"

示例响应:

｛“id”:155505016，“计费”:假，“is_active”:真正的，“created_at”:“2017 - 06 - 26 t21:52:18z”，“updated_at”:“2017 - 06 - 26 t21:54:06z”，“hourly_rate”:100.0，“预算”:零，“项目”: {“id”:14308069，“名称”:“网上商店-第一期”，“代码”:“OS1”}，“任务”: {“id”:8083369，“名称”:“研究”｝｝

创建任务分配

创建一个新的任务分配对象。返回任务分配对象和201年创建调用成功时的响应代码。

POST / v2 /项目/ {PROJECT_ID} / task_assignments
参数 类型 要求 描述
task_id 整数 要求 要与项目关联的任务的ID。
is_active 布尔 可选 任务分配是活动的还是存档的。默认为真正的．
计费 布尔 可选 任务分配是否可计费。默认为假．
hourly_rate 小数 可选 项目时使用的费率bill_by是任务．默认为零当按任务每小时收费时，否则0．
预算 小数 可选 预算用于项目进行时budget_by是任务或task_fees．

示例请求:

curl "https://api.bob客服端下载harvestapp.com/v2/projects/14308069/task_assignments" \ -H "授权:持有者$ACCESS_TOKEN" \ -H "收获帐户id: $ACCOUNT_ID" \ -H "User-Agent: MyApp (yourname@example.com)"\ -X POST \ -H "Content-Type: application/json" \ -d '{"task_id": 808800，"is_active":true，"billable":true，"hourly_rate":75.50}'

示例响应:

｛“id”:155506339，“计费”:真正的，“is_active”:真正的，“created_at”:“2017 - 06 - 26 t22:10:43z”，“updated_at”:“2017 - 06 - 26 t22:10:43z”，“hourly_rate”:75.5，“预算”:零，“项目”: {“id”:14308069，“名称”:“网上商店-第一期”，“代码”:“OS1”}，“任务”: {“id”:8083800，“名称”:“业务发展”｝｝

更新任务分配

通过设置传递的参数值更新特定的任务分配。任何未提供的参数将保持不变。返回任务分配对象和200好了调用成功时的响应代码。

补丁/ v2 /项目/ {PROJECT_ID} / task_assignments / {TASK_ASSIGNMENT_ID}
参数 类型 描述
is_active 布尔 任务分配是活动的还是存档的。
计费 布尔 任务分配是否可计费。
hourly_rate 小数 项目时使用的费率bill_by是任务．
预算 小数 预算用于项目进行时budget_by是任务或task_fees．

示例请求:

curl "https://api.bob客服端下载harvestapp.com/v2/projects/14308069/task_assignments/155506339" \ -H "授权:持有者$ACCESS_TOKEN" \ -H "收获帐户id: $ACCOUNT_ID" \ -H "User-Agent: MyApp (yourname@example.com)"\ -X PATCH \ -H "Content-Type: application/json" \ -d '{"budget":120}'

示例响应:

｛“id”:155506339，“计费”:真正的，“is_active”:真正的，“created_at”:“2017 - 06 - 26 t22:10:43z”，“updated_at”:“2017 - 06 - 26 t22:11:27z”，“hourly_rate”:75.5，“预算”:120.0，“项目”: {“id”:14308069，“名称”:“网上商店-第一期”，“代码”:“OS1”}，“任务”: {“id”:8083800，“名称”:“业务发展”｝｝

删除任务分配

删除任务分配。只有当任务分配没有与之关联的时间项时，才可以删除任务分配。返回一个200好了调用成功时的响应代码。

删除/ v2 /项目/ {PROJECT_ID} / task_assignments / {TASK_ASSIGNMENT_ID}

示例请求:

curl "https://api.bob客服端下载harvestapp.com/v2/projects/14308069/task_assignments/155506339" \ -H "授权:持有者$ACCESS_TOKEN" \ -H "收获帐户id: $ACCOUNT_ID" \ -H "User-Agent: MyApp (yourname@example.com)"\ -x删除

还有问题吗?我们很乐意帮忙!

联系我们
Baidu
map