團隊合作專案（預覽版）

將團隊的所有任務集中在一個地方。即時協作和工作以獲得實際結果。團隊合作項目是與您的團隊協作的一種強大而簡單的方式。

此連接器適用於以下產品和區域：

服務	Class	Regions
副駕駛工作室	進階	除下列區域外的所有 Power Automate 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）
邏輯應用程式	標準	所有 Logic Apps 區域，但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部（DoD）
Power Apps	進階	除下列區域外的所有 Power Apps 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）
Power Automate（自動化服務）	進階	除下列區域外的所有 Power Automate 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）

連接器中繼資料
Publisher	Microsoft
網站	https://www.teamwork.com/
隱私策略	https://www.teamwork.com/legal/privacy-policy/

若要在此整合中使用觸發器，首先您必須為您的團隊合作專案帳戶啟用 Webhook。若要啟用 Webhook，請按一下團隊合作專案帳戶右上角的「設定」，按一下「網站設定」，然後選取「Webhook」標籤。在您的帳戶中啟用此設定後，使用觸發器將自動為您註冊 Webhook。

正在建立連線

連接器支援下列驗證類型：


預設值	建立連線的參數。	所有區域	不可共享

預設

適用：所有地區

建立連線的參數。

這不是可共用的連線。如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

名稱	類型	Description	為必填項目
用戶名稱	字串	此 API 的使用者名稱	對
密碼	securestring	此 API 的密碼	對
網站網址	字串	根網站網址（範例： https://my.teamwork.com ）	對

節流限制

名稱	呼叫	續約期間
每個連線的 API 呼叫	100	60 秒
觸發輪詢的頻率	1	1秒鐘

動作

列出使用者	此作業會傳回與特定專案相關聯之所有使用者的清單。
列出專案	此作業會傳回與您的帳戶相關聯之所有專案的清單。
列出工作	此作業可用來傳回指定專案的任務清單。
刪除工作	此作業可用來刪除工作。
取得任務	此作業會傳回與特定工作相關聯的所有屬性，指定其識別碼。
取得使用者	此作業可用來取得使用者的所有詳細資料。
取得專案	此作業會傳回與特定專案相關聯的所有屬性，指定其識別碼。
建立任務	此作業可用來建立新工作。
建立使用者	此作業可用來建立新使用者。
建立專案	此作業可用來建立新的團隊合作專案。
更新工作	此作業可用來更新特定工作的屬性。

列出使用者

作業識別碼：: ListUsers

此作業會傳回與特定專案相關聯之所有使用者的清單。

參數

名稱	機碼	必要	類型	Description
專案編號	projectId	True	string	挑選一個專案。

傳回

身體: ListUsers_Response

列出專案

作業識別碼：: ListProjects

此作業會傳回與您的帳戶相關聯之所有專案的清單。

傳回

身體: ListProjects_Response

列出工作

作業識別碼：: ListTasks

此作業可用來傳回指定專案的任務清單。

參數

名稱	機碼	必要	類型	Description
專案編號	projectId	True	string	挑選一個專案。
工作清單識別碼	taskListId	True	string	挑選任務清單。

傳回

身體: ListTasks_Response

刪除工作

作業識別碼：: DeleteTask

此作業可用來刪除工作。

參數

名稱	機碼	必要	類型	Description
任務標識符	taskId	True	string	工作的唯一識別碼。

傳回

身體: DeleteTask_Response

取得任務

作業識別碼：: GetTask

此作業會傳回與特定工作相關聯的所有屬性，指定其識別碼。

參數

名稱	機碼	必要	類型	Description
任務標識符	taskId	True	string	工作的唯一識別碼。

傳回

與特定任務相關聯的詳細資料。

身體: GetTask_Response

取得使用者

作業識別碼：: GetUser

此作業可用來取得使用者的所有詳細資料。

參數

名稱	機碼	必要	類型	Description
人員 ID	personId	True	string	人員的唯一 ID。

傳回

身體: GetUser_Response

取得專案

作業識別碼：: GetProject

此作業會傳回與特定專案相關聯的所有屬性，指定其識別碼。

參數

名稱	機碼	必要	類型	Description
專案編號	projectId	True	string	專案的唯一識別碼。

傳回

身體: GetProject_Response

建立任務

作業識別碼：: CreateTask

此作業可用來建立新工作。

參數

名稱	機碼	必要	類型	Description
專案編號	projectId	True	string	挑選一個專案。
工作清單識別碼	taskListId	True	string	挑選任務清單。
名稱	content	True	string	工作標題。
Description	description		string	任務的詳細信息。
Progress	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	True 表示透過電子郵件通知指派給此工作的人員。
是私人	private		boolean	True 可將任務設為私人。
Tags	tags		string	以逗號分隔的作業標籤清單。

傳回

身體: UpsertTask_Response

建立使用者

作業識別碼：: CreateUser

此作業可用來建立新使用者。

參數

名稱	機碼	必要	類型	Description
電子郵件地址	email-address	True	string	使用者的電子郵件。
名字	first-name	True	string	使用者的名字。
姓氏	last-name	True	string	使用者的姓氏。
公司編號	company-id		string	用戶的公司。
職稱	title		string	使用者的標題。
常用	phone-number-home		string	使用者的家庭電話。
行動裝置	phone-number-mobile		string	使用者的行動電話。
Office	phone-number-office		string	使用者的辦公室電話。
辦公室擴展	phone-number-office-ext		string	使用者的辦公室電話分機。
傳真	phone-number-fax		string	使用者的傳真號碼。
用戶名稱	user-name	True	string	使用者的顯示名稱。

傳回

身體: CreateUser_Response

建立專案

作業識別碼：: CreateProject

此作業可用來建立新的團隊合作專案。

參數

名稱	機碼	必要	類型	Description
名稱	name	True	string	專案名稱。
Description	description		string	有關該項目的更多詳細信息。
類別識別碼	category-id		string	選擇類別
公司編號	companyId		string	選擇一家現有公司。
新公司	newCompany		string	輸入新外部公司的名稱。
開始日期	startDate		string	yyyy-MM-dd
結束日期	endDate		string	yyyy-MM-dd
Tags	tags		string	專案的逗號分隔標籤清單。

傳回

身體: CreateProject_Response

更新工作

作業識別碼：: UpdateTask

此作業可用來更新特定工作的屬性。

參數

名稱	機碼	必要	類型	Description
任務標識符	taskId	True	string	工作的唯一識別碼。
名稱	content		string	任務名稱。
Description	description		string	任務描述。
Progress	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	True 表示透過電子郵件通知指派給此工作的人員。
是私人	private		boolean	True 可將任務設為私人。
Tags	tags		string	以逗號分隔的作業標籤清單。

傳回

身體: UpsertTask_Response

觸發程序

建立任務時	此作業會在建立新工作時觸發。
建立使用者時	此作業會在建立新使用者時觸發。
建立專案時	此作業會在建立新專案時觸發。

建立任務時

作業識別碼：: WebhookCreateTask

此作業會在建立新工作時觸發。

傳回

身體: TaskResponse

建立使用者時

作業識別碼：: WebhookCreateUser

此作業會在建立新使用者時觸發。

傳回

身體: UserResponse

建立專案時

作業識別碼：: WebhookCreateProject

此作業會在建立新專案時觸發。

傳回

身體: ProjectResponse

定義

專案回應

名稱	路徑	類型	Description
專案編號	objectId	string	專案的唯一識別碼。

任務回應

名稱	路徑	類型	Description
任務標識符	objectId	string	工作的唯一識別碼。

使用者回應

名稱	路徑	類型	Description
使用者 ID	objectId	string	使用者的唯一識別碼。

CreateProject_Response

名稱	路徑	類型	Description
專案編號	id	string	專案的唯一識別碼。

ListProjects_Response

名稱	路徑	類型	Description
專案清單	projects	array of Project_Response	與您的帳戶相關的所有項目的陣列。

GetProject_Response

名稱	路徑	類型	Description
專案	project	Project_Response

Project_Response

名稱	路徑	類型	Description
Id	category.id	string	專案類別的唯一識別碼。
名稱	category.name	string	專案類別的名稱。
Id	company.id	string	公司的唯一 ID。
名稱	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	如果已啟用「收穫計時器」，則為 True。
專案編號	id	string	專案的唯一識別碼。
更新 Date-Time	last-changed-on	date-time	yyyy-MM-ddTHH：mm：ss.fffZ
商標	logo	string	項目標誌。
名稱	name	string	專案名稱。
概觀頁面	overview-start-page	string	overview-start-page的URL。
啟用隱私	privacyEnabled	boolean	如果已啟用隱私權，則為 true。
已加星標	starred	boolean	如果項目已加星號，則為 true。
開始 Date-Time	startDate	string	yyyy-MM-dd
起始頁	start-page	string	起始頁的 URL。
地位	status	string	專案的狀態。
子狀態	subStatus	string	專案的子狀態。
工作起始頁	tasks-start-page	string	tasks-start-page的URL。
類型	type	string	專案類型。

UpsertTask_Response

名稱	路徑	類型	Description
任務標識符	id	string	工作的唯一識別碼。

ListTasks_Response

名稱	路徑	類型	Description
待辦事項	todo-items	array of Task_Response	任務清單及其屬性。

GetTask_Response