google-api-client 0.41.0 → 0.42.2

data/generated/google/apis/dialogflow_v2/representations.rb

@@ -58,12 +58,48 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudDialogflowCxV3beta1ResponseMessageEndInteraction
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudDialogflowCxV3beta1ResponseMessageHumanAgentHandoff
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudDialogflowCxV3beta1ResponseMessageLiveAgentHandoff
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudDialogflowCxV3beta1ResponseMessageMixedAudio
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudDialogflowCxV3beta1ResponseMessageMixedAudioSegment
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudDialogflowCxV3beta1ResponseMessageOutputAudioText
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudDialogflowCxV3beta1ResponseMessagePlayAudio
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudDialogflowCxV3beta1ResponseMessageText
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -646,6 +682,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudDialogflowV2beta1AutoApproveSmartMessagingEntriesResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudDialogflowV2beta1BatchUpdateEntityTypesResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1113,9 +1155,19 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           property :conversation_success, as: 'conversationSuccess', class: Google::Apis::DialogflowV2::GoogleCloudDialogflowCxV3beta1ResponseMessageConversationSuccess, decorator: Google::Apis::DialogflowV2::GoogleCloudDialogflowCxV3beta1ResponseMessageConversationSuccess::Representation
       
+          property :end_interaction, as: 'endInteraction', class: Google::Apis::DialogflowV2::GoogleCloudDialogflowCxV3beta1ResponseMessageEndInteraction, decorator: Google::Apis::DialogflowV2::GoogleCloudDialogflowCxV3beta1ResponseMessageEndInteraction::Representation
+      
           property :human_agent_handoff, as: 'humanAgentHandoff', class: Google::Apis::DialogflowV2::GoogleCloudDialogflowCxV3beta1ResponseMessageHumanAgentHandoff, decorator: Google::Apis::DialogflowV2::GoogleCloudDialogflowCxV3beta1ResponseMessageHumanAgentHandoff::Representation
       
+          property :live_agent_handoff, as: 'liveAgentHandoff', class: Google::Apis::DialogflowV2::GoogleCloudDialogflowCxV3beta1ResponseMessageLiveAgentHandoff, decorator: Google::Apis::DialogflowV2::GoogleCloudDialogflowCxV3beta1ResponseMessageLiveAgentHandoff::Representation
+      
+          property :mixed_audio, as: 'mixedAudio', class: Google::Apis::DialogflowV2::GoogleCloudDialogflowCxV3beta1ResponseMessageMixedAudio, decorator: Google::Apis::DialogflowV2::GoogleCloudDialogflowCxV3beta1ResponseMessageMixedAudio::Representation
+      
+          property :output_audio_text, as: 'outputAudioText', class: Google::Apis::DialogflowV2::GoogleCloudDialogflowCxV3beta1ResponseMessageOutputAudioText, decorator: Google::Apis::DialogflowV2::GoogleCloudDialogflowCxV3beta1ResponseMessageOutputAudioText::Representation
+      
           hash :payload, as: 'payload'
+          property :play_audio, as: 'playAudio', class: Google::Apis::DialogflowV2::GoogleCloudDialogflowCxV3beta1ResponseMessagePlayAudio, decorator: Google::Apis::DialogflowV2::GoogleCloudDialogflowCxV3beta1ResponseMessagePlayAudio::Representation
+      
           property :text, as: 'text', class: Google::Apis::DialogflowV2::GoogleCloudDialogflowCxV3beta1ResponseMessageText, decorator: Google::Apis::DialogflowV2::GoogleCloudDialogflowCxV3beta1ResponseMessageText::Representation
       
         end
@@ -1128,6 +1180,12 @@ module Google
         end
       end
       
+      class GoogleCloudDialogflowCxV3beta1ResponseMessageEndInteraction
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
       class GoogleCloudDialogflowCxV3beta1ResponseMessageHumanAgentHandoff
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1135,9 +1193,50 @@ module Google
         end
       end
       
+      class GoogleCloudDialogflowCxV3beta1ResponseMessageLiveAgentHandoff
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          hash :metadata, as: 'metadata'
+        end
+      end
+      
+      class GoogleCloudDialogflowCxV3beta1ResponseMessageMixedAudio
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :segments, as: 'segments', class: Google::Apis::DialogflowV2::GoogleCloudDialogflowCxV3beta1ResponseMessageMixedAudioSegment, decorator: Google::Apis::DialogflowV2::GoogleCloudDialogflowCxV3beta1ResponseMessageMixedAudioSegment::Representation
+      
+        end
+      end
+      
+      class GoogleCloudDialogflowCxV3beta1ResponseMessageMixedAudioSegment
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :allow_playback_interruption, as: 'allowPlaybackInterruption'
+          property :audio, :base64 => true, as: 'audio'
+          property :uri, as: 'uri'
+        end
+      end
+      
+      class GoogleCloudDialogflowCxV3beta1ResponseMessageOutputAudioText
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :ssml, as: 'ssml'
+          property :text, as: 'text'
+        end
+      end
+      
+      class GoogleCloudDialogflowCxV3beta1ResponseMessagePlayAudio
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :allow_playback_interruption, as: 'allowPlaybackInterruption'
+          property :audio_uri, as: 'audioUri'
+        end
+      end
+      
       class GoogleCloudDialogflowCxV3beta1ResponseMessageText
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :allow_playback_interruption, as: 'allowPlaybackInterruption'
           collection :text, as: 'text'
         end
       end
@@ -2151,6 +2250,15 @@ module Google
         end
       end
       
+      class GoogleCloudDialogflowV2beta1AutoApproveSmartMessagingEntriesResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :disabled_count, as: 'disabledCount'
+          property :enabled_count, as: 'enabledCount'
+          property :unreviewed_count, as: 'unreviewedCount'
+        end
+      end
+      
       class GoogleCloudDialogflowV2beta1BatchUpdateEntityTypesResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

data/generated/google/apis/dialogflow_v2/service.rb

@@ -926,6 +926,8 @@ module Google
         #   `User Id`. They can be a random number or some type of user and session
         #   identifiers (preferably hashed). The length of the `Session ID` and
         #   `User ID` must not exceed 36 characters.
+        #   For more information, see the [API interactions
+        #   guide](https://cloud.google.com/dialogflow/docs/api-overview).
         # @param [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2DetectIntentRequest] google_cloud_dialogflow_v2_detect_intent_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1705,6 +1707,8 @@ module Google
         #   `User Id`. They can be a random number or some type of user and session
         #   identifiers (preferably hashed). The length of the `Session ID` and
         #   `User ID` must not exceed 36 characters.
+        #   For more information, see the [API interactions
+        #   guide](https://cloud.google.com/dialogflow/docs/api-overview).
         # @param [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2DetectIntentRequest] google_cloud_dialogflow_v2_detect_intent_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.

data/generated/google/apis/dialogflow_v2beta1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/dialogflow/
     module DialogflowV2beta1
       VERSION = 'V2beta1'
-      REVISION = '20200615'
+      REVISION = '20200719'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/dialogflow_v2beta1/classes.rb

@@ -190,6 +190,13 @@ module Google
         # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowCxV3beta1ResponseMessageConversationSuccess]
         attr_accessor :conversation_success
       
+        # Indicates that interaction with the Dialogflow agent has ended.
+        # This message is generated by Dialogflow only and not supposed to be
+        # defined by the user.
+        # Corresponds to the JSON property `endInteraction`
+        # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowCxV3beta1ResponseMessageEndInteraction]
+        attr_accessor :end_interaction
+      
         # Indicates that the conversation should be handed off to a human agent.
         # Dialogflow only uses this to determine which conversations were handed off
         # to a human agent for measurement purposes. What else to do with this signal
@@ -204,11 +211,47 @@ module Google
         # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowCxV3beta1ResponseMessageHumanAgentHandoff]
         attr_accessor :human_agent_handoff
       
+        # Indicates that the conversation should be handed off to a live agent.
+        # Dialogflow only uses this to determine which conversations were handed off
+        # to a human agent for measurement purposes. What else to do with this signal
+        # is up to you and your handoff procedures.
+        # You may set this, for example:
+        # * In the entry_fulfillment of a Page if
+        # entering the page indicates something went extremely wrong in the
+        # conversation.
+        # * In a webhook response when you determine that the customer issue can only
+        # be handled by a human.
+        # Corresponds to the JSON property `liveAgentHandoff`
+        # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowCxV3beta1ResponseMessageLiveAgentHandoff]
+        attr_accessor :live_agent_handoff
+      
+        # Represents an audio message that is composed of both segments
+        # synthesized from the Dialogflow agent prompts and ones hosted externally
+        # at the specified URIs.
+        # The external URIs are specified via
+        # play_audio.
+        # This message is generated by Dialogflow only and not supposed to be
+        # defined by the user.
+        # Corresponds to the JSON property `mixedAudio`
+        # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowCxV3beta1ResponseMessageMixedAudio]
+        attr_accessor :mixed_audio
+      
+        # A text or ssml response that is preferentially used for TTS output audio
+        # synthesis, as described in the comment on the ResponseMessage message.
+        # Corresponds to the JSON property `outputAudioText`
+        # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowCxV3beta1ResponseMessageOutputAudioText]
+        attr_accessor :output_audio_text
+      
         # Returns a response containing a custom, platform-specific payload.
         # Corresponds to the JSON property `payload`
         # @return [Hash<String,Object>]
         attr_accessor :payload
       
+        # Specifies an audio clip to be played by the client as part of the response.
+        # Corresponds to the JSON property `playAudio`
+        # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowCxV3beta1ResponseMessagePlayAudio]
+        attr_accessor :play_audio
+      
         # The text response message.
         # Corresponds to the JSON property `text`
         # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowCxV3beta1ResponseMessageText]
@@ -221,8 +264,13 @@ module Google
         # Update properties of this object
         def update!(**args)
           @conversation_success = args[:conversation_success] if args.key?(:conversation_success)
+          @end_interaction = args[:end_interaction] if args.key?(:end_interaction)
           @human_agent_handoff = args[:human_agent_handoff] if args.key?(:human_agent_handoff)
+          @live_agent_handoff = args[:live_agent_handoff] if args.key?(:live_agent_handoff)
+          @mixed_audio = args[:mixed_audio] if args.key?(:mixed_audio)
+          @output_audio_text = args[:output_audio_text] if args.key?(:output_audio_text)
           @payload = args[:payload] if args.key?(:payload)
+          @play_audio = args[:play_audio] if args.key?(:play_audio)
           @text = args[:text] if args.key?(:text)
         end
       end
@@ -257,6 +305,21 @@ module Google
         end
       end
       
+      # Indicates that interaction with the Dialogflow agent has ended.
+      # This message is generated by Dialogflow only and not supposed to be
+      # defined by the user.
+      class GoogleCloudDialogflowCxV3beta1ResponseMessageEndInteraction
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # Indicates that the conversation should be handed off to a human agent.
       # Dialogflow only uses this to determine which conversations were handed off
       # to a human agent for measurement purposes. What else to do with this signal
@@ -286,11 +349,167 @@ module Google
         end
       end
       
+      # Indicates that the conversation should be handed off to a live agent.
+      # Dialogflow only uses this to determine which conversations were handed off
+      # to a human agent for measurement purposes. What else to do with this signal
+      # is up to you and your handoff procedures.
+      # You may set this, for example:
+      # * In the entry_fulfillment of a Page if
+      # entering the page indicates something went extremely wrong in the
+      # conversation.
+      # * In a webhook response when you determine that the customer issue can only
+      # be handled by a human.
+      class GoogleCloudDialogflowCxV3beta1ResponseMessageLiveAgentHandoff
+        include Google::Apis::Core::Hashable
+      
+        # Custom metadata for your handoff procedure. Dialogflow doesn't impose
+        # any structure on this.
+        # Corresponds to the JSON property `metadata`
+        # @return [Hash<String,Object>]
+        attr_accessor :metadata
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @metadata = args[:metadata] if args.key?(:metadata)
+        end
+      end
+      
+      # Represents an audio message that is composed of both segments
+      # synthesized from the Dialogflow agent prompts and ones hosted externally
+      # at the specified URIs.
+      # The external URIs are specified via
+      # play_audio.
+      # This message is generated by Dialogflow only and not supposed to be
+      # defined by the user.
+      class GoogleCloudDialogflowCxV3beta1ResponseMessageMixedAudio
+        include Google::Apis::Core::Hashable
+      
+        # Segments this audio response is composed of.
+        # Corresponds to the JSON property `segments`
+        # @return [Array<Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowCxV3beta1ResponseMessageMixedAudioSegment>]
+        attr_accessor :segments
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @segments = args[:segments] if args.key?(:segments)
+        end
+      end
+      
+      # Represents one segment of audio.
+      class GoogleCloudDialogflowCxV3beta1ResponseMessageMixedAudioSegment
+        include Google::Apis::Core::Hashable
+      
+        # Whether the playback of this segment can be interrupted by the end
+        # user's speech and the client should then start the next Dialogflow
+        # request.
+        # Corresponds to the JSON property `allowPlaybackInterruption`
+        # @return [Boolean]
+        attr_accessor :allow_playback_interruption
+        alias_method :allow_playback_interruption?, :allow_playback_interruption
+      
+        # Raw audio synthesized from the Dialogflow agent's response using
+        # the output config specified in the request.
+        # Corresponds to the JSON property `audio`
+        # NOTE: Values are automatically base64 encoded/decoded in the client library.
+        # @return [String]
+        attr_accessor :audio
+      
+        # Client-specific URI that points to an audio clip accessible to the
+        # client. Dialogflow does not impose any validation on it.
+        # Corresponds to the JSON property `uri`
+        # @return [String]
+        attr_accessor :uri
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @allow_playback_interruption = args[:allow_playback_interruption] if args.key?(:allow_playback_interruption)
+          @audio = args[:audio] if args.key?(:audio)
+          @uri = args[:uri] if args.key?(:uri)
+        end
+      end
+      
+      # A text or ssml response that is preferentially used for TTS output audio
+      # synthesis, as described in the comment on the ResponseMessage message.
+      class GoogleCloudDialogflowCxV3beta1ResponseMessageOutputAudioText
+        include Google::Apis::Core::Hashable
+      
+        # The SSML text to be synthesized. For more information, see
+        # [SSML](/speech/text-to-speech/docs/ssml).
+        # Corresponds to the JSON property `ssml`
+        # @return [String]
+        attr_accessor :ssml
+      
+        # The raw text to be synthesized.
+        # Corresponds to the JSON property `text`
+        # @return [String]
+        attr_accessor :text
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @ssml = args[:ssml] if args.key?(:ssml)
+          @text = args[:text] if args.key?(:text)
+        end
+      end
+      
+      # Specifies an audio clip to be played by the client as part of the response.
+      class GoogleCloudDialogflowCxV3beta1ResponseMessagePlayAudio
+        include Google::Apis::Core::Hashable
+      
+        # Whether the playback of this message can be interrupted by the end
+        # user's speech and the client can then starts the next Dialogflow
+        # request.
+        # Corresponds to the JSON property `allowPlaybackInterruption`
+        # @return [Boolean]
+        attr_accessor :allow_playback_interruption
+        alias_method :allow_playback_interruption?, :allow_playback_interruption
+      
+        # Required. URI of the audio clip. Dialogflow does not impose any validation on
+        # this
+        # value. It is specific to the client that reads it.
+        # Corresponds to the JSON property `audioUri`
+        # @return [String]
+        attr_accessor :audio_uri
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @allow_playback_interruption = args[:allow_playback_interruption] if args.key?(:allow_playback_interruption)
+          @audio_uri = args[:audio_uri] if args.key?(:audio_uri)
+        end
+      end
+      
       # The text response message.
       class GoogleCloudDialogflowCxV3beta1ResponseMessageText
         include Google::Apis::Core::Hashable
       
-        # A collection of text responses.
+        # Whether the playback of this message can be interrupted by the end
+        # user's speech and the client can then starts the next Dialogflow
+        # request.
+        # Corresponds to the JSON property `allowPlaybackInterruption`
+        # @return [Boolean]
+        attr_accessor :allow_playback_interruption
+        alias_method :allow_playback_interruption?, :allow_playback_interruption
+      
+        # Required. A collection of text responses.
         # Corresponds to the JSON property `text`
         # @return [Array<String>]
         attr_accessor :text
@@ -301,6 +520,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @allow_playback_interruption = args[:allow_playback_interruption] if args.key?(:allow_playback_interruption)
           @text = args[:text] if args.key?(:text)
         end
       end
@@ -634,7 +854,19 @@ module Google
         end
       end
       
-      # Represents a context.
+      # Dialogflow contexts are similar to natural language context. If a person says
+      # to you "they are orange", you need context in order to understand what "they"
+      # is referring to. Similarly, for Dialogflow to handle an end-user expression
+      # like that, it needs to be provided with context in order to correctly match
+      # an intent.
+      # Using contexts, you can control the flow of a conversation. You can configure
+      # contexts for an intent by setting input and output contexts, which are
+      # identified by string names. When an intent is matched, any configured output
+      # contexts for that intent become active. While any contexts are active,
+      # Dialogflow is more likely to match intents that are configured with input
+      # contexts that correspond to the currently active contexts.
+      # For more information about context, see the
+      # [Contexts guide](https://cloud.google.com/dialogflow/docs/contexts-overview).
       class GoogleCloudDialogflowV2Context
         include Google::Apis::Core::Hashable
       
@@ -692,7 +924,7 @@ module Google
         end
       end
       
-      # Represents a notification sent to Cloud Pub/Sub subscribers for conversation
+      # Represents a notification sent to Pub/Sub subscribers for conversation
       # lifecycle events.
       class GoogleCloudDialogflowV2ConversationEvent
         include Google::Apis::Core::Hashable
@@ -737,9 +969,16 @@ module Google
         end
       end
       
-      # Represents an entity type.
-      # Entity types serve as a tool for extracting parameter values from natural
-      # language queries.
+      # Each intent parameter has a type, called the entity type, which dictates
+      # exactly how data from an end-user expression is extracted.
+      # Dialogflow provides predefined system entities that can match many common
+      # types of data. For example, there are system entities for matching dates,
+      # times, colors, email addresses, and so on. You can also create your own
+      # custom entities for matching custom data. For example, you could define a
+      # vegetable entity that can match the types of vegetables available for
+      # purchase with a grocery store agent.
+      # For more information, see the
+      # [Entity guide](https://cloud.google.com/dialogflow/docs/entities-overview).
       class GoogleCloudDialogflowV2EntityType
         include Google::Apis::Core::Hashable
       
@@ -906,9 +1145,14 @@ module Google
         end
       end
       
-      # Represents an intent.
-      # Intents convert a number of user expressions or patterns into an action. An
-      # action is an extraction of a user command or sentence semantics.
+      # An intent categorizes an end-user's intention for one conversation turn. For
+      # each agent, you define many intents, where your combined intents can handle a
+      # complete conversation. When an end-user writes or says something, referred to
+      # as an end-user expression or end-user input, Dialogflow matches the end-user
+      # input to the best intent in your agent. Matching an intent is also known as
+      # intent classification.
+      # For more information, see the [intent
+      # guide](https://cloud.google.com/dialogflow/docs/intents-overview).
       class GoogleCloudDialogflowV2Intent
         include Google::Apis::Core::Hashable
       
@@ -2334,9 +2578,14 @@ module Google
         # @return [String]
         attr_accessor :fulfillment_text
       
-        # Represents an intent.
-        # Intents convert a number of user expressions or patterns into an action. An
-        # action is an extraction of a user command or sentence semantics.
+        # An intent categorizes an end-user's intention for one conversation turn. For
+        # each agent, you define many intents, where your combined intents can handle a
+        # complete conversation. When an end-user writes or says something, referred to
+        # as an end-user expression or end-user input, Dialogflow matches the end-user
+        # input to the best intent in your agent. Matching an intent is also known as
+        # intent classification.
+        # For more information, see the [intent
+        # guide](https://cloud.google.com/dialogflow/docs/intents-overview).
         # Corresponds to the JSON property `intent`
         # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2Intent]
         attr_accessor :intent
@@ -2398,8 +2647,16 @@ module Google
         # @return [String]
         attr_accessor :query_text
       
-        # The result of sentiment analysis as configured by
-        # `sentiment_analysis_request_config`.
+        # The result of sentiment analysis. Sentiment analysis inspects user input
+        # and identifies the prevailing subjective opinion, especially to determine a
+        # user's attitude as positive, negative, or neutral.
+        # For Participants.AnalyzeContent, it needs to be configured in
+        # DetectIntentRequest.query_params. For
+        # Participants.StreamingAnalyzeContent, it needs to be configured in
+        # StreamingDetectIntentRequest.query_params.
+        # And for Participants.AnalyzeContent and
+        # Participants.StreamingAnalyzeContent, it needs to be configured in
+        # ConversationProfile.human_agent_assistant_config
         # Corresponds to the JSON property `sentimentAnalysisResult`
         # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2SentimentAnalysisResult]
         attr_accessor :sentiment_analysis_result
@@ -2480,8 +2737,16 @@ module Google
         end
       end
       
-      # The result of sentiment analysis as configured by
-      # `sentiment_analysis_request_config`.
+      # The result of sentiment analysis. Sentiment analysis inspects user input
+      # and identifies the prevailing subjective opinion, especially to determine a
+      # user's attitude as positive, negative, or neutral.
+      # For Participants.AnalyzeContent, it needs to be configured in
+      # DetectIntentRequest.query_params. For
+      # Participants.StreamingAnalyzeContent, it needs to be configured in
+      # StreamingDetectIntentRequest.query_params.
+      # And for Participants.AnalyzeContent and
+      # Participants.StreamingAnalyzeContent, it needs to be configured in
+      # ConversationProfile.human_agent_assistant_config
       class GoogleCloudDialogflowV2SentimentAnalysisResult
         include Google::Apis::Core::Hashable
       
@@ -2501,11 +2766,13 @@ module Google
         end
       end
       
-      # Represents a session entity type.
-      # Extends or replaces a custom entity type at the user session level (we
-      # refer to the entity types defined at the agent level as "custom entity
-      # types").
-      # Note: session entity types apply to all queries, regardless of the language.
+      # A session represents a conversation between a Dialogflow agent and an
+      # end-user. You can create special entities, called session entities, during a
+      # session. Session entities can extend or replace custom entity types and only
+      # exist during the session that they were created for. All session data,
+      # including session entities, is stored by Dialogflow for 20 minutes.
+      # For more information, see the [session entity
+      # guide](https://cloud.google.com/dialogflow/docs/entities-session).
       class GoogleCloudDialogflowV2SessionEntityType
         include Google::Apis::Core::Hashable
       
@@ -2683,7 +2950,14 @@ module Google
         end
       end
       
-      # Represents a conversational agent.
+      # A Dialogflow agent is a virtual agent that handles conversations with your
+      # end-users. It is a natural language understanding module that understands the
+      # nuances of human language. Dialogflow translates end-user text or audio
+      # during a conversation to structured data that your apps and services can
+      # understand. You design and build a Dialogflow agent to handle the types of
+      # conversations required for your system.
+      # For more information about agents, see the
+      # [Agent guide](https://cloud.google.com/dialogflow/docs/agents-overview).
       class GoogleCloudDialogflowV2beta1Agent
         include Google::Apis::Core::Hashable
       
@@ -2858,6 +3132,37 @@ module Google
         end
       end
       
+      # Response message for [Documents.AutoApproveSmartMessagingEntries].
+      class GoogleCloudDialogflowV2beta1AutoApproveSmartMessagingEntriesResponse
+        include Google::Apis::Core::Hashable
+      
+        # Number of smart messaging entries disabled.
+        # Corresponds to the JSON property `disabledCount`
+        # @return [Fixnum]
+        attr_accessor :disabled_count
+      
+        # Number of smart messaging entries enabled.
+        # Corresponds to the JSON property `enabledCount`
+        # @return [Fixnum]
+        attr_accessor :enabled_count
+      
+        # Number of smart messaging entries unreviewed.
+        # Corresponds to the JSON property `unreviewedCount`
+        # @return [Fixnum]
+        attr_accessor :unreviewed_count
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @disabled_count = args[:disabled_count] if args.key?(:disabled_count)
+          @enabled_count = args[:enabled_count] if args.key?(:enabled_count)
+          @unreviewed_count = args[:unreviewed_count] if args.key?(:unreviewed_count)
+        end
+      end
+      
       # The request message for EntityTypes.BatchCreateEntities.
       class GoogleCloudDialogflowV2beta1BatchCreateEntitiesRequest
         include Google::Apis::Core::Hashable
@@ -3129,7 +3434,19 @@ module Google
         end
       end
       
-      # Represents a context.
+      # Dialogflow contexts are similar to natural language context. If a person says
+      # to you "they are orange", you need context in order to understand what "they"
+      # is referring to. Similarly, for Dialogflow to handle an end-user expression
+      # like that, it needs to be provided with context in order to correctly match
+      # an intent.
+      # Using contexts, you can control the flow of a conversation. You can configure
+      # contexts for an intent by setting input and output contexts, which are
+      # identified by string names. When an intent is matched, any configured output
+      # contexts for that intent become active. While any contexts are active,
+      # Dialogflow is more likely to match intents that are configured with input
+      # contexts that correspond to the currently active contexts.
+      # For more information about context, see the
+      # [Contexts guide](https://cloud.google.com/dialogflow/docs/contexts-overview).
       class GoogleCloudDialogflowV2beta1Context
         include Google::Apis::Core::Hashable
       
@@ -3316,7 +3633,9 @@ module Google
         end
       end
       
-      # A document resource.
+      # A knowledge document to be used by a KnowledgeBase.
+      # For more information, see the [knowledge base
+      # guide](https://cloud.google.com/dialogflow/docs/how/knowledge-bases).
       # Note: The `projects.agent.knowledgeBases.documents` resource is deprecated;
       # only use `projects.knowledgeBases.documents`.
       class GoogleCloudDialogflowV2beta1Document
@@ -3445,9 +3764,16 @@ module Google
         end
       end
       
-      # Represents an entity type.
-      # Entity types serve as a tool for extracting parameter values from natural
-      # language queries.
+      # Each intent parameter has a type, called the entity type, which dictates
+      # exactly how data from an end-user expression is extracted.
+      # Dialogflow provides predefined system entities that can match many common
+      # types of data. For example, there are system entities for matching dates,
+      # times, colors, email addresses, and so on. You can also create your own
+      # custom entities for matching custom data. For example, you could define a
+      # vegetable entity that can match the types of vegetables available for
+      # purchase with a grocery store agent.
+      # For more information, see the
+      # [Entity guide](https://cloud.google.com/dialogflow/docs/entities-overview).
       class GoogleCloudDialogflowV2beta1EntityType
         include Google::Apis::Core::Hashable
       
@@ -3556,7 +3882,20 @@ module Google
         end
       end
       
-      # Represents an agent environment.
+      # You can create multiple versions of your agent and publish them to separate
+      # environments.
+      # When you edit an agent, you are editing the draft agent. At any point, you
+      # can save the draft agent as an agent version, which is an immutable snapshot
+      # of your agent.
+      # When you save the draft agent, it is published to the default environment.
+      # When you create agent versions, you can publish them to custom environments.
+      # You can create a variety of custom environments for:
+      # - testing
+      # - development
+      # - production
+      # - etc.
+      # For more information, see the [versions and environments
+      # guide](https://cloud.google.com/dialogflow/docs/agents-versions).
       class GoogleCloudDialogflowV2beta1Environment
         include Google::Apis::Core::Hashable
       
@@ -3573,8 +3912,10 @@ module Google
         attr_accessor :description
       
         # Output only. The unique identifier of this agent environment.
-        # Format: `projects/<Project ID>/agent/environments/<Environment ID>`.
-        # For Environment ID, "-" is reserved for 'draft' environment.
+        # Format:
+        # - `projects/<Project Number / ID>/agent/environments/<Environment ID>`
+        # - `projects/<Project Number / ID>/locations/<Location
+        # ID>/agent/environments/<Environment ID>`
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -3707,7 +4048,15 @@ module Google
         end
       end
       
-      # Represents a fulfillment.
+      # By default, your agent responds to a matched intent with a static response.
+      # As an alternative, you can provide a more dynamic response by using
+      # fulfillment. When you enable fulfillment for an intent, Dialogflow responds
+      # to that intent by calling a service that you define. For example, if an
+      # end-user wants to schedule a haircut on Friday, your service can check your
+      # database and respond to the end-user with availability information for
+      # Friday.
+      # For more information, see the [fulfillment
+      # guide](https://cloud.google.com/dialogflow/docs/fulfillment-overview).
       class GoogleCloudDialogflowV2beta1Fulfillment
         include Google::Apis::Core::Hashable
       
@@ -3989,9 +4338,14 @@ module Google
         end
       end
       
-      # Represents an intent.
-      # Intents convert a number of user expressions or patterns into an action. An
-      # action is an extraction of a user command or sentence semantics.
+      # An intent categorizes an end-user's intention for one conversation turn. For
+      # each agent, you define many intents, where your combined intents can handle a
+      # complete conversation. When an end-user writes or says something, referred to
+      # as an end-user expression or end-user input, Dialogflow matches the end-user
+      # input to the best intent in your agent. Matching an intent is also known as
+      # intent classification.
+      # For more information, see the [intent
+      # guide](https://cloud.google.com/dialogflow/docs/intents-overview).
       class GoogleCloudDialogflowV2beta1Intent
         include Google::Apis::Core::Hashable
       
@@ -4287,9 +4641,6 @@ module Google
         # Carousel Rich Business Messaging (RBM) rich card.
         # Rich cards allow you to respond to users with more vivid content, e.g.
         # with media and suggestions.
-        # For more details about RBM rich cards, please see:
-        # https://developers.google.com/business-communications/rcs-business-messaging/
-        # guides/build/messages/send#rich-cards
         # If you want to show a single card with more control over the layout,
         # please use RbmStandaloneCard instead.
         # Corresponds to the JSON property `rbmCarouselRichCard`
@@ -4299,9 +4650,6 @@ module Google
         # Standalone Rich Business Messaging (RBM) rich card.
         # Rich cards allow you to respond to users with more vivid content, e.g.
         # with media and suggestions.
-        # For more details about RBM rich cards, please see:
-        # https://developers.google.com/business-communications/rcs-business-messaging/
-        # guides/build/messages/send#rich-cards
         # You can group multiple rich cards into one using RbmCarouselCard but
         # carousel cards will give you less control over the card layout.
         # Corresponds to the JSON property `rbmStandaloneRichCard`
@@ -5009,7 +5357,7 @@ module Google
         attr_accessor :file_uri
       
         # Required for cards with vertical orientation. The height of the media
-        # within a rich card with a vertical layout. (https://goo.gl/NeFCjz).
+        # within a rich card with a vertical layout.
         # For a standalone card with horizontal layout, height is not
         # customizable, and this field is ignored.
         # Corresponds to the JSON property `height`
@@ -5040,9 +5388,6 @@ module Google
       # Carousel Rich Business Messaging (RBM) rich card.
       # Rich cards allow you to respond to users with more vivid content, e.g.
       # with media and suggestions.
-      # For more details about RBM rich cards, please see:
-      # https://developers.google.com/business-communications/rcs-business-messaging/
-      # guides/build/messages/send#rich-cards
       # If you want to show a single card with more control over the layout,
       # please use RbmStandaloneCard instead.
       class GoogleCloudDialogflowV2beta1IntentMessageRbmCarouselCard
@@ -5073,9 +5418,6 @@ module Google
       # Standalone Rich Business Messaging (RBM) rich card.
       # Rich cards allow you to respond to users with more vivid content, e.g.
       # with media and suggestions.
-      # For more details about RBM rich cards, please see:
-      # https://developers.google.com/business-communications/rcs-business-messaging/
-      # guides/build/messages/send#rich-cards
       # You can group multiple rich cards into one using RbmCarouselCard but
       # carousel cards will give you less control over the card layout.
       class GoogleCloudDialogflowV2beta1IntentMessageRbmStandaloneCard
@@ -5115,13 +5457,13 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Opens the user's default dialer app with the specified phone number
-        # but does not dial automatically (https://goo.gl/ergbB2).
+        # but does not dial automatically.
         # Corresponds to the JSON property `dial`
         # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedActionRbmSuggestedActionDial]
         attr_accessor :dial
       
         # Opens the user's default web browser app to the specified uri
-        # (https://goo.gl/6GLJD2). If the user has an app installed that is
+        # If the user has an app installed that is
         # registered as the default handler for the URL, then this app will be
         # opened instead, and its icon will be used in the suggested action UI.
         # Corresponds to the JSON property `openUrl`
@@ -5136,7 +5478,7 @@ module Google
         attr_accessor :postback_data
       
         # Opens the device's location chooser so the user can pick a location
-        # to send back to the agent (https://goo.gl/GXotJW).
+        # to send back to the agent.
         # Corresponds to the JSON property `shareLocation`
         # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedActionRbmSuggestedActionShareLocation]
         attr_accessor :share_location
@@ -5161,7 +5503,7 @@ module Google
       end
       
       # Opens the user's default dialer app with the specified phone number
-      # but does not dial automatically (https://goo.gl/ergbB2).
+      # but does not dial automatically.
       class GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedActionRbmSuggestedActionDial
         include Google::Apis::Core::Hashable
       
@@ -5184,7 +5526,7 @@ module Google
       end
       
       # Opens the user's default web browser app to the specified uri
-      # (https://goo.gl/6GLJD2). If the user has an app installed that is
+      # If the user has an app installed that is
       # registered as the default handler for the URL, then this app will be
       # opened instead, and its icon will be used in the suggested action UI.
       class GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedActionRbmSuggestedActionOpenUri
@@ -5206,7 +5548,7 @@ module Google
       end
       
       # Opens the device's location chooser so the user can pick a location
-      # to send back to the agent (https://goo.gl/GXotJW).
+      # to send back to the agent.
       class GoogleCloudDialogflowV2beta1IntentMessageRbmSuggestedActionRbmSuggestedActionShareLocation
         include Google::Apis::Core::Hashable
       
@@ -5867,7 +6209,12 @@ module Google
         end
       end
       
-      # Represents knowledge base resource.
+      # A knowledge base represents a collection of knowledge documents that you
+      # provide to Dialogflow. Your knowledge documents contain information that may
+      # be useful during conversations with end-users. Some Dialogflow features use
+      # knowledge bases when looking for a response to an end-user input.
+      # For more information, see the [knowledge base
+      # guide](https://cloud.google.com/dialogflow/docs/how/knowledge-bases).
       # Note: The `projects.agent.knowledgeBases` resource is deprecated;
       # only use `projects.knowledgeBases`.
       class GoogleCloudDialogflowV2beta1KnowledgeBase
@@ -6398,9 +6745,14 @@ module Google
         # @return [String]
         attr_accessor :fulfillment_text
       
-        # Represents an intent.
-        # Intents convert a number of user expressions or patterns into an action. An
-        # action is an extraction of a user command or sentence semantics.
+        # An intent categorizes an end-user's intention for one conversation turn. For
+        # each agent, you define many intents, where your combined intents can handle a
+        # complete conversation. When an end-user writes or says something, referred to
+        # as an end-user expression or end-user input, Dialogflow matches the end-user
+        # input to the best intent in your agent. Matching an intent is also known as
+        # intent classification.
+        # For more information, see the [intent
+        # guide](https://cloud.google.com/dialogflow/docs/intents-overview).
         # Corresponds to the JSON property `intent`
         # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Intent]
         attr_accessor :intent
@@ -6467,8 +6819,16 @@ module Google
         # @return [String]
         attr_accessor :query_text
       
-        # The result of sentiment analysis as configured by
-        # `sentiment_analysis_request_config`.
+        # The result of sentiment analysis. Sentiment analysis inspects user input
+        # and identifies the prevailing subjective opinion, especially to determine a
+        # user's attitude as positive, negative, or neutral.
+        # For Participants.AnalyzeContent, it needs to be configured in
+        # DetectIntentRequest.query_params. For
+        # Participants.StreamingAnalyzeContent, it needs to be configured in
+        # StreamingDetectIntentRequest.query_params.
+        # And for Participants.AnalyzeContent and
+        # Participants.StreamingAnalyzeContent, it needs to be configured in
+        # ConversationProfile.human_agent_assistant_config
         # Corresponds to the JSON property `sentimentAnalysisResult`
         # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1SentimentAnalysisResult]
         attr_accessor :sentiment_analysis_result
@@ -6645,8 +7005,16 @@ module Google
         end
       end
       
-      # The result of sentiment analysis as configured by
-      # `sentiment_analysis_request_config`.
+      # The result of sentiment analysis. Sentiment analysis inspects user input
+      # and identifies the prevailing subjective opinion, especially to determine a
+      # user's attitude as positive, negative, or neutral.
+      # For Participants.AnalyzeContent, it needs to be configured in
+      # DetectIntentRequest.query_params. For
+      # Participants.StreamingAnalyzeContent, it needs to be configured in
+      # StreamingDetectIntentRequest.query_params.
+      # And for Participants.AnalyzeContent and
+      # Participants.StreamingAnalyzeContent, it needs to be configured in
+      # ConversationProfile.human_agent_assistant_config
       class GoogleCloudDialogflowV2beta1SentimentAnalysisResult
         include Google::Apis::Core::Hashable
       
@@ -6666,11 +7034,13 @@ module Google
         end
       end
       
-      # Represents a session entity type.
-      # Extends or replaces a custom entity type at the user session level (we
-      # refer to the entity types defined at the agent level as "custom entity
-      # types").
-      # Note: session entity types apply to all queries, regardless of the language.
+      # A session represents a conversation between a Dialogflow agent and an
+      # end-user. You can create special entities, called session entities, during a
+      # session. Session entities can extend or replace custom entity types and only
+      # exist during the session that they were created for. All session data,
+      # including session entities, is stored by Dialogflow for 20 minutes.
+      # For more information, see the [session entity
+      # guide](https://cloud.google.com/dialogflow/docs/entities-session).
       class GoogleCloudDialogflowV2beta1SessionEntityType
         include Google::Apis::Core::Hashable