google-api-client 0.37.0 → 0.38.0

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

@@ -110,7 +110,7 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Optional. The number of conversational query requests after which the
-        # context expires. If set to `0` (the default) the context expires
+        # context expires. The default is `0`. If set to `0`, the context expires
         # immediately. Contexts expire automatically after 20 minutes if there
         # are no matching queries.
         # Corresponds to the JSON property `lifespanCount`
@@ -118,9 +118,13 @@ module Google
         attr_accessor :lifespan_count
       
         # Required. The unique identifier of the context. Format:
-        # `projects/<Project ID>/agent/sessions/<Session ID>/contexts/<Context ID>`.
+        # `projects/<Project ID>/agent/sessions/<Session ID>/contexts/<Context ID>`,
+        # or `projects/<Project ID>/agent/environments/<Environment ID>/users/<User
+        # ID>/sessions/<Session ID>/contexts/<Context ID>`.
         # The `Context ID` is always converted to lowercase, may only contain
-        # characters in [a-zA-Z0-9_-%] and may be at most 250 bytes long.
+        # characters in a-zA-Z0-9_-% and may be at most 250 bytes long.
+        # If `Environment ID` is not specified, we assume default 'draft'
+        # environment. If `User ID` is not specified, we assume default '-' user.
         # The following context names are reserved for internal use by Dialogflow.
         # You should not use these contexts or create contexts with these names:
         # * `__system_counters__`
@@ -131,9 +135,18 @@ module Google
         attr_accessor :name
       
         # Optional. The collection of parameters associated with this context.
-        # Refer to [this
-        # doc](https://cloud.google.com/dialogflow/docs/intents-actions-parameters)
-        # for syntax.
+        # Depending on your protocol or client library language, this is a
+        # map, associative array, symbol table, dictionary, or JSON object
+        # composed of a collection of (MapKey, MapValue) pairs:
+        # -   MapKey type: string
+        # -   MapKey value: parameter name
+        # -   MapValue type:
+        # -   If parameter's entity type is a composite entity: map
+        # -   Else: string
+        # -   MapValue value:
+        # -   If parameter's entity type is a composite entity:
+        # map from composite entity property names to property values
+        # -   Else: parameter value
         # Corresponds to the JSON property `parameters`
         # @return [Hash<String,Object>]
         attr_accessor :parameters
@@ -308,7 +321,7 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # Optional. The collection of parameters associated with the event.
+        # The collection of parameters associated with the event.
         # Corresponds to the JSON property `parameters`
         # @return [Hash<String,Object>]
         attr_accessor :parameters
@@ -378,6 +391,7 @@ module Google
         # Optional. The collection of event names that trigger the intent.
         # If the collection of input contexts is not empty, all of the contexts must
         # be present in the active user session for an event to trigger this intent.
+        # Event names are limited to 150 characters.
         # Corresponds to the JSON property `events`
         # @return [Array<String>]
         attr_accessor :events
@@ -416,7 +430,7 @@ module Google
         attr_accessor :ml_disabled
         alias_method :ml_disabled?, :ml_disabled
       
-        # The unique identifier of this intent.
+        # Optional. The unique identifier of this intent.
         # Required for Intents.UpdateIntent and Intents.BatchUpdateIntents
         # methods.
         # Format: `projects/<Project ID>/agent/intents/<Intent ID>`.
@@ -540,7 +554,11 @@ module Google
         end
       end
       
-      # Corresponds to the `Response` field in the Dialogflow console.
+      # A rich response message.
+      # Corresponds to the intent `Response` field in the Dialogflow console.
+      # For more information, see
+      # [Rich response
+      # messages](https://cloud.google.com/dialogflow/docs/intents-rich-messages).
       class GoogleCloudDialogflowV2IntentMessage
         include Google::Apis::Core::Hashable
       
@@ -586,9 +604,7 @@ module Google
         # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2IntentMessageMediaContent]
         attr_accessor :media_content
       
-        # Returns a response containing a custom, platform-specific payload.
-        # See the Intent.Message.Platform type for a description of the
-        # structure that may be required for your platform.
+        # A custom platform-specific response.
         # Corresponds to the JSON property `payload`
         # @return [Hash<String,Object>]
         attr_accessor :payload
@@ -1699,7 +1715,8 @@ module Google
         # Optional. This field is set to the value of the `QueryParameters.payload`
         # field passed in the request. Some integrations that query a Dialogflow
         # agent may provide additional information in the payload.
-        # In particular for the Telephony Gateway this field has the form:
+        # In particular, for the Dialogflow Phone Gateway integration, this field has
+        # the form:
         # <pre>`
         # "telephony": `
         # "caller_id": "+18558363987"
@@ -1953,7 +1970,11 @@ module Google
       
         # Required. The unique identifier of this session entity type. Format:
         # `projects/<Project ID>/agent/sessions/<Session ID>/entityTypes/<Entity Type
-        # Display Name>`.
+        # Display Name>`, or `projects/<Project ID>/agent/environments/<Environment
+        # ID>/users/<User ID>/sessions/<Session ID>/entityTypes/<Entity Type Display
+        # Name>`.
+        # If `Environment ID` is not specified, we assume default 'draft'
+        # environment. If `User ID` is not specified, we assume default '-' user.
         # `<Entity Type Display Name>` must be the display name of an existing entity
         # type in the same agent that will be overridden or supplemented.
         # Corresponds to the JSON property `name`
@@ -2056,28 +2077,18 @@ module Google
         # @return [Array<Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2Context>]
         attr_accessor :output_contexts
       
-        # Optional. This value is passed directly to `QueryResult.webhook_payload`.
-        # See the related `fulfillment_messages[i].payload field`, which may be used
-        # as an alternative to this field.
-        # This field can be used for Actions on Google responses.
-        # It should have a structure similar to the JSON message shown here. For more
-        # information, see
-        # [Actions on Google Webhook
-        # Format](https://developers.google.com/actions/dialogflow/webhook)
-        # <pre>`
-        # "google": `
-        # "expectUserResponse": true,
-        # "richResponse": `
-        # "items": [
-        # `
-        # "simpleResponse": `
-        # "textToSpeech": "this is a simple response"
-        # `
-        # `
-        # ]
-        # `
-        # `
-        # `</pre>
+        # Optional. This field can be used to pass custom data from your webhook to the
+        # API
+        # caller. Arbitrary JSON objects are supported.
+        # When provided, Dialogflow uses this field to populate
+        # `QueryResult.webhook_payload` sent to the API caller.
+        # This field is also used by the
+        # [Google Assistant
+        # integration](https://cloud.google.com/dialogflow/docs/integrations/aog)
+        # for rich response messages.
+        # See the format definition at [Google Assistant Dialogflow webhook
+        # format](https://developers.google.com/assistant/actions/build/json/dialogflow-
+        # webhook-json)
         # Corresponds to the JSON property `payload`
         # @return [Hash<String,Object>]
         attr_accessor :payload
@@ -2296,12 +2307,12 @@ module Google
         # @return [Array<Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1EntityTypeEntity>]
         attr_accessor :entities
       
-        # Optional. The language of entity synonyms defined in `entities`. If not
-        # specified, the agent's default language is used.
-        # [Many
-        # languages](https://cloud.google.com/dialogflow/docs/reference/language)
-        # are supported. Note: languages must be enabled in the agent before they can
-        # be used.
+        # Optional. The language used to access language-specific data.
+        # If not specified, the agent's default language is used.
+        # For more information, see
+        # [Multilingual intent and entity
+        # data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-
+        # entity).
         # Corresponds to the JSON property `languageCode`
         # @return [String]
         attr_accessor :language_code
@@ -2328,12 +2339,12 @@ module Google
         # @return [Array<String>]
         attr_accessor :entity_values
       
-        # Optional. The language of entity synonyms defined in `entities`. If not
-        # specified, the agent's default language is used.
-        # [Many
-        # languages](https://cloud.google.com/dialogflow/docs/reference/language)
-        # are supported. Note: languages must be enabled in the agent before they can
-        # be used.
+        # Optional. The language used to access language-specific data.
+        # If not specified, the agent's default language is used.
+        # For more information, see
+        # [Multilingual intent and entity
+        # data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-
+        # entity).
         # Corresponds to the JSON property `languageCode`
         # @return [String]
         attr_accessor :language_code
@@ -2398,12 +2409,12 @@ module Google
         # @return [Array<Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1EntityTypeEntity>]
         attr_accessor :entities
       
-        # Optional. The language of entity synonyms defined in `entities`. If not
-        # specified, the agent's default language is used.
-        # [Many
-        # languages](https://cloud.google.com/dialogflow/docs/reference/language)
-        # are supported. Note: languages must be enabled in the agent before they can
-        # be used.
+        # Optional. The language used to access language-specific data.
+        # If not specified, the agent's default language is used.
+        # For more information, see
+        # [Multilingual intent and entity
+        # data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-
+        # entity).
         # Corresponds to the JSON property `languageCode`
         # @return [String]
         attr_accessor :language_code
@@ -2442,12 +2453,12 @@ module Google
         # @return [String]
         attr_accessor :entity_type_batch_uri
       
-        # Optional. The language of entity synonyms defined in `entity_types`. If not
-        # specified, the agent's default language is used.
-        # [Many
-        # languages](https://cloud.google.com/dialogflow/docs/reference/language)
-        # are supported. Note: languages must be enabled in the agent before they can
-        # be used.
+        # Optional. The language used to access language-specific data.
+        # If not specified, the agent's default language is used.
+        # For more information, see
+        # [Multilingual intent and entity
+        # data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-
+        # entity).
         # Corresponds to the JSON property `languageCode`
         # @return [String]
         attr_accessor :language_code
@@ -2510,12 +2521,12 @@ module Google
         # @return [String]
         attr_accessor :intent_view
       
-        # Optional. The language of training phrases, parameters and rich messages
-        # defined in `intents`. If not specified, the agent's default language is
-        # used. [Many
-        # languages](https://cloud.google.com/dialogflow/docs/reference/language)
-        # are supported. Note: languages must be enabled in the agent before they can
-        # be used.
+        # Optional. The language used to access language-specific data.
+        # If not specified, the agent's default language is used.
+        # For more information, see
+        # [Multilingual intent and entity
+        # data](https://cloud.google.com/dialogflow/docs/agents-multilingual#intent-
+        # entity).
         # Corresponds to the JSON property `languageCode`
         # @return [String]
         attr_accessor :language_code
@@ -2563,7 +2574,7 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Optional. The number of conversational query requests after which the
-        # context expires. If set to `0` (the default) the context expires
+        # context expires. The default is `0`. If set to `0`, the context expires
         # immediately. Contexts expire automatically after 20 minutes if there
         # are no matching queries.
         # Corresponds to the JSON property `lifespanCount`
@@ -2588,9 +2599,18 @@ module Google
         attr_accessor :name
       
         # Optional. The collection of parameters associated with this context.
-        # Refer to [this
-        # doc](https://cloud.google.com/dialogflow/docs/intents-actions-parameters)
-        # for syntax.
+        # Depending on your protocol or client library language, this is a
+        # map, associative array, symbol table, dictionary, or JSON object
+        # composed of a collection of (MapKey, MapValue) pairs:
+        # -   MapKey type: string
+        # -   MapKey value: parameter name
+        # -   MapValue type:
+        # -   If parameter's entity type is a composite entity: map
+        # -   Else: string
+        # -   MapValue value:
+        # -   If parameter's entity type is a composite entity:
+        # map from composite entity property names to property values
+        # -   Else: parameter value
         # Corresponds to the JSON property `parameters`
         # @return [Hash<String,Object>]
         attr_accessor :parameters
@@ -2607,13 +2627,11 @@ module Google
         end
       end
       
-      # ============================================================================
-      # Requests and responses for custom methods.
       # The request to detect user's intent.
       class GoogleCloudDialogflowV2beta1DetectIntentRequest
         include Google::Apis::Core::Hashable
       
-        # Optional. The natural language speech audio to be processed. This field
+        # The natural language speech audio to be processed. This field
         # should be populated iff `query_input` is set to an input audio config.
         # A single request can contain up to 1 minute of speech audio data.
         # Corresponds to the JSON property `inputAudio`
@@ -2628,6 +2646,15 @@ module Google
         # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1OutputAudioConfig]
         attr_accessor :output_audio_config
       
+        # Mask for output_audio_config indicating which settings in this
+        # request-level config should override speech synthesizer settings defined at
+        # agent-level.
+        # If unspecified or empty, output_audio_config replaces the agent-level
+        # config in its entirety.
+        # Corresponds to the JSON property `outputAudioConfigMask`
+        # @return [String]
+        attr_accessor :output_audio_config_mask
+      
         # Represents the query input. It can contain either:
         # 1.  An audio config which
         # instructs the speech recognizer how to process the speech audio.
@@ -2650,6 +2677,7 @@ module Google
         def update!(**args)
           @input_audio = args[:input_audio] if args.key?(:input_audio)
           @output_audio_config = args[:output_audio_config] if args.key?(:output_audio_config)
+          @output_audio_config_mask = args[:output_audio_config_mask] if args.key?(:output_audio_config_mask)
           @query_input = args[:query_input] if args.key?(:query_input)
           @query_params = args[:query_params] if args.key?(:query_params)
         end
@@ -2908,124 +2936,6 @@ module Google
         end
       end
       
-      # Represents an agent environment.
-      class GoogleCloudDialogflowV2beta1Environment
-        include Google::Apis::Core::Hashable
-      
-        # Optional. The agent version loaded into this environment.
-        # Format: `projects/<Project ID>/agent/versions/<Version ID>`.
-        # Corresponds to the JSON property `agentVersion`
-        # @return [String]
-        attr_accessor :agent_version
-      
-        # Optional. The developer-provided description for this environment.
-        # The maximum length is 500 characters. If exceeded, the request is rejected.
-        # Corresponds to the JSON property `description`
-        # @return [String]
-        attr_accessor :description
-      
-        # Output only. The unique identifier of this agent environment.
-        # Format: `projects/<Project ID>/agent/environments/<Environment ID>`.
-        # You can use "-" as Environment ID to refer to 'draft' environment.
-        # Corresponds to the JSON property `name`
-        # @return [String]
-        attr_accessor :name
-      
-        # Output only. The state of this environment. This field is read-only, i.e., it
-        # cannot be
-        # set by create and update methods.
-        # Corresponds to the JSON property `state`
-        # @return [String]
-        attr_accessor :state
-      
-        # Output only. The last update time of this environment. This field is read-only,
-        # i.e., it
-        # cannot be set by create and update methods.
-        # Corresponds to the JSON property `updateTime`
-        # @return [String]
-        attr_accessor :update_time
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @agent_version = args[:agent_version] if args.key?(:agent_version)
-          @description = args[:description] if args.key?(:description)
-          @name = args[:name] if args.key?(:name)
-          @state = args[:state] if args.key?(:state)
-          @update_time = args[:update_time] if args.key?(:update_time)
-        end
-      end
-      
-      # The response message for Environments.GetEnvironmentHistory.
-      class GoogleCloudDialogflowV2beta1EnvironmentHistory
-        include Google::Apis::Core::Hashable
-      
-        # Output only. The list of agent environments. There will be a maximum number of
-        # items
-        # returned based on the page_size field in the request.
-        # Corresponds to the JSON property `entries`
-        # @return [Array<Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1EnvironmentHistoryEntry>]
-        attr_accessor :entries
-      
-        # Output only. Token to retrieve the next page of results, or empty if there are
-        # no
-        # more results in the list.
-        # Corresponds to the JSON property `nextPageToken`
-        # @return [String]
-        attr_accessor :next_page_token
-      
-        # Output only. The name of the environment this history is for.
-        # Format: `projects/<Project ID>/agent/environments/<Environment ID>`.
-        # Corresponds to the JSON property `parent`
-        # @return [String]
-        attr_accessor :parent
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @entries = args[:entries] if args.key?(:entries)
-          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
-          @parent = args[:parent] if args.key?(:parent)
-        end
-      end
-      
-      # Represents a environment history entry.
-      class GoogleCloudDialogflowV2beta1EnvironmentHistoryEntry
-        include Google::Apis::Core::Hashable
-      
-        # The agent version loaded into this environment history entry.
-        # Corresponds to the JSON property `agentVersion`
-        # @return [String]
-        attr_accessor :agent_version
-      
-        # The creation time of this environment history entry.
-        # Corresponds to the JSON property `createTime`
-        # @return [String]
-        attr_accessor :create_time
-      
-        # The developer-provided description for this environment history entry.
-        # Corresponds to the JSON property `description`
-        # @return [String]
-        attr_accessor :description
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @agent_version = args[:agent_version] if args.key?(:agent_version)
-          @create_time = args[:create_time] if args.key?(:create_time)
-          @description = args[:description] if args.key?(:description)
-        end
-      end
-      
       # Events allow for matching intents by event name instead of the natural
       # language input. For instance, input `<event: ` name: "welcome_event",
       # parameters: ` name: "Sam" ` `>` can trigger a personalized welcome response.
@@ -3047,7 +2957,7 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # Optional. The collection of parameters associated with the event.
+        # The collection of parameters associated with the event.
         # Corresponds to the JSON property `parameters`
         # @return [Hash<String,Object>]
         attr_accessor :parameters
@@ -3292,7 +3202,7 @@ module Google
         # @return [String]
         attr_accessor :audio_encoding
       
-        # Optional. If `true`, Dialogflow returns SpeechWordInfo in
+        # If `true`, Dialogflow returns SpeechWordInfo in
         # StreamingRecognitionResult with information about the recognized speech
         # words, e.g. start and end time offsets. If false or unspecified, Speech
         # doesn't return any word-level information.
@@ -3310,7 +3220,7 @@ module Google
         # @return [String]
         attr_accessor :language_code
       
-        # Optional. Which Speech model to select for the given request. Select the
+        # Which Speech model to select for the given request. Select the
         # model best suited to your domain to get best results. If a model is not
         # explicitly specified, then we auto-select a model based on the parameters
         # in the InputAudioConfig.
@@ -3326,12 +3236,12 @@ module Google
         # @return [String]
         attr_accessor :model
       
-        # Optional. Which variant of the Speech model to use.
+        # Which variant of the Speech model to use.
         # Corresponds to the JSON property `modelVariant`
         # @return [String]
         attr_accessor :model_variant
       
-        # Optional. A list of strings containing words and phrases that the speech
+        # A list of strings containing words and phrases that the speech
         # recognizer should recognize with higher likelihood.
         # See [the Cloud Speech
         # documentation](https://cloud.google.com/speech-to-text/docs/basics#phrase-
@@ -3353,7 +3263,7 @@ module Google
         # @return [Fixnum]
         attr_accessor :sample_rate_hertz
       
-        # Optional. If `false` (default), recognition does not cease until the
+        # If `false` (default), recognition does not cease until the
         # client closes the stream.
         # If `true`, the recognizer will detect a single spoken utterance in input
         # audio. Recognition ceases when it detects the audio's voice has
@@ -3368,7 +3278,7 @@ module Google
         attr_accessor :single_utterance
         alias_method :single_utterance?, :single_utterance
       
-        # Optional. Context information to assist speech recognition.
+        # Context information to assist speech recognition.
         # See [the Cloud Speech
         # documentation](https://cloud.google.com/speech-to-text/docs/basics#phrase-
         # hints)
@@ -3429,6 +3339,7 @@ module Google
         # Optional. The collection of event names that trigger the intent.
         # If the collection of input contexts is not empty, all of the contexts must
         # be present in the active user session for an event to trigger this intent.
+        # Event names are limited to 150 characters.
         # Corresponds to the JSON property `events`
         # @return [Array<String>]
         attr_accessor :events
@@ -3674,9 +3585,7 @@ module Google
         # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1IntentMessageMediaContent]
         attr_accessor :media_content
       
-        # Returns a response containing a custom, platform-specific payload.
-        # See the Intent.Message.Platform type for a description of the
-        # structure that may be required for your platform.
+        # A custom platform-specific response.
         # Corresponds to the JSON property `payload`
         # @return [Hash<String,Object>]
         attr_accessor :payload
@@ -4350,18 +4259,18 @@ module Google
       
         # Rich Business Messaging (RBM) Media displayed in Cards
         # The following media-types are currently supported:
-        # ## Image Types
-        # image/jpeg
-        # image/jpg'
-        # image/gif
-        # image/png
-        # ## Video Types
-        # video/h263
-        # video/m4v
-        # video/mp4
-        # video/mpeg
-        # video/mpeg4
-        # video/webm
+        # Image Types
+        # * image/jpeg
+        # * image/jpg'
+        # * image/gif
+        # * image/png
+        # Video Types
+        # * video/h263
+        # * video/m4v
+        # * video/mp4
+        # * video/mpeg
+        # * video/mpeg4
+        # * video/webm
         # Corresponds to the JSON property `media`
         # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1IntentMessageRbmCardContentRbmMedia]
         attr_accessor :media
@@ -4392,18 +4301,18 @@ module Google
       
       # Rich Business Messaging (RBM) Media displayed in Cards
       # The following media-types are currently supported:
-      # ## Image Types
-      # image/jpeg
-      # image/jpg'
-      # image/gif
-      # image/png
-      # ## Video Types
-      # video/h263
-      # video/m4v
-      # video/mp4
-      # video/mpeg
-      # video/mpeg4
-      # video/webm
+      # Image Types
+      # * image/jpeg
+      # * image/jpg'
+      # * image/gif
+      # * image/png
+      # Video Types
+      # * video/h263
+      # * video/m4v
+      # * video/mp4
+      # * video/mpeg
+      # * video/mpeg4
+      # * video/webm
       class GoogleCloudDialogflowV2beta1IntentMessageRbmCardContentRbmMedia
         include Google::Apis::Core::Hashable
       
@@ -5435,33 +5344,6 @@ module Google
         end
       end
       
-      # The response message for Environments.ListEnvironments.
-      class GoogleCloudDialogflowV2beta1ListEnvironmentsResponse
-        include Google::Apis::Core::Hashable
-      
-        # The list of agent environments. There will be a maximum number of items
-        # returned based on the page_size field in the request.
-        # Corresponds to the JSON property `environments`
-        # @return [Array<Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Environment>]
-        attr_accessor :environments
-      
-        # Token to retrieve the next page of results, or empty if there are no
-        # more results in the list.
-        # Corresponds to the JSON property `nextPageToken`
-        # @return [String]
-        attr_accessor :next_page_token
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @environments = args[:environments] if args.key?(:environments)
-          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
-        end
-      end
-      
       # The response message for Intents.ListIntents.
       class GoogleCloudDialogflowV2beta1ListIntentsResponse
         include Google::Apis::Core::Hashable
@@ -5542,33 +5424,6 @@ module Google
         end
       end
       
-      # The response message for Versions.ListVersions.
-      class GoogleCloudDialogflowV2beta1ListVersionsResponse
-        include Google::Apis::Core::Hashable
-      
-        # Token to retrieve the next page of results, or empty if there are no
-        # more results in the list.
-        # Corresponds to the JSON property `nextPageToken`
-        # @return [String]
-        attr_accessor :next_page_token
-      
-        # The list of agent versions. There will be a maximum number of items
-        # returned based on the page_size field in the request.
-        # Corresponds to the JSON property `versions`
-        # @return [Array<Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Version>]
-        attr_accessor :versions
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
-          @versions = args[:versions] if args.key?(:versions)
-        end
-      end
-      
       # Represents the contents of the original request that was passed to
       # the `[Streaming]DetectIntent` call.
       class GoogleCloudDialogflowV2beta1OriginalDetectIntentRequest
@@ -5577,7 +5432,8 @@ module Google
         # Optional. This field is set to the value of the `QueryParameters.payload`
         # field passed in the request. Some integrations that query a Dialogflow
         # agent may provide additional information in the payload.
-        # In particular for the Telephony Gateway this field has the form:
+        # In particular, for the Dialogflow Phone Gateway integration, this field has
+        # the form:
         # <pre>`
         # "telephony": `
         # "caller_id": "+18558363987"
@@ -5625,7 +5481,7 @@ module Google
         # @return [String]
         attr_accessor :audio_encoding
       
-        # Optional. The synthesis sample rate (in hertz) for this audio. If not
+        # The synthesis sample rate (in hertz) for this audio. If not
         # provided, then the synthesizer will use the default sample rate based on
         # the audio encoding. If this is different from the voice's natural sample
         # rate, then the synthesizer will honor this request by converting to the
@@ -5694,7 +5550,7 @@ module Google
       class GoogleCloudDialogflowV2beta1QueryParameters
         include Google::Apis::Core::Hashable
       
-        # Optional. The collection of contexts to be activated before this query is
+        # The collection of contexts to be activated before this query is
         # executed.
         # Corresponds to the JSON property `contexts`
         # @return [Array<Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Context>]
@@ -5709,20 +5565,23 @@ module Google
         # @return [Google::Apis::DialogflowV2beta1::GoogleTypeLatLng]
         attr_accessor :geo_location
       
-        # Optional. KnowledgeBases to get alternative results from. If not set, the
+        # KnowledgeBases to get alternative results from. If not set, the
         # KnowledgeBases enabled in the agent (through UI) will be used.
         # Format:  `projects/<Project ID>/knowledgeBases/<Knowledge Base ID>`.
         # Corresponds to the JSON property `knowledgeBaseNames`
         # @return [Array<String>]
         attr_accessor :knowledge_base_names
       
-        # Optional. This field can be used to pass custom data into the webhook
-        # associated with the agent. Arbitrary JSON objects are supported.
+        # This field can be used to pass custom data to your webhook.
+        # Arbitrary JSON objects are supported.
+        # If supplied, the value is used to populate the
+        # `WebhookRequest.original_detect_intent_request.payload`
+        # field sent to your webhook.
         # Corresponds to the JSON property `payload`
         # @return [Hash<String,Object>]
         attr_accessor :payload
       
-        # Optional. Specifies whether to delete all contexts in the current session
+        # Specifies whether to delete all contexts in the current session
         # before the new ones are activated.
         # Corresponds to the JSON property `resetContexts`
         # @return [Boolean]
@@ -5734,14 +5593,14 @@ module Google
         # @return [Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1SentimentAnalysisRequestConfig]
         attr_accessor :sentiment_analysis_request_config
       
-        # Optional. Additional session entity types to replace or extend developer
+        # Additional session entity types to replace or extend developer
         # entity types with. The entity synonyms apply to all languages and persist
         # for the session of this query.
         # Corresponds to the JSON property `sessionEntityTypes`
         # @return [Array<Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1SessionEntityType>]
         attr_accessor :session_entity_types
       
-        # Optional. For mega agent query, directly specify which sub agents to query.
+        # For mega agent query, directly specify which sub agents to query.
         # If any specified sub agent is not linked to the mega agent, an error will
         # be returned. If empty, Dialogflow will decide which sub agents to query.
         # If specified for a non-mega-agent query, will be silently ignored.
@@ -5749,7 +5608,7 @@ module Google
         # @return [Array<Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1SubAgent>]
         attr_accessor :sub_agents
       
-        # Optional. The time zone of this conversational query from the
+        # The time zone of this conversational query from the
         # [time zone database](https://www.iana.org/time-zones), e.g.,
         # America/New_York, Europe/Paris. If not provided, the time zone specified in
         # agent settings is used.
@@ -5757,7 +5616,7 @@ module Google
         # @return [String]
         attr_accessor :time_zone
       
-        # Optional. This field can be used to pass HTTP headers for a webhook
+        # This field can be used to pass HTTP headers for a webhook
         # call. These headers will be sent to webhook alone with the headers that
         # have been configured through Dialogflow web console. The headers defined
         # within this field will overwrite the headers configured through Dialogflow
@@ -6045,7 +5904,7 @@ module Google
       class GoogleCloudDialogflowV2beta1SentimentAnalysisRequestConfig
         include Google::Apis::Core::Hashable
       
-        # Optional. Instructs the service to perform sentiment analysis on
+        # Instructs the service to perform sentiment analysis on
         # `query_text`. If not provided, sentiment analysis is not performed on
         # `query_text`.
         # Corresponds to the JSON property `analyzeQueryTextSentiment`
@@ -6359,56 +6218,6 @@ module Google
         end
       end
       
-      # Represents an agent version.
-      class GoogleCloudDialogflowV2beta1Version
-        include Google::Apis::Core::Hashable
-      
-        # Output only. The creation time of this version. This field is read-only, i.e.,
-        # it cannot
-        # be set by create and update methods.
-        # Corresponds to the JSON property `createTime`
-        # @return [String]
-        attr_accessor :create_time
-      
-        # Optional. The developer-provided description of this version.
-        # Corresponds to the JSON property `description`
-        # @return [String]
-        attr_accessor :description
-      
-        # Output only. The unique identifier of this agent version.
-        # Format: `projects/<Project ID>/agent/versions/<Version ID>`.
-        # Corresponds to the JSON property `name`
-        # @return [String]
-        attr_accessor :name
-      
-        # Output only. The status of this version. This field is read-only and cannot be
-        # set by
-        # create and update methods.
-        # Corresponds to the JSON property `status`
-        # @return [String]
-        attr_accessor :status
-      
-        # Output only. The sequential number of this version. This field is read-only
-        # which means
-        # it cannot be set by create and update methods.
-        # Corresponds to the JSON property `versionNumber`
-        # @return [Fixnum]
-        attr_accessor :version_number
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @create_time = args[:create_time] if args.key?(:create_time)
-          @description = args[:description] if args.key?(:description)
-          @name = args[:name] if args.key?(:name)
-          @status = args[:status] if args.key?(:status)
-          @version_number = args[:version_number] if args.key?(:version_number)
-        end
-      end
-      
       # Description of which voice to use for speech synthesis.
       class GoogleCloudDialogflowV2beta1VoiceSelectionParams
         include Google::Apis::Core::Hashable
@@ -6538,28 +6347,18 @@ module Google
         # @return [Array<Google::Apis::DialogflowV2beta1::GoogleCloudDialogflowV2beta1Context>]
         attr_accessor :output_contexts
       
-        # Optional. This value is passed directly to `QueryResult.webhook_payload`.
-        # See the related `fulfillment_messages[i].payload field`, which may be used
-        # as an alternative to this field.
-        # This field can be used for Actions on Google responses.
-        # It should have a structure similar to the JSON message shown here. For more
-        # information, see
-        # [Actions on Google Webhook
-        # Format](https://developers.google.com/actions/dialogflow/webhook)
-        # <pre>`
-        # "google": `
-        # "expectUserResponse": true,
-        # "richResponse": `
-        # "items": [
-        # `
-        # "simpleResponse": `
-        # "textToSpeech": "this is a simple response"
-        # `
-        # `
-        # ]
-        # `
-        # `
-        # `</pre>
+        # Optional. This field can be used to pass custom data from your webhook to the
+        # API
+        # caller. Arbitrary JSON objects are supported.
+        # When provided, Dialogflow uses this field to populate
+        # `QueryResult.webhook_payload` sent to the API caller.
+        # This field is also used by the
+        # [Google Assistant
+        # integration](https://cloud.google.com/dialogflow/docs/integrations/aog)
+        # for rich response messages.
+        # See the format definition at [Google Assistant Dialogflow webhook
+        # format](https://developers.google.com/assistant/actions/build/json/dialogflow-
+        # webhook-json)
         # Corresponds to the JSON property `payload`
         # @return [Hash<String,Object>]
         attr_accessor :payload