google-api-client 0.37.0 → 0.38.0

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

@@ -184,12 +184,12 @@ module Google
         # @return [Array<Google::Apis::DialogflowV2::GoogleCloudDialogflowV2EntityTypeEntity>]
         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
@@ -216,12 +216,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
@@ -286,12 +286,12 @@ module Google
         # @return [Array<Google::Apis::DialogflowV2::GoogleCloudDialogflowV2EntityTypeEntity>]
         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
@@ -330,12 +330,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
@@ -377,7 +377,7 @@ module Google
         end
       end
       
-      # The request message for Intents.BatchUpdateIntents.
+      # 
       class GoogleCloudDialogflowV2BatchUpdateIntentsRequest
         include Google::Apis::Core::Hashable
       
@@ -398,12 +398,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
@@ -451,7 +451,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`
@@ -459,9 +459,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__`
@@ -472,9 +476,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
@@ -536,13 +549,11 @@ module Google
         end
       end
       
-      # ============================================================================
-      # Requests and responses for custom methods.
       # The request to detect user's intent.
       class GoogleCloudDialogflowV2DetectIntentRequest
         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`
@@ -557,6 +568,15 @@ module Google
         # @return [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2OutputAudioConfig]
         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.
@@ -579,6 +599,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
@@ -752,123 +773,6 @@ module Google
         end
       end
       
-      # Represents an agent environment.
-      class GoogleCloudDialogflowV2Environment
-        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>`.
-        # 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 GoogleCloudDialogflowV2EnvironmentHistory
-        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::DialogflowV2::GoogleCloudDialogflowV2EnvironmentHistoryEntry>]
-        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 GoogleCloudDialogflowV2EnvironmentHistoryEntry
-        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.
@@ -890,7 +794,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
@@ -1112,7 +1016,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.
@@ -1130,7 +1034,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.
@@ -1146,12 +1050,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-
@@ -1173,7 +1077,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
@@ -1188,7 +1092,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)
@@ -1241,6 +1145,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
@@ -1279,7 +1184,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>`.
@@ -1422,7 +1327,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
       
@@ -1468,9 +1377,7 @@ module Google
         # @return [Google::Apis::DialogflowV2::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
@@ -2540,33 +2447,6 @@ module Google
         end
       end
       
-      # The response message for Environments.ListEnvironments.
-      class GoogleCloudDialogflowV2ListEnvironmentsResponse
-        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::DialogflowV2::GoogleCloudDialogflowV2Environment>]
-        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 GoogleCloudDialogflowV2ListIntentsResponse
         include Google::Apis::Core::Hashable
@@ -2621,33 +2501,6 @@ module Google
         end
       end
       
-      # The response message for Versions.ListVersions.
-      class GoogleCloudDialogflowV2ListVersionsResponse
-        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::DialogflowV2::GoogleCloudDialogflowV2Version>]
-        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 a message posted into a conversation.
       class GoogleCloudDialogflowV2Message
         include Google::Apis::Core::Hashable
@@ -2743,7 +2596,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"
@@ -2791,7 +2645,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
@@ -2860,7 +2714,7 @@ module Google
       class GoogleCloudDialogflowV2QueryParameters
         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::DialogflowV2::GoogleCloudDialogflowV2Context>]
@@ -2875,13 +2729,16 @@ module Google
         # @return [Google::Apis::DialogflowV2::GoogleTypeLatLng]
         attr_accessor :geo_location
       
-        # 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]
@@ -2893,14 +2750,14 @@ module Google
         # @return [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2SentimentAnalysisRequestConfig]
         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::DialogflowV2::GoogleCloudDialogflowV2SessionEntityType>]
         attr_accessor :session_entity_types
       
-        # 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.
@@ -3156,7 +3013,7 @@ module Google
       class GoogleCloudDialogflowV2SentimentAnalysisRequestConfig
         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`
@@ -3217,7 +3074,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`
@@ -3438,56 +3299,6 @@ module Google
         end
       end
       
-      # Represents an agent version.
-      class GoogleCloudDialogflowV2Version
-        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 GoogleCloudDialogflowV2VoiceSelectionParams
         include Google::Apis::Core::Hashable
@@ -3603,28 +3414,18 @@ module Google
         # @return [Array<Google::Apis::DialogflowV2::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
@@ -3769,7 +3570,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`
@@ -3794,9 +3595,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
@@ -3926,7 +3736,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
@@ -4004,6 +3814,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
@@ -4230,9 +4041,7 @@ module Google
         # @return [Google::Apis::DialogflowV2::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
@@ -4906,18 +4715,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::DialogflowV2::GoogleCloudDialogflowV2beta1IntentMessageRbmCardContentRbmMedia]
         attr_accessor :media
@@ -4948,18 +4757,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
       
@@ -5881,7 +5690,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"
@@ -6262,28 +6072,18 @@ module Google
         # @return [Array<Google::Apis::DialogflowV2::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