团队合作项目（预览版）

将所有团队的任务保存在一个位置。实时协作和工作以获取实时结果。团队合作项目是与团队协作的强大简单方法。

此连接器在以下产品和区域中可用：

服务	Class	区域
Copilot Studio	高级	除以下各项外的所有 Power Automate 区域： - 美国政府（GCC） - 美国政府（GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD）
逻辑应用程序	标准	除以下各项外的所有逻辑应用区域： - Azure 政府区域 - Azure 中国区域 - 美国国防部（DoD）
Power Apps	高级	除以下各项外的所有 Power Apps 区域： - 美国政府（GCC） - 美国政府（GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD）
Power Automate	高级	除以下各项外的所有 Power Automate 区域： - 美国政府（GCC） - 美国政府（GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD）

连接器元数据
发布者	Microsoft
网站	https://www.teamwork.com/
隐私策略	https://www.teamwork.com/legal/privacy-policy/

若要在此集成中使用触发器，必须先为 Teamwork Projects 帐户启用 Webhook。若要启用 Webhook，请单击 Teamwork Projects 帐户右上角的“设置”，单击“网站设置”，然后选择“Webhook”选项卡。在帐户中启用设置后，使用触发器会自动为你注册 Webhook。

正在创建连接

连接器支持以下身份验证类型：


默认	用于创建连接的参数。	所有区域	不可共享

违约

适用：所有区域

用于创建连接的参数。

这是不可共享的连接。如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。

Name	类型	Description	必选
用户名	字符串	此 API 的用户名	True
密码	securestring	此 API 的密码	True
网站 URL	字符串	根网站 URL （示例： https://my.teamwork.com ）	True

限制

名称	调用	续订期
每个连接的 API 调用数	100	60 秒
触发器轮询的频率	1	1 秒

操作

列出任务	此作用于返回给定项目的任务列表。
列出用户	此作返回与特定项目一起分配的所有用户的列表。
列出项目	此作返回与帐户关联的所有项目的列表。
创建任务	此作用于创建新任务。
创建用户	此作用于创建新用户。
创建项目	此作用于创建新的 Teamwork 项目。
删除任务	此作用于删除任务。
更新任务	此作用于更新特定任务的属性。
获取任务	此作返回使用特定任务给定其 ID 的所有属性。
获取用户	此作用于获取用户的所有详细信息。
获取项目	此作返回使用特定项目给定其 ID 的所有属性。

列出任务

操作 ID:: ListTasks

此作用于返回给定项目的任务列表。

参数

名称	密钥	必需	类型	说明
项目 ID	projectId	True	string	选取项目。
任务列表 ID	taskListId	True	string	选择任务列表。

Body: ListTasks_Response

列出用户

操作 ID:: ListUsers

此作返回与特定项目一起分配的所有用户的列表。

参数

名称	密钥	必需	类型	说明
项目 ID	projectId	True	string	选取项目。

Body: ListUsers_Response

列出项目

操作 ID:: ListProjects

此作返回与帐户关联的所有项目的列表。

Body: ListProjects_Response

创建任务

操作 ID:: CreateTask

此作用于创建新任务。

参数

名称	密钥	必需	类型	说明
项目 ID	projectId	True	string	选取项目。
任务列表 ID	taskListId	True	string	选择任务列表。
Name	content	True	string	任务标题。
Description	description		string	任务的详细信息。
进展	progress		string	将进度从 0 设置为 90。
分配到	responsible-party-id		string	选取用户。
开始日期	start-date		string	yyyy-MM-dd
截止日期	due-date		string	yyyy-MM-dd
估计分钟数	estimated-minutes		string	要完成的任务。
Priority	priority		string	选择优先级。
通知人员	notify		boolean	如此可通过电子邮件通知分配给此任务的人员。
专用	private		boolean	真使任务成为私有任务。
标记	tags		string	任务的标记的逗号分隔列表。

Body: UpsertTask_Response

创建用户

操作 ID:: CreateUser

此作用于创建新用户。

参数

名称	密钥	必需	类型	说明
电子邮件地址	email-address	True	string	用户的电子邮件。
名字	first-name	True	string	用户的名字。
姓氏	last-name	True	string	用户的姓氏。
公司 ID	company-id		string	用户的公司。
职务	title		string	用户的标题。
主	phone-number-home		string	用户的家庭电话。
手机	phone-number-mobile		string	用户的移动电话。
Office	phone-number-office		string	用户的办公电话。
Office 扩展	phone-number-office-ext		string	用户的办公电话扩展。
传真	phone-number-fax		string	用户的传真号。
用户名	user-name	True	string	用户的显示名称。

Body: CreateUser_Response

创建项目

操作 ID:: CreateProject

此作用于创建新的 Teamwork 项目。

参数

名称	密钥	必需	类型	说明
Name	name	True	string	项目名称。
Description	description		string	有关项目的更多详细信息。
类别 ID	category-id		string	选取类别
公司 ID	companyId		string	选择现有公司。
新公司	newCompany		string	输入新外部公司的名称。
开始日期	startDate		string	yyyy-MM-dd
结束日期	endDate		string	yyyy-MM-dd
标记	tags		string	项目的标记的逗号分隔列表。

Body: CreateProject_Response

删除任务

操作 ID:: DeleteTask

此作用于删除任务。

参数

名称	密钥	必需	类型	说明
任务 ID	taskId	True	string	任务的唯一 ID。

Body: DeleteTask_Response

更新任务

操作 ID:: UpdateTask

此作用于更新特定任务的属性。

参数

名称	密钥	必需	类型	说明
任务 ID	taskId	True	string	任务的唯一 ID。
Name	content		string	任务名称。
Description	description		string	任务说明。
进展	progress		string	从 0 到 90 的整数。
分配对象	responsible-party-id		string	选取一个人。
开始日期	start-date		string	yyyy-MM-dd
截止日期	due-date		string	yyyy-MM-dd
估计时间	estimated-minutes		string	完成任务的分钟数。
Priority	priority		string	选择优先级。
通知人员	notify		boolean	如此可通过电子邮件通知分配给此任务的人员。
专用	private		boolean	真使任务成为私有任务。
标记	tags		string	任务的标记的逗号分隔列表。

Body: UpsertTask_Response

获取任务

操作 ID:: GetTask

此作返回使用特定任务给定其 ID 的所有属性。

参数

名称	密钥	必需	类型	说明
任务 ID	taskId	True	string	任务的唯一 ID。

与特定任务关联的详细信息。

Body: GetTask_Response

获取用户

操作 ID:: GetUser

此作用于获取用户的所有详细信息。

参数

名称	密钥	必需	类型	说明
人员 ID	personId	True	string	人员的唯一 ID。

Body: GetUser_Response

获取项目

操作 ID:: GetProject

此作返回使用特定项目给定其 ID 的所有属性。

参数

名称	密钥	必需	类型	说明
项目 ID	projectId	True	string	项目的唯一 ID。

Body: GetProject_Response

触发器

任务创建时	此作在创建新任务时触发。
创建用户时	此作在创建新用户时触发。
创建项目时	此作在创建新项目时触发。

任务创建时

操作 ID:: WebhookCreateTask

此作在创建新任务时触发。

Body: TaskResponse

创建用户时

操作 ID:: WebhookCreateUser

此作在创建新用户时触发。

Body: UserResponse

创建项目时

操作 ID:: WebhookCreateProject

此作在创建新项目时触发。

Body: ProjectResponse

定义

ProjectResponse

名称	路径	类型	说明
项目 ID	objectId	string	项目的唯一标识符。

TaskResponse

名称	路径	类型	说明
任务 ID	objectId	string	任务的唯一标识符。

UserResponse

名称	路径	类型	说明
用户 ID	objectId	string	用户的唯一标识符。

CreateProject_Response

名称	路径	类型	说明
项目 ID	id	string	项目的唯一 ID。

ListProjects_Response

名称	路径	类型	说明
项目列表	projects	array of Project_Response	使用帐户分配的所有项目的数组。

GetProject_Response

名称	路径	类型	说明
项目	project	Project_Response

Project_Response

名称	路径	类型	说明
Id	category.id	string	项目类别的唯一 ID。
Name	category.name	string	项目类别的名称。
Id	company.id	string	公司的唯一 ID。
Name	company.name	string	公司的名称。
已创建 Date-Time	created-on	date-time	yyyy-MM-ddTHH：mm：ss.fffZ
Description	description	string	有关项目的更多详细信息。
结束 Date-Time	endDate	string	yyyy-MM-dd
已启用计时器	harvest-timers-enabled	boolean	如果已启用 Harvest 计时器，则为 True。
项目 ID	id	string	项目的唯一 ID。
更新了 Date-Time	last-changed-on	date-time	yyyy-MM-ddTHH：mm：ss.fffZ
Logo	logo	string	项目徽标。
Name	name	string	项目名称。
“概述”页	overview-start-page	string	overview-start-page 的 URL。
已启用隐私	privacyEnabled	boolean	如果启用了隐私，则为 True。
主演	starred	boolean	如此如果项目为星号。
开始 Date-Time	startDate	string	yyyy-MM-dd
起始页	start-page	string	起始页的 URL。
状态	status	string	项目的状态。
Substatus	subStatus	string	项目的子状态。
“任务开始”页	tasks-start-page	string	tasks-start-page 的 URL。
类型	type	string	项目类型。

UpsertTask_Response

名称	路径	类型	说明
任务 ID	id	string	任务的唯一 ID。

ListTasks_Response

名称	路径	类型	说明
todo-items	todo-items	array of Task_Response	任务列表及其属性。

GetTask_Response