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

# CreateCallAnalyticsCategory
<a name="API_CreateCallAnalyticsCategory"></a>

创建新的呼叫分析类别。

所有类别都会自动应用于您的呼叫分析转录。请注意，为了将类别应用于您的转录，您必须在提交转录请求之前创建类别，因为类别不能追溯应用。

创建新类别时，您可以使用`InputType`参数将该类别标记为`POST_CALL`或`REAL_TIME`类别。 `POST_CALL`类别只能应用于通话后转录，`REAL_TIME`类别只能应用于实时转录。如果您不包括`InputType`，则默认情况下，您的类别将创建为一个`POST_CALL`类别。

呼叫分析类别由规则组成。对于每个类别，您必须创建 1 到 20 条规则。规则可以包括以下参数：[InterruptionFilter](API_InterruptionFilter.md)[NonTalkTimeFilter](API_NonTalkTimeFilter.md)、[SentimentFilter](API_SentimentFilter.md)、和[TranscriptFilter](API_TranscriptFilter.md)。

要更新现有类别，请参阅[UpdateCallAnalyticsCategory](API_UpdateCallAnalyticsCategory.md)。

要了解有关呼叫分析类别的更多信息，请参阅[为通话后转录](https://docs.aws.amazon.com/transcribe/latest/dg/tca-categories-batch.html)[创建类别和为实时转录](https://docs.aws.amazon.com/transcribe/latest/dg/tca-categories-stream.html)创建类别。

## 请求语法
<a name="API_CreateCallAnalyticsCategory_RequestSyntax"></a>

```
{
   "CategoryName": "string",
   "InputType": "string",
   "Rules": [ 
      { 
         "InterruptionFilter": { 
            "AbsoluteTimeRange": { 
               "EndTime": number,
               "First": number,
               "Last": number,
               "StartTime": number
            },
            "Negate": boolean,
            "ParticipantRole": "string",
            "RelativeTimeRange": { 
               "EndPercentage": number,
               "First": number,
               "Last": number,
               "StartPercentage": number
            },
            "Threshold": number
         },
         "NonTalkTimeFilter": { 
            "AbsoluteTimeRange": { 
               "EndTime": number,
               "First": number,
               "Last": number,
               "StartTime": number
            },
            "Negate": boolean,
            "RelativeTimeRange": { 
               "EndPercentage": number,
               "First": number,
               "Last": number,
               "StartPercentage": number
            },
            "Threshold": number
         },
         "SentimentFilter": { 
            "AbsoluteTimeRange": { 
               "EndTime": number,
               "First": number,
               "Last": number,
               "StartTime": number
            },
            "Negate": boolean,
            "ParticipantRole": "string",
            "RelativeTimeRange": { 
               "EndPercentage": number,
               "First": number,
               "Last": number,
               "StartPercentage": number
            },
            "Sentiments": [ "string" ]
         },
         "TranscriptFilter": { 
            "AbsoluteTimeRange": { 
               "EndTime": number,
               "First": number,
               "Last": number,
               "StartTime": number
            },
            "Negate": boolean,
            "ParticipantRole": "string",
            "RelativeTimeRange": { 
               "EndPercentage": number,
               "First": number,
               "Last": number,
               "StartPercentage": number
            },
            "Targets": [ "string" ],
            "TranscriptFilterType": "string"
         }
      }
   ]
}
```

## 请求参数
<a name="API_CreateCallAnalyticsCategory_RequestParameters"></a>

有关所有操作的共同参数的信息，请参阅[公共参数](CommonParameters.md)。

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

 ** [CategoryName](#API_CreateCallAnalyticsCategory_RequestSyntax) **   <a name="transcribe-CreateCallAnalyticsCategory-request-CategoryName"></a>
您为呼叫分析类别选择的唯一名称。使用将来对你有意义的详细命名系统会很有帮助。例如，最好使用`sentiment-positive-last30seconds`类别而不是像这样的通用名称`test-category`。  
类别名称区分大小写。  
类型：字符串  
长度限制：最小长度为 1。最大长度为 200。  
模式：`^[0-9a-zA-Z._-]+`  
必需：是

 ** [InputType](#API_CreateCallAnalyticsCategory_RequestSyntax) **   <a name="transcribe-CreateCallAnalyticsCategory-request-InputType"></a>
选择要为呼叫分析转录创建实时类别还是通话后类别。  
指定会将您的类别`POST_CALL`分配给呼叫后转录；具有此输入类型的类别不能应用于流式传输（实时）转录。  
指定会将您的类别`REAL_TIME`分配给流媒体转录；具有此输入类型的类别不能应用于通话后转录。  
如果您不包括`InputType`，则默认情况下，您的类别将创建为通话后类别。  
类型：字符串  
有效值:` REAL_TIME | POST_CALL`   
必需：否

 ** [Rules](#API_CreateCallAnalyticsCategory_RequestSyntax) **   <a name="transcribe-CreateCallAnalyticsCategory-request-Rules"></a>
规则定义了呼叫分析类别。创建新类别时，必须为该类别创建 1 到 20 条规则。对于每个规则，指定一个应用于呼叫属性的筛选条件。例如，您可以选择情绪过滤器来检测客户在通话的最后 30 秒内情绪是否正面。  
类型：[Rule](API_Rule.md) 对象数组  
数组成员：最少 1 项。最多 20 项。  
必需：是

## 响应语法
<a name="API_CreateCallAnalyticsCategory_ResponseSyntax"></a>

```
{
   "CategoryProperties": { 
      "CategoryName": "string",
      "CreateTime": number,
      "InputType": "string",
      "LastUpdateTime": number,
      "Rules": [ 
         { 
            "InterruptionFilter": { 
               "AbsoluteTimeRange": { 
                  "EndTime": number,
                  "First": number,
                  "Last": number,
                  "StartTime": number
               },
               "Negate": boolean,
               "ParticipantRole": "string",
               "RelativeTimeRange": { 
                  "EndPercentage": number,
                  "First": number,
                  "Last": number,
                  "StartPercentage": number
               },
               "Threshold": number
            },
            "NonTalkTimeFilter": { 
               "AbsoluteTimeRange": { 
                  "EndTime": number,
                  "First": number,
                  "Last": number,
                  "StartTime": number
               },
               "Negate": boolean,
               "RelativeTimeRange": { 
                  "EndPercentage": number,
                  "First": number,
                  "Last": number,
                  "StartPercentage": number
               },
               "Threshold": number
            },
            "SentimentFilter": { 
               "AbsoluteTimeRange": { 
                  "EndTime": number,
                  "First": number,
                  "Last": number,
                  "StartTime": number
               },
               "Negate": boolean,
               "ParticipantRole": "string",
               "RelativeTimeRange": { 
                  "EndPercentage": number,
                  "First": number,
                  "Last": number,
                  "StartPercentage": number
               },
               "Sentiments": [ "string" ]
            },
            "TranscriptFilter": { 
               "AbsoluteTimeRange": { 
                  "EndTime": number,
                  "First": number,
                  "Last": number,
                  "StartTime": number
               },
               "Negate": boolean,
               "ParticipantRole": "string",
               "RelativeTimeRange": { 
                  "EndPercentage": number,
                  "First": number,
                  "Last": number,
                  "StartPercentage": number
               },
               "Targets": [ "string" ],
               "TranscriptFilterType": "string"
            }
         }
      ]
   }
}
```

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

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

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

 ** [CategoryProperties](#API_CreateCallAnalyticsCategory_ResponseSyntax) **   <a name="transcribe-CreateCallAnalyticsCategory-response-CategoryProperties"></a>
为您提供新类别的属性，包括其关联规则。  
类型：[CategoryProperties](API_CategoryProperties.md) 对象

## 错误
<a name="API_CreateCallAnalyticsCategory_Errors"></a>

有关所有操作常见错误的信息，请参阅[常见错误](CommonErrors.md)。

 ** BadRequestException **   
您的请求未通过一项或多项验证测试。当您要删除的实体不存在或处于非终端状态（例如`IN PROGRESS`）时，可能会发生这种情况。有关更多信息，请参阅异常消息字段。  
HTTP 状态代码：400

 ** ConflictException **   
使用此名称的资源已经存在。中的资源名称必须唯一AWS 账户。  
HTTP 状态代码：400

 ** InternalFailureException **   
遇到了内部错误。检查错误消息、更正问题，然后重试请求。  
HTTP 状态代码：500

 ** LimitExceededException **   
你要么发送了太多的请求，要么你的输入文件太长。请稍候，然后重试您的请求，或者使用较小的文件重试您的请求。  
HTTP 状态代码：400

## 另请参阅
<a name="API_CreateCallAnalyticsCategory_SeeAlso"></a>

有关在特定语言的 AWS 软件开发工具包中使用此 API 的更多信息，请参阅以下内容：
+  [AWS 命令行界面](https://docs.aws.amazon.com/goto/aws-cli/transcribe-2017-10-26/CreateCallAnalyticsCategory) 
+  [适用于 .NET 的 AWS SDK](https://docs.aws.amazon.com/goto/DotNetSDKV3/transcribe-2017-10-26/CreateCallAnalyticsCategory) 
+  [适用于 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForCpp/transcribe-2017-10-26/CreateCallAnalyticsCategory) 
+  [适用于 Go 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForGoV1/transcribe-2017-10-26/CreateCallAnalyticsCategory) 
+  [适用于 Java V2 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/transcribe-2017-10-26/CreateCallAnalyticsCategory) 
+  [AWS适用于 SDK JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/transcribe-2017-10-26/CreateCallAnalyticsCategory) 
+  [适用于 PHP V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/transcribe-2017-10-26/CreateCallAnalyticsCategory) 
+  [适用于 Python 的 AWS SDK](https://docs.aws.amazon.com/goto/boto3/transcribe-2017-10-26/CreateCallAnalyticsCategory) 
+  [适用于 Ruby V3 的 AWS SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/transcribe-2017-10-26/CreateCallAnalyticsCategory)