google-apis-dialogflow_v3 0.18.0 → 0.22.0

data/lib/google/apis/dialogflow_v3/classes.rb

@@ -22,6 +22,54 @@ module Google
   module Apis
     module DialogflowV3
       
+      # Hierarchical advanced settings for agent/flow/page/fulfillment/parameter.
+      # Settings exposed at lower level overrides the settings exposed at higher level.
+      # Hierarchy: Agent->Flow->Page->Fulfillment/Parameter.
+      class GoogleCloudDialogflowCxV3AdvancedSettings
+        include Google::Apis::Core::Hashable
+      
+        # Define behaviors on logging.
+        # Corresponds to the JSON property `loggingSettings`
+        # @return [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3AdvancedSettingsLoggingSettings]
+        attr_accessor :logging_settings
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @logging_settings = args[:logging_settings] if args.key?(:logging_settings)
+        end
+      end
+      
+      # Define behaviors on logging.
+      class GoogleCloudDialogflowCxV3AdvancedSettingsLoggingSettings
+        include Google::Apis::Core::Hashable
+      
+        # If true, DF Interaction logging is currently enabled.
+        # Corresponds to the JSON property `enableInteractionLogging`
+        # @return [Boolean]
+        attr_accessor :enable_interaction_logging
+        alias_method :enable_interaction_logging?, :enable_interaction_logging
+      
+        # If true, StackDriver logging is currently enabled.
+        # Corresponds to the JSON property `enableStackdriverLogging`
+        # @return [Boolean]
+        attr_accessor :enable_stackdriver_logging
+        alias_method :enable_stackdriver_logging?, :enable_stackdriver_logging
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @enable_interaction_logging = args[:enable_interaction_logging] if args.key?(:enable_interaction_logging)
+          @enable_stackdriver_logging = args[:enable_stackdriver_logging] if args.key?(:enable_stackdriver_logging)
+        end
+      end
+      
       # Agents are best described as Natural Language Understanding (NLU) modules that
       # transform user requests into actionable data. You can include agents in your
       # app, product, or service to determine user intent and respond to the user in a
@@ -30,6 +78,13 @@ module Google
       class GoogleCloudDialogflowCxV3Agent
         include Google::Apis::Core::Hashable
       
+        # Hierarchical advanced settings for agent/flow/page/fulfillment/parameter.
+        # Settings exposed at lower level overrides the settings exposed at higher level.
+        # Hierarchy: Agent->Flow->Page->Fulfillment/Parameter.
+        # Corresponds to the JSON property `advancedSettings`
+        # @return [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3AdvancedSettings]
+        attr_accessor :advanced_settings
+      
         # The URI of the agent's avatar. Avatars are used throughout the Dialogflow
         # console and in the self-hosted [Web Demo](https://cloud.google.com/dialogflow/
         # docs/integrations/web-demo) integration.
@@ -62,7 +117,8 @@ module Google
         attr_accessor :enable_spell_correction
         alias_method :enable_spell_correction?, :enable_spell_correction
       
-        # Indicates if stackdriver logging is enabled for the agent.
+        # Indicates if stackdriver logging is enabled for the agent. Please use agent.
+        # advanced_settings instead.
         # Corresponds to the JSON property `enableStackdriverLogging`
         # @return [Boolean]
         attr_accessor :enable_stackdriver_logging
@@ -111,6 +167,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @advanced_settings = args[:advanced_settings] if args.key?(:advanced_settings)
           @avatar_uri = args[:avatar_uri] if args.key?(:avatar_uri)
           @default_language_code = args[:default_language_code] if args.key?(:default_language_code)
           @description = args[:description] if args.key?(:description)
@@ -310,6 +367,123 @@ module Google
         end
       end
       
+      # Changelogs represents a change made to a given agent.
+      class GoogleCloudDialogflowCxV3Changelog
+        include Google::Apis::Core::Hashable
+      
+        # The action of the change.
+        # Corresponds to the JSON property `action`
+        # @return [String]
+        attr_accessor :action
+      
+        # The timestamp of the change.
+        # Corresponds to the JSON property `createTime`
+        # @return [String]
+        attr_accessor :create_time
+      
+        # The affected resource display name of the change.
+        # Corresponds to the JSON property `displayName`
+        # @return [String]
+        attr_accessor :display_name
+      
+        # The unique identifier of the changelog. Format: `projects//locations//agents//
+        # changelogs/`.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # The affected resource name of the change.
+        # Corresponds to the JSON property `resource`
+        # @return [String]
+        attr_accessor :resource
+      
+        # The affected resource type.
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+      
+        # Email address of the authenticated user.
+        # Corresponds to the JSON property `userEmail`
+        # @return [String]
+        attr_accessor :user_email
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @action = args[:action] if args.key?(:action)
+          @create_time = args[:create_time] if args.key?(:create_time)
+          @display_name = args[:display_name] if args.key?(:display_name)
+          @name = args[:name] if args.key?(:name)
+          @resource = args[:resource] if args.key?(:resource)
+          @type = args[:type] if args.key?(:type)
+          @user_email = args[:user_email] if args.key?(:user_email)
+        end
+      end
+      
+      # The request message for Versions.CompareVersions.
+      class GoogleCloudDialogflowCxV3CompareVersionsRequest
+        include Google::Apis::Core::Hashable
+      
+        # The language to compare the flow versions for. 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.
+        # Corresponds to the JSON property `languageCode`
+        # @return [String]
+        attr_accessor :language_code
+      
+        # Required. Name of the target flow version to compare with the base version.
+        # Use version ID `0` to indicate the draft version of the specified flow. Format:
+        # `projects//locations//agents//flows//versions/`.
+        # Corresponds to the JSON property `targetVersion`
+        # @return [String]
+        attr_accessor :target_version
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @language_code = args[:language_code] if args.key?(:language_code)
+          @target_version = args[:target_version] if args.key?(:target_version)
+        end
+      end
+      
+      # The response message for Versions.CompareVersions.
+      class GoogleCloudDialogflowCxV3CompareVersionsResponse
+        include Google::Apis::Core::Hashable
+      
+        # JSON representation of the base version content.
+        # Corresponds to the JSON property `baseVersionContentJson`
+        # @return [String]
+        attr_accessor :base_version_content_json
+      
+        # The timestamp when the two version compares.
+        # Corresponds to the JSON property `compareTime`
+        # @return [String]
+        attr_accessor :compare_time
+      
+        # JSON representation of the target version content.
+        # Corresponds to the JSON property `targetVersionContentJson`
+        # @return [String]
+        attr_accessor :target_version_content_json
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @base_version_content_json = args[:base_version_content_json] if args.key?(:base_version_content_json)
+          @compare_time = args[:compare_time] if args.key?(:compare_time)
+          @target_version_content_json = args[:target_version_content_json] if args.key?(:target_version_content_json)
+        end
+      end
+      
       # Represents a result from running a test case in an agent environment.
       class GoogleCloudDialogflowCxV3ContinuousTestResult
         include Google::Apis::Core::Hashable
@@ -439,7 +613,8 @@ module Google
         # @return [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Page]
         attr_accessor :current_page
       
-        # Required. Input only. The diagnostic info output for the turn.
+        # Required. Input only. The diagnostic info output for the turn. Required to
+        # calculate the testing coverage.
         # Corresponds to the JSON property `diagnosticInfo`
         # @return [Hash<String,Object>]
         attr_accessor :diagnostic_info
@@ -552,6 +727,158 @@ module Google
         end
       end
       
+      # Metadata returned for the Environments.DeployFlow long running operation.
+      class GoogleCloudDialogflowCxV3DeployFlowMetadata
+        include Google::Apis::Core::Hashable
+      
+        # Errors of running deployment tests.
+        # Corresponds to the JSON property `testErrors`
+        # @return [Array<Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3TestError>]
+        attr_accessor :test_errors
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @test_errors = args[:test_errors] if args.key?(:test_errors)
+        end
+      end
+      
+      # The request message for Environments.DeployFlow.
+      class GoogleCloudDialogflowCxV3DeployFlowRequest
+        include Google::Apis::Core::Hashable
+      
+        # Required. The flow version to deploy. Format: `projects//locations//agents//
+        # flows//versions/`.
+        # Corresponds to the JSON property `flowVersion`
+        # @return [String]
+        attr_accessor :flow_version
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @flow_version = args[:flow_version] if args.key?(:flow_version)
+        end
+      end
+      
+      # The response message for Environments.DeployFlow.
+      class GoogleCloudDialogflowCxV3DeployFlowResponse
+        include Google::Apis::Core::Hashable
+      
+        # The name of the flow version Deployment. Format: `projects//locations//agents//
+        # environments//deployments/`.
+        # Corresponds to the JSON property `deployment`
+        # @return [String]
+        attr_accessor :deployment
+      
+        # Represents an environment for an agent. You can create multiple versions of
+        # your agent and publish them to separate environments. When you edit an agent,
+        # you are editing the draft agent. At any point, you can save the draft agent as
+        # an agent version, which is an immutable snapshot of your agent. When you save
+        # the draft agent, it is published to the default environment. When you create
+        # agent versions, you can publish them to custom environments. You can create a
+        # variety of custom environments for testing, development, production, etc.
+        # Corresponds to the JSON property `environment`
+        # @return [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Environment]
+        attr_accessor :environment
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @deployment = args[:deployment] if args.key?(:deployment)
+          @environment = args[:environment] if args.key?(:environment)
+        end
+      end
+      
+      # Represents an deployment in an environment. A deployment happens when a flow
+      # version configured to be active in the environment. You can configure running
+      # pre-deployment steps, e.g. running validation test cases, experiment auto-
+      # rollout, etc.
+      class GoogleCloudDialogflowCxV3Deployment
+        include Google::Apis::Core::Hashable
+      
+        # End time of this deployment.
+        # Corresponds to the JSON property `endTime`
+        # @return [String]
+        attr_accessor :end_time
+      
+        # The name of the flow version for this deployment. Format: projects//locations//
+        # agents//flows//versions/.
+        # Corresponds to the JSON property `flowVersion`
+        # @return [String]
+        attr_accessor :flow_version
+      
+        # The name of the deployment. Format: projects//locations//agents//environments//
+        # deployments/.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Result of the deployment.
+        # Corresponds to the JSON property `result`
+        # @return [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3DeploymentResult]
+        attr_accessor :result
+      
+        # Start time of this deployment.
+        # Corresponds to the JSON property `startTime`
+        # @return [String]
+        attr_accessor :start_time
+      
+        # The current state of the deployment.
+        # Corresponds to the JSON property `state`
+        # @return [String]
+        attr_accessor :state
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @end_time = args[:end_time] if args.key?(:end_time)
+          @flow_version = args[:flow_version] if args.key?(:flow_version)
+          @name = args[:name] if args.key?(:name)
+          @result = args[:result] if args.key?(:result)
+          @start_time = args[:start_time] if args.key?(:start_time)
+          @state = args[:state] if args.key?(:state)
+        end
+      end
+      
+      # Result of the deployment.
+      class GoogleCloudDialogflowCxV3DeploymentResult
+        include Google::Apis::Core::Hashable
+      
+        # Results of test cases running before the deployment. Format: `projects//
+        # locations//agents//testCases//results/`.
+        # Corresponds to the JSON property `deploymentTestResults`
+        # @return [Array<String>]
+        attr_accessor :deployment_test_results
+      
+        # The name of the experiment triggered by this deployment. Format: projects//
+        # locations//agents//environments//experiments/.
+        # Corresponds to the JSON property `experiment`
+        # @return [String]
+        attr_accessor :experiment
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @deployment_test_results = args[:deployment_test_results] if args.key?(:deployment_test_results)
+          @experiment = args[:experiment] if args.key?(:experiment)
+        end
+      end
+      
       # The request to detect user's intent.
       class GoogleCloudDialogflowCxV3DetectIntentRequest
         include Google::Apis::Core::Hashable
@@ -838,6 +1165,11 @@ module Google
         # @return [String]
         attr_accessor :name
       
+        # The configuration for continuous tests.
+        # Corresponds to the JSON property `testCasesConfig`
+        # @return [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3EnvironmentTestCasesConfig]
+        attr_accessor :test_cases_config
+      
         # Output only. Update time of this environment.
         # Corresponds to the JSON property `updateTime`
         # @return [String]
@@ -859,11 +1191,48 @@ module Google
           @description = args[:description] if args.key?(:description)
           @display_name = args[:display_name] if args.key?(:display_name)
           @name = args[:name] if args.key?(:name)
+          @test_cases_config = args[:test_cases_config] if args.key?(:test_cases_config)
           @update_time = args[:update_time] if args.key?(:update_time)
           @version_configs = args[:version_configs] if args.key?(:version_configs)
         end
       end
       
+      # The configuration for continuous tests.
+      class GoogleCloudDialogflowCxV3EnvironmentTestCasesConfig
+        include Google::Apis::Core::Hashable
+      
+        # Whether to run test cases in TestCasesConfig.test_cases periodically. Default
+        # false. If set to ture, run once a day.
+        # Corresponds to the JSON property `enableContinuousRun`
+        # @return [Boolean]
+        attr_accessor :enable_continuous_run
+        alias_method :enable_continuous_run?, :enable_continuous_run
+      
+        # Whether to run test cases in TestCasesConfig.test_cases before deploying a
+        # flow version to the environment. Default false.
+        # Corresponds to the JSON property `enablePredeploymentRun`
+        # @return [Boolean]
+        attr_accessor :enable_predeployment_run
+        alias_method :enable_predeployment_run?, :enable_predeployment_run
+      
+        # A list of test case names to run. They should be under the same agent. Format
+        # of each test case name: `projects//locations/ /agents//testCases/`
+        # Corresponds to the JSON property `testCases`
+        # @return [Array<String>]
+        attr_accessor :test_cases
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @enable_continuous_run = args[:enable_continuous_run] if args.key?(:enable_continuous_run)
+          @enable_predeployment_run = args[:enable_predeployment_run] if args.key?(:enable_predeployment_run)
+          @test_cases = args[:test_cases] if args.key?(:test_cases)
+        end
+      end
+      
       # Configuration for the version.
       class GoogleCloudDialogflowCxV3EnvironmentVersionConfig
         include Google::Apis::Core::Hashable
@@ -988,11 +1357,9 @@ module Google
         # @return [String]
         attr_accessor :end_time
       
-        # LINT.IfChange(default_experiment_length) Maximum number of days to run the
-        # experiment/rollout. If auto-rollout is not enabled, default value and maximum
-        # will be 30 days. If auto-rollout is enabled, default value and maximum will be
-        # 6 days. LINT.ThenChange(//depot/google3/cloud/ml/api/conversation/analytics/
-        # compute.cc:default_experiment_length)
+        # Maximum number of days to run the experiment/rollout. If auto-rollout is not
+        # enabled, default value and maximum will be 30 days. If auto-rollout is enabled,
+        # default value and maximum will be 6 days.
         # Corresponds to the JSON property `experimentLength`
         # @return [String]
         attr_accessor :experiment_length
@@ -1014,6 +1381,22 @@ module Google
         # @return [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3ExperimentResult]
         attr_accessor :result
       
+        # The configuration for auto rollout.
+        # Corresponds to the JSON property `rolloutConfig`
+        # @return [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3RolloutConfig]
+        attr_accessor :rollout_config
+      
+        # The reason why rollout has failed. Should only be set when state is
+        # ROLLOUT_FAILED.
+        # Corresponds to the JSON property `rolloutFailureReason`
+        # @return [String]
+        attr_accessor :rollout_failure_reason
+      
+        # State of the auto-rollout process.
+        # Corresponds to the JSON property `rolloutState`
+        # @return [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3RolloutState]
+        attr_accessor :rollout_state
+      
         # Start time of this experiment.
         # Corresponds to the JSON property `startTime`
         # @return [String]
@@ -1046,6 +1429,9 @@ module Google
           @last_update_time = args[:last_update_time] if args.key?(:last_update_time)
           @name = args[:name] if args.key?(:name)
           @result = args[:result] if args.key?(:result)
+          @rollout_config = args[:rollout_config] if args.key?(:rollout_config)
+          @rollout_failure_reason = args[:rollout_failure_reason] if args.key?(:rollout_failure_reason)
+          @rollout_state = args[:rollout_state] if args.key?(:rollout_state)
           @start_time = args[:start_time] if args.key?(:start_time)
           @state = args[:state] if args.key?(:state)
           @variants_history = args[:variants_history] if args.key?(:variants_history)
@@ -1336,6 +1722,7 @@ module Google
       end
       
       # Metadata returned for the TestCases.ExportTestCases long running operation.
+      # This message currently has no fields.
       class GoogleCloudDialogflowCxV3ExportTestCasesMetadata
         include Google::Apis::Core::Hashable
       
@@ -2470,6 +2857,34 @@ module Google
         end
       end
       
+      # The response message for Changelogs.ListChangelogs.
+      class GoogleCloudDialogflowCxV3ListChangelogsResponse
+        include Google::Apis::Core::Hashable
+      
+        # The list of changelogs. There will be a maximum number of items returned based
+        # on the page_size field in the request. The changelogs will be ordered by
+        # timestamp.
+        # Corresponds to the JSON property `changelogs`
+        # @return [Array<Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Changelog>]
+        attr_accessor :changelogs
+      
+        # 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)
+          @changelogs = args[:changelogs] if args.key?(:changelogs)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+        end
+      end
+      
       # The response message for Environments.ListTestCaseResults.
       class GoogleCloudDialogflowCxV3ListContinuousTestResultsResponse
         include Google::Apis::Core::Hashable
@@ -2496,6 +2911,34 @@ module Google
         end
       end
       
+      # The response message for Deployments.ListDeployments.
+      class GoogleCloudDialogflowCxV3ListDeploymentsResponse
+        include Google::Apis::Core::Hashable
+      
+        # The list of deployments. There will be a maximum number of items returned
+        # based on the page_size field in the request. The list may in some cases be
+        # empty or contain fewer entries than page_size even if this isn't the last page.
+        # Corresponds to the JSON property `deployments`
+        # @return [Array<Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3Deployment>]
+        attr_accessor :deployments
+      
+        # 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)
+          @deployments = args[:deployments] if args.key?(:deployments)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+        end
+      end
+      
       # The response message for EntityTypes.ListEntityTypes.
       class GoogleCloudDialogflowCxV3ListEntityTypesResponse
         include Google::Apis::Core::Hashable
@@ -3408,6 +3851,15 @@ module Google
         attr_accessor :disable_webhook
         alias_method :disable_webhook?, :disable_webhook
       
+        # A list of flow versions to override for the request. Format: `projects//
+        # locations//agents//flows//versions/`. If version 1 of flow X is included in
+        # this list, the traffic of flow X will go through version 1 regardless of the
+        # version configuration in the environment. Each flow can have at most one
+        # version specified in this list.
+        # Corresponds to the JSON property `flowVersions`
+        # @return [Array<String>]
+        attr_accessor :flow_versions
+      
         # An object that represents a latitude/longitude pair. This is expressed as a
         # pair of doubles to represent degrees latitude and degrees longitude. Unless
         # specified otherwise, this object must conform to the WGS84 standard. Values
@@ -3475,6 +3927,7 @@ module Google
           @analyze_query_text_sentiment = args[:analyze_query_text_sentiment] if args.key?(:analyze_query_text_sentiment)
           @current_page = args[:current_page] if args.key?(:current_page)
           @disable_webhook = args[:disable_webhook] if args.key?(:disable_webhook)
+          @flow_versions = args[:flow_versions] if args.key?(:flow_versions)
           @geo_location = args[:geo_location] if args.key?(:geo_location)
           @parameters = args[:parameters] if args.key?(:parameters)
           @payload = args[:payload] if args.key?(:payload)
@@ -3511,6 +3964,11 @@ module Google
         # @return [Hash<String,Object>]
         attr_accessor :diagnostic_info
       
+        # Represents the input for dtmf event.
+        # Corresponds to the JSON property `dtmf`
+        # @return [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3DtmfInput]
+        attr_accessor :dtmf
+      
         # An intent represents a user's intent to interact with a conversational agent.
         # You can provide information for the Dialogflow API to use to match user input
         # to an intent by adding training phrases (i.e., examples of user input) to your
@@ -3611,6 +4069,7 @@ module Google
         def update!(**args)
           @current_page = args[:current_page] if args.key?(:current_page)
           @diagnostic_info = args[:diagnostic_info] if args.key?(:diagnostic_info)
+          @dtmf = args[:dtmf] if args.key?(:dtmf)
           @intent = args[:intent] if args.key?(:intent)
           @intent_detection_confidence = args[:intent_detection_confidence] if args.key?(:intent_detection_confidence)
           @language_code = args[:language_code] if args.key?(:language_code)
@@ -4010,6 +4469,109 @@ module Google
         end
       end
       
+      # The configuration for auto rollout.
+      class GoogleCloudDialogflowCxV3RolloutConfig
+        include Google::Apis::Core::Hashable
+      
+        # The conditions that are used to evaluate the failure of a rollout step. If not
+        # specified, no rollout steps will fail. E.g. "containment_rate < 10% OR
+        # average_turn_count < 3". See the [conditions reference](https://cloud.google.
+        # com/dialogflow/cx/docs/reference/condition).
+        # Corresponds to the JSON property `failureCondition`
+        # @return [String]
+        attr_accessor :failure_condition
+      
+        # The conditions that are used to evaluate the success of a rollout step. If not
+        # specified, all rollout steps will proceed to the next one unless failure
+        # conditions are met. E.g. "containment_rate > 60% AND callback_rate < 20%". See
+        # the [conditions reference](https://cloud.google.com/dialogflow/cx/docs/
+        # reference/condition).
+        # Corresponds to the JSON property `rolloutCondition`
+        # @return [String]
+        attr_accessor :rollout_condition
+      
+        # Steps to roll out a flow version. Steps should be sorted by percentage in
+        # ascending order.
+        # Corresponds to the JSON property `rolloutSteps`
+        # @return [Array<Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3RolloutConfigRolloutStep>]
+        attr_accessor :rollout_steps
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @failure_condition = args[:failure_condition] if args.key?(:failure_condition)
+          @rollout_condition = args[:rollout_condition] if args.key?(:rollout_condition)
+          @rollout_steps = args[:rollout_steps] if args.key?(:rollout_steps)
+        end
+      end
+      
+      # A single rollout step with specified traffic allocation.
+      class GoogleCloudDialogflowCxV3RolloutConfigRolloutStep
+        include Google::Apis::Core::Hashable
+      
+        # The name of the rollout step;
+        # Corresponds to the JSON property `displayName`
+        # @return [String]
+        attr_accessor :display_name
+      
+        # The minimum time that this step should last. Should be longer than 1 hour. If
+        # not set, the default minimum duration for each step will be 1 hour.
+        # Corresponds to the JSON property `minDuration`
+        # @return [String]
+        attr_accessor :min_duration
+      
+        # The percentage of traffic allocated to the flow version of this rollout step. (
+        # 0%, 100%].
+        # Corresponds to the JSON property `trafficPercent`
+        # @return [Fixnum]
+        attr_accessor :traffic_percent
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @display_name = args[:display_name] if args.key?(:display_name)
+          @min_duration = args[:min_duration] if args.key?(:min_duration)
+          @traffic_percent = args[:traffic_percent] if args.key?(:traffic_percent)
+        end
+      end
+      
+      # State of the auto-rollout process.
+      class GoogleCloudDialogflowCxV3RolloutState
+        include Google::Apis::Core::Hashable
+      
+        # Start time of the current step.
+        # Corresponds to the JSON property `startTime`
+        # @return [String]
+        attr_accessor :start_time
+      
+        # Display name of the current auto rollout step.
+        # Corresponds to the JSON property `step`
+        # @return [String]
+        attr_accessor :step
+      
+        # Index of the current step in the auto rollout steps list.
+        # Corresponds to the JSON property `stepIndex`
+        # @return [Fixnum]
+        attr_accessor :step_index
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @start_time = args[:start_time] if args.key?(:start_time)
+          @step = args[:step] if args.key?(:step)
+          @step_index = args[:step_index] if args.key?(:step_index)
+        end
+      end
+      
       # Metadata returned for the Environments.RunContinuousTest long running
       # operation.
       class GoogleCloudDialogflowCxV3RunContinuousTestMetadata
@@ -4062,7 +4624,8 @@ module Google
         end
       end
       
-      # Metadata returned for the TestCases.RunTestCase long running operation.
+      # Metadata returned for the TestCases.RunTestCase long running operation. This
+      # message currently has no fields.
       class GoogleCloudDialogflowCxV3RunTestCaseMetadata
         include Google::Apis::Core::Hashable
       
@@ -4120,22 +4683,42 @@ module Google
       class GoogleCloudDialogflowCxV3SecuritySettings
         include Google::Apis::Core::Hashable
       
+        # [DLP](https://cloud.google.com/dlp/docs) deidentify template name. Use this
+        # template to define de-identification configuration for the content. If empty,
+        # Dialogflow replaces sensitive info with `[redacted]` text. The template name
+        # will have one of the following formats: `projects//locations//
+        # deidentifyTemplates/` OR `organizations//locations//deidentifyTemplates/` Note:
+        # `deidentify_template` must be located in the same region as the `
+        # SecuritySettings`.
+        # Corresponds to the JSON property `deidentifyTemplate`
+        # @return [String]
+        attr_accessor :deidentify_template
+      
         # Required. The human-readable name of the security settings, unique within the
         # location.
         # Corresponds to the JSON property `displayName`
         # @return [String]
         attr_accessor :display_name
       
+        # Settings for exporting conversations to [Insights](https://cloud.google.com/
+        # dialogflow/priv/docs/insights).
+        # Corresponds to the JSON property `insightsExportSettings`
+        # @return [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3SecuritySettingsInsightsExportSettings]
+        attr_accessor :insights_export_settings
+      
         # [DLP](https://cloud.google.com/dlp/docs) inspect template name. Use this
         # template to define inspect base settings. If empty, we use the default DLP
         # inspect config. The template name will have one of the following formats: `
-        # projects//inspectTemplates/` OR `projects//locations//inspectTemplates/` OR `
-        # organizations//inspectTemplates/`
+        # projects//locations//inspectTemplates/` OR `organizations//locations//
+        # inspectTemplates/` Note: `inspect_template` must be located in the same region
+        # as the `SecuritySettings`.
         # Corresponds to the JSON property `inspectTemplate`
         # @return [String]
         attr_accessor :inspect_template
       
-        # Required. Resource name of the settings. Format: `projects//locations//
+        # Resource name of the settings. Required for the SecuritySettingsService.
+        # UpdateSecuritySettings method. SecuritySettingsService.CreateSecuritySettings
+        # populates the name automatically. Format: `projects//locations//
         # securitySettings/`.
         # Corresponds to the JSON property `name`
         # @return [String]
@@ -4173,7 +4756,9 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @deidentify_template = args[:deidentify_template] if args.key?(:deidentify_template)
           @display_name = args[:display_name] if args.key?(:display_name)
+          @insights_export_settings = args[:insights_export_settings] if args.key?(:insights_export_settings)
           @inspect_template = args[:inspect_template] if args.key?(:inspect_template)
           @name = args[:name] if args.key?(:name)
           @purge_data_types = args[:purge_data_types] if args.key?(:purge_data_types)
@@ -4183,6 +4768,28 @@ module Google
         end
       end
       
+      # Settings for exporting conversations to [Insights](https://cloud.google.com/
+      # dialogflow/priv/docs/insights).
+      class GoogleCloudDialogflowCxV3SecuritySettingsInsightsExportSettings
+        include Google::Apis::Core::Hashable
+      
+        # If enabled, we will automatically exports conversations to Insights and
+        # Insights runs its analyzers.
+        # Corresponds to the JSON property `enableInsightsExport`
+        # @return [Boolean]
+        attr_accessor :enable_insights_export
+        alias_method :enable_insights_export?, :enable_insights_export
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @enable_insights_export = args[:enable_insights_export] if args.key?(:enable_insights_export)
+        end
+      end
+      
       # The result of sentiment analysis. Sentiment analysis inspects user input and
       # identifies the prevailing subjective opinion, especially to determine a user's
       # attitude as positive, negative, or neutral.
@@ -5861,7 +6468,8 @@ module Google
         # @return [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3beta1Page]
         attr_accessor :current_page
       
-        # Required. Input only. The diagnostic info output for the turn.
+        # Required. Input only. The diagnostic info output for the turn. Required to
+        # calculate the testing coverage.
         # Corresponds to the JSON property `diagnosticInfo`
         # @return [Hash<String,Object>]
         attr_accessor :diagnostic_info
@@ -5974,6 +6582,57 @@ module Google
         end
       end
       
+      # Metadata returned for the Environments.DeployFlow long running operation.
+      class GoogleCloudDialogflowCxV3beta1DeployFlowMetadata
+        include Google::Apis::Core::Hashable
+      
+        # Errors of running deployment tests.
+        # Corresponds to the JSON property `testErrors`
+        # @return [Array<Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3beta1TestError>]
+        attr_accessor :test_errors
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @test_errors = args[:test_errors] if args.key?(:test_errors)
+        end
+      end
+      
+      # The response message for Environments.DeployFlow.
+      class GoogleCloudDialogflowCxV3beta1DeployFlowResponse
+        include Google::Apis::Core::Hashable
+      
+        # The name of the flow version deployment. Format: `projects//locations//agents//
+        # environments//deployments/`.
+        # Corresponds to the JSON property `deployment`
+        # @return [String]
+        attr_accessor :deployment
+      
+        # Represents an environment for an agent. You can create multiple versions of
+        # your agent and publish them to separate environments. When you edit an agent,
+        # you are editing the draft agent. At any point, you can save the draft agent as
+        # an agent version, which is an immutable snapshot of your agent. When you save
+        # the draft agent, it is published to the default environment. When you create
+        # agent versions, you can publish them to custom environments. You can create a
+        # variety of custom environments for testing, development, production, etc.
+        # Corresponds to the JSON property `environment`
+        # @return [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3beta1Environment]
+        attr_accessor :environment
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @deployment = args[:deployment] if args.key?(:deployment)
+          @environment = args[:environment] if args.key?(:environment)
+        end
+      end
+      
       # Represents the input for dtmf event.
       class GoogleCloudDialogflowCxV3beta1DtmfInput
         include Google::Apis::Core::Hashable
@@ -5999,6 +6658,121 @@ module Google
         end
       end
       
+      # Represents an environment for an agent. You can create multiple versions of
+      # your agent and publish them to separate environments. When you edit an agent,
+      # you are editing the draft agent. At any point, you can save the draft agent as
+      # an agent version, which is an immutable snapshot of your agent. When you save
+      # the draft agent, it is published to the default environment. When you create
+      # agent versions, you can publish them to custom environments. You can create a
+      # variety of custom environments for testing, development, production, etc.
+      class GoogleCloudDialogflowCxV3beta1Environment
+        include Google::Apis::Core::Hashable
+      
+        # The human-readable description of the environment. The maximum length is 500
+        # characters. If exceeded, the request is rejected.
+        # Corresponds to the JSON property `description`
+        # @return [String]
+        attr_accessor :description
+      
+        # Required. The human-readable name of the environment (unique in an agent).
+        # Limit of 64 characters.
+        # Corresponds to the JSON property `displayName`
+        # @return [String]
+        attr_accessor :display_name
+      
+        # The name of the environment. Format: `projects//locations//agents//
+        # environments/`.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # The configuration for continuous tests.
+        # Corresponds to the JSON property `testCasesConfig`
+        # @return [Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3beta1EnvironmentTestCasesConfig]
+        attr_accessor :test_cases_config
+      
+        # Output only. Update time of this environment.
+        # Corresponds to the JSON property `updateTime`
+        # @return [String]
+        attr_accessor :update_time
+      
+        # Required. A list of configurations for flow versions. You should include
+        # version configs for all flows that are reachable from `Start Flow` in the
+        # agent. Otherwise, an error will be returned.
+        # Corresponds to the JSON property `versionConfigs`
+        # @return [Array<Google::Apis::DialogflowV3::GoogleCloudDialogflowCxV3beta1EnvironmentVersionConfig>]
+        attr_accessor :version_configs
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @description = args[:description] if args.key?(:description)
+          @display_name = args[:display_name] if args.key?(:display_name)
+          @name = args[:name] if args.key?(:name)
+          @test_cases_config = args[:test_cases_config] if args.key?(:test_cases_config)
+          @update_time = args[:update_time] if args.key?(:update_time)
+          @version_configs = args[:version_configs] if args.key?(:version_configs)
+        end
+      end
+      
+      # The configuration for continuous tests.
+      class GoogleCloudDialogflowCxV3beta1EnvironmentTestCasesConfig
+        include Google::Apis::Core::Hashable
+      
+        # Whether to run test cases in TestCasesConfig.test_cases periodically. Default
+        # false. If set to ture, run once a day.
+        # Corresponds to the JSON property `enableContinuousRun`
+        # @return [Boolean]
+        attr_accessor :enable_continuous_run
+        alias_method :enable_continuous_run?, :enable_continuous_run
+      
+        # Whether to run test cases in TestCasesConfig.test_cases before deploying a
+        # flow version to the environment. Default false.
+        # Corresponds to the JSON property `enablePredeploymentRun`
+        # @return [Boolean]
+        attr_accessor :enable_predeployment_run
+        alias_method :enable_predeployment_run?, :enable_predeployment_run
+      
+        # A list of test case names to run. They should be under the same agent. Format
+        # of each test case name: `projects//locations/ /agents//testCases/`
+        # Corresponds to the JSON property `testCases`
+        # @return [Array<String>]
+        attr_accessor :test_cases
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @enable_continuous_run = args[:enable_continuous_run] if args.key?(:enable_continuous_run)
+          @enable_predeployment_run = args[:enable_predeployment_run] if args.key?(:enable_predeployment_run)
+          @test_cases = args[:test_cases] if args.key?(:test_cases)
+        end
+      end
+      
+      # Configuration for the version.
+      class GoogleCloudDialogflowCxV3beta1EnvironmentVersionConfig
+        include Google::Apis::Core::Hashable
+      
+        # Required. Format: projects//locations//agents//flows//versions/.
+        # Corresponds to the JSON property `version`
+        # @return [String]
+        attr_accessor :version
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @version = args[:version] if args.key?(:version)
+        end
+      end
+      
       # An event handler specifies an event that can be handled during a session. When
       # the specified event happens, the following actions are taken in order: * If
       # there is a `trigger_fulfillment` associated with the event, it will be called.
@@ -6129,6 +6903,7 @@ module Google
       end
       
       # Metadata returned for the TestCases.ExportTestCases long running operation.
+      # This message currently has no fields.
       class GoogleCloudDialogflowCxV3beta1ExportTestCasesMetadata
         include Google::Apis::Core::Hashable
       
@@ -7508,7 +8283,8 @@ module Google
         end
       end
       
-      # Metadata returned for the TestCases.RunTestCase long running operation.
+      # Metadata returned for the TestCases.RunTestCase long running operation. This
+      # message currently has no fields.
       class GoogleCloudDialogflowCxV3beta1RunTestCaseMetadata
         include Google::Apis::Core::Hashable
       
@@ -8729,8 +9505,9 @@ module Google
         # @return [Array<String>]
         attr_accessor :events
       
-        # Read-only. Information about all followup intents that have this intent as a
-        # direct or indirect parent. We populate this field only in the output.
+        # Output only. Read-only. Information about all followup intents that have this
+        # intent as a direct or indirect parent. We populate this field only in the
+        # output.
         # Corresponds to the JSON property `followupIntentInfo`
         # @return [Array<Google::Apis::DialogflowV3::GoogleCloudDialogflowV2IntentFollowupIntentInfo>]
         attr_accessor :followup_intent_info
@@ -8815,9 +9592,10 @@ module Google
         attr_accessor :reset_contexts
         alias_method :reset_contexts?, :reset_contexts
       
-        # Read-only. The unique identifier of the root intent in the chain of followup
-        # intents. It identifies the correct followup intents chain for this intent. We
-        # populate this field only in the output. Format: `projects//agent/intents/`.
+        # Output only. Read-only. The unique identifier of the root intent in the chain
+        # of followup intents. It identifies the correct followup intents chain for this
+        # intent. We populate this field only in the output. Format: `projects//agent/
+        # intents/`.
         # Corresponds to the JSON property `rootFollowupIntentName`
         # @return [String]
         attr_accessor :root_followup_intent_name
@@ -13769,6 +14547,78 @@ module Google
         end
       end
       
+      # The response message for Locations.ListLocations.
+      class GoogleCloudLocationListLocationsResponse
+        include Google::Apis::Core::Hashable
+      
+        # A list of locations that matches the specified filter in the request.
+        # Corresponds to the JSON property `locations`
+        # @return [Array<Google::Apis::DialogflowV3::GoogleCloudLocationLocation>]
+        attr_accessor :locations
+      
+        # The standard List next-page token.
+        # 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)
+          @locations = args[:locations] if args.key?(:locations)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+        end
+      end
+      
+      # A resource that represents Google Cloud Platform location.
+      class GoogleCloudLocationLocation
+        include Google::Apis::Core::Hashable
+      
+        # The friendly name for this location, typically a nearby city name. For example,
+        # "Tokyo".
+        # Corresponds to the JSON property `displayName`
+        # @return [String]
+        attr_accessor :display_name
+      
+        # Cross-service attributes for the location. For example `"cloud.googleapis.com/
+        # region": "us-east1"`
+        # Corresponds to the JSON property `labels`
+        # @return [Hash<String,String>]
+        attr_accessor :labels
+      
+        # The canonical id for this location. For example: `"us-east1"`.
+        # Corresponds to the JSON property `locationId`
+        # @return [String]
+        attr_accessor :location_id
+      
+        # Service-specific metadata. For example the available capacity at the given
+        # location.
+        # Corresponds to the JSON property `metadata`
+        # @return [Hash<String,Object>]
+        attr_accessor :metadata
+      
+        # Resource name for the location, which may vary between implementations. For
+        # example: `"projects/example-project/locations/us-east1"`
+        # 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)
+          @labels = args[:labels] if args.key?(:labels)
+          @location_id = args[:location_id] if args.key?(:location_id)
+          @metadata = args[:metadata] if args.key?(:metadata)
+          @name = args[:name] if args.key?(:name)
+        end
+      end
+      
       # The response message for Operations.ListOperations.
       class GoogleLongrunningListOperationsResponse
         include Google::Apis::Core::Hashable