Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # CreateCallAnalyticsCategory Erstellt eine neue Call Analytics-Kategorie. Alle Kategorien werden automatisch auf Ihre Call Analytics-Transkriptionen angewendet. Beachten Sie, dass Sie, um Kategorien auf Ihre Transkriptionen anzuwenden, diese erstellen müssen, bevor Sie Ihre Transkriptionsanfrage einreichen, da Kategorien nicht rückwirkend angewendet werden können. Wenn Sie eine neue Kategorie erstellen, können Sie den`InputType` Parameter verwenden, um die Kategorie als Kategorie`POST_CALL` oder als`REAL_TIME` Kategorie zu kennzeichnen. `POST_CALL`Kategorien können nur auf Transkriptionen nach einem Anruf angewendet werden und`REAL_TIME` Kategorien können nur auf Transkriptionen in Echtzeit angewendet werden. Wenn Sie dies nicht angeben`InputType`, wird Ihre Kategorie standardmäßig als`POST_CALL` Kategorie erstellt. Die Kategorien von Call Analytics bestehen aus Regeln. Für jede Kategorie müssen Sie zwischen 1 und 20 Regeln erstellen. Regeln können die folgenden Parameter enthalten:[InterruptionFilter](API_InterruptionFilter.md)[NonTalkTimeFilter](API_NonTalkTimeFilter.md),[SentimentFilter](API_SentimentFilter.md), und[TranscriptFilter](API_TranscriptFilter.md). Informationen zum Aktualisieren einer vorhandenen Kategorie finden Sie unter[UpdateCallAnalyticsCategory](API_UpdateCallAnalyticsCategory.md). Weitere Informationen zu Call Analytics-Kategorien finden Sie unter [Kategorien für Transkriptionen nach einem Anruf](https://docs.aws.amazon.com/transcribe/latest/dg/tca-categories-batch.html) [erstellen und Kategorien für Echtzeit-Transkriptionen](https://docs.aws.amazon.com/transcribe/latest/dg/tca-categories-stream.html) erstellen. ## Anforderungssyntax ``` { "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" } } ] } ``` ## Anfrageparameter Informationen zu den Parametern, die allen Aktionen gemeinsam sind, finden Sie unter [Allgemeine Parameter](CommonParameters.md). Die Anforderung akzeptiert die folgenden Daten im JSON-Format. ** [CategoryName](#API_CreateCallAnalyticsCategory_RequestSyntax) ** Ein von Ihnen ausgewählter eindeutiger Name für Ihre Call Analytics-Kategorie. Es ist hilfreich, ein detailliertes Benennungssystem zu verwenden, das für Sie in future sinnvoll sein wird. Zum Beispiel ist es besser, ihn`sentiment-positive-last30seconds` für eine Kategorie als einen generischen Namen wie zu verwenden`test-category`. Bei Namen von Kategorien wird zwischen Groß- und Kleinschreibung unterschieden. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge von 1. Höchstlänge = 200 Zeichen. Pattern: `^[0-9a-zA-Z._-]+` Erforderlich: Ja ** [InputType](#API_CreateCallAnalyticsCategory_RequestSyntax) ** Wählen Sie aus, ob Sie eine Echtzeit- oder eine Kategorie nach dem Anruf für Ihre Call Analytics-Transkription erstellen möchten. Wenn Sie angeben,`POST_CALL` wird Ihre Kategorie Transkriptionen nach einem Anruf zugewiesen. Kategorien mit diesem Eingabetyp können nicht auf Streaming-Transkriptionen (Echtzeit) angewendet werden. Durch die Angabe`REAL_TIME` wird Ihre Kategorie Streaming-Transkriptionen zugewiesen. Kategorien mit diesem Eingabetyp können nicht auf Transkriptionen nach einem Anruf angewendet werden. Wenn Sie dies nicht angeben`InputType`, wird Ihre Kategorie standardmäßig als Kategorie nach dem Anruf erstellt. Typ: Zeichenfolge Zulässige Werte:` REAL_TIME | POST_CALL` Required: No ** [Rules](#API_CreateCallAnalyticsCategory_RequestSyntax) ** Regeln definieren eine Call Analytics-Kategorie. Wenn Sie eine neue Kategorie erstellen, müssen Sie zwischen 1 und 20 Regeln für diese Kategorie erstellen. Für jede Regel geben Sie einen Filter an, der auf die Attribute eines Anrufs angewendet werden soll. Sie können beispielsweise einen Stimmungsfilter wählen, der erkennt, ob die Stimmung eines Kunden in den letzten 30 Sekunden des Anrufs positiv war. Typ: Array von [Rule](API_Rule.md)-Objekten Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Die maximale Anzahl beträgt 50 Elemente. Erforderlich: Ja ## Antwortsyntax ``` { "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" } } ] } } ``` ## Antwortelemente Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück. Die folgenden Daten werden vom Service im JSON-Format zurückgegeben. ** [CategoryProperties](#API_CreateCallAnalyticsCategory_ResponseSyntax) ** Stellt Ihnen die Eigenschaften Ihrer neuen Kategorie zur Verfügung, einschließlich der zugehörigen Regeln. Typ: [CategoryProperties](API_CategoryProperties.md) Objekt ## Fehler Hinweise zu den Fehlern, die allen Aktionen gemeinsam sind, finden Sie unter[Häufige Fehler](CommonErrors.md). ** BadRequestException ** Ihre Anfrage hat einen oder mehrere Validierungstests nicht bestanden. Dies kann vorkommen, wenn die Entität, die Sie löschen möchten, nicht existiert oder wenn sie sich in einem nicht terminalen Zustand befindet (z. B.`IN PROGRESS`). Weitere Informationen finden Sie im Feld für die Ausnahmemeldung. HTTP Status Code: 400 ** ConflictException ** Eine Ressource mit diesem Namen ist bereits vorhanden. Ressourcennamen müssen innerhalb eines ---Objekts eindeutig seinAWS-Konto. HTTP Status Code: 400 ** InternalFailureException ** Es ist ein interner Fehler aufgetreten. Überprüfen Sie die Fehlermeldung, korrigieren Sie das Problem und versuchen Sie Ihre Anfrage erneut. HTTP Status Code: 500 ** LimitExceededException ** Sie haben entweder zu viele Anfragen gesendet oder Ihre Eingabedatei ist zu lang. Warten Sie, bevor Sie Ihre Anfrage erneut versuchen, oder verwenden Sie eine kleinere Datei und versuchen Sie es erneut. HTTP Status Code: 400 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter: + [AWS-Befehlszeilenschnittstelle](https://docs.aws.amazon.com/goto/aws-cli/transcribe-2017-10-26/CreateCallAnalyticsCategory) + [AWS-SDK für .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/transcribe-2017-10-26/CreateCallAnalyticsCategory) + [AWS-SDK für C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/transcribe-2017-10-26/CreateCallAnalyticsCategory) + [AWS-SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/transcribe-2017-10-26/CreateCallAnalyticsCategory) + [AWS-SDK für Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/transcribe-2017-10-26/CreateCallAnalyticsCategory) + [AWSSDK für JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/transcribe-2017-10-26/CreateCallAnalyticsCategory) + [AWS SDK für PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/transcribe-2017-10-26/CreateCallAnalyticsCategory) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/transcribe-2017-10-26/CreateCallAnalyticsCategory) + [AWS SDK für Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/transcribe-2017-10-26/CreateCallAnalyticsCategory)