Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

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

Membuat kategori Analytics Panggilan baru.

Semua kategori secara otomatis diterapkan ke transkripsi Call Analytics. Perhatikan bahwa untuk menerapkan kategori pada transkripsi Anda, Anda harus membuatnya sebelum mengirimkan permintaan transkripsi Anda, karena kategori tidak dapat diterapkan secara surut.

Saat membuat kategori baru, Anda dapat menggunakan`InputType` parameter untuk memberi label kategori sebagai`REAL_TIME` kategori`POST_CALL` atau. `POST_CALL`kategori hanya dapat diterapkan pada transkripsi pasca-panggilan dan`REAL_TIME` kategori hanya dapat diterapkan untuk transkripsi real-time. Jika Anda tidak menyertakan`InputType`, kategori Anda dibuat sebagai`POST_CALL` kategori secara default.

Kategori Call Analytics terdiri dari aturan. Untuk setiap kategori, Anda harus membuat antara 1 dan 20 aturan. Aturan dapat mencakup parameter ini:[InterruptionFilter](API_InterruptionFilter.md),[NonTalkTimeFilter](API_NonTalkTimeFilter.md),[SentimentFilter](API_SentimentFilter.md), dan[TranscriptFilter](API_TranscriptFilter.md).

Untuk memperbarui kategori yang ada, lihat[UpdateCallAnalyticsCategory](API_UpdateCallAnalyticsCategory.md).

Untuk mempelajari lebih lanjut tentang kategori Analytics Panggilan, lihat [Membuat kategori untuk transkripsi pasca-panggilan](https://docs.aws.amazon.com/transcribe/latest/dg/tca-categories-batch.html) dan [Membuat kategori untuk transkripsi real-time](https://docs.aws.amazon.com/transcribe/latest/dg/tca-categories-stream.html).

## Sintaksis Permintaan
<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"
         }
      }
   ]
}
```

## Parameter Permintaan
<a name="API_CreateCallAnalyticsCategory_RequestParameters"></a>

Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).

Permintaan menerima data berikut dalam format JSON.

 ** [CategoryName](#API_CreateCallAnalyticsCategory_RequestSyntax) **   <a name="transcribe-CreateCallAnalyticsCategory-request-CategoryName"></a>
Nama unik, yang dipilih oleh Anda, untuk kategori Analitik Panggilan Anda. Sangat membantu untuk menggunakan sistem penamaan terperinci yang akan masuk akal bagi Anda di future. Misalnya, lebih baik digunakan`sentiment-positive-last30seconds` untuk kategori di atas nama generik seperti`test-category`.  
Nama kategori peka huruf besar/kecil.  
Jenis: String  
Panjang Batasan: Panjang minimum 1. Panjang maksimum 200.  
Pola: `^[0-9a-zA-Z._-]+`   
Diperlukan: Ya

 ** [InputType](#API_CreateCallAnalyticsCategory_RequestSyntax) **   <a name="transcribe-CreateCallAnalyticsCategory-request-InputType"></a>
Pilih apakah Anda ingin membuat kategori real-time atau pasca-panggilan untuk transkripsi Analytics Panggilan Anda.  
Menentukan`POST_CALL` menetapkan kategori Anda untuk transkripsi pasca-panggilan; kategori dengan jenis masukan ini tidak dapat diterapkan untuk streaming (real-time) transkripsi.  
Menentukan`REAL_TIME` menetapkan kategori Anda untuk streaming transkripsi; kategori dengan jenis masukan ini tidak dapat diterapkan untuk transkripsi pasca-panggilan.  
Jika Anda tidak menyertakan`InputType`, kategori Anda dibuat sebagai kategori pasca-panggilan secara default.  
Jenis: String  
Nilai yang Valid:` REAL_TIME | POST_CALL`   
Wajib: Tidak

 ** [Rules](#API_CreateCallAnalyticsCategory_RequestSyntax) **   <a name="transcribe-CreateCallAnalyticsCategory-request-Rules"></a>
Aturan menentukan kategori Analytics Panggilan. Saat membuat kategori baru, Anda harus membuat antara 1 dan 20 aturan untuk kategori itu. Untuk setiap aturan, Anda menetapkan filter yang ingin diterapkan ke atribut panggilan. Misalnya, Anda dapat memilih filter sentimen yang mendeteksi apakah sentimen pelanggan positif selama 30 detik terakhir panggilan.  
Tipe: Array objek [Rule](API_Rule.md)  
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 20 item.  
Wajib: Ya

## Sintaksis Respons
<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"
            }
         }
      ]
   }
}
```

## Elemen Respons
<a name="API_CreateCallAnalyticsCategory_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [CategoryProperties](#API_CreateCallAnalyticsCategory_ResponseSyntax) **   <a name="transcribe-CreateCallAnalyticsCategory-response-CategoryProperties"></a>
Menyediakan properti kategori baru Anda, termasuk aturan terkait.  
Tipe: Objek [CategoryProperties](API_CategoryProperties.md)

## Kesalahan
<a name="API_CreateCallAnalyticsCategory_Errors"></a>

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).

 ** BadRequestException **   
Permintaan Anda tidak lulus satu atau beberapa tes validasi. Hal ini dapat terjadi ketika entitas yang Anda coba hapus tidak ada atau jika itu dalam keadaan non-terminal (seperti`IN PROGRESS`). Lihat kolom pesan pengecualian untuk informasi selengkapnya.  
Kode Status HTTP: 400

 ** ConflictException **   
Sumber daya sudah ada dengan nama ini. Nama sumber daya harus unik dalamAkun AWS.  
Kode Status HTTP: 400

 ** InternalFailureException **   
Ada kesalahan internal. Periksa pesan kesalahan, perbaiki masalah, dan coba permintaan Anda lagi.  
Kode Status HTTP: 500

 ** LimitExceededException **   
Anda telah mengirim terlalu banyak permintaan atau file input Anda terlalu panjang. Tunggu sebelum mencoba ulang permintaan Anda, atau gunakan file yang lebih kecil dan coba lagi permintaan Anda.  
Kode Status HTTP: 400

## Lihat Juga
<a name="API_CreateCallAnalyticsCategory_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API di salah satuAWS SDK khusus bahasa, lihat yang berikut ini:
+  [AWSAntarmuka Baris Perintah](https://docs.aws.amazon.com/goto/aws-cli/transcribe-2017-10-26/CreateCallAnalyticsCategory) 
+  [AWSSDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/transcribe-2017-10-26/CreateCallAnalyticsCategory) 
+  [AWSSDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/transcribe-2017-10-26/CreateCallAnalyticsCategory) 
+  [AWSSDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/transcribe-2017-10-26/CreateCallAnalyticsCategory) 
+  [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/transcribe-2017-10-26/CreateCallAnalyticsCategory) 
+  [AWSSDK untuk JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/transcribe-2017-10-26/CreateCallAnalyticsCategory) 
+  [AWSSDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/transcribe-2017-10-26/CreateCallAnalyticsCategory) 
+  [AWSSDK for Python](https://docs.aws.amazon.com/goto/boto3/transcribe-2017-10-26/CreateCallAnalyticsCategory) 
+  [AWSSDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/transcribe-2017-10-26/CreateCallAnalyticsCategory)