任务接口

class teambition.api.tasks.Tasks(client=None)[源代码]
add_tag(id, tag_id)[源代码]

关联标签

参数:
  • id – 任务 ID
  • tag_id – 标签 ID
返回:

返回的 JSON 数据包

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 数据包

关联对象

参数:
  • 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 数据包

get_activities(id)[源代码]

获取任务动态

参数:id – 任务 ID
返回:返回的 JSON 数据包

获取任务关联的 objectlink 列表

参数:id – 任务 ID
返回:返回的 JSON 数据包
get_subtasks(id)[源代码]

获取子任务列表

参数:id – 任务 ID
返回:返回的 JSON 数据包
get_tags(id)[源代码]

获取任务标签列表

参数: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 数据包

关联日程

参数:
  • id – 任务 ID
  • linked_id – 关联日程 ID
返回:

返回的 JSON 数据包

link_post(id, linked_id)[源代码]

关联分享

参数:
  • id – 任务 ID
  • linked_id – 关联分享 ID
返回:

返回的 JSON 数据包

关联任务

参数:
  • id – 任务 ID
  • linked_id – 关联任务 ID
返回:

返回的 JSON 数据包

关联文件

参数:
  • id – 任务 ID
  • linked_id – 关联文件 ID
返回:

返回的 JSON 数据包

move(id, stage_id)[源代码]

移动任务

详情请参考 http://docs.teambition.com/wiki/tasks#tasks-move

参数:
  • id – 任务 ID
  • stage_id – 目的阶段 ID
返回:

返回的 JSON 数据包

remove_tag(id, tag_id)[源代码]

移除标签

参数:
  • id – 任务 ID
  • tag_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 数据包

update_tags(id, tag_ids)[源代码]

更新任务标签

详情请参考 http://docs.teambition.com/wiki/tasks#tasks-update-tags

参数:
  • id – 任务 ID
  • tag_ids – 标签 ID 列表
返回:

返回的 JSON 数据包