任务接口¶
-
class
teambition.api.tasks.
Tasks
(client=None)[源代码]¶ -
-
archive
(id)[源代码]¶ 归档任务
详情请参考 http://docs.teambition.com/wiki/tasks#tasks-archive
参数: id – 任务 ID 返回: 返回的 JSON 数据包
-
create
(content, tasklist_id, stage_id=None, executor_id=None, involve_members=None, due_date=None, priority=None, recurrence=None, tag_ids=None)[源代码]¶ 创建任务
详情请参考 http://docs.teambition.com/wiki/tasks#tasks-create
参数: - content – 任务内容
- tasklist_id – 任务分组 ID
- stage_id – 可选,阶段 ID,默认为任务分组的第一个阶段
- executor_id – 可选,执行者 ID,默认为空
- involve_members – 可选,参与者 ID 数组,默认为创建者和执行者
- due_date – 可选,截止日期
- priority – 可选,优先级,可选值为 0,1,2,对应普通、紧急、非常紧急
- recurrence – 可选,重复规则列表
- tag_ids – 可选,标签 ID 列表
返回: 返回的 JSON 数据包
-
create_objectlink
(id, linked_id, linked_type)[源代码]¶ 关联对象
参数: - id – 任务 ID
- linked_id – 关联对象 ID
- linked_type – 关联对象类型
返回: 返回的 JSON 数据包
-
delete
(id)[源代码]¶ 删除任务
详情请参考 http://docs.teambition.com/wiki/tasks#tasks-delete
参数: id – 任务 ID 返回: 返回的 JSON 数据包
-
fork
(id, stage_id, do_link=False, do_linked=False)[源代码]¶ 复制任务
详情请参考 http://docs.teambition.com/wiki/tasks#tasks-fork
参数: - id – 任务 ID,任务 ID
- stage_id – 目的阶段 ID
- do_link – 可选,是否关联复制出的任务,默认为 False
- do_linked – 可选,是否会被复制出的任务关联,默认为 False
返回: 返回的 JSON 数据包
-
get
(id, detail_type=None)[源代码]¶ 获取任务
详情请参考 http://docs.teambition.com/wiki/tasks#tasks-get-by-id
参数: - id – 任务 ID
- detail_type – 可选值complete, 则会包含子任务详细信息
返回: 返回的 JSON 数据包
获取任务标签列表
参数: id – 任务 ID 返回: 返回的 JSON 数据包
-
import_tasks
(tasklist_id, tasks, stage_id=None, executor_id=None, involve_members=None, due_date=None, visiable=None)[源代码]¶ 批量导入任务
一次允许50条, 仅支持任务标题列表
参数: - tasklist_id – 任务分组 ID
- tasks – 任务内容列表
- stage_id – 可选,阶段 ID,默认分组的第一个阶段
- executor_id – 可选,执行者 ID
- involve_members – 可选,参与者列表
- due_date – 可选,截止日期
- visiable – 可选,可见状态
返回: 返回的 JSON 数据包
-
like
(id)[源代码]¶ 赞任务
详情请参考 http://docs.teambition.com/wiki/tasks#tasks-like
参数: id – 任务 ID 返回: 返回的 JSON 数据包
-
move
(id, stage_id)[源代码]¶ 移动任务
详情请参考 http://docs.teambition.com/wiki/tasks#tasks-move
参数: - id – 任务 ID
- stage_id – 目的阶段 ID
返回: 返回的 JSON 数据包
-
unarchive
(id)[源代码]¶ 取消归档任务
详情请参考 http://docs.teambition.com/wiki/tasks#tasks-unarchive
参数: id – 任务 ID 返回: 返回的 JSON 数据包
-
update
(id, content=None, tasklist_id=None, stage_id=None, executor_id=None, involve_members=None, due_date=None, priority=None, recurrence=None, is_done=None, note=None)[源代码]¶ 更新任务
详情请参考 http://docs.teambition.com/wiki/tasks#tasks-update
参数: - content – 任务内容
- tasklist_id – 任务分组 ID
- stage_id – 可选,阶段 ID,默认为任务分组的第一个阶段
- executor_id – 可选,执行者 ID,默认为空
- involve_members – 可选,参与者 ID 数组,默认为创建者和执行者
- due_date – 可选,截止日期
- priority – 可选,优先级,可选值为 0,1,2,对应普通、紧急、非常紧急
- recurrence – 可选,重复规则列表
- is_done – 可选,完成状态
- note – 可选,笔记
-
update_content
(id, content)[源代码]¶ 更新任务内容
详情请参考 http://docs.teambition.com/wiki/tasks#tasks-update_content
参数: - id – 任务 ID
- content – 任务内容
返回: 返回的 JSON 数据包
-
update_duedate
(id, duedate)[源代码]¶ 更新截止日期
详情请参考 http://docs.teambition.com/wiki/tasks#tasks-update_duedate
参数: - id – 任务 ID
- duedate – 截止日期,请使用 ISOString 格式,置空请传 None
返回: 返回的 JSON 数据包
-
update_executor
(id, executor_id)[源代码]¶ 更新任务执行者
详情请参考 http://docs.teambition.com/wiki/tasks#tasks-update_executor
参数: - id – 任务 ID
- executor_id – 执行者 ID
返回: 返回的 JSON 数据包
-
update_note
(id, note)[源代码]¶ 更新任务备注
详情请参考 http://docs.teambition.com/wiki/tasks#tasks-update_note
参数: - id – 任务 ID
- note – 任务备注
返回: 返回的 JSON 数据包
-
update_status
(id, is_done)[源代码]¶ 更新任务状态
详情请参考 http://docs.teambition.com/wiki/tasks#tasks-update_status
参数: - id – 任务 ID
- is_done – 是否已经完成
返回: 返回的 JSON 数据包
-
update_subtasks
(id, subtask_ids)[源代码]¶ 更新任务内子任务顺序
详情请参考 http://docs.teambition.com/wiki/tasks#tasks-update-subtaskids
参数: - id – 任务 ID
- subtask_ids – 子任务 ID 列表
返回: 返回的 JSON 数据包
更新任务标签
详情请参考 http://docs.teambition.com/wiki/tasks#tasks-update-tags
参数: - id – 任务 ID
- tag_ids – 标签 ID 列表
返回: 返回的 JSON 数据包
-