项目任务分配
需要管理员或项目经理权限。
任务分配对象
属性 | 类型 | 描述 |
---|---|---|
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删除