Asana
Asana 使团队能够在一个位置管理其项目和任务。
此连接器在以下产品和区域中可用：
| 服务 | 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 |
| Website | https://asana.com/ |
| 隐私策略 | https://asana.com/terms#privacy-policy |
限制
| 名称 | 调用 | 续订期 |
|---|---|---|
| 每个连接的 API 调用数 | 30 | 60 秒 |
| 触发器轮询的频率 | 1 | 15 秒 |
操作
| 创建任务 [已弃用] |
此作已弃用。 请改用“创建任务”（V2）。
|
| 创建任务 （V2） |
此作用于在 Asana 项目中创建新任务（V2）。 |
| 创建新项目 [已弃用] |
此作已弃用。 请改用“创建新项目”（V2）。
|
| 创建新项目 （V2） |
此作用于创建新项目（V2）。 |
| 完成任务 [已弃用] |
此作已弃用。 请改用“完成任务”（V2）。
|
| 完成任务 （V2） |
此作用于将现有任务标记为已完成（V2）。 |
| 按 ID 获取任务 [已弃用] |
此作已弃用。 请改用 ID 获取任务（V2）。
|
| 按 ID 获取任务 （V2） |
此作按任务 ID（V2）检索任务对象。 |
| 按 ID 获取用户 [已弃用] |
此作已弃用。 请改用 ID 获取用户（V2）。
|
| 按 ID 获取用户 （V2） |
此作按用户 ID（V2）检索用户对象。 |
| 按 ID 获取项目 [已弃用] |
此作已弃用。 请改用 ID 获取项目（V2）。
|
| 按 ID 获取项目 （V2） |
此作按项目 ID（V2）检索项目对象。 |
| 按工作区列出团队 [已弃用] |
此作已弃用。 请改用按工作区列出的团队（V2）。
|
| 按工作区列出团队 （V2） |
此作用于查看工作区或组织中的团队（V2）。 |
| 按工作区列出用户 [已弃用] |
此作已弃用。 请改用“按工作区列出用户”（V2）。
|
| 按工作区列出用户 （V2） |
此作检索给定工作区的用户列表（V2）。 |
| 添加注释 [已弃用] |
此作已弃用。 请改用“添加注释”（V2）。
|
| 添加注释 （V2） |
此作用于向现有任务（V2）添加注释。 |
创建任务 [已弃用]
此作已弃用。 请改用“创建任务”（V2）。
此作用于在 Asana 项目中创建新任务。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作区 ID
|
workspace | True | string |
要用于项目的工作区。 |
|
项目标识
|
projects | True | string |
项目 |
|
任务名称
|
name | True | string |
任务的名称。 |
|
Assignee
|
assignee | string |
“电子邮件或用户 ID，默认为当前用户。 |
|
|
Description
|
notes | string |
任务描述。 |
|
|
被分配者状态
|
assignee_status | string |
任务的计划状态。 |
|
|
完成
|
completed | boolean |
指示任务是否标记为已完成。 |
|
|
到期日期
|
due_on | date |
任务的截止日期。 |
返回
Asana 任务。
- Body
- TaskResponse
创建任务 （V2）
此作用于在 Asana 项目中创建新任务（V2）。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作区 ID
|
workspace | True | string |
要用于项目的工作区。 |
|
项目标识
|
projects | True | string |
项目 |
|
任务名称
|
name | True | string |
任务的名称。 |
|
Assignee
|
assignee | string |
电子邮件或用户 ID，默认为当前用户。 |
|
|
Description
|
notes | string |
任务描述。 |
|
|
被分配者状态
|
assignee_status | string |
任务的计划状态。 |
|
|
完成
|
completed | boolean |
指示任务是否标记为已完成。 |
|
|
到期日期
|
due_on | date |
任务的截止日期。 |
返回
Asana 任务。
- Body
- TaskResponseV2
创建新项目 [已弃用]
此作已弃用。 请改用“创建新项目”（V2）。
此作用于创建新项目。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作区 ID
|
workspace | True | string |
用于新项目的工作区。 |
|
团队 ID
|
team | string |
如果在组织中创建，则要在其中创建项目的特定团队。 |
|
|
项目名称
|
name | True | string |
项目的名称。 |
|
到期日期
|
due_date | date |
yyyy-MM-dd |
|
|
公众
|
public | boolean |
如此 如果项目是组织的公共项目。 |
|
|
项目颜色
|
color | string |
用于显示项目的颜色。 |
|
|
项目说明
|
notes | string |
有关项目的说明。 |
|
|
所有者
|
owner | string |
项目的所有者。 |
|
|
存档
|
archived | boolean |
默认情况下，存档的项目不会显示在 UI 中。 |
返回
Asana 项目。
- Body
- ProjectResponse
创建新项目 （V2）
此作用于创建新项目（V2）。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作区 ID
|
workspace | True | string |
用于新项目的工作区。 |
|
团队 ID
|
team | string |
如果在组织中创建，则要在其中创建项目的特定团队。 |
|
|
项目名称
|
name | True | string |
项目的名称。 |
|
到期日期
|
due_date | date |
yyyy-MM-dd |
|
|
公众
|
public | boolean |
如此 如果项目是组织的公共项目。 |
|
|
项目颜色
|
color | string |
用于显示项目的颜色。 |
|
|
项目说明
|
notes | string |
有关项目的说明。 |
|
|
所有者
|
owner | string |
项目的所有者。 |
|
|
存档
|
archived | boolean |
默认情况下，存档的项目不会显示在 UI 中。 |
返回
Asana 项目。
- Body
- ProjectResponseV2
完成任务 [已弃用]
此作已弃用。 请改用“完成任务”（V2）。
此作用于将现有任务标记为已完成。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
任务 ID
|
task_id | True | string |
任务的唯一 ID。 |
返回
Asana 任务。
- Body
- TaskResponse
完成任务 （V2）
此作用于将现有任务标记为已完成（V2）。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
任务 ID
|
task_id | True | string |
任务的唯一 ID。 |
返回
Asana 任务。
- Body
- TaskResponseV2
按 ID 获取任务 [已弃用]
此作已弃用。 请改用 ID 获取任务（V2）。
此作按任务 ID 检索任务对象。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
任务 ID
|
task_id | True | string |
任务的唯一 ID。 |
返回
Asana 任务。
- Body
- TaskResponse
按 ID 获取任务 （V2）
此作按任务 ID（V2）检索任务对象。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
任务 ID
|
task_id | True | string |
任务的唯一 ID。 |
返回
Asana 任务。
- Body
- TaskResponseV2
按 ID 获取用户 [已弃用]
此作已弃用。 请改用 ID 获取用户（V2）。
此作按用户 ID 检索用户对象。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
用户
|
user_id | True | string |
用户 |
返回
Asana 用户。
- Body
- UserResponse
按 ID 获取用户 （V2）
按 ID 获取项目 [已弃用]
此作已弃用。 请改用 ID 获取项目（V2）。
此作按项目 ID 检索项目对象。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
项目标识
|
project_id | True | string |
项目的 ID。 |
返回
Asana 项目。
- Body
- ProjectResponse
按 ID 获取项目 （V2）
此作按项目 ID（V2）检索项目对象。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
项目标识
|
project_id | True | string |
项目的 ID。 |
返回
Asana 项目。
- Body
- ProjectResponseV2
按工作区列出团队 [已弃用]
此作已弃用。 请改用按工作区列出的团队（V2）。
此作用于查看工作区或组织中的团队。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作区 ID
|
workspace | True | string |
工作区或组织 ID。 |
返回
- Body
- ListTeamsResponse
按工作区列出团队 （V2）
此作用于查看工作区或组织中的团队（V2）。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作区 ID
|
workspace | True | string |
工作区或组织 ID。 |
返回
- Body
- ListTeamsResponseV2
按工作区列出用户 [已弃用]
此作已弃用。 请改用“按工作区列出用户”（V2）。
此作检索给定工作区的用户列表。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作区 ID
|
workspace_id | True | string |
要监视用户的工作区。 |
返回
- Body
- ListUsersResponse
按工作区列出用户 （V2）
此作检索给定工作区的用户列表（V2）。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作区 ID
|
workspace_id | True | string |
要监视用户的工作区。 |
返回
- Body
- ListUsersResponseV2
添加注释 [已弃用]
此作已弃用。 请改用“添加注释”（V2）。
此作用于向现有任务添加注释。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
任务 ID
|
task_id | True | string |
任务的唯一 ID。 |
|
注释
|
text | True | string |
要用作注释的文本。 |
返回
对 Asana 任务的注释。
- Body
- AddCommentResponse
添加注释 （V2）
此作用于向现有任务（V2）添加注释。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
任务 ID
|
task_id | True | string |
任务的唯一 ID。 |
|
注释
|
text | True | string |
要用作注释的文本。 |
返回
对 Asana 任务的注释。
- Body
- AddCommentResponseV2
触发器
| 任务完成后 [已弃用] |
此作已弃用。 请改用任务完成时间（V2）。
|
| 任务完成后（V2） |
完成现有任务时触发 （V2）。 |
| 创建任务时 [已弃用] |
此作已弃用。 请改用创建任务时（V2）。
|
| 创建任务时 （V2） |
创建新任务时触发 （V2）。 |
| 创建项目时 [已弃用] |
此作已弃用。 请改用创建项目时（V2）。
|
| 创建项目时（V2） |
创建新项目时触发 （V2）。 |
任务完成后 [已弃用]
此作已弃用。 请改用任务完成时间（V2）。
完成现有任务时触发。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作区 ID
|
workspace | True | string |
用于监视新项目的工作区。 |
|
项目标识
|
project | True | string |
项目 |
返回
- Body
- ListTasksResponse
任务完成后（V2）
完成现有任务时触发 （V2）。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作区 ID
|
workspace | True | string |
用于监视新项目的工作区。 |
|
项目标识
|
project | True | string |
项目 |
返回
- Body
- ListTasksResponseV2
创建任务时 [已弃用]
此作已弃用。 请改用创建任务时（V2）。
创建新任务时触发。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作区 ID
|
workspace | True | string |
用于监视新项目的工作区。 |
|
项目标识
|
project | True | string |
项目 |
返回
- Body
- ListTasksResponse
创建任务时 （V2）
创建新任务时触发 （V2）。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作区 ID
|
workspace | True | string |
用于监视新项目的工作区。 |
|
项目标识
|
project | True | string |
项目 |
返回
- Body
- ListTasksResponseV2
创建项目时 [已弃用]
此作已弃用。 请改用创建项目时（V2）。
创建新项目时触发。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作区 ID
|
workspace | True | string |
用于监视新项目的工作区。 |
返回
- Body
- ListProjectsResponse
创建项目时（V2）
创建新项目时触发 （V2）。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
工作区 ID
|
workspace | True | string |
用于监视新项目的工作区。 |
返回
定义
ListProjectsResponse
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
项目
|
data | array of ProjectResponse |
ProjectResponse
Asana 项目。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
项目标识
|
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 | boolean | |
|
工作空间
|
workspace | WorkSpace |
工作区。 |
|
颜色
|
color | string |
项目颜色。 |
ListTasksResponse
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
Tasks
|
data | array of TaskResponse |
TaskResponse
Asana 任务。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
任务 ID
|
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 |
分配此任务的用户。 |
|
Asignee 状态
|
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 |
AddCommentResponse
对 Asana 任务的注释。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
任务
|
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 |
此注释的 ID。 |
ListTeamsResponse
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
数据
|
data | array of object | |
|
团队 ID
|
data.id | integer |
团队的全局唯一 ID。 |
ListUsersResponse
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
用户
|
data | array of UserResponse |
UserResponse
Asana 用户。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
用户 ID
|
id | integer | |
|
用户名
|
name | string | |
|
Email
|
string |
CurrentStatus
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
color
|
color | string |
项目的颜色状态。 |
|
文本消息
|
text | string |
描述项目状态的文本。 |
|
ID
|
author.id | integer |
项目状态的作者的 ID。 |
|
姓名
|
author.name | string |
项目状态的作者的名称。 |
工作
工作区。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
ID
|
id | integer | |
|
姓名
|
name | string |
所有者
项目所有者。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
ID
|
id | integer |
项目所有者的 ID。 |
|
姓名
|
name | string |
项目所有者的名称。 |
Assignee
分配此任务的用户。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
ID
|
id | integer | |
|
姓名
|
name | string |
目标
此注释与之关联的任务。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
ID
|
id | integer |
此注释与之关联的任务的 ID。 |
|
姓名
|
name | string |
此注释与之关联的任务的 ID。 |
创建者
创作此注释的用户。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
ID
|
id | integer |
创作此注释的用户的 ID。 |
|
姓名
|
name | string |
创作此注释的用户的名称。 |
ListProjectsResponseV2
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
项目
|
data | array of ProjectResponseV2 |
ProjectResponseV2
Asana 项目。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
项目标识
|
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 | boolean | |
|
工作空间
|
workspace | WorkSpaceV2 |
工作区。 |
|
颜色
|
color | string |
项目颜色。 |
ListTasksResponseV2
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
Tasks
|
data | array of TaskResponseV2 |
TaskResponseV2
Asana 任务。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
任务 ID
|
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
|
assignee | AssigneeV2 |
分配此任务的用户。 |
|
Asignee 状态
|
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 | |
|
永久 URL
|
permalink_url | string |
任务的永久 URL。 |
|
喜欢
|
hearted | boolean |
AddCommentResponseV2
对 Asana 任务的注释。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
任务
|
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 |
此注释的 ID。 |
ListTeamsResponseV2
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
数据
|
data | array of object | |
|
团队 ID
|
data.gid | string |
团队的全局唯一 ID。 |
ListUsersResponseV2
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
用户
|
data | array of UserResponseV2 |
UserResponseV2
Asana 用户。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
用户 ID
|
gid | string | |
|
用户名
|
name | string | |
|
Email
|
string |
CurrentStatusV2
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
color
|
color | string |
项目的颜色状态。 |
|
文本消息
|
text | string |
描述项目状态的文本。 |
|
ID
|
author.gid | string |
项目状态的作者的 ID。 |
|
姓名
|
author.name | string |
项目状态的作者的名称。 |
WorkSpaceV2
工作区。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
ID
|
gid | string | |
|
姓名
|
name | string |
OwnerV2
项目所有者。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
ID
|
gid | string |
项目所有者的 ID。 |
|
姓名
|
name | string |
项目所有者的名称。 |
AssigneeV2
分配此任务的用户。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
ID
|
gid | string | |
|
姓名
|
name | string |
TargetV2
此注释与之关联的任务。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
ID
|
gid | string |
此注释与之关联的任务的 ID。 |
|
姓名
|
name | string |
此注释与之关联的任务的 ID。 |
CreatedByV2
创作此注释的用户。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
ID
|
gid | string |
创作此注释的用户的 ID。 |
|
姓名
|
name | string |
创作此注释的用户的名称。 |