google-cloud-dialogflow-cx-v3 1.2.0 → 1.4.0

data/lib/google/cloud/dialogflow/cx/v3/webhooks/rest/service_stub.rb

@@ -31,7 +31,8 @@ module Google
               # including transcoding, making the REST call, and deserialing the response.
               #
               class ServiceStub
-                def initialize endpoint:, endpoint_template:, universe_domain:, credentials:
+                # @private
+                def initialize endpoint:, endpoint_template:, universe_domain:, credentials:, logger:
                   # These require statements are intentionally placed here to initialize
                   # the REST modules only when it's required.
                   require "gapic/rest"
@@ -41,7 +42,9 @@ module Google
                                                                universe_domain: universe_domain,
                                                                credentials: credentials,
                                                                numeric_enums: true,
-                                                               raise_faraday_errors: false
+                                                               service_name: self.class,
+                                                               raise_faraday_errors: false,
+                                                               logger: logger
                 end
 
                 ##
@@ -62,6 +65,15 @@ module Google
                   @client_stub.endpoint
                 end
 
+                ##
+                # The logger used for request/response debug logging.
+                #
+                # @return [Logger]
+                #
+                def logger stub: false
+                  stub ? @client_stub.stub_logger : @client_stub.logger
+                end
+
                 ##
                 # Baseline implementation for the list_webhooks REST call
                 #
@@ -88,16 +100,18 @@ module Google
 
                   response = @client_stub.make_http_request(
                     verb,
-                    uri:     uri,
-                    body:    body || "",
-                    params:  query_string_params,
+                    uri: uri,
+                    body: body || "",
+                    params: query_string_params,
+                    method_name: "list_webhooks",
                     options: options
                   )
                   operation = ::Gapic::Rest::TransportOperation.new response
                   result = ::Google::Cloud::Dialogflow::CX::V3::ListWebhooksResponse.decode_json response.body, ignore_unknown_fields: true
-
-                  yield result, operation if block_given?
-                  result
+                  catch :response do
+                    yield result, operation if block_given?
+                    result
+                  end
                 end
 
                 ##
@@ -126,16 +140,18 @@ module Google
 
                   response = @client_stub.make_http_request(
                     verb,
-                    uri:     uri,
-                    body:    body || "",
-                    params:  query_string_params,
+                    uri: uri,
+                    body: body || "",
+                    params: query_string_params,
+                    method_name: "get_webhook",
                     options: options
                   )
                   operation = ::Gapic::Rest::TransportOperation.new response
                   result = ::Google::Cloud::Dialogflow::CX::V3::Webhook.decode_json response.body, ignore_unknown_fields: true
-
-                  yield result, operation if block_given?
-                  result
+                  catch :response do
+                    yield result, operation if block_given?
+                    result
+                  end
                 end
 
                 ##
@@ -164,16 +180,18 @@ module Google
 
                   response = @client_stub.make_http_request(
                     verb,
-                    uri:     uri,
-                    body:    body || "",
-                    params:  query_string_params,
+                    uri: uri,
+                    body: body || "",
+                    params: query_string_params,
+                    method_name: "create_webhook",
                     options: options
                   )
                   operation = ::Gapic::Rest::TransportOperation.new response
                   result = ::Google::Cloud::Dialogflow::CX::V3::Webhook.decode_json response.body, ignore_unknown_fields: true
-
-                  yield result, operation if block_given?
-                  result
+                  catch :response do
+                    yield result, operation if block_given?
+                    result
+                  end
                 end
 
                 ##
@@ -202,16 +220,18 @@ module Google
 
                   response = @client_stub.make_http_request(
                     verb,
-                    uri:     uri,
-                    body:    body || "",
-                    params:  query_string_params,
+                    uri: uri,
+                    body: body || "",
+                    params: query_string_params,
+                    method_name: "update_webhook",
                     options: options
                   )
                   operation = ::Gapic::Rest::TransportOperation.new response
                   result = ::Google::Cloud::Dialogflow::CX::V3::Webhook.decode_json response.body, ignore_unknown_fields: true
-
-                  yield result, operation if block_given?
-                  result
+                  catch :response do
+                    yield result, operation if block_given?
+                    result
+                  end
                 end
 
                 ##
@@ -240,16 +260,18 @@ module Google
 
                   response = @client_stub.make_http_request(
                     verb,
-                    uri:     uri,
-                    body:    body || "",
-                    params:  query_string_params,
+                    uri: uri,
+                    body: body || "",
+                    params: query_string_params,
+                    method_name: "delete_webhook",
                     options: options
                   )
                   operation = ::Gapic::Rest::TransportOperation.new response
                   result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
-
-                  yield result, operation if block_given?
-                  result
+                  catch :response do
+                    yield result, operation if block_given?
+                    result
+                  end
                 end
 
                 ##

data/proto_docs/google/api/client.rb

@@ -306,9 +306,28 @@ module Google
     # @!attribute [rw] common
     #   @return [::Google::Api::CommonLanguageSettings]
     #     Some settings.
+    # @!attribute [rw] renamed_services
+    #   @return [::Google::Protobuf::Map{::String => ::String}]
+    #     Map of service names to renamed services. Keys are the package relative
+    #     service names and values are the name to be used for the service client
+    #     and call options.
+    #
+    #     publishing:
+    #       go_settings:
+    #         renamed_services:
+    #           Publisher: TopicAdmin
     class GoSettings
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
+
+      # @!attribute [rw] key
+      #   @return [::String]
+      # @!attribute [rw] value
+      #   @return [::String]
+      class RenamedServicesEntry
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
     end
 
     # Describes the generator configuration for a method.

data/proto_docs/google/cloud/dialogflow/cx/v3/agent.rb

@@ -389,16 +389,22 @@ module Google
           #     The URI to a file containing the exported agent. This field is populated
           #     if `agent_uri` is specified in
           #     {::Google::Cloud::Dialogflow::CX::V3::ExportAgentRequest ExportAgentRequest}.
+          #
+          #     Note: The following fields are mutually exclusive: `agent_uri`, `agent_content`, `commit_sha`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] agent_content
           #   @return [::String]
           #     Uncompressed raw byte content for agent. This field is populated
           #     if none of `agent_uri` and `git_destination` are specified in
           #     {::Google::Cloud::Dialogflow::CX::V3::ExportAgentRequest ExportAgentRequest}.
+          #
+          #     Note: The following fields are mutually exclusive: `agent_content`, `agent_uri`, `commit_sha`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] commit_sha
           #   @return [::String]
           #     Commit SHA of the git push. This field is populated if
           #     `git_destination` is specified in
           #     {::Google::Cloud::Dialogflow::CX::V3::ExportAgentRequest ExportAgentRequest}.
+          #
+          #     Note: The following fields are mutually exclusive: `commit_sha`, `agent_uri`, `agent_content`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           class ExportAgentResponse
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -421,12 +427,18 @@ module Google
           #     have read permissions for the object. For more information, see
           #     [Dialogflow access
           #     control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
+          #
+          #     Note: The following fields are mutually exclusive: `agent_uri`, `agent_content`, `git_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] agent_content
           #   @return [::String]
           #     Uncompressed raw byte content for agent.
+          #
+          #     Note: The following fields are mutually exclusive: `agent_content`, `agent_uri`, `git_source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] git_source
           #   @return [::Google::Cloud::Dialogflow::CX::V3::RestoreAgentRequest::GitSource]
           #     Setting for restoring from a git branch
+          #
+          #     Note: The following fields are mutually exclusive: `git_source`, `agent_uri`, `agent_content`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] restore_option
           #   @return [::Google::Cloud::Dialogflow::CX::V3::RestoreAgentRequest::RestoreOption]
           #     Agent restore mode. If not specified, `KEEP` is assumed.

data/proto_docs/google/cloud/dialogflow/cx/v3/entity_type.rb

@@ -183,9 +183,13 @@ module Google
           #     have write permissions for the object. For more information, see
           #     [Dialogflow access
           #     control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
+          #
+          #     Note: The following fields are mutually exclusive: `entity_types_uri`, `entity_types_content_inline`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] entity_types_content_inline
           #   @return [::Boolean]
           #     Optional. The option to return the serialized entity types inline.
+          #
+          #     Note: The following fields are mutually exclusive: `entity_types_content_inline`, `entity_types_uri`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] data_format
           #   @return [::Google::Cloud::Dialogflow::CX::V3::ExportEntityTypesRequest::DataFormat]
           #     Optional. The data format of the exported entity types. If not specified,
@@ -228,11 +232,15 @@ module Google
           #     The URI to a file containing the exported entity types. This field is
           #     populated only if `entity_types_uri` is specified in
           #     {::Google::Cloud::Dialogflow::CX::V3::ExportEntityTypesRequest ExportEntityTypesRequest}.
+          #
+          #     Note: The following fields are mutually exclusive: `entity_types_uri`, `entity_types_content`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] entity_types_content
           #   @return [::Google::Cloud::Dialogflow::CX::V3::InlineDestination]
           #     Uncompressed byte content for entity types. This field is populated only
           #     if `entity_types_content_inline` is set to true in
           #     {::Google::Cloud::Dialogflow::CX::V3::ExportEntityTypesRequest ExportEntityTypesRequest}.
+          #
+          #     Note: The following fields are mutually exclusive: `entity_types_content`, `entity_types_uri`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           class ExportEntityTypesResponse
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -263,9 +271,13 @@ module Google
           #     have read permissions for the object. For more information, see
           #     [Dialogflow access
           #     control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
+          #
+          #     Note: The following fields are mutually exclusive: `entity_types_uri`, `entity_types_content`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] entity_types_content
           #   @return [::Google::Cloud::Dialogflow::CX::V3::InlineSource]
           #     Uncompressed byte content of entity types.
+          #
+          #     Note: The following fields are mutually exclusive: `entity_types_content`, `entity_types_uri`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] merge_option
           #   @return [::Google::Cloud::Dialogflow::CX::V3::ImportEntityTypesRequest::MergeOption]
           #     Required. Merge option for importing entity types.

data/proto_docs/google/cloud/dialogflow/cx/v3/experiment.rb

@@ -146,9 +146,13 @@ module Google
               # @!attribute [rw] ratio
               #   @return [::Float]
               #     Ratio value of a metric.
+              #
+              #     Note: The following fields are mutually exclusive: `ratio`, `count`. If a field in that set is populated, all other fields in the set will automatically be cleared.
               # @!attribute [rw] count
               #   @return [::Float]
               #     Count value of a metric.
+              #
+              #     Note: The following fields are mutually exclusive: `count`, `ratio`. If a field in that set is populated, all other fields in the set will automatically be cleared.
               # @!attribute [rw] confidence_interval
               #   @return [::Google::Cloud::Dialogflow::CX::V3::Experiment::Result::ConfidenceInterval]
               #     The probability that the treatment is better than all other treatments

data/proto_docs/google/cloud/dialogflow/cx/v3/flow.rb

@@ -418,9 +418,13 @@ module Google
           #     have read permissions for the object. For more information, see
           #     [Dialogflow access
           #     control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
+          #
+          #     Note: The following fields are mutually exclusive: `flow_uri`, `flow_content`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] flow_content
           #   @return [::String]
           #     Uncompressed raw byte content for flow.
+          #
+          #     Note: The following fields are mutually exclusive: `flow_content`, `flow_uri`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] import_option
           #   @return [::Google::Cloud::Dialogflow::CX::V3::ImportFlowRequest::ImportOption]
           #     Flow import mode. If not specified, `KEEP` is assumed.
@@ -508,9 +512,13 @@ module Google
           #     The URI to a file containing the exported flow. This field is populated
           #     only if `flow_uri` is specified in
           #     {::Google::Cloud::Dialogflow::CX::V3::ExportFlowRequest ExportFlowRequest}.
+          #
+          #     Note: The following fields are mutually exclusive: `flow_uri`, `flow_content`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] flow_content
           #   @return [::String]
           #     Uncompressed raw byte content for flow.
+          #
+          #     Note: The following fields are mutually exclusive: `flow_content`, `flow_uri`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           class ExportFlowResponse
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/dialogflow/cx/v3/fulfillment.rb

@@ -129,9 +129,13 @@ module Google
                 # @!attribute [rw] message
                 #   @return [::Google::Cloud::Dialogflow::CX::V3::ResponseMessage]
                 #     Returned message.
+                #
+                #     Note: The following fields are mutually exclusive: `message`, `additional_cases`. If a field in that set is populated, all other fields in the set will automatically be cleared.
                 # @!attribute [rw] additional_cases
                 #   @return [::Google::Cloud::Dialogflow::CX::V3::Fulfillment::ConditionalCases]
                 #     Additional cases to be evaluated.
+                #
+                #     Note: The following fields are mutually exclusive: `additional_cases`, `message`. If a field in that set is populated, all other fields in the set will automatically be cleared.
                 class CaseContent
                   include ::Google::Protobuf::MessageExts
                   extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/dialogflow/cx/v3/intent.rb

@@ -328,9 +328,13 @@ module Google
           #     have read permissions for the object. For more information, see
           #     [Dialogflow access
           #     control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
+          #
+          #     Note: The following fields are mutually exclusive: `intents_uri`, `intents_content`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] intents_content
           #   @return [::Google::Cloud::Dialogflow::CX::V3::InlineSource]
           #     Uncompressed byte content of intents.
+          #
+          #     Note: The following fields are mutually exclusive: `intents_content`, `intents_uri`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] merge_option
           #   @return [::Google::Cloud::Dialogflow::CX::V3::ImportIntentsRequest::MergeOption]
           #     Merge option for importing intents. If not specified, `REJECT` is assumed.
@@ -433,9 +437,13 @@ module Google
           #     have write permissions for the object. For more information, see
           #     [Dialogflow access
           #     control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
+          #
+          #     Note: The following fields are mutually exclusive: `intents_uri`, `intents_content_inline`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] intents_content_inline
           #   @return [::Boolean]
           #     Optional. The option to return the serialized intents inline.
+          #
+          #     Note: The following fields are mutually exclusive: `intents_content_inline`, `intents_uri`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] data_format
           #   @return [::Google::Cloud::Dialogflow::CX::V3::ExportIntentsRequest::DataFormat]
           #     Optional. The data format of the exported intents. If not specified, `BLOB`
@@ -467,11 +475,15 @@ module Google
           #     The URI to a file containing the exported intents. This field is
           #     populated only if `intents_uri` is specified in
           #     {::Google::Cloud::Dialogflow::CX::V3::ExportIntentsRequest ExportIntentsRequest}.
+          #
+          #     Note: The following fields are mutually exclusive: `intents_uri`, `intents_content`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] intents_content
           #   @return [::Google::Cloud::Dialogflow::CX::V3::InlineDestination]
           #     Uncompressed byte content for intents. This field is populated only if
           #     `intents_content_inline` is set to true in
           #     {::Google::Cloud::Dialogflow::CX::V3::ExportIntentsRequest ExportIntentsRequest}.
+          #
+          #     Note: The following fields are mutually exclusive: `intents_content`, `intents_uri`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           class ExportIntentsResponse
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/dialogflow/cx/v3/page.rb

@@ -257,11 +257,15 @@ module Google
           #     The target page to transition to.
           #     Format:
           #     `projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>/pages/<PageID>`.
+          #
+          #     Note: The following fields are mutually exclusive: `target_page`, `target_flow`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] target_flow
           #   @return [::String]
           #     The target flow to transition to.
           #     Format:
           #     `projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>`.
+          #
+          #     Note: The following fields are mutually exclusive: `target_flow`, `target_page`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           class EventHandler
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -321,11 +325,15 @@ module Google
           #     The target page to transition to.
           #     Format:
           #     `projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>/pages/<PageID>`.
+          #
+          #     Note: The following fields are mutually exclusive: `target_page`, `target_flow`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] target_flow
           #   @return [::String]
           #     The target flow to transition to.
           #     Format:
           #     `projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>`.
+          #
+          #     Note: The following fields are mutually exclusive: `target_flow`, `target_page`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           class TransitionRoute
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -540,11 +548,15 @@ module Google
           #     The target page to transition to.
           #     Format:
           #     `projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>/pages/<PageID>`.
+          #
+          #     Note: The following fields are mutually exclusive: `target_page`, `target_flow`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] target_flow
           #   @return [::String]
           #     The target flow to transition to.
           #     Format:
           #     `projects/<ProjectID>/locations/<LocationID>/agents/<AgentID>/flows/<FlowID>`.
+          #
+          #     Note: The following fields are mutually exclusive: `target_flow`, `target_page`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] data_store_connections
           #   @return [::Array<::Google::Cloud::Dialogflow::CX::V3::DataStoreConnection>]
           #     Optional. List of related data store connections.

data/proto_docs/google/cloud/dialogflow/cx/v3/response_message.rb

@@ -42,19 +42,29 @@ module Google
           # @!attribute [rw] text
           #   @return [::Google::Cloud::Dialogflow::CX::V3::ResponseMessage::Text]
           #     Returns a text response.
+          #
+          #     Note: The following fields are mutually exclusive: `text`, `payload`, `conversation_success`, `output_audio_text`, `live_agent_handoff`, `end_interaction`, `play_audio`, `mixed_audio`, `telephony_transfer_call`, `knowledge_info_card`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] payload
           #   @return [::Google::Protobuf::Struct]
           #     Returns a response containing a custom, platform-specific payload.
+          #
+          #     Note: The following fields are mutually exclusive: `payload`, `text`, `conversation_success`, `output_audio_text`, `live_agent_handoff`, `end_interaction`, `play_audio`, `mixed_audio`, `telephony_transfer_call`, `knowledge_info_card`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] conversation_success
           #   @return [::Google::Cloud::Dialogflow::CX::V3::ResponseMessage::ConversationSuccess]
           #     Indicates that the conversation succeeded.
+          #
+          #     Note: The following fields are mutually exclusive: `conversation_success`, `text`, `payload`, `output_audio_text`, `live_agent_handoff`, `end_interaction`, `play_audio`, `mixed_audio`, `telephony_transfer_call`, `knowledge_info_card`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] output_audio_text
           #   @return [::Google::Cloud::Dialogflow::CX::V3::ResponseMessage::OutputAudioText]
           #     A text or ssml response that is preferentially used for TTS output audio
           #     synthesis, as described in the comment on the ResponseMessage message.
+          #
+          #     Note: The following fields are mutually exclusive: `output_audio_text`, `text`, `payload`, `conversation_success`, `live_agent_handoff`, `end_interaction`, `play_audio`, `mixed_audio`, `telephony_transfer_call`, `knowledge_info_card`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] live_agent_handoff
           #   @return [::Google::Cloud::Dialogflow::CX::V3::ResponseMessage::LiveAgentHandoff]
           #     Hands off conversation to a human agent.
+          #
+          #     Note: The following fields are mutually exclusive: `live_agent_handoff`, `text`, `payload`, `conversation_success`, `output_audio_text`, `end_interaction`, `play_audio`, `mixed_audio`, `telephony_transfer_call`, `knowledge_info_card`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [r] end_interaction
           #   @return [::Google::Cloud::Dialogflow::CX::V3::ResponseMessage::EndInteraction]
           #     Output only. A signal that indicates the interaction with the Dialogflow
@@ -63,6 +73,8 @@ module Google
           #     by the user.
           #
           #     It's guaranteed that there is at most one such message in each response.
+          #
+          #     Note: The following fields are mutually exclusive: `end_interaction`, `text`, `payload`, `conversation_success`, `output_audio_text`, `live_agent_handoff`, `play_audio`, `mixed_audio`, `telephony_transfer_call`, `knowledge_info_card`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] play_audio
           #   @return [::Google::Cloud::Dialogflow::CX::V3::ResponseMessage::PlayAudio]
           #     Signal that the client should play an audio clip hosted at a
@@ -70,6 +82,8 @@ module Google
           #     {::Google::Cloud::Dialogflow::CX::V3::ResponseMessage#mixed_audio mixed_audio}.
           #     However, Dialogflow itself does not try to read or process the URI in any
           #     way.
+          #
+          #     Note: The following fields are mutually exclusive: `play_audio`, `text`, `payload`, `conversation_success`, `output_audio_text`, `live_agent_handoff`, `end_interaction`, `mixed_audio`, `telephony_transfer_call`, `knowledge_info_card`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [r] mixed_audio
           #   @return [::Google::Cloud::Dialogflow::CX::V3::ResponseMessage::MixedAudio]
           #     Output only. An audio response message composed of both the synthesized
@@ -77,14 +91,20 @@ module Google
           #     {::Google::Cloud::Dialogflow::CX::V3::ResponseMessage#play_audio play_audio}.
           #     This message is generated by Dialogflow only and not supposed to be
           #     defined by the user.
+          #
+          #     Note: The following fields are mutually exclusive: `mixed_audio`, `text`, `payload`, `conversation_success`, `output_audio_text`, `live_agent_handoff`, `end_interaction`, `play_audio`, `telephony_transfer_call`, `knowledge_info_card`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] telephony_transfer_call
           #   @return [::Google::Cloud::Dialogflow::CX::V3::ResponseMessage::TelephonyTransferCall]
           #     A signal that the client should transfer the phone call connected to
           #     this agent to a third-party endpoint.
+          #
+          #     Note: The following fields are mutually exclusive: `telephony_transfer_call`, `text`, `payload`, `conversation_success`, `output_audio_text`, `live_agent_handoff`, `end_interaction`, `play_audio`, `mixed_audio`, `knowledge_info_card`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] knowledge_info_card
           #   @return [::Google::Cloud::Dialogflow::CX::V3::ResponseMessage::KnowledgeInfoCard]
           #     Represents info card for knowledge answers, to be better rendered in
           #     Dialogflow Messenger.
+          #
+          #     Note: The following fields are mutually exclusive: `knowledge_info_card`, `text`, `payload`, `conversation_success`, `output_audio_text`, `live_agent_handoff`, `end_interaction`, `play_audio`, `mixed_audio`, `telephony_transfer_call`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] response_type
           #   @return [::Google::Cloud::Dialogflow::CX::V3::ResponseMessage::ResponseType]
           #     Response type.
@@ -165,10 +185,14 @@ module Google
             # @!attribute [rw] text
             #   @return [::String]
             #     The raw text to be synthesized.
+            #
+            #     Note: The following fields are mutually exclusive: `text`, `ssml`. If a field in that set is populated, all other fields in the set will automatically be cleared.
             # @!attribute [rw] ssml
             #   @return [::String]
             #     The SSML text to be synthesized. For more information, see
             #     [SSML](/speech/text-to-speech/docs/ssml).
+            #
+            #     Note: The following fields are mutually exclusive: `ssml`, `text`. If a field in that set is populated, all other fields in the set will automatically be cleared.
             # @!attribute [r] allow_playback_interruption
             #   @return [::Boolean]
             #     Output only. Whether the playback of this message can be interrupted by
@@ -221,10 +245,14 @@ module Google
               #   @return [::String]
               #     Raw audio synthesized from the Dialogflow agent's response using
               #     the output config specified in the request.
+              #
+              #     Note: The following fields are mutually exclusive: `audio`, `uri`. If a field in that set is populated, all other fields in the set will automatically be cleared.
               # @!attribute [rw] uri
               #   @return [::String]
               #     Client-specific URI that points to an audio clip accessible to the
               #     client. Dialogflow does not impose any validation on it.
+              #
+              #     Note: The following fields are mutually exclusive: `uri`, `audio`. If a field in that set is populated, all other fields in the set will automatically be cleared.
               # @!attribute [r] allow_playback_interruption
               #   @return [::Boolean]
               #     Output only. Whether the playback of this segment can be interrupted by

data/proto_docs/google/cloud/dialogflow/cx/v3/security_settings.rb

@@ -177,10 +177,14 @@ module Google
           #     When data retention configuration is changed, it only applies to the data
           #     created after the change; the TTL of existing data created before the
           #     change stays intact.
+          #
+          #     Note: The following fields are mutually exclusive: `retention_window_days`, `retention_strategy`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] retention_strategy
           #   @return [::Google::Cloud::Dialogflow::CX::V3::SecuritySettings::RetentionStrategy]
           #     Specifies the retention behavior defined by
           #     {::Google::Cloud::Dialogflow::CX::V3::SecuritySettings::RetentionStrategy SecuritySettings.RetentionStrategy}.
+          #
+          #     Note: The following fields are mutually exclusive: `retention_strategy`, `retention_window_days`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           # @!attribute [rw] purge_data_types
           #   @return [::Array<::Google::Cloud::Dialogflow::CX::V3::SecuritySettings::PurgeDataType>]
           #     List of types of data to remove when retention settings triggers purge.