google-api-client 0.36.0 → 0.37.0

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

@@ -209,7 +209,7 @@ module Google
       class GoogleCloudDialogflowV2BatchDeleteEntitiesRequest
         include Google::Apis::Core::Hashable
       
-        # Required. The canonical `values` of the entities to delete. Note that
+        # Required. The reference `values` of the entities to delete. Note that
         # these are not fully-qualified names, i.e. they don't start with
         # `projects/<Project ID>`.
         # Corresponds to the JSON property `entityValues`
@@ -462,6 +462,11 @@ module Google
         # `projects/<Project ID>/agent/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.
+        # 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__`
+        # * `*_id_dialog_context`
+        # * `*_dialog_params_size`
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -531,6 +536,8 @@ module Google
         end
       end
       
+      # ============================================================================
+      # Requests and responses for custom methods.
       # The request to detect user's intent.
       class GoogleCloudDialogflowV2DetectIntentRequest
         include Google::Apis::Core::Hashable
@@ -544,6 +551,8 @@ module Google
         attr_accessor :input_audio
       
         # Instructs the speech synthesizer on how to generate the output audio content.
+        # If this audio config is supplied in a request, it overrides all existing
+        # text-to-speech settings applied to the agent.
         # Corresponds to the JSON property `outputAudioConfig`
         # @return [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2OutputAudioConfig]
         attr_accessor :output_audio_config
@@ -591,6 +600,8 @@ module Google
         attr_accessor :output_audio
       
         # Instructs the speech synthesizer on how to generate the output audio content.
+        # If this audio config is supplied in a request, it overrides all existing
+        # text-to-speech settings applied to the agent.
         # Corresponds to the JSON property `outputAudioConfig`
         # @return [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2OutputAudioConfig]
         attr_accessor :output_audio_config
@@ -722,7 +733,7 @@ module Google
         # For example, if the entity type is *vegetable*, the value could be
         # *scallions*.
         # For `KIND_MAP` entity types:
-        # *   A canonical value to be used in place of synonyms.
+        # *   A reference value to be used in place of synonyms.
         # For `KIND_LIST` entity types:
         # *   A string that can contain references to other entity types (with or
         # without aliases).
@@ -741,6 +752,123 @@ 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.
@@ -828,6 +956,126 @@ module Google
         end
       end
       
+      # Represents a fulfillment.
+      class GoogleCloudDialogflowV2Fulfillment
+        include Google::Apis::Core::Hashable
+      
+        # Optional. The human-readable name of the fulfillment, unique within the agent.
+        # Corresponds to the JSON property `displayName`
+        # @return [String]
+        attr_accessor :display_name
+      
+        # Optional. Whether fulfillment is enabled.
+        # Corresponds to the JSON property `enabled`
+        # @return [Boolean]
+        attr_accessor :enabled
+        alias_method :enabled?, :enabled
+      
+        # Optional. The field defines whether the fulfillment is enabled for certain
+        # features.
+        # Corresponds to the JSON property `features`
+        # @return [Array<Google::Apis::DialogflowV2::GoogleCloudDialogflowV2FulfillmentFeature>]
+        attr_accessor :features
+      
+        # Represents configuration for a generic web service.
+        # Dialogflow supports two mechanisms for authentications:
+        # - Basic authentication with username and password.
+        # - Authentication with additional authentication headers.
+        # More information could be found at:
+        # https://cloud.google.com/dialogflow/docs/fulfillment-configure.
+        # Corresponds to the JSON property `genericWebService`
+        # @return [Google::Apis::DialogflowV2::GoogleCloudDialogflowV2FulfillmentGenericWebService]
+        attr_accessor :generic_web_service
+      
+        # Required. The unique identifier of the fulfillment.
+        # Format: `projects/<Project ID>/agent/fulfillment`.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @display_name = args[:display_name] if args.key?(:display_name)
+          @enabled = args[:enabled] if args.key?(:enabled)
+          @features = args[:features] if args.key?(:features)
+          @generic_web_service = args[:generic_web_service] if args.key?(:generic_web_service)
+          @name = args[:name] if args.key?(:name)
+        end
+      end
+      
+      # Whether fulfillment is enabled for the specific feature.
+      class GoogleCloudDialogflowV2FulfillmentFeature
+        include Google::Apis::Core::Hashable
+      
+        # The type of the feature that enabled for fulfillment.
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @type = args[:type] if args.key?(:type)
+        end
+      end
+      
+      # Represents configuration for a generic web service.
+      # Dialogflow supports two mechanisms for authentications:
+      # - Basic authentication with username and password.
+      # - Authentication with additional authentication headers.
+      # More information could be found at:
+      # https://cloud.google.com/dialogflow/docs/fulfillment-configure.
+      class GoogleCloudDialogflowV2FulfillmentGenericWebService
+        include Google::Apis::Core::Hashable
+      
+        # Optional. Indicates if generic web service is created through Cloud Functions
+        # integration. Defaults to false.
+        # Corresponds to the JSON property `isCloudFunction`
+        # @return [Boolean]
+        attr_accessor :is_cloud_function
+        alias_method :is_cloud_function?, :is_cloud_function
+      
+        # Optional. The password for HTTP Basic authentication.
+        # Corresponds to the JSON property `password`
+        # @return [String]
+        attr_accessor :password
+      
+        # Optional. The HTTP request headers to send together with fulfillment requests.
+        # Corresponds to the JSON property `requestHeaders`
+        # @return [Hash<String,String>]
+        attr_accessor :request_headers
+      
+        # Required. The fulfillment URI for receiving POST requests.
+        # Corresponds to the JSON property `uri`
+        # @return [String]
+        attr_accessor :uri
+      
+        # Optional. The user name for HTTP Basic authentication.
+        # Corresponds to the JSON property `username`
+        # @return [String]
+        attr_accessor :username
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @is_cloud_function = args[:is_cloud_function] if args.key?(:is_cloud_function)
+          @password = args[:password] if args.key?(:password)
+          @request_headers = args[:request_headers] if args.key?(:request_headers)
+          @uri = args[:uri] if args.key?(:uri)
+          @username = args[:username] if args.key?(:username)
+        end
+      end
+      
       # The request message for Agents.ImportAgent.
       class GoogleCloudDialogflowV2ImportAgentRequest
         include Google::Apis::Core::Hashable
@@ -864,6 +1112,15 @@ module Google
         # @return [String]
         attr_accessor :audio_encoding
       
+        # Optional. 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.
+        # Corresponds to the JSON property `enableWordInfo`
+        # @return [Boolean]
+        attr_accessor :enable_word_info
+        alias_method :enable_word_info?, :enable_word_info
+      
         # Required. The language of the supplied audio. Dialogflow does not do
         # translations. See [Language
         # Support](https://cloud.google.com/dialogflow/docs/reference/language)
@@ -873,6 +1130,22 @@ module Google
         # @return [String]
         attr_accessor :language_code
       
+        # Optional. 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.
+        # If enhanced speech model is enabled for the agent and an enhanced
+        # version of the specified model for the language does not exist, then the
+        # speech is recognized using the standard version of the specified model.
+        # Refer to
+        # [Cloud Speech API
+        # documentation](https://cloud.google.com/speech-to-text/docs/basics#select-
+        # model)
+        # for more details.
+        # Corresponds to the JSON property `model`
+        # @return [String]
+        attr_accessor :model
+      
         # Optional. Which variant of the Speech model to use.
         # Corresponds to the JSON property `modelVariant`
         # @return [String]
@@ -884,6 +1157,9 @@ module Google
         # documentation](https://cloud.google.com/speech-to-text/docs/basics#phrase-
         # hints)
         # for more details.
+        # This field is deprecated. Please use [speech_contexts]() instead. If you
+        # specify both [phrase_hints]() and [speech_contexts](), Dialogflow will
+        # treat the [phrase_hints]() as a single additional [SpeechContext]().
         # Corresponds to the JSON property `phraseHints`
         # @return [Array<String>]
         attr_accessor :phrase_hints
@@ -912,6 +1188,15 @@ module Google
         attr_accessor :single_utterance
         alias_method :single_utterance?, :single_utterance
       
+        # Optional. Context information to assist speech recognition.
+        # See [the Cloud Speech
+        # documentation](https://cloud.google.com/speech-to-text/docs/basics#phrase-
+        # hints)
+        # for more details.
+        # Corresponds to the JSON property `speechContexts`
+        # @return [Array<Google::Apis::DialogflowV2::GoogleCloudDialogflowV2SpeechContext>]
+        attr_accessor :speech_contexts
+      
         def initialize(**args)
            update!(**args)
         end
@@ -919,11 +1204,14 @@ module Google
         # Update properties of this object
         def update!(**args)
           @audio_encoding = args[:audio_encoding] if args.key?(:audio_encoding)
+          @enable_word_info = args[:enable_word_info] if args.key?(:enable_word_info)
           @language_code = args[:language_code] if args.key?(:language_code)
+          @model = args[:model] if args.key?(:model)
           @model_variant = args[:model_variant] if args.key?(:model_variant)
           @phrase_hints = args[:phrase_hints] if args.key?(:phrase_hints)
           @sample_rate_hertz = args[:sample_rate_hertz] if args.key?(:sample_rate_hertz)
           @single_utterance = args[:single_utterance] if args.key?(:single_utterance)
+          @speech_contexts = args[:speech_contexts] if args.key?(:speech_contexts)
         end
       end
       
@@ -983,7 +1271,7 @@ module Google
         attr_accessor :messages
       
         # Optional. Indicates whether Machine Learning is disabled for the intent.
-        # Note: If `ml_diabled` setting is set to true, then this intent is not
+        # Note: If `ml_disabled` setting is set to true, then this intent is not
         # taken into account during inference in `ML ONLY` match mode. Also,
         # auto-markup in the UI is turned off.
         # Corresponds to the JSON property `mlDisabled`
@@ -1015,8 +1303,9 @@ module Google
       
         # Read-only after creation. The unique identifier of the parent intent in the
         # chain of followup intents. You can set this field when creating an intent,
-        # for example with CreateIntent or BatchUpdateIntents, in order to
-        # make this intent a followup intent.
+        # for example with CreateIntent or
+        # BatchUpdateIntents, in order to make this
+        # intent a followup intent.
         # It identifies the parent followup intent.
         # Format: `projects/<Project ID>/agent/intents/<Intent ID>`.
         # Corresponds to the JSON property `parentFollowupIntentName`
@@ -2251,6 +2540,33 @@ 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
@@ -2305,6 +2621,33 @@ 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
@@ -2438,6 +2781,8 @@ module Google
       end
       
       # Instructs the speech synthesizer on how to generate the output audio content.
+      # If this audio config is supplied in a request, it overrides all existing
+      # text-to-speech settings applied to the agent.
       class GoogleCloudDialogflowV2OutputAudioConfig
         include Google::Apis::Core::Hashable
       
@@ -2598,9 +2943,12 @@ module Google
         attr_accessor :all_required_params_present
         alias_method :all_required_params_present?, :all_required_params_present
       
-        # The free-form diagnostic info. For example, this field could contain
-        # webhook call latency. The string keys of the Struct's fields map can change
-        # without notice.
+        # Free-form diagnostic information for the associated detect intent request.
+        # The fields of this data can change without notice, so you should not write
+        # code that depends on its structure.
+        # The data may contain:
+        # - webhook call latency
+        # - webhook errors
         # Corresponds to the JSON property `diagnosticInfo`
         # @return [Hash<String,Object>]
         attr_accessor :diagnostic_info
@@ -2848,8 +3196,8 @@ module Google
       end
       
       # Represents a session entity type.
-      # Extends or replaces a developer entity type at the user session level (we
-      # refer to the entity types defined at the agent level as "developer entity
+      # 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.
       class GoogleCloudDialogflowV2SessionEntityType
@@ -2862,7 +3210,7 @@ module Google
         attr_accessor :entities
       
         # Required. Indicates whether the additional data should override or
-        # supplement the developer entity type definition.
+        # supplement the custom entity type definition.
         # Corresponds to the JSON property `entityOverrideMode`
         # @return [String]
         attr_accessor :entity_override_mode
@@ -2888,6 +3236,47 @@ module Google
         end
       end
       
+      # Hints for the speech recognizer to help with recognition in a specific
+      # conversation state.
+      class GoogleCloudDialogflowV2SpeechContext
+        include Google::Apis::Core::Hashable
+      
+        # Optional. Boost for this context compared to other contexts:
+        # * If the boost is positive, Dialogflow will increase the probability that
+        # the phrases in this context are recognized over similar sounding phrases.
+        # * If the boost is unspecified or non-positive, Dialogflow will not apply
+        # any boost.
+        # Dialogflow recommends that you use boosts in the range (0, 20] and that you
+        # find a value that fits your use case with binary search.
+        # Corresponds to the JSON property `boost`
+        # @return [Float]
+        attr_accessor :boost
+      
+        # Optional. A list of strings containing words and phrases that the speech
+        # recognizer should recognize with higher likelihood.
+        # This list can be used to:
+        # * improve accuracy for words and phrases you expect the user to say,
+        # e.g. typical commands for your Dialogflow agent
+        # * add additional words to the speech recognizer vocabulary
+        # * ...
+        # See the [Cloud Speech
+        # documentation](https://cloud.google.com/speech-to-text/quotas) for usage
+        # limits.
+        # Corresponds to the JSON property `phrases`
+        # @return [Array<String>]
+        attr_accessor :phrases
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @boost = args[:boost] if args.key?(:boost)
+          @phrases = args[:phrases] if args.key?(:phrases)
+        end
+      end
+      
       # Configuration of how speech should be synthesized.
       class GoogleCloudDialogflowV2SynthesizeSpeechConfig
         include Google::Apis::Core::Hashable
@@ -2987,6 +3376,118 @@ module Google
         end
       end
       
+      # Represents a single validation error.
+      class GoogleCloudDialogflowV2ValidationError
+        include Google::Apis::Core::Hashable
+      
+        # The names of the entries that the error is associated with.
+        # Format:
+        # - "projects/<Project ID>/agent", if the error is associated with the entire
+        # agent.
+        # - "projects/<Project ID>/agent/intents/<Intent ID>", if the error is
+        # associated with certain intents.
+        # - "projects/<Project
+        # ID>/agent/intents/<Intent Id>/trainingPhrases/<Training Phrase ID>", if the
+        # error is associated with certain intent training phrases.
+        # - "projects/<Project ID>/agent/intents/<Intent Id>/parameters/<Parameter
+        # ID>", if the error is associated with certain intent parameters.
+        # - "projects/<Project ID>/agent/entities/<Entity ID>", if the error is
+        # associated with certain entities.
+        # Corresponds to the JSON property `entries`
+        # @return [Array<String>]
+        attr_accessor :entries
+      
+        # The detailed error messsage.
+        # Corresponds to the JSON property `errorMessage`
+        # @return [String]
+        attr_accessor :error_message
+      
+        # The severity of the error.
+        # Corresponds to the JSON property `severity`
+        # @return [String]
+        attr_accessor :severity
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @entries = args[:entries] if args.key?(:entries)
+          @error_message = args[:error_message] if args.key?(:error_message)
+          @severity = args[:severity] if args.key?(:severity)
+        end
+      end
+      
+      # Represents the output of agent validation.
+      class GoogleCloudDialogflowV2ValidationResult
+        include Google::Apis::Core::Hashable
+      
+        # Contains all validation errors.
+        # Corresponds to the JSON property `validationErrors`
+        # @return [Array<Google::Apis::DialogflowV2::GoogleCloudDialogflowV2ValidationError>]
+        attr_accessor :validation_errors
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @validation_errors = args[:validation_errors] if args.key?(:validation_errors)
+        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
@@ -3062,6 +3563,16 @@ module Google
       end
       
       # The response message for a webhook call.
+      # This response is validated by the Dialogflow server. If validation fails,
+      # an error will be returned in the QueryResult.diagnostic_info field.
+      # Setting JSON fields to an empty value with the wrong type is a common error.
+      # To avoid this error:
+      # - Use `""` for empty strings
+      # - Use ```` or `null` for empty objects
+      # - Use `[]` or `null` for empty arrays
+      # For more information, see the
+      # [Protocol Buffers Language
+      # Guide](https://developers.google.com/protocol-buffers/docs/proto3#json).
       class GoogleCloudDialogflowV2WebhookResponse
         include Google::Apis::Core::Hashable
       
@@ -3273,6 +3784,11 @@ module Google
         # 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__`
+        # * `*_id_dialog_context`
+        # * `*_dialog_params_size`
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -3370,7 +3886,7 @@ module Google
         # For example, if the entity type is *vegetable*, the value could be
         # *scallions*.
         # For `KIND_MAP` entity types:
-        # *   A canonical value to be used in place of synonyms.
+        # *   A reference value to be used in place of synonyms.
         # For `KIND_LIST` entity types:
         # *   A string that can contain references to other entity types (with or
         # without aliases).
@@ -3566,8 +4082,9 @@ module Google
       
         # Read-only after creation. The unique identifier of the parent intent in the
         # chain of followup intents. You can set this field when creating an intent,
-        # for example with CreateIntent or BatchUpdateIntents, in order to
-        # make this intent a followup intent.
+        # for example with CreateIntent or
+        # BatchUpdateIntents, in order to make this
+        # intent a followup intent.
         # It identifies the parent followup intent.
         # Format: `projects/<Project ID>/agent/intents/<Intent ID>`.
         # Corresponds to the JSON property `parentFollowupIntentName`
@@ -5333,7 +5850,7 @@ module Google
       end
       
       # The response for
-      # ConversationDatasets.LabelConversation
+      # ConversationDatasets.LabelConversation.
       class GoogleCloudDialogflowV2beta1LabelConversationResponse
         include Google::Apis::Core::Hashable
       
@@ -5420,9 +5937,12 @@ module Google
         attr_accessor :all_required_params_present
         alias_method :all_required_params_present?, :all_required_params_present
       
-        # The free-form diagnostic info. For example, this field could contain
-        # webhook call latency. The string keys of the Struct's fields map can change
-        # without notice.
+        # Free-form diagnostic information for the associated detect intent request.
+        # The fields of this data can change without notice, so you should not write
+        # code that depends on its structure.
+        # The data may contain:
+        # - webhook call latency
+        # - webhook errors
         # Corresponds to the JSON property `diagnosticInfo`
         # @return [Hash<String,Object>]
         attr_accessor :diagnostic_info
@@ -5600,8 +6120,8 @@ module Google
       end
       
       # Represents a session entity type.
-      # Extends or replaces a developer entity type at the user session level (we
-      # refer to the entity types defined at the agent level as "developer entity
+      # 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.
       class GoogleCloudDialogflowV2beta1SessionEntityType
@@ -5614,7 +6134,7 @@ module Google
         attr_accessor :entities
       
         # Required. Indicates whether the additional data should override or
-        # supplement the developer entity type definition.
+        # supplement the custom entity type definition.
         # Corresponds to the JSON property `entityOverrideMode`
         # @return [String]
         attr_accessor :entity_override_mode
@@ -5694,6 +6214,16 @@ module Google
       end
       
       # The response message for a webhook call.
+      # This response is validated by the Dialogflow server. If validation fails,
+      # an error will be returned in the QueryResult.diagnostic_info field.
+      # Setting JSON fields to an empty value with the wrong type is a common error.
+      # To avoid this error:
+      # - Use `""` for empty strings
+      # - Use ```` or `null` for empty objects
+      # - Use `[]` or `null` for empty arrays
+      # For more information, see the
+      # [Protocol Buffers Language
+      # Guide](https://developers.google.com/protocol-buffers/docs/proto3#json).
       class GoogleCloudDialogflowV2beta1WebhookResponse
         include Google::Apis::Core::Hashable