feat: Launch UploadConversation endpoint

Google APIs · copybara-github · commit dabc23526a9e · 2023-04-05T12:54:07.000-07:00
PiperOrigin-RevId: 522129764
diff --git a/google/cloud/contactcenterinsights/v1/contact_center_insights.proto b/google/cloud/contactcenterinsights/v1/contact_center_insights.proto
@@ -52,6 +52,21 @@ service ContactCenterInsights {
         "parent,conversation,conversation_id";
   }
 
+  // Create a longrunning conversation upload operation. This method differs
+  // from CreateConversation by allowing audio transcription and optional DLP
+  // redaction.
+  rpc UploadConversation(UploadConversationRequest)
+      returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*/locations/*}/conversations:upload"
+      body: "*"
+    };
+    option (google.longrunning.operation_info) = {
+      response_type: "Conversation"
+      metadata_type: "UploadConversationMetadata"
+    };
+  }
+
   // Updates a conversation.
   rpc UpdateConversation(UpdateConversationRequest) returns (Conversation) {
     option (google.api.http) = {
@@ -537,6 +552,55 @@ message CreateConversationRequest {
   string conversation_id = 3;
 }
 
+// Request to upload a conversation.
+message UploadConversationRequest {
+  // Required. The parent resource of the conversation.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "locations.googleapis.com/Location"
+    }
+  ];
+
+  // Required. The conversation resource to create.
+  Conversation conversation = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. A unique ID for the new conversation. This ID will become the
+  // final component of the conversation'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]-`
+  string conversation_id = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. DLP settings for transcript redaction. Optional, will default to
+  // the config specified in Settings.
+  RedactionConfig redaction_config = 4 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// The metadata for an UploadConversation operation.
+message UploadConversationMetadata {
+  // Output only. The time the operation was created.
+  google.protobuf.Timestamp create_time = 1
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The time the operation finished running.
+  google.protobuf.Timestamp end_time = 2
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The original request.
+  UploadConversationRequest request = 3
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The operation name for a successfully created analysis
+  // operation, if any.
+  string analysis_operation = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The redaction config applied to the uploaded conversation.
+  RedactionConfig applied_redaction_config = 5
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+}
+
 // Request to list conversations.
 message ListConversationsRequest {
   // Required. The parent resource of the conversation.
diff --git a/google/cloud/contactcenterinsights/v1/contactcenterinsights_v1.yaml b/google/cloud/contactcenterinsights/v1/contactcenterinsights_v1.yaml
@@ -21,13 +21,7 @@ types:
 - name: google.cloud.contactcenterinsights.v1.IngestConversationsResponse
 - name: google.cloud.contactcenterinsights.v1.UndeployIssueModelMetadata
 - name: google.cloud.contactcenterinsights.v1.UndeployIssueModelResponse
-
-documentation:
-  rules:
-  - selector: google.longrunning.Operations.ListOperations
-    description: |-
-      Lists operations that match the specified filter in the request. If
-      the server doesn't support this method, it returns `UNIMPLEMENTED`.
+- name: google.cloud.contactcenterinsights.v1.UploadConversationMetadata
 
 http:
   rules:
diff --git a/google/cloud/contactcenterinsights/v1/resources.proto b/google/cloud/contactcenterinsights/v1/resources.proto
@@ -917,6 +917,23 @@ message Settings {
 
   // Default analysis settings.
   AnalysisConfig analysis_config = 7;
+
+  // Default DLP redaction resources to be applied while ingesting
+  // conversations.
+  RedactionConfig redaction_config = 10;
+}
+
+// DLP resources used for redaction while ingesting conversations.
+message RedactionConfig {
+  // The fully-qualified DLP deidentify template resource name.
+  // Format:
+  // `projects/{project}/deidentifyTemplates/{template}`
+  string deidentify_template = 1;
+
+  // The fully-qualified DLP inspect template resource name.
+  // Format:
+  // `projects/{project}/inspectTemplates/{template}`
+  string inspect_template = 2;
 }
 
 // An annotation that was generated during the customer and agent interaction.
