feat(contactcenterinsights): update the api

#### contactcenterinsights:v1

The following keys were added:
- resources.projects.resources.locations.resources.conversations.methods.create.deprecated (Total Keys: 1)
- schemas.GoogleCloudContactcenterinsightsV1IngestConversationsRequest.properties.sampleSize (Total Keys: 2)
- schemas.GoogleCloudContactcenterinsightsV1alpha1IngestConversationsRequest.properties.sampleSize (Total Keys: 2)

Author: yoshi-automation

docs/dyn/contactcenterinsights_v1.projects.locations.conversations.html

@@ -93,7 +93,7 @@ <h2>Instance Methods</h2>
 <p class="firstline">Close httplib2 connections.</p>
 <p class="toc_element">
   <code><a href="#create">create(parent, body=None, conversationId=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Creates a conversation.</p>
+<p class="firstline">Creates a conversation. DEPRECATED: Use UploadConversation instead. CreateConversation does not support audio transcription or DLP redaction.</p>
 <p class="toc_element">
   <code><a href="#delete">delete(name, force=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Deletes a conversation.</p>
@@ -279,7 +279,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="create">create(parent, body=None, conversationId=None, x__xgafv=None)</code>
-  <pre>Creates a conversation.
+  <pre>Creates a conversation. DEPRECATED: Use UploadConversation instead. CreateConversation does not support audio transcription or DLP redaction.
 
 Args:
   parent: string, Required. The parent resource of the conversation. (required)
@@ -1493,7 +1493,7 @@ <h3>Method Details</h3>
 { # The request to ingest conversations.
   &quot;conversationConfig&quot;: { # Configuration that applies to all conversations. # Configuration that applies to all conversations.
     &quot;agentChannel&quot;: 42, # Optional. Indicates which of the channels, 1 or 2, contains the agent. Note that this must be set for conversations to be properly displayed and analyzed.
-    &quot;agentId&quot;: &quot;A String&quot;, # An opaque, user-specified string representing the human agent who handled the conversations.
+    &quot;agentId&quot;: &quot;A String&quot;, # Optional. An opaque, user-specified string representing a human agent who handled all conversations in the import. Note that this will be overridden if per-conversation metadata is provided via the `metadata_bucket_uri`.
     &quot;customerChannel&quot;: 42, # Optional. Indicates which of the channels, 1 or 2, contains the agent. Note that this must be set for conversations to be properly displayed and analyzed.
   },
   &quot;gcsSource&quot;: { # Configuration for Cloud Storage bucket sources. # A cloud storage bucket source. Note that any previously ingested objects from the source will be skipped to avoid duplication.
@@ -1505,11 +1505,12 @@ <h3>Method Details</h3>
     &quot;metadataBucketUri&quot;: &quot;A String&quot;, # Optional. The Cloud Storage path to the source object metadata. Note that: [1] metadata files are expected to be in JSON format [2] metadata and source objects must be in separate buckets [3] a source object&#x27;s metadata object must share the same name to be properly ingested
   },
   &quot;parent&quot;: &quot;A String&quot;, # Required. The parent resource for new conversations.
-  &quot;redactionConfig&quot;: { # DLP resources used for redaction while ingesting conversations. # Optional. DLP settings for transcript redaction. Optional, will default to the config specified in Settings.
+  &quot;redactionConfig&quot;: { # DLP resources used for redaction while ingesting conversations. DLP settings are applied to conversations ingested from the UploadConversation and IngestConversations endpoints, including conversation coming from CCAI Platform. They are not applied to conversations ingested from the CreateConversation endpoint or the Dialogflow / Agent Assist runtime integrations. When using Dialogflow / Agent Assist runtime integrations redaction should be performed in Dialogflow / Agent Assist. # Optional. DLP settings for transcript redaction. Optional, will default to the config specified in Settings.
     &quot;deidentifyTemplate&quot;: &quot;A String&quot;, # The fully-qualified DLP deidentify template resource name. Format: `projects/{project}/deidentifyTemplates/{template}`
     &quot;inspectTemplate&quot;: &quot;A String&quot;, # The fully-qualified DLP inspect template resource name. Format: `projects/{project}/locations/{location}/inspectTemplates/{template}`
   },
-  &quot;speechConfig&quot;: { # Speech-to-Text configuration. # Optional. Default Speech-to-Text configuration. Optional, will default to the config specified in Settings.
+  &quot;sampleSize&quot;: 42, # Optional. If set, this fields indicates the number of objects to ingest from the Cloud Storage bucket. If empty, the entire bucket will be ingested. Note that conversations produced via sampling will not be ingested by subsequent ingest requests unless they are first deleted.
+  &quot;speechConfig&quot;: { # Speech-to-Text configuration. Speech-to-Text settings are applied to conversations ingested from the UploadConversation and IngestConversations endpoints, including conversation coming from CCAI Platform. They are not applied to conversations ingested from the CreateConversation endpoint. # Optional. Default Speech-to-Text configuration. Optional, will default to the config specified in Settings.
     &quot;speechRecognizer&quot;: &quot;A String&quot;, # The fully-qualified Speech Recognizer resource name. Format: `projects/{project_id}/locations/{location}/recognizer/{recognizer}`
   },
   &quot;transcriptObjectConfig&quot;: { # Configuration for processing transcript objects. # Configuration for when `source` contains conversation transcripts.
@@ -3147,11 +3148,11 @@ <h3>Method Details</h3>
   },
   &quot;conversationId&quot;: &quot;A String&quot;, # Optional. A unique ID for the new conversation. This ID will become the final component of the conversation&#x27;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-`
   &quot;parent&quot;: &quot;A String&quot;, # Required. The parent resource of the conversation.
-  &quot;redactionConfig&quot;: { # DLP resources used for redaction while ingesting conversations. # Optional. DLP settings for transcript redaction. Will default to the config specified in Settings.
+  &quot;redactionConfig&quot;: { # DLP resources used for redaction while ingesting conversations. DLP settings are applied to conversations ingested from the UploadConversation and IngestConversations endpoints, including conversation coming from CCAI Platform. They are not applied to conversations ingested from the CreateConversation endpoint or the Dialogflow / Agent Assist runtime integrations. When using Dialogflow / Agent Assist runtime integrations redaction should be performed in Dialogflow / Agent Assist. # Optional. DLP settings for transcript redaction. Will default to the config specified in Settings.
     &quot;deidentifyTemplate&quot;: &quot;A String&quot;, # The fully-qualified DLP deidentify template resource name. Format: `projects/{project}/deidentifyTemplates/{template}`
     &quot;inspectTemplate&quot;: &quot;A String&quot;, # The fully-qualified DLP inspect template resource name. Format: `projects/{project}/locations/{location}/inspectTemplates/{template}`
   },
-  &quot;speechConfig&quot;: { # Speech-to-Text configuration. # Optional. Speech-to-Text configuration. Will default to the config specified in Settings.
+  &quot;speechConfig&quot;: { # Speech-to-Text configuration. Speech-to-Text settings are applied to conversations ingested from the UploadConversation and IngestConversations endpoints, including conversation coming from CCAI Platform. They are not applied to conversations ingested from the CreateConversation endpoint. # Optional. Speech-to-Text configuration. Will default to the config specified in Settings.
     &quot;speechRecognizer&quot;: &quot;A String&quot;, # The fully-qualified Speech Recognizer resource name. Format: `projects/{project_id}/locations/{location}/recognizer/{recognizer}`
   },
 }

docs/dyn/contactcenterinsights_v1.projects.locations.html

@@ -165,11 +165,11 @@ <h3>Method Details</h3>
   &quot;pubsubNotificationSettings&quot;: { # A map that maps a notification trigger to a Pub/Sub topic. Each time a specified trigger occurs, Insights will notify the corresponding Pub/Sub topic. Keys are notification triggers. Supported keys are: * &quot;all-triggers&quot;: Notify each time any of the supported triggers occurs. * &quot;create-analysis&quot;: Notify each time an analysis is created. * &quot;create-conversation&quot;: Notify each time a conversation is created. * &quot;export-insights-data&quot;: Notify each time an export is complete. * &quot;ingest-conversations&quot;: Notify each time an IngestConversations LRO completes. * &quot;update-conversation&quot;: Notify each time a conversation is updated via UpdateConversation. * &quot;upload-conversation&quot;: Notify when an UploadConversation LRO completes. Values are Pub/Sub topics. The format of each Pub/Sub topic is: projects/{project}/topics/{topic}
     &quot;a_key&quot;: &quot;A String&quot;,
   },
-  &quot;redactionConfig&quot;: { # DLP resources used for redaction while ingesting conversations. # Default DLP redaction resources to be applied while ingesting conversations.
+  &quot;redactionConfig&quot;: { # DLP resources used for redaction while ingesting conversations. DLP settings are applied to conversations ingested from the UploadConversation and IngestConversations endpoints, including conversation coming from CCAI Platform. They are not applied to conversations ingested from the CreateConversation endpoint or the Dialogflow / Agent Assist runtime integrations. When using Dialogflow / Agent Assist runtime integrations redaction should be performed in Dialogflow / Agent Assist. # Default DLP redaction resources to be applied while ingesting conversations. This applies to conversations ingested from the UploadConversation and IngestConversations endpoints, including conversations coming from CCAI Platform.
     &quot;deidentifyTemplate&quot;: &quot;A String&quot;, # The fully-qualified DLP deidentify template resource name. Format: `projects/{project}/deidentifyTemplates/{template}`
     &quot;inspectTemplate&quot;: &quot;A String&quot;, # The fully-qualified DLP inspect template resource name. Format: `projects/{project}/locations/{location}/inspectTemplates/{template}`
   },
-  &quot;speechConfig&quot;: { # Speech-to-Text configuration. # Optional. Default Speech-to-Text resources to be used while ingesting audio files. Optional, CCAI Insights will create a default if not provided.
+  &quot;speechConfig&quot;: { # Speech-to-Text configuration. Speech-to-Text settings are applied to conversations ingested from the UploadConversation and IngestConversations endpoints, including conversation coming from CCAI Platform. They are not applied to conversations ingested from the CreateConversation endpoint. # Optional. Default Speech-to-Text resources to be used while ingesting audio files. Optional, CCAI Insights will create a default if not provided. This applies to conversations ingested from the UploadConversation and IngestConversations endpoints, including conversations coming from CCAI Platform.
     &quot;speechRecognizer&quot;: &quot;A String&quot;, # The fully-qualified Speech Recognizer resource name. Format: `projects/{project_id}/locations/{location}/recognizer/{recognizer}`
   },
   &quot;updateTime&quot;: &quot;A String&quot;, # Output only. The time at which the settings were last updated.
@@ -217,11 +217,11 @@ <h3>Method Details</h3>
   &quot;pubsubNotificationSettings&quot;: { # A map that maps a notification trigger to a Pub/Sub topic. Each time a specified trigger occurs, Insights will notify the corresponding Pub/Sub topic. Keys are notification triggers. Supported keys are: * &quot;all-triggers&quot;: Notify each time any of the supported triggers occurs. * &quot;create-analysis&quot;: Notify each time an analysis is created. * &quot;create-conversation&quot;: Notify each time a conversation is created. * &quot;export-insights-data&quot;: Notify each time an export is complete. * &quot;ingest-conversations&quot;: Notify each time an IngestConversations LRO completes. * &quot;update-conversation&quot;: Notify each time a conversation is updated via UpdateConversation. * &quot;upload-conversation&quot;: Notify when an UploadConversation LRO completes. Values are Pub/Sub topics. The format of each Pub/Sub topic is: projects/{project}/topics/{topic}
     &quot;a_key&quot;: &quot;A String&quot;,
   },
-  &quot;redactionConfig&quot;: { # DLP resources used for redaction while ingesting conversations. # Default DLP redaction resources to be applied while ingesting conversations.
+  &quot;redactionConfig&quot;: { # DLP resources used for redaction while ingesting conversations. DLP settings are applied to conversations ingested from the UploadConversation and IngestConversations endpoints, including conversation coming from CCAI Platform. They are not applied to conversations ingested from the CreateConversation endpoint or the Dialogflow / Agent Assist runtime integrations. When using Dialogflow / Agent Assist runtime integrations redaction should be performed in Dialogflow / Agent Assist. # Default DLP redaction resources to be applied while ingesting conversations. This applies to conversations ingested from the UploadConversation and IngestConversations endpoints, including conversations coming from CCAI Platform.
     &quot;deidentifyTemplate&quot;: &quot;A String&quot;, # The fully-qualified DLP deidentify template resource name. Format: `projects/{project}/deidentifyTemplates/{template}`
     &quot;inspectTemplate&quot;: &quot;A String&quot;, # The fully-qualified DLP inspect template resource name. Format: `projects/{project}/locations/{location}/inspectTemplates/{template}`
   },
-  &quot;speechConfig&quot;: { # Speech-to-Text configuration. # Optional. Default Speech-to-Text resources to be used while ingesting audio files. Optional, CCAI Insights will create a default if not provided.
+  &quot;speechConfig&quot;: { # Speech-to-Text configuration. Speech-to-Text settings are applied to conversations ingested from the UploadConversation and IngestConversations endpoints, including conversation coming from CCAI Platform. They are not applied to conversations ingested from the CreateConversation endpoint. # Optional. Default Speech-to-Text resources to be used while ingesting audio files. Optional, CCAI Insights will create a default if not provided. This applies to conversations ingested from the UploadConversation and IngestConversations endpoints, including conversations coming from CCAI Platform.
     &quot;speechRecognizer&quot;: &quot;A String&quot;, # The fully-qualified Speech Recognizer resource name. Format: `projects/{project_id}/locations/{location}/recognizer/{recognizer}`
   },
   &quot;updateTime&quot;: &quot;A String&quot;, # Output only. The time at which the settings were last updated.
@@ -268,11 +268,11 @@ <h3>Method Details</h3>
   &quot;pubsubNotificationSettings&quot;: { # A map that maps a notification trigger to a Pub/Sub topic. Each time a specified trigger occurs, Insights will notify the corresponding Pub/Sub topic. Keys are notification triggers. Supported keys are: * &quot;all-triggers&quot;: Notify each time any of the supported triggers occurs. * &quot;create-analysis&quot;: Notify each time an analysis is created. * &quot;create-conversation&quot;: Notify each time a conversation is created. * &quot;export-insights-data&quot;: Notify each time an export is complete. * &quot;ingest-conversations&quot;: Notify each time an IngestConversations LRO completes. * &quot;update-conversation&quot;: Notify each time a conversation is updated via UpdateConversation. * &quot;upload-conversation&quot;: Notify when an UploadConversation LRO completes. Values are Pub/Sub topics. The format of each Pub/Sub topic is: projects/{project}/topics/{topic}
     &quot;a_key&quot;: &quot;A String&quot;,
   },
-  &quot;redactionConfig&quot;: { # DLP resources used for redaction while ingesting conversations. # Default DLP redaction resources to be applied while ingesting conversations.
+  &quot;redactionConfig&quot;: { # DLP resources used for redaction while ingesting conversations. DLP settings are applied to conversations ingested from the UploadConversation and IngestConversations endpoints, including conversation coming from CCAI Platform. They are not applied to conversations ingested from the CreateConversation endpoint or the Dialogflow / Agent Assist runtime integrations. When using Dialogflow / Agent Assist runtime integrations redaction should be performed in Dialogflow / Agent Assist. # Default DLP redaction resources to be applied while ingesting conversations. This applies to conversations ingested from the UploadConversation and IngestConversations endpoints, including conversations coming from CCAI Platform.
     &quot;deidentifyTemplate&quot;: &quot;A String&quot;, # The fully-qualified DLP deidentify template resource name. Format: `projects/{project}/deidentifyTemplates/{template}`
     &quot;inspectTemplate&quot;: &quot;A String&quot;, # The fully-qualified DLP inspect template resource name. Format: `projects/{project}/locations/{location}/inspectTemplates/{template}`
   },
-  &quot;speechConfig&quot;: { # Speech-to-Text configuration. # Optional. Default Speech-to-Text resources to be used while ingesting audio files. Optional, CCAI Insights will create a default if not provided.
+  &quot;speechConfig&quot;: { # Speech-to-Text configuration. Speech-to-Text settings are applied to conversations ingested from the UploadConversation and IngestConversations endpoints, including conversation coming from CCAI Platform. They are not applied to conversations ingested from the CreateConversation endpoint. # Optional. Default Speech-to-Text resources to be used while ingesting audio files. Optional, CCAI Insights will create a default if not provided. This applies to conversations ingested from the UploadConversation and IngestConversations endpoints, including conversations coming from CCAI Platform.
     &quot;speechRecognizer&quot;: &quot;A String&quot;, # The fully-qualified Speech Recognizer resource name. Format: `projects/{project_id}/locations/{location}/recognizer/{recognizer}`
   },
   &quot;updateTime&quot;: &quot;A String&quot;, # Output only. The time at which the settings were last updated.