本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 提高工作效率 AppFabric 的 API 操作（预览版）
<a name="productivity-actions"></a>


|  | 
| --- |
| 提高 AWS AppFabric 工作效率功能处于预览阶段，可能会发生变化。 | 

提高工作效率功能 AppFabric 支持以下操作。

有关所有其他 AppFabric API 操作，请参阅 [AWS AppFabric API 操作](https://docs.aws.amazon.com/appfabric/latest/api/API_Operations.html)。

**Topics**
+ [授权](API_Authorize.md)
+ [CreateAppClient](API_CreateAppClient.md)
+ [DeleteAppClient](API_DeleteAppClient.md)
+ [GetAppClient](API_GetAppClient.md)
+ [ListActionableInsights](API_ListActionableInsights.md)
+ [ListAppClients](API_ListAppClients.md)
+ [ListMeetingInsights](API_ListMeetingInsights.md)
+ [PutFeedback](API_PutFeedback.md)
+ [令牌](API_Token.md)
+ [UpdateAppClient](API_UpdateAppClient.md)

# 授权
<a name="API_Authorize"></a>


|  | 
| --- |
| 提高 AWS AppFabric 工作效率功能处于预览阶段，可能会发生变化。 | 

授权. AppClient 

**Topics**
+ [请求正文](#API_Authorize_request)

## 请求正文
<a name="API_Authorize_request"></a>

请求接受采用 JSON 格式的以下数据。


| 参数 | 说明 | 
| --- | --- | 
|  **app\$1client\$1id**  |   AppClient 要授权的 ID。  | 
|  **redirect\$1uri**  |  授权后要将最终用户重定向到的 URI。  | 
|  **state**  |  用于维护请求和回调之间状态的唯一值。  | 

# CreateAppClient
<a name="API_CreateAppClient"></a>


|  | 
| --- |
| 提高 AWS AppFabric 工作效率功能处于预览阶段，可能会发生变化。 | 

创建一个 AppClient.

**Topics**
+ [请求正文](#API_CreateAppClient_request)
+ [响应元素](#API_CreateAppClient_response)

## 请求正文
<a name="API_CreateAppClient_request"></a>

请求接受采用 JSON 格式的以下数据。


| 参数 | 说明 | 
| --- | --- | 
|  **appName**  |  应用程序的名称。 类型：字符串 长度限制：最小长度为 1。最大长度为 255。 是否必需：是  | 
|  **clientToken**  |  指定为确保请求的幂等性而提供的唯一、区分大小写的标识符。这使您可以安全地重试请求，而不会意外地再次执行相同的操作。要将相同值传递给以后对操作的调用，则还需要为所有其他参数传递相同的值。我们建议您使用 [UUID 类型的值](https://wikipedia.org/wiki/Universally_unique_identifier)。 如果您不提供此值，则 AWS 会为您生成一个随机值。 如果您使用相同 `ClientToken` 但不同的参数重试该操作，则重试将失败并显示 `IdempotentParameterMismatch` 错误。 类型：字符串 模式：`[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 必需：否  | 
|  **customerManagedKey标识符**  |  由 客户自主管理型密钥 生成的 ARN。 AWS Key Management Service密钥用于加密数据。 如果未指定密钥， AWS 托管式密钥 则使用。要分配给资源的一个或多个标记的键值对的映射。 有关客户托管密钥 AWS 拥有的密钥 的更多信息，请参阅*《AWS Key Management Service 开发人员指南》*中的[客户 AWS 密钥和密钥](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-mgmt)。 类型：字符串 长度限制：最小长度为 1。最大长度为 1011。 模式：`arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 必需：否  | 
|  **描述**  |  应用的描述。 类型：字符串 是否必需：是  | 
|  **iconUrl**  |  的图标或徽标的网址 AppClient。 类型：字符串 必需：否  | 
|  **redirectUrls**  |  授权后要将最终用户重定向到的 URI。您最多可以添加 5 个 redirectUrl。例如 `https://localhost:8080`。 类型：字符串数组 数组成员：最少 1 个物品。最多 5 项。 长度限制：最小长度为 1。最大长度为 2048。 模式：`(http\|https):\/\/[-a-zA-Z0-9_:.\/]+` 是否必需：是  | 
|  **starterUserEmails**  |  入门电子邮件地址，这些用户在验证之前有权接收见解。 AppClient  类型：字符串数组 数组成员：固定数量为 1 项。 长度限制：最小长度为 0。长度上限为 320。 模式：`[a-zA-Z0-9.!#$%&’*+/=?^_`{\|}~-]+@[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)*` 是否必需：是  | 
|  **tags**  |  要分配给资源的一个或多个标记的键值对的映射。 类型：标签对象数组 数组成员：最少 0 个物品。最多 50 项。 必需：否  | 

## 响应元素
<a name="API_CreateAppClient_response"></a>

如果此操作成功，则该服务将会发送回 HTTP 201 响应。

服务以 JSON 格式返回的以下数据。


| 参数 | 说明 | 
| --- | --- | 
|  **appClientSummary**  |  包含的摘要 AppClient。 类型：[AppClientSummary](API_AppClientSummary.md) 对象  | 

# DeleteAppClient
<a name="API_DeleteAppClient"></a>


|  | 
| --- |
| 提高 AWS AppFabric 工作效率功能处于预览阶段，可能会发生变化。 | 

删除应用程序客户端。

**Topics**
+ [请求正文](#API_DeleteAppClient_request)
+ [响应元素](#API_DeleteAppClient_response)

## 请求正文
<a name="API_DeleteAppClient_request"></a>

请求接受采用 JSON 格式的以下数据。


| 参数 | 说明 | 
| --- | --- | 
|  **appClientIdentifier**  |  用于请求的亚马逊资源名称 (ARN) 或通用唯一标识符 (UUID)。 AppClient  长度限制：最小长度为 1。最大长度为 1011。 模式：`arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 是否必需：是  | 

## 响应元素
<a name="API_DeleteAppClient_response"></a>

如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 204 响应。

# GetAppClient
<a name="API_GetAppClient"></a>


|  | 
| --- |
| 提高 AWS AppFabric 工作效率功能处于预览阶段，可能会发生变化。 | 

返回有关的信息 AppClient。

**Topics**
+ [请求正文](#API_GetAppClient_request)
+ [响应元素](#API_GetAppClient_response)

## 请求正文
<a name="API_GetAppClient_request"></a>

请求接受采用 JSON 格式的以下数据。


| 参数 | 说明 | 
| --- | --- | 
|  **appClientIdentifier**  |  用于请求的亚马逊资源名称 (ARN) 或通用唯一标识符 (UUID)。 AppClient  长度限制：最小长度为 1。最大长度为 1011。 模式：`arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 是否必需：是  | 

## 响应元素
<a name="API_GetAppClient_response"></a>

如果此操作成功，则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回以下数据。


| 参数 | 说明 | 
| --- | --- | 
|  **appClient**  |  包含有关的信息 AppClient。 类型：[AppClient](API_AppClient.md) 对象  | 

# ListActionableInsights
<a name="API_ListActionableInsights"></a>


|  | 
| --- |
| 提高 AWS AppFabric 工作效率功能处于预览阶段，可能会发生变化。 | 

列出最重要的可操作电子邮件、任务和其他更新。

**Topics**
+ [请求正文](#API_ListActionableInsights_request)
+ [响应元素](#API_ListActionableInsights_response)

## 请求正文
<a name="API_ListActionableInsights_request"></a>

请求接受采用 JSON 格式的以下数据。


| 参数 | 说明 | 
| --- | --- | 
|  **nextToken**  |  如果返回 `nextToken`，则会有更多可用结果。`nextToken` 的值是每个页面的唯一分页令牌。使用返回的令牌再次调用以检索下一页。保留所有其他参数不变。每个分页令牌将在 24 小时后过期。使用过期的分页令牌将返回 *HTTP 400 InvalidToken 错误*。  | 

## 响应元素
<a name="API_ListActionableInsights_response"></a>

如果此操作成功，则该服务将会发送回 HTTP 201 响应。

服务以 JSON 格式返回的以下数据。


| 参数 | 说明 | 
| --- | --- | 
|  **ActionableInsightsList**  |  列出可操作的见解，包括标题、描述、操作和创建的时间戳。有关更多信息，请参阅 [ActionableInsights](API_ActionableInsights.md)。  | 
|  **nextToken**  |  如果返回 `nextToken`，则会有更多可用结果。`nextToken` 的值是每个页面的唯一分页令牌。使用返回的令牌再次调用以检索下一页。保留所有其他参数不变。每个分页令牌将在 24 小时后过期。使用过期的分页令牌将返回 *HTTP 400 InvalidToken 错误*。 类型：字符串  | 

# ListAppClients
<a name="API_ListAppClients"></a>


|  | 
| --- |
| 提高 AWS AppFabric 工作效率功能处于预览阶段，可能会发生变化。 | 

返回所有列表 AppClients。

**Topics**
+ [请求正文](#API_ListAppClients_request)
+ [响应元素](#API_ListAppClients_response)

## 请求正文
<a name="API_ListAppClients_request"></a>

请求接受采用 JSON 格式的以下数据。


| 参数 | 说明 | 
| --- | --- | 
|  **maxResults**  |  每个调用返回的最大结果数。您可以使用 `nextToken` 获取更多的结果页面。 这只是一个上限。每次调用返回的实际结果数可能少于指定的最大值。 有效范围：最小值为 1。最大值为 100。  | 
|  **nextToken**  |  如果返回 `nextToken`，则会有更多可用结果。`nextToken` 的值是每个页面的唯一分页令牌。使用返回的令牌再次调用以检索下一页。保留所有其他参数不变。每个分页令牌将在 24 小时后过期。使用过期的分页令牌将返回 *HTTP 400 InvalidToken 错误*。  | 

## 响应元素
<a name="API_ListAppClients_response"></a>

如果此操作成功，则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回以下数据。


| 参数 | 说明 | 
| --- | --- | 
|  **appClientList**  |  包含 AppClient 结果列表。 类型：[AppClientSummary](API_AppClientSummary.md) 对象数组  | 
|  **nextToken**  |  如果返回 `nextToken`，则会有更多可用结果。`nextToken` 的值是每个页面的唯一分页令牌。使用返回的令牌再次调用以检索下一页。保留所有其他参数不变。每个分页令牌将在 24 小时后过期。使用过期的分页令牌将返回 *HTTP 400 InvalidToken 错误*。 类型：字符串  | 

# ListMeetingInsights
<a name="API_ListMeetingInsights"></a>


|  | 
| --- |
| 提高 AWS AppFabric 工作效率功能处于预览阶段，可能会发生变化。 | 

列出最重要的可操作的日历事件。

**Topics**
+ [请求正文](#API_ListMeetingInsights_request)
+ [响应元素](#API_ListMeetingInsights_response)

## 请求正文
<a name="API_ListMeetingInsights_request"></a>

请求接受采用 JSON 格式的以下数据。


| 参数 | 说明 | 
| --- | --- | 
|  **nextToken**  |  如果返回 `nextToken`，则会有更多可用结果。`nextToken` 的值是每个页面的唯一分页令牌。使用返回的令牌再次调用以检索下一页。保留所有其他参数不变。每个分页令牌将在 24 小时后过期。使用过期的分页令牌将返回 *HTTP 400 InvalidToken 错误*。  | 

## 响应元素
<a name="API_ListMeetingInsights_response"></a>

如果此操作成功，则该服务将会发送回 HTTP 201 响应。

服务以 JSON 格式返回的以下数据。


| 参数 | 说明 | 
| --- | --- | 
|  **MeetingInsightList**  |  列出可操作的会议见解。有关更多信息，请参阅 [MeetingInsights](API_MeetingInsights.md)。  | 
|  **nextToken**  |  如果返回 `nextToken`，则会有更多可用结果。`nextToken` 的值是每个页面的唯一分页令牌。使用返回的令牌再次调用以检索下一页。保留所有其他参数不变。每个分页令牌将在 24 小时后过期。使用过期的分页令牌将返回 *HTTP 400 InvalidToken 错误*。 类型：字符串  | 

# PutFeedback
<a name="API_PutFeedback"></a>


|  | 
| --- |
| 提高 AWS AppFabric 工作效率功能处于预览阶段，可能会发生变化。 | 

允许用户针对给定的见解或操作提交反馈。

**Topics**
+ [请求正文](#API_PutFeedback_request)
+ [响应元素](#API_PutFeedback_response)

## 请求正文
<a name="API_PutFeedback_request"></a>

请求接受采用 JSON 格式的以下数据。


| 参数 | 说明 | 
| --- | --- | 
|  **id**  |  要提交反馈的对象的 ID。这可以是 InsightId 或 ActionId。  | 
|  **feedbackFor**  |  要提交反馈的见解类型。 可能的值：`ACTIONABLE_INSIGHT \| MEETING_INSIGHT \| ACTION`  | 
|  **feedbackRating**  |  反馈评分从 `1` 到 `5`。评分越高越好。  | 

## 响应元素
<a name="API_PutFeedback_response"></a>

如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 201 响应。

# 令牌
<a name="API_Token"></a>


|  | 
| --- |
| 提高 AWS AppFabric 工作效率功能处于预览阶段，可能会发生变化。 | 

包含 AppClients 允许将授权码交换为访问令牌的信息。

**Topics**
+ [请求正文](#API_Token_request)
+ [响应元素](#API_Token_response)

## 请求正文
<a name="API_Token_request"></a>

请求接受采用 JSON 格式的以下数据。


| 参数 | 说明 | 
| --- | --- | 
|  **代码**  |  从授权端点接收的授权码。 类型：字符串 长度限制：最小长度为 1。最大长度为 2048。 必需：否  | 
|  **grant\$1type**  |  令牌的授予类型。必须是 `authorization_code` 或 `refresh_token`。 类型：字符串 是否必需：是  | 
|  **app\$1client\$1id**  |   AppClient 的 ID。 类型：字符串 模式：`[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 是否必需：是  | 
|  **redirect\$1uri**  |  传递给授权端点的重定向 URI。 类型：字符串 必需：否  | 
|  **refresh\$1token**  |  从初始令牌请求接收的刷新令牌。 类型：字符串 长度限制：最小长度为 1。最大长度为 4096。 必需：否  | 

## 响应元素
<a name="API_Token_response"></a>

如果此操作成功，则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回以下数据。


| 参数 | 说明 | 
| --- | --- | 
|  **appfabric\$1user\$1id**  |  令牌的用户 ID。只有使用 `authorization_code` 授予类型的请求才会返回此值。 类型：字符串  | 
|  **expires\$1in**  |  令牌过期前的秒数。 类型：长整型  | 
|  **refresh\$1token**  |  用于后续请求的刷新令牌。 类型：字符串 长度限制：最小长度为 1。最大长度为 2048。  | 
|  **token**  |  访问令牌。 类型：字符串 长度限制：最小长度为 1。最大长度为 2048。  | 
|  **token\$1type**  |  令牌类型。 类型：字符串  | 

# UpdateAppClient
<a name="API_UpdateAppClient"></a>


|  | 
| --- |
| 提高 AWS AppFabric 工作效率功能处于预览阶段，可能会发生变化。 | 

更新一个 AppClient.

**Topics**
+ [请求正文](#API_UpdateAppClient_request)
+ [响应元素](#API_UpdateAppClient_response)

## 请求正文
<a name="API_UpdateAppClient_request"></a>

请求接受采用 JSON 格式的以下数据。


| 参数 | 说明 | 
| --- | --- | 
|  **appClientIdentifier**  |  用于请求的亚马逊资源名称 (ARN) 或通用唯一标识符 (UUID)。 AppClient  长度限制：最小长度为 1。最大长度为 1011。 模式：`arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 是否必需：是  | 
|  **redirectUrls**  |  授权后要将最终用户重定向到的 URI。您最多可以添加 5 个 redirectUrl。例如 `https://localhost:8080`。 类型：字符串数组 数组成员：最少 1 个物品。最多 5 项。 长度限制：最小长度为 1。最大长度为 2048。 模式：`(http\|https):\/\/[-a-zA-Z0-9_:.\/]+`   | 

## 响应元素
<a name="API_UpdateAppClient_response"></a>

如果此操作成功，则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回以下数据。


| 参数 | 说明 | 
| --- | --- | 
|  **appClient**  |  包含有关的信息 AppClient。 类型：[AppClient](API_AppClient.md) 对象  |