feat: [contactcenterinsights] Add FeedbackLabel resource and APIs (#5817

)

* feat: Add FeedbackLabel resource and APIs
feat: Add QueryMetrics API
feat: Add Quality AI resources and APIs
feat: Add AnalysisRules resource and APIs
docs: A comment for method `InitializeEncryptionSpec` in service `ContactCenterInsights` is changed
docs: A comment for field `custom_metadata_keys` in message `.google.cloud.contactcenterinsights.v1.IngestConversationsRequest` is changed
docs: A comment for field `encryption_spec` in message `.google.cloud.contactcenterinsights.v1.InitializeEncryptionSpecRequest` is changed
docs: A comment for field `partial_errors` in message `.google.cloud.contactcenterinsights.v1.InitializeEncryptionSpecMetadata` is changed
docs: A comment for field `labels` in message `.google.cloud.contactcenterinsights.v1.Conversation` is changed
docs: A comment for field `metadata_json` in message `.google.cloud.contactcenterinsights.v1.Conversation` is changed
docs: A comment for message `EncryptionSpec` is changed
docs: A comment for field `kms_key` in message `.google.cloud.contactcenterinsights.v1.EncryptionSpec` is changed

PiperOrigin-RevId: 696581715

Source-Link: googleapis/googleapis@242a5f1

Source-Link: googleapis/googleapis-gen@1a51252
Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWNvbnRhY3RjZW50ZXJpbnNpZ2h0cy8uT3dsQm90LnlhbWwiLCJoIjoiMWE1MTI1MjUzYzNkYmRkOTEyMjc4ZDQ1OTA5YWQ2Y2ZiMDAzMTA4NSJ9

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

packages/google-cloud-contactcenterinsights/samples/generated/v1/contact_center_insights.bulk_download_feedback_labels.js

@@ -0,0 +1,103 @@
+// Copyright 2024 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+// ** This file is automatically generated by gapic-generator-typescript. **
+// ** https://github.com/googleapis/gapic-generator-typescript **
+// ** All changes to this file may be overwritten. **
+
+
+
+'use strict';
+
+function main(parent) {
+  // [START contactcenterinsights_v1_generated_ContactCenterInsights_BulkDownloadFeedbackLabels_async]
+  /**
+   * This snippet has been automatically generated and should be regarded as a code template only.
+   * It will require modifications to work.
+   * It may require correct/in-range values for request initialization.
+   * TODO(developer): Uncomment these variables before running the sample.
+   */
+  /**
+   *  A cloud storage bucket destination.
+   */
+  // const gcsDestination = {}
+  /**
+   *  Required. The parent resource for new feedback labels.
+   */
+  // const parent = 'abc123'
+  /**
+   *  Optional. A filter to reduce results to a specific subset. Supports
+   *  disjunctions (OR) and conjunctions (AND).
+   *  Supported fields:
+   *  * `issue_model_id`
+   *  * `qa_question_id`
+   *  * `qa_scorecard_id`
+   *  * `min_create_time`
+   *  * `max_create_time`
+   *  * `min_update_time`
+   *  * `max_update_time`
+   *  * `feedback_label_type`: QUALITY_AI, TOPIC_MODELING
+   */
+  // const filter = 'abc123'
+  /**
+   *  Optional. Limits the maximum number of feedback labels that will be
+   *  downloaded. The first `N` feedback labels will be downloaded.
+   */
+  // const maxDownloadCount = 1234
+  /**
+   *  Optional. The type of feedback labels that will be downloaded.
+   */
+  // const feedbackLabelType = {}
+  /**
+   *  Optional. Filter parent conversations to download feedback labels for.
+   *  When specified, the feedback labels will be downloaded for the
+   *  conversations that match the filter.
+   *  If `template_qa_scorecard_id` is set, all the conversations that match the
+   *  filter will be paired with the questions under the scorecard for labeling.
+   */
+  // const conversationFilter = 'abc123'
+  /**
+   *  Optional. If set, a template for labeling conversations and scorecard
+   *  questions will be created from the conversation_filter and the questions
+   *  under the scorecard(s). The feedback label `filter` will be ignored.
+   */
+  // const templateQaScorecardId = ['abc','def']
+
+  // Imports the Contactcenterinsights library
+  const {ContactCenterInsightsClient} = require('@google-cloud/contact-center-insights').v1;
+
+  // Instantiates a client
+  const contactcenterinsightsClient = new ContactCenterInsightsClient();
+
+  async function callBulkDownloadFeedbackLabels() {
+    // Construct request
+    const request = {
+      parent,
+    };
+
+    // Run request
+    const [operation] = await contactcenterinsightsClient.bulkDownloadFeedbackLabels(request);
+    const [response] = await operation.promise();
+    console.log(response);
+  }
+
+  callBulkDownloadFeedbackLabels();
+  // [END contactcenterinsights_v1_generated_ContactCenterInsights_BulkDownloadFeedbackLabels_async]
+}
+
+process.on('unhandledRejection', err => {
+  console.error(err.message);
+  process.exitCode = 1;
+});
+main(...process.argv.slice(2));

packages/google-cloud-contactcenterinsights/samples/generated/v1/contact_center_insights.bulk_upload_feedback_labels.js

@@ -0,0 +1,72 @@
+// Copyright 2024 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+// ** This file is automatically generated by gapic-generator-typescript. **
+// ** https://github.com/googleapis/gapic-generator-typescript **
+// ** All changes to this file may be overwritten. **
+
+
+
+'use strict';
+
+function main(parent) {
+  // [START contactcenterinsights_v1_generated_ContactCenterInsights_BulkUploadFeedbackLabels_async]
+  /**
+   * This snippet has been automatically generated and should be regarded as a code template only.
+   * It will require modifications to work.
+   * It may require correct/in-range values for request initialization.
+   * TODO(developer): Uncomment these variables before running the sample.
+   */
+  /**
+   *  A cloud storage bucket source.
+   */
+  // const gcsSource = {}
+  /**
+   *  Required. The parent resource for new feedback labels.
+   */
+  // const parent = 'abc123'
+  /**
+   *  Optional. If set, upload will not happen and the labels will be validated.
+   *  If not set, then default behavior will be to upload the labels after
+   *  validation is complete.
+   */
+  // const validateOnly = true
+
+  // Imports the Contactcenterinsights library
+  const {ContactCenterInsightsClient} = require('@google-cloud/contact-center-insights').v1;
+
+  // Instantiates a client
+  const contactcenterinsightsClient = new ContactCenterInsightsClient();
+
+  async function callBulkUploadFeedbackLabels() {
+    // Construct request
+    const request = {
+      parent,
+    };
+
+    // Run request
+    const [operation] = await contactcenterinsightsClient.bulkUploadFeedbackLabels(request);
+    const [response] = await operation.promise();
+    console.log(response);
+  }
+
+  callBulkUploadFeedbackLabels();
+  // [END contactcenterinsights_v1_generated_ContactCenterInsights_BulkUploadFeedbackLabels_async]
+}
+
+process.on('unhandledRejection', err => {
+  console.error(err.message);
+  process.exitCode = 1;
+});
+main(...process.argv.slice(2));

packages/google-cloud-contactcenterinsights/samples/generated/v1/contact_center_insights.create_analysis_rule.js

@@ -0,0 +1,69 @@
+// Copyright 2024 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+// ** This file is automatically generated by gapic-generator-typescript. **
+// ** https://github.com/googleapis/gapic-generator-typescript **
+// ** All changes to this file may be overwritten. **
+
+
+
+'use strict';
+
+function main(parent, analysisRule) {
+  // [START contactcenterinsights_v1_generated_ContactCenterInsights_CreateAnalysisRule_async]
+  /**
+   * This snippet has been automatically generated and should be regarded as a code template only.
+   * It will require modifications to work.
+   * It may require correct/in-range values for request initialization.
+   * TODO(developer): Uncomment these variables before running the sample.
+   */
+  /**
+   *  Required. The parent resource of the analysis rule. Required. The location
+   *  to create a analysis rule for. Format: `projects/<Project
+   *  ID>/locations/<Location ID>` or `projects/<Project
+   *  Number>/locations/<Location ID>`
+   */
+  // const parent = 'abc123'
+  /**
+   *  Required. The analysis rule resource to create.
+   */
+  // const analysisRule = {}
+
+  // Imports the Contactcenterinsights library
+  const {ContactCenterInsightsClient} = require('@google-cloud/contact-center-insights').v1;
+
+  // Instantiates a client
+  const contactcenterinsightsClient = new ContactCenterInsightsClient();
+
+  async function callCreateAnalysisRule() {
+    // Construct request
+    const request = {
+      parent,
+      analysisRule,
+    };
+
+    // Run request
+    const response = await contactcenterinsightsClient.createAnalysisRule(request);
+    console.log(response);
+  }
+
+  callCreateAnalysisRule();
+  // [END contactcenterinsights_v1_generated_ContactCenterInsights_CreateAnalysisRule_async]
+}
+
+process.on('unhandledRejection', err => {
+  console.error(err.message);
+  process.exitCode = 1;
+});
+main(...process.argv.slice(2));

packages/google-cloud-contactcenterinsights/samples/generated/v1/contact_center_insights.create_feedback_label.js

@@ -0,0 +1,71 @@
+// Copyright 2024 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+// ** This file is automatically generated by gapic-generator-typescript. **
+// ** https://github.com/googleapis/gapic-generator-typescript **
+// ** All changes to this file may be overwritten. **
+
+
+
+'use strict';
+
+function main(parent, feedbackLabel) {
+  // [START contactcenterinsights_v1_generated_ContactCenterInsights_CreateFeedbackLabel_async]
+  /**
+   * This snippet has been automatically generated and should be regarded as a code template only.
+   * It will require modifications to work.
+   * It may require correct/in-range values for request initialization.
+   * TODO(developer): Uncomment these variables before running the sample.
+   */
+  /**
+   *  Required. The parent resource of the feedback label.
+   */
+  // const parent = 'abc123'
+  /**
+   *  Optional. The ID of the feedback label to create.
+   *  If one is not specified it will be generated by the server.
+   */
+  // const feedbackLabelId = 'abc123'
+  /**
+   *  Required. The feedback label to create.
+   */
+  // const feedbackLabel = {}
+
+  // Imports the Contactcenterinsights library
+  const {ContactCenterInsightsClient} = require('@google-cloud/contact-center-insights').v1;
+
+  // Instantiates a client
+  const contactcenterinsightsClient = new ContactCenterInsightsClient();
+
+  async function callCreateFeedbackLabel() {
+    // Construct request
+    const request = {
+      parent,
+      feedbackLabel,
+    };
+
+    // Run request
+    const response = await contactcenterinsightsClient.createFeedbackLabel(request);
+    console.log(response);
+  }
+
+  callCreateFeedbackLabel();
+  // [END contactcenterinsights_v1_generated_ContactCenterInsights_CreateFeedbackLabel_async]
+}
+
+process.on('unhandledRejection', err => {
+  console.error(err.message);
+  process.exitCode = 1;
+});
+main(...process.argv.slice(2));

packages/google-cloud-contactcenterinsights/samples/generated/v1/contact_center_insights.create_qa_question.js

@@ -0,0 +1,74 @@
+// Copyright 2024 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     https://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+// ** This file is automatically generated by gapic-generator-typescript. **
+// ** https://github.com/googleapis/gapic-generator-typescript **
+// ** All changes to this file may be overwritten. **
+
+
+
+'use strict';
+
+function main(parent, qaQuestion) {
+  // [START contactcenterinsights_v1_generated_ContactCenterInsights_CreateQaQuestion_async]
+  /**
+   * This snippet has been automatically generated and should be regarded as a code template only.
+   * It will require modifications to work.
+   * It may require correct/in-range values for request initialization.
+   * TODO(developer): Uncomment these variables before running the sample.
+   */
+  /**
+   *  Required. The parent resource of the QaQuestion.
+   */
+  // const parent = 'abc123'
+  /**
+   *  Required. The QaQuestion to create.
+   */
+  // const qaQuestion = {}
+  /**
+   *  Optional. A unique ID for the new question. This ID will become the final
+   *  component of the question's resource name. If no ID is specified, a
+   *  server-generated ID will be used.
+   *  This value should be 4-64 characters and must match the regular
+   *  expression `^[a-z0-9-]{4,64}$`. Valid characters are `[a-z][0-9]-`.
+   */
+  // const qaQuestionId = 'abc123'
+
+  // Imports the Contactcenterinsights library
+  const {ContactCenterInsightsClient} = require('@google-cloud/contact-center-insights').v1;
+
+  // Instantiates a client
+  const contactcenterinsightsClient = new ContactCenterInsightsClient();
+
+  async function callCreateQaQuestion() {
+    // Construct request
+    const request = {
+      parent,
+      qaQuestion,
+    };
+
+    // Run request
+    const response = await contactcenterinsightsClient.createQaQuestion(request);
+    console.log(response);
+  }
+
+  callCreateQaQuestion();
+  // [END contactcenterinsights_v1_generated_ContactCenterInsights_CreateQaQuestion_async]
+}
+
+process.on('unhandledRejection', err => {
+  console.error(err.message);
+  process.exitCode = 1;
+});
+main(...process.argv.slice(2));