feat: [dialogflow-cx] added gcs.proto. added support for GcsDestinati…

…on and TextToSpeechSettings (#3998)

* feat: added gcs.proto. added support for GcsDestination and TextToSpeechSettings. feat!: Remove [REQUIRED] for VersionConfig
docs: add more meaningful comments

PiperOrigin-RevId: 510257108

Source-Link: googleapis/googleapis@140334b

Source-Link: googleapis/googleapis-gen@88ee501
Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWRpYWxvZ2Zsb3ctY3gvLk93bEJvdC55YW1sIiwiaCI6Ijg4ZWU1MDE1NjY3ZDcxNjQyZThlOWNmOWM2ZTYwNWEzODJlZTM5NGMifQ==

* 🦉 Updates from OwlBot post-processor

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

* feat: added gcs.proto. added support for GcsDestination and TextToSpeechSettings
feat!: Remove [REQUIRED] for VersionConfig
docs: add more meaningful comments

PiperOrigin-RevId: 511306725

Source-Link: googleapis/googleapis@57673de

Source-Link: googleapis/googleapis-gen@9adddda
Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWRpYWxvZ2Zsb3ctY3gvLk93bEJvdC55YW1sIiwiaCI6IjlhZGRkZGEyNjhlMWIxMzFkNmRmY2I5MzRmOGIzNGY3ODQ4OWJmMDgifQ==

* 🦉 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>
Co-authored-by: sofisl <55454395+sofisl@users.noreply.github.com>

packages/google-cloud-dialogflow-cx/protos/google/cloud/dialogflow/cx/v3/advanced_settings.proto

@@ -17,6 +17,7 @@ syntax = "proto3";
 package google.cloud.dialogflow.cx.v3;
 
 import "google/api/field_behavior.proto";
+import "google/cloud/dialogflow/cx/v3/gcs.proto";
 
 option cc_enable_arenas = true;
 option csharp_namespace = "Google.Cloud.Dialogflow.Cx.V3";
@@ -48,6 +49,13 @@ message AdvancedSettings {
     bool enable_interaction_logging = 3;
   }
 
+  // If present, incoming audio is exported by Dialogflow to the configured
+  // Google Cloud Storage destination.
+  // Exposed at the following levels:
+  // - Agent level
+  // - Flow level
+  GcsDestination audio_export_gcs_destination = 2;
+
   // Settings for logging.
   // Settings for Dialogflow History, Contact Center messages, StackDriver logs,
   // and speech logging.

packages/google-cloud-dialogflow-cx/protos/google/cloud/dialogflow/cx/v3/agent.proto

@@ -21,10 +21,12 @@ import "google/api/client.proto";
 import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
 import "google/cloud/dialogflow/cx/v3/advanced_settings.proto";
+import "google/cloud/dialogflow/cx/v3/audio_config.proto";
 import "google/cloud/dialogflow/cx/v3/flow.proto";
 import "google/longrunning/operations.proto";
 import "google/protobuf/empty.proto";
 import "google/protobuf/field_mask.proto";
+import "google/protobuf/struct.proto";
 
 option cc_enable_arenas = true;
 option csharp_namespace = "Google.Cloud.Dialogflow.Cx.V3";
@@ -266,6 +268,10 @@ message Agent {
   // Hierarchical advanced settings for this agent. The settings exposed at the
   // lower level overrides the settings exposed at the higher level.
   AdvancedSettings advanced_settings = 22;
+
+  // Settings on instructing the speech synthesizer on how to generate the
+  // output audio content.
+  TextToSpeechSettings text_to_speech_settings = 31;
 }
 
 // The request message for

packages/google-cloud-dialogflow-cx/protos/google/cloud/dialogflow/cx/v3/audio_config.proto

@@ -316,3 +316,11 @@ message OutputAudioConfig {
   // Optional. Configuration of how speech should be synthesized.
   SynthesizeSpeechConfig synthesize_speech_config = 3;
 }
+
+// Settings related to speech generating.
+message TextToSpeechSettings {
+  // Configuration of how speech should be synthesized, mapping from
+  // language (https://dialogflow.com/docs/reference/language) to
+  // SynthesizeSpeechConfig.
+  map<string, SynthesizeSpeechConfig> synthesize_speech_configs = 1;
+}

packages/google-cloud-dialogflow-cx/protos/google/cloud/dialogflow/cx/v3/environment.proto

@@ -25,6 +25,7 @@ import "google/cloud/dialogflow/cx/v3/webhook.proto";
 import "google/longrunning/operations.proto";
 import "google/protobuf/empty.proto";
 import "google/protobuf/field_mask.proto";
+import "google/protobuf/struct.proto";
 import "google/protobuf/timestamp.proto";
 
 option cc_enable_arenas = true;
@@ -253,12 +254,11 @@ message Environment {
   // 500 characters. If exceeded, the request is rejected.
   string description = 3;
 
-  // Required. A list of configurations for flow versions. You should include
-  // version configs for all flows that are reachable from [`Start
+  // A list of configurations for flow versions. You should include version
+  // configs for all flows that are reachable from [`Start
   // Flow`][Agent.start_flow] in the agent. Otherwise, an error will be
   // returned.
-  repeated VersionConfig version_configs = 6
-      [(google.api.field_behavior) = REQUIRED];
+  repeated VersionConfig version_configs = 6;
 
   // Output only. Update time of this environment.
   google.protobuf.Timestamp update_time = 5

packages/google-cloud-dialogflow-cx/protos/google/cloud/dialogflow/cx/v3/flow.proto

@@ -25,6 +25,7 @@ import "google/cloud/dialogflow/cx/v3/validation_message.proto";
 import "google/longrunning/operations.proto";
 import "google/protobuf/empty.proto";
 import "google/protobuf/field_mask.proto";
+import "google/protobuf/struct.proto";
 import "google/protobuf/timestamp.proto";
 
 option cc_enable_arenas = true;

packages/google-cloud-dialogflow-cx/protos/google/cloud/dialogflow/cx/v3/gcs.proto

@@ -0,0 +1,39 @@
+// Copyright 2022 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
+//
+//     http://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.
+
+syntax = "proto3";
+
+package google.cloud.dialogflow.cx.v3;
+
+import "google/api/field_behavior.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Cloud.Dialogflow.Cx.V3";
+option go_package = "cloud.google.com/go/dialogflow/cx/apiv3/cxpb;cxpb";
+option java_multiple_files = true;
+option java_outer_classname = "GcsProto";
+option java_package = "com.google.cloud.dialogflow.cx.v3";
+option objc_class_prefix = "DF";
+option ruby_package = "Google::Cloud::Dialogflow::CX::V3";
+
+// Google Cloud Storage location for a Dialogflow operation that writes or
+// exports objects (e.g. exported agent or transcripts) outside of Dialogflow.
+message GcsDestination {
+  // Required. The Google Cloud Storage URI for the exported objects. A URI is
+  // of the form:
+  //   gs://bucket/object-name-or-prefix
+  // Whether a full object name, or just a prefix, its usage depends on the
+  // Dialogflow operation.
+  string uri = 1 [(google.api.field_behavior) = REQUIRED];
+}

packages/google-cloud-dialogflow-cx/protos/google/cloud/dialogflow/cx/v3/version.proto

@@ -24,6 +24,7 @@ import "google/cloud/dialogflow/cx/v3/flow.proto";
 import "google/longrunning/operations.proto";
 import "google/protobuf/empty.proto";
 import "google/protobuf/field_mask.proto";
+import "google/protobuf/struct.proto";
 import "google/protobuf/timestamp.proto";
 
 option cc_enable_arenas = true;

packages/google-cloud-dialogflow-cx/protos/google/cloud/dialogflow/cx/v3beta1/advanced_settings.proto

@@ -17,6 +17,7 @@ syntax = "proto3";
 package google.cloud.dialogflow.cx.v3beta1;
 
 import "google/api/field_behavior.proto";
+import "google/cloud/dialogflow/cx/v3beta1/gcs.proto";
 
 option cc_enable_arenas = true;
 option csharp_namespace = "Google.Cloud.Dialogflow.Cx.V3Beta1";
@@ -48,6 +49,13 @@ message AdvancedSettings {
     bool enable_interaction_logging = 3;
   }
 
+  // If present, incoming audio is exported by Dialogflow to the configured
+  // Google Cloud Storage destination.
+  // Exposed at the following levels:
+  // - Agent level
+  // - Flow level
+  GcsDestination audio_export_gcs_destination = 2;
+
   // Settings for logging.
   // Settings for Dialogflow History, Contact Center messages, StackDriver logs,
   // and speech logging.

packages/google-cloud-dialogflow-cx/protos/google/cloud/dialogflow/cx/v3beta1/agent.proto

@@ -21,10 +21,12 @@ import "google/api/client.proto";
 import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
 import "google/cloud/dialogflow/cx/v3beta1/advanced_settings.proto";
+import "google/cloud/dialogflow/cx/v3beta1/audio_config.proto";
 import "google/cloud/dialogflow/cx/v3beta1/flow.proto";
 import "google/longrunning/operations.proto";
 import "google/protobuf/empty.proto";
 import "google/protobuf/field_mask.proto";
+import "google/protobuf/struct.proto";
 
 option cc_enable_arenas = true;
 option csharp_namespace = "Google.Cloud.Dialogflow.Cx.V3Beta1";
@@ -266,6 +268,10 @@ message Agent {
   // Hierarchical advanced settings for this agent. The settings exposed at the
   // lower level overrides the settings exposed at the higher level.
   AdvancedSettings advanced_settings = 22;
+
+  // Settings on instructing the speech synthesizer on how to generate the
+  // output audio content.
+  TextToSpeechSettings text_to_speech_settings = 31;
 }
 
 // The request message for

packages/google-cloud-dialogflow-cx/protos/google/cloud/dialogflow/cx/v3beta1/audio_config.proto

@@ -316,3 +316,11 @@ message OutputAudioConfig {
   // Optional. Configuration of how speech should be synthesized.
   SynthesizeSpeechConfig synthesize_speech_config = 3;
 }
+
+// Settings related to speech generating.
+message TextToSpeechSettings {
+  // Configuration of how speech should be synthesized, mapping from
+  // language (https://dialogflow.com/docs/reference/language) to
+  // SynthesizeSpeechConfig.
+  map<string, SynthesizeSpeechConfig> synthesize_speech_configs = 1;
+}

packages/google-cloud-dialogflow-cx/protos/google/cloud/dialogflow/cx/v3beta1/environment.proto

@@ -25,6 +25,7 @@ import "google/cloud/dialogflow/cx/v3beta1/webhook.proto";
 import "google/longrunning/operations.proto";
 import "google/protobuf/empty.proto";
 import "google/protobuf/field_mask.proto";
+import "google/protobuf/struct.proto";
 import "google/protobuf/timestamp.proto";
 
 option cc_enable_arenas = true;
@@ -253,12 +254,11 @@ message Environment {
   // 500 characters. If exceeded, the request is rejected.
   string description = 3;
 
-  // Required. A list of configurations for flow versions. You should include
-  // version configs for all flows that are reachable from [`Start
+  // A list of configurations for flow versions. You should include version
+  // configs for all flows that are reachable from [`Start
   // Flow`][Agent.start_flow] in the agent. Otherwise, an error will be
   // returned.
-  repeated VersionConfig version_configs = 6
-      [(google.api.field_behavior) = REQUIRED];
+  repeated VersionConfig version_configs = 6;
 
   // Output only. Update time of this environment.
   google.protobuf.Timestamp update_time = 5

packages/google-cloud-dialogflow-cx/protos/google/cloud/dialogflow/cx/v3beta1/flow.proto

@@ -25,6 +25,7 @@ import "google/cloud/dialogflow/cx/v3beta1/validation_message.proto";
 import "google/longrunning/operations.proto";
 import "google/protobuf/empty.proto";
 import "google/protobuf/field_mask.proto";
+import "google/protobuf/struct.proto";
 import "google/protobuf/timestamp.proto";
 
 option cc_enable_arenas = true;

packages/google-cloud-dialogflow-cx/protos/google/cloud/dialogflow/cx/v3beta1/gcs.proto

@@ -0,0 +1,39 @@
+// Copyright 2022 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
+//
+//     http://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.
+
+syntax = "proto3";
+
+package google.cloud.dialogflow.cx.v3beta1;
+
+import "google/api/field_behavior.proto";
+
+option cc_enable_arenas = true;
+option csharp_namespace = "Google.Cloud.Dialogflow.Cx.V3Beta1";
+option go_package = "cloud.google.com/go/dialogflow/cx/apiv3beta1/cxpb;cxpb";
+option java_multiple_files = true;
+option java_outer_classname = "GcsProto";
+option java_package = "com.google.cloud.dialogflow.cx.v3beta1";
+option objc_class_prefix = "DF";
+option ruby_package = "Google::Cloud::Dialogflow::CX::V3beta1";
+
+// Google Cloud Storage location for a Dialogflow operation that writes or
+// exports objects (e.g. exported agent or transcripts) outside of Dialogflow.
+message GcsDestination {
+  // Required. The Google Cloud Storage URI for the exported objects. A URI is
+  // of the form:
+  //   gs://bucket/object-name-or-prefix
+  // Whether a full object name, or just a prefix, its usage depends on the
+  // Dialogflow operation.
+  string uri = 1 [(google.api.field_behavior) = REQUIRED];
+}

packages/google-cloud-dialogflow-cx/protos/google/cloud/dialogflow/cx/v3beta1/version.proto

@@ -24,6 +24,7 @@ import "google/cloud/dialogflow/cx/v3beta1/flow.proto";
 import "google/longrunning/operations.proto";
 import "google/protobuf/empty.proto";
 import "google/protobuf/field_mask.proto";
+import "google/protobuf/struct.proto";
 import "google/protobuf/timestamp.proto";
 
 option cc_enable_arenas = true;