google-apis-dialogflow_v3 0.19.0 → 0.23.0

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

@@ -367,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
@@ -496,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
@@ -609,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
@@ -895,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]
@@ -916,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
@@ -1045,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
@@ -1071,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]
@@ -1103,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)
@@ -1393,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
       
@@ -2527,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
@@ -2553,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
@@ -3578,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
@@ -3678,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)
@@ -4077,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
@@ -4129,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
       
@@ -4187,6 +4683,20 @@ 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. The `DLP
+        # De-identify Templates Reader` role is needed on the Dialogflow service
+        # identity service account (has the form `service-PROJECT_NUMBER@gcp-sa-
+        # dialogflow.iam.gserviceaccount.com`) for your agent's project. 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`
@@ -4200,15 +4710,20 @@ module Google
         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/`
+        # template to define inspect base settings. The `DLP Inspect Templates Reader`
+        # role is needed on the Dialogflow service identity service account (has the
+        # form `service-PROJECT_NUMBER@gcp-sa-dialogflow.iam.gserviceaccount.com`) for
+        # your agent's project. If empty, we use the default DLP inspect config. The
+        # template name will have one of the following formats: `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]
@@ -4232,10 +4747,11 @@ module Google
       
         # Retains data in interaction logging for the specified number of days. This
         # does not apply to Cloud logging, which is owned by the user - not Dialogflow.
-        # User must Set a value lower than Dialogflow's default 30d TTL. Setting a value
-        # higher than that has no effect. A missing value or setting to 0 also means we
-        # use Dialogflow's default TTL. Note: Interaction logging is a limited access
-        # feature. Talk to your Google representative to check availability for you.
+        # User must set a value lower than Dialogflow's default 365d TTL. Setting a
+        # value higher than that has no effect. A missing value or setting to 0 also
+        # means we use Dialogflow's default TTL. Note: Interaction logging is a limited
+        # access feature. Talk to your Google representative to check availability for
+        # you.
         # Corresponds to the JSON property `retentionWindowDays`
         # @return [Fixnum]
         attr_accessor :retention_window_days
@@ -4246,6 +4762,7 @@ 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)
@@ -5957,7 +6474,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
@@ -6070,6 +6588,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
@@ -6095,6 +6664,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 true, 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.
@@ -6225,6 +6909,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
       
@@ -7604,7 +8289,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
       
@@ -8825,8 +9511,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
@@ -8911,9 +9598,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
@@ -13865,6 +14553,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