Asana

Asana 使團隊能夠在一個地方管理他們的項目和任務。

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

服務	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://asana.com/
隱私策略	https://asana.com/terms#privacy-policy

節流限制

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

動作

依工作區列出使用者 [已淘汰]	此動作已被取代。請改用 [依工作區列出使用者（V2） ]。 ~~此作業會擷取指定工作區的使用者清單。~~
依工作區列出使用者（V2）	此作業會擷取指定工作區（V2）的使用者清單。
依工作區列出小組 [已淘汰]	此動作已被取代。請改用依工作區列出小組（V2）。 ~~此作業可用來檢視工作區或組織中的小組。~~
依工作區列出小組（V2）	此作業可用來檢視工作區或組織（V2）中的小組。
依識別碼取得使用者 [已棄用]	此動作已被取代。請改用 [ 依識別碼取得使用者（V2） ]。 ~~此作業會依使用者 ID 擷取使用者物件。~~
依識別碼取得使用者（V2）	此作業會依使用者 ID （V2）擷取使用者物件。
依識別碼取得專案 [已取代]	此動作已被取代。請改用 [依識別碼取得專案（V2）]。 ~~此作業會依專案識別碼擷取專案物件。~~
依識別碼取得專案（V2）	此作業會依專案識別碼（V2）擷取專案物件。
依識別碼取得工作 [已棄用]	此動作已被取代。請改用 [ 依 ID 取得工作（V2）] 。 ~~此作業會依工作識別碼擷取工作物件。~~
依識別碼取得工作（V2）	此作業會依工作識別碼（V2）擷取工作物件。
完成任務 [已淘汰]	此動作已被取代。請改用完成任務（V2）。 ~~此作業可用來將現有工作標示為完成。~~
完成任務（V2）	此作業可用來將現有工作標示為完成（V2）。
建立任務（V2）	此作業用於在Asana專案（V2）中建立新任務。
建立工作 [已棄用]	此動作已被取代。請改用建立任務（V2）。 ~~此作業可用來在Asana專案中建立新任務。~~
建立新專案 [已棄用]	此動作已被取代。請改用建立新專案（V2）。 ~~此作業可用來建立新專案。~~
建立新專案（V2）	此作業可用來建立新專案（V2）。
新增註解 [已棄用]	此動作已被取代。請改用 [新增註解（V2）] 。 ~~此作業可用來將註解新增至現有任務。~~
新增註解（V2）	此作業可用來將註解新增至現有任務（V2）。

依工作區列出使用者 [已淘汰]

作業識別碼：: ListUsers

此動作已被取代。請改用 [依工作區列出使用者（V2） ]。

~~此作業會擷取指定工作區的使用者清單。~~

參數

名稱	機碼	必要	類型	Description
工作區識別碼	workspace_id	True	string	用於監控使用者的工作區。

傳回

身體: ListUsersResponse

依工作區列出使用者（V2）

作業識別碼：: ListUsersV2

此作業會擷取指定工作區（V2）的使用者清單。

參數

名稱	機碼	必要	類型	Description
工作區識別碼	workspace_id	True	string	用於監控使用者的工作區。

傳回

身體: ListUsersResponseV2

依工作區列出小組 [已淘汰]

作業識別碼：: ListWorkspaceTeams

此動作已被取代。請改用依工作區列出小組（V2）。

~~此作業可用來檢視工作區或組織中的小組。~~

參數

名稱	機碼	必要	類型	Description
工作區識別碼	workspace	True	string	工作區或組織 ID。

傳回

身體: ListTeamsResponse

依工作區列出小組（V2）

作業識別碼：: ListWorkspaceTeamsV2

此作業可用來檢視工作區或組織（V2）中的小組。

參數

名稱	機碼	必要	類型	Description
工作區識別碼	workspace	True	string	工作區或組織 ID。

傳回

身體: ListTeamsResponseV2

依識別碼取得使用者 [已棄用]

作業識別碼：: GetUser

此動作已被取代。請改用 [ 依識別碼取得使用者（V2） ]。

~~此作業會依使用者 ID 擷取使用者物件。~~

參數

名稱	機碼	必要	類型	Description
User	user_id	True	string	User

傳回

Asana 使用者。

身體: UserResponse

依識別碼取得使用者（V2）

作業識別碼：: GetUserV2

此作業會依使用者 ID （V2）擷取使用者物件。

參數

名稱	機碼	必要	類型	Description
User	user_id	True	string	User

傳回

Asana 使用者。

身體: UserResponseV2

依識別碼取得專案 [已取代]

作業識別碼：: GetProject

此動作已被取代。請改用 [依識別碼取得專案（V2）]。

~~此作業會依專案識別碼擷取專案物件。~~

參數

名稱	機碼	必要	類型	Description
專案識別碼	project_id	True	string	項目的標識碼。

傳回

Asana 專案。

身體: ProjectResponse

依識別碼取得專案（V2）

作業識別碼：: GetProjectV2

此作業會依專案識別碼（V2）擷取專案物件。

參數

名稱	機碼	必要	類型	Description
專案識別碼	project_id	True	string	項目的標識碼。

傳回

Asana 專案。

身體: ProjectResponseV2

依識別碼取得工作 [已棄用]

作業識別碼：: GetTask

此動作已被取代。請改用 [ 依 ID 取得工作（V2）] 。

~~此作業會依工作識別碼擷取工作物件。~~

參數

名稱	機碼	必要	類型	Description
工作識別碼	task_id	True	string	工作的唯一識別碼。

傳回

Asana 任務。

身體: TaskResponse

依識別碼取得工作（V2）

作業識別碼：: GetTaskV2

此作業會依工作識別碼（V2）擷取工作物件。

參數

名稱	機碼	必要	類型	Description
工作識別碼	task_id	True	string	工作的唯一識別碼。

傳回

Asana 任務。

身體: TaskResponseV2

完成任務 [已淘汰]

作業識別碼：: CompleteTask

此動作已被取代。請改用完成任務（V2）。

~~此作業可用來將現有工作標示為完成。~~

參數

名稱	機碼	必要	類型	Description
工作識別碼	task_id	True	string	工作的唯一識別碼。

傳回

Asana 任務。

身體: TaskResponse

完成任務（V2）

作業識別碼：: CompleteTaskV2

此作業可用來將現有工作標示為完成（V2）。

參數

名稱	機碼	必要	類型	Description
工作識別碼	task_id	True	string	工作的唯一識別碼。

傳回

Asana 任務。

身體: TaskResponseV2

建立任務（V2）

作業識別碼：: CreateTaskV2

此作業用於在Asana專案（V2）中建立新任務。

參數

名稱	機碼	必要	類型	Description
工作區識別碼	workspace	True	string	用於專案的工作區。
專案識別碼	projects	True	string	專案
任務名稱	name	True	string	工作名稱。
受讓人	assignee		string	電子郵件或使用者 ID，預設為目前使用者。
Description	notes		string	任務描述。
受指派人狀態	assignee_status		string	任務的排程狀態。
完成	completed		boolean	指出任務是否會標示為已完成。
到期日	due_on		date	任務的到期日。

傳回

Asana 任務。

身體: TaskResponseV2

建立工作 [已棄用]

作業識別碼：: CreateTask

此動作已被取代。請改用建立任務（V2）。

~~此作業可用來在Asana專案中建立新任務。~~

參數

名稱	機碼	必要	類型	Description
工作區識別碼	workspace	True	string	用於專案的工作區。
專案識別碼	projects	True	string	專案
任務名稱	name	True	string	工作名稱。
受讓人	assignee		string	'電子郵件或使用者 ID，預設為目前使用者。
Description	notes		string	任務描述。
受指派人狀態	assignee_status		string	任務的排程狀態。
完成	completed		boolean	指出任務是否會標示為已完成。
到期日	due_on		date	任務的到期日。

傳回

Asana 任務。

身體: TaskResponse

建立新專案 [已棄用]

作業識別碼：: CreateProject

此動作已被取代。請改用建立新專案（V2）。

~~此作業可用來建立新專案。~~

參數

名稱	機碼	必要	類型	Description
工作區識別碼	workspace	True	string	用於新專案的工作區。
團隊識別碼	team		string	如果在組織中建立，則要在其中建立專案的特定團隊。
專案名稱	name	True	string	項目的名稱。
到期日	due_date		date	yyyy-MM-dd
公開	public		boolean	如果專案對組織公開，則為 true。
專案顏色	color		string	用來顯示專案的顏色。
項目筆記	notes		string	關於該項目的說明。
所有者	owner		string	專案的擁有者。
檔案館	archived		boolean	預設情況下，封存的專案不會顯示在 UI 中。

傳回

Asana 專案。

身體: ProjectResponse

建立新專案（V2）

作業識別碼：: CreateProjectV2

此作業可用來建立新專案（V2）。

參數

名稱	機碼	必要	類型	Description
工作區識別碼	workspace	True	string	用於新專案的工作區。
團隊識別碼	team		string	如果在組織中建立，則要在其中建立專案的特定團隊。
專案名稱	name	True	string	項目的名稱。
到期日	due_date		date	yyyy-MM-dd
公開	public		boolean	如果專案對組織公開，則為 true。
專案顏色	color		string	用來顯示專案的顏色。
項目筆記	notes		string	關於該項目的說明。
所有者	owner		string	專案的擁有者。
檔案館	archived		boolean	預設情況下，封存的專案不會顯示在 UI 中。

傳回

Asana 專案。

身體: ProjectResponseV2

新增註解 [已棄用]

作業識別碼：: AddComment

此動作已被取代。請改用 [新增註解（V2）] 。

~~此作業可用來將註解新增至現有任務。~~

參數

名稱	機碼	必要	類型	Description
工作識別碼	task_id	True	string	工作的唯一識別碼。
評論	text	True	string	要用作註釋的文字。

傳回

對Asana任務的註解。

身體: AddCommentResponse

新增註解（V2）

作業識別碼：: AddCommentV2

此作業可用來將註解新增至現有任務（V2）。

參數

名稱	機碼	必要	類型	Description
工作識別碼	task_id	True	string	工作的唯一識別碼。
評論	text	True	string	要用作註釋的文字。

傳回

對Asana任務的註解。

身體: AddCommentResponseV2

觸發程序

建立任務時（V2）	建立新任務時觸發（V2）。
建立專案時 [已棄用]	此動作已被取代。請改用建立專案時（V2）。 ~~建立新專案時觸發。~~
建立專案時（V2）	建立新專案時觸發（V2）。
建立工作時 [已棄用]	此動作已被取代。請改用建立任務時（V2）。 ~~建立新任務時觸發。~~
當任務完成時 [已淘汰]	此動作已被取代。請改用 When a task is completed （V2）。 ~~當現有任務完成時觸發。~~
當任務完成時（V2）	當現有任務完成時觸發（V2）。

建立任務時（V2）

作業識別碼：: OnTaskCreatedV2

建立新任務時觸發（V2）。

參數

名稱	機碼	必要	類型	Description
工作區識別碼	workspace	True	string	用於監控新專案的工作區。
專案識別碼	project	True	string	專案

傳回

身體: ListTasksResponseV2

建立專案時 [已棄用]

作業識別碼：: OnProjectCreated

此動作已被取代。請改用建立專案時（V2）。

~~建立新專案時觸發。~~

參數

名稱	機碼	必要	類型	Description
工作區識別碼	workspace	True	string	用於監控新專案的工作區。

傳回

身體: ListProjectsResponse

建立專案時（V2）

作業識別碼：: OnProjectCreatedV2

建立新專案時觸發（V2）。

參數

名稱	機碼	必要	類型	Description
工作區識別碼	workspace	True	string	用於監控新專案的工作區。

傳回

身體: ListProjectsResponseV2

建立工作時 [已棄用]

作業識別碼：: OnTaskCreated

此動作已被取代。請改用建立任務時（V2）。

~~建立新任務時觸發。~~

參數

名稱	機碼	必要	類型	Description
工作區識別碼	workspace	True	string	用於監控新專案的工作區。
專案識別碼	project	True	string	專案

傳回

身體: ListTasksResponse

當任務完成時 [已淘汰]

作業識別碼：: OnTaskCompleted

此動作已被取代。請改用 When a task is completed （V2）。

~~當現有任務完成時觸發。~~

參數

名稱	機碼	必要	類型	Description
工作區識別碼	workspace	True	string	用於監控新專案的工作區。
專案識別碼	project	True	string	專案

傳回

身體: ListTasksResponse

當任務完成時（V2）

作業識別碼：: OnTaskCompletedV2

當現有任務完成時觸發（V2）。

參數

名稱	機碼	必要	類型	Description
工作區識別碼	workspace	True	string	用於監控新專案的工作區。
專案識別碼	project	True	string	專案

傳回

身體: ListTasksResponseV2

定義

ListProjects回應

名稱	路徑	類型	Description
專案	data	array of ProjectResponse

專案回應

Asana 專案。

名稱	路徑	類型	Description
專案識別碼	id	integer
專案名稱	name	string
項目筆記	notes	string
建立日期	created_at	date-time	yyyy-MM-ddTHH：mm：ss.fffZ
修改日期	modified_at	date-time	yyyy-MM-ddTHH：mm：ss.fffZ
所有者	owner	Owner	專案擁有者。
到期日	due_date	date	yyyy-MM-dd
地位	current_status	CurrentStatus
公開	public	boolean
Archived	archived	boolean
工作空間	workspace	WorkSpace	工作區。
顏色	color	string	專案顏色。

ListTasks回應

名稱	路徑	類型	Description
任務	data	array of TaskResponse

任務回應

Asana 任務。

名稱	路徑	類型	Description
工作識別碼	id	integer
建立日期	created_at	date-time	yyyy-MM-ddTHH：mm：ss.fffZ
修改日期	modified_at	date-time	yyyy-MM-ddTHH：mm：ss.fffZ
任務名稱	name	string
任務筆記	notes	string
完成	completed	boolean
受讓人	assignee	Assignee	指派此作業的使用者。
收款人狀態	assignee_status	string	任務的排程狀態。
完成日期和時間	completed_at	date-time	yyyy-MM-ddTHH：mm：ss.fffZ
到期日	due_on	date	yyyy-MM-dd
截止日期和時間	due_at	string	yyyy-MM-ddTHH：mm：ss.fffZ
工作空間	workspace	WorkSpace	工作區。
點贊數	num_hearts	integer
喜歡	hearted	boolean

AddComment回應

對Asana任務的註解。

名稱	路徑	類型	Description
任務	data.target	Target	與此註解相關聯的作業。
文字	data.text	string	批註的文字。
建立日期	data.created_at	string	建立此註解的日期和時間。
作者	data.created_by	CreatedBy	撰寫此註解的使用者。
來源	data.source	string	使用者用來觸發註解的Asana產品元件。
類型	data.type	string	這是評論的類型。
註解 ID	data.id	integer	此註解的識別碼。

ListTeams回應

名稱	路徑	類型	Description
資料	data	array of object
團隊識別碼	data.id	integer	小組的全域唯一識別碼。

ListUsers回應

名稱	路徑	類型	Description
使用者	data	array of UserResponse

使用者回應

Asana 使用者。

名稱	路徑	類型
使用者識別碼	id	integer
使用者名	name	string
Email	email	string

目前狀態

名稱	路徑	類型	Description
color	color	string	專案的色彩狀態。
收發簡訊	text	string	描述專案狀態的文字。
ID	author.id	integer	專案狀態作者的ID。
名稱	author.name	string	專案狀態的作者名稱。

工作空間

工作區。

名稱	路徑	類型	Description
ID	id	integer
名稱	name	string

所有者

專案擁有者。

名稱	路徑	類型	Description
ID	id	integer	專案擁有者的 ID。
名稱	name	string	專案擁有者的名稱。

受讓人

指派此作業的使用者。

名稱	路徑	類型	Description
ID	id	integer
名稱	name	string

標的

與此註解相關聯的作業。

名稱	路徑	類型	Description
ID	id	integer	與此註解相關聯之任務的 ID。
名稱	name	string	與此註解相關聯之任務的 ID。

CreatedBy

撰寫此註解的使用者。

名稱	路徑	類型	Description
ID	id	integer	撰寫此註解之使用者的識別碼。
名稱	name	string	撰寫此註解的使用者名稱。

清單專案回應V2

名稱	路徑	類型	Description
專案	data	array of ProjectResponseV2

專案回應V2

Asana 專案。

名稱	路徑	類型	Description
專案識別碼	gid	string
專案名稱	name	string
項目筆記	notes	string
建立日期	created_at	date-time	yyyy-MM-ddTHH：mm：ss.fffZ
修改日期	modified_at	date-time	yyyy-MM-ddTHH：mm：ss.fffZ
所有者	owner	OwnerV2	專案擁有者。
到期日	due_date	date	yyyy-MM-dd
地位	current_status	CurrentStatusV2
公開	public	boolean
Archived	archived	boolean
工作空間	workspace	WorkSpaceV2	工作區。
顏色	color	string	專案顏色。

ListTasksResponseV2 的

名稱	路徑	類型	Description
任務	data	array of TaskResponseV2

任務回應V2

Asana 任務。

名稱	路徑	類型	Description
工作識別碼	gid	string
建立日期	created_at	date-time	yyyy-MM-ddTHH：mm：ss.fffZ
修改日期	modified_at	date-time	yyyy-MM-ddTHH：mm：ss.fffZ
任務名稱	name	string
任務筆記	notes	string
完成	completed	boolean
受讓人	assignee	AssigneeV2	指派此作業的使用者。
收款人狀態	assignee_status	string	任務的排程狀態。
完成日期和時間	completed_at	date-time	yyyy-MM-ddTHH：mm：ss.fffZ
到期日	due_on	date	yyyy-MM-dd
截止日期和時間	due_at	string	yyyy-MM-ddTHH：mm：ss.fffZ
工作空間	workspace	WorkSpaceV2	工作區。
點贊數	num_hearts	integer
永久網址	permalink_url	string	任務的永久 URL。
喜歡	hearted	boolean

新增註解回應V2

對Asana任務的註解。

名稱	路徑	類型	Description
任務	data.target	TargetV2	與此註解相關聯的作業。
文字	data.text	string	批註的文字。
建立日期	data.created_at	string	建立此註解的日期和時間。
作者	data.created_by	CreatedByV2	撰寫此註解的使用者。
來源	data.source	string	使用者用來觸發註解的Asana產品元件。
類型	data.type	string	這是評論的類型。
註解 ID	data.gid	string	此註解的識別碼。

ListTeams回應V2

名稱	路徑	類型	Description
資料	data	array of object
團隊識別碼	data.gid	string	小組的全域唯一識別碼。

ListUsers回應V2

名稱	路徑	類型	Description
使用者	data	array of UserResponseV2

用戶回應V2

Asana 使用者。

名稱	路徑	類型
使用者識別碼	gid	string
使用者名	name	string
Email	email	string

目前狀態V2

名稱	路徑	類型	Description
color	color	string	專案的色彩狀態。
收發簡訊	text	string	描述專案狀態的文字。
ID	author.gid	string	專案狀態作者的ID。
名稱	author.name	string	專案狀態的作者名稱。

工作空間V2

工作區。

名稱	路徑	類型	Description
ID	gid	string
名稱	name	string

業主V2

專案擁有者。

名稱	路徑	類型	Description
ID	gid	string	專案擁有者的 ID。
名稱	name	string	專案擁有者的名稱。

受讓人V2

指派此作業的使用者。

名稱	路徑	類型	Description
ID	gid	string
名稱	name	string

目標V2

與此註解相關聯的作業。

名稱	路徑	類型	Description
ID	gid	string	與此註解相關聯之任務的 ID。
名稱	name	string	與此註解相關聯之任務的 ID。

創建者V2

撰寫此註解的使用者。

名稱	路徑	類型	Description
ID	gid	string	撰寫此註解之使用者的識別碼。
名稱	name	string	撰寫此註解的使用者名稱。

共用方式為

Asana

節流限制

動作

依工作區列出使用者 [已淘汰]

參數

傳回

依工作區列出使用者 （V2）

參數

傳回

依工作區列出小組 [已淘汰]

參數

傳回

依工作區列出小組 （V2）

參數

傳回

依識別碼取得使用者 [已棄用]

參數

傳回

依識別碼取得使用者 （V2）

參數

傳回

依識別碼取得專案 [已取代]

參數

傳回

依識別碼取得專案 （V2）

參數

傳回

依識別碼取得工作 [已棄用]

參數

傳回

依識別碼取得工作 （V2）

參數

傳回

完成任務 [已淘汰]

參數

傳回

完成任務 （V2）

參數

傳回

建立任務 （V2）

參數

傳回

建立工作 [已棄用]

參數

傳回

建立新專案 [已棄用]

參數

傳回

建立新專案 （V2）

參數

傳回

新增註解 [已棄用]

參數

傳回

新增註解 （V2）

參數

傳回

觸發程序

建立任務時 （V2）

參數

傳回

建立專案時 [已棄用]

參數

傳回

建立專案時 （V2）

參數

傳回

建立工作時 [已棄用]

參數

傳回

當任務完成時 [已淘汰]

參數

傳回

當任務完成時 （V2）

參數

傳回

定義

ListProjects回應

專案回應

依工作區列出使用者（V2）

依工作區列出小組（V2）

依識別碼取得使用者（V2）

依識別碼取得專案（V2）

依識別碼取得工作（V2）

完成任務（V2）

建立任務（V2）

建立新專案（V2）

新增註解（V2）

建立任務時（V2）

建立專案時（V2）

當任務完成時（V2）