google-api-client 0.32.1 → 0.40.0

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

@@ -83,6 +83,56 @@ module Google
         end
       end
       
+      # 
+      class GoogleCloudMlV1AutomatedStoppingConfigDecayCurveAutomatedStoppingConfig
+        include Google::Apis::Core::Hashable
+      
+        # If true, measurement.elapsed_time is used as the x-axis of each
+        # Trials Decay Curve. Otherwise, Measurement.steps will be used as the
+        # x-axis.
+        # Corresponds to the JSON property `useElapsedTime`
+        # @return [Boolean]
+        attr_accessor :use_elapsed_time
+        alias_method :use_elapsed_time?, :use_elapsed_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @use_elapsed_time = args[:use_elapsed_time] if args.key?(:use_elapsed_time)
+        end
+      end
+      
+      # The median automated stopping rule stops a pending trial if the trial's
+      # best objective_value is strictly below the median 'performance' of all
+      # completed trials reported up to the trial's last measurement.
+      # Currently, 'performance' refers to the running average of the objective
+      # values reported by the trial in each measurement.
+      class GoogleCloudMlV1AutomatedStoppingConfigMedianAutomatedStoppingConfig
+        include Google::Apis::Core::Hashable
+      
+        # If true, the median automated stopping rule applies to
+        # measurement.use_elapsed_time, which means the elapsed_time field of
+        # the current trial's
+        # latest measurement is used to compute the median objective
+        # value for each completed trial.
+        # Corresponds to the JSON property `useElapsedTime`
+        # @return [Boolean]
+        attr_accessor :use_elapsed_time
+        alias_method :use_elapsed_time?, :use_elapsed_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @use_elapsed_time = args[:use_elapsed_time] if args.key?(:use_elapsed_time)
+        end
+      end
+      
       # An observed value of a metric.
       class GoogleCloudMlV1HyperparameterOutputHyperparameterMetric
         include Google::Apis::Core::Hashable
@@ -108,8 +158,335 @@ module Google
         end
       end
       
+      # A message representing a metric in the measurement.
+      class GoogleCloudMlV1MeasurementMetric
+        include Google::Apis::Core::Hashable
+      
+        # Required. Metric name.
+        # Corresponds to the JSON property `metric`
+        # @return [String]
+        attr_accessor :metric
+      
+        # Required. The value for this metric.
+        # Corresponds to the JSON property `value`
+        # @return [Float]
+        attr_accessor :value
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @metric = args[:metric] if args.key?(:metric)
+          @value = args[:value] if args.key?(:value)
+        end
+      end
+      
+      # 
+      class GoogleCloudMlV1StudyConfigParameterSpecCategoricalValueSpec
+        include Google::Apis::Core::Hashable
+      
+        # Must be specified if type is `CATEGORICAL`.
+        # The list of possible categories.
+        # Corresponds to the JSON property `values`
+        # @return [Array<String>]
+        attr_accessor :values
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @values = args[:values] if args.key?(:values)
+        end
+      end
+      
+      # 
+      class GoogleCloudMlV1StudyConfigParameterSpecDiscreteValueSpec
+        include Google::Apis::Core::Hashable
+      
+        # Must be specified if type is `DISCRETE`.
+        # A list of feasible points.
+        # The list should be in strictly increasing order. For instance, this
+        # parameter might have possible settings of 1.5, 2.5, and 4.0. This list
+        # should not contain more than 1,000 values.
+        # Corresponds to the JSON property `values`
+        # @return [Array<Float>]
+        attr_accessor :values
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @values = args[:values] if args.key?(:values)
+        end
+      end
+      
+      # 
+      class GoogleCloudMlV1StudyConfigParameterSpecDoubleValueSpec
+        include Google::Apis::Core::Hashable
+      
+        # Must be specified if type is `DOUBLE`. Maximum value of the parameter.
+        # Corresponds to the JSON property `maxValue`
+        # @return [Float]
+        attr_accessor :max_value
+      
+        # Must be specified if type is `DOUBLE`. Minimum value of the parameter.
+        # Corresponds to the JSON property `minValue`
+        # @return [Float]
+        attr_accessor :min_value
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @max_value = args[:max_value] if args.key?(:max_value)
+          @min_value = args[:min_value] if args.key?(:min_value)
+        end
+      end
+      
+      # 
+      class GoogleCloudMlV1StudyConfigParameterSpecIntegerValueSpec
+        include Google::Apis::Core::Hashable
+      
+        # Must be specified if type is `INTEGER`. Maximum value of the parameter.
+        # Corresponds to the JSON property `maxValue`
+        # @return [Fixnum]
+        attr_accessor :max_value
+      
+        # Must be specified if type is `INTEGER`. Minimum value of the parameter.
+        # Corresponds to the JSON property `minValue`
+        # @return [Fixnum]
+        attr_accessor :min_value
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @max_value = args[:max_value] if args.key?(:max_value)
+          @min_value = args[:min_value] if args.key?(:min_value)
+        end
+      end
+      
+      # Represents the spec to match categorical values from parent parameter.
+      class GoogleCloudMlV1StudyConfigParameterSpecMatchingParentCategoricalValueSpec
+        include Google::Apis::Core::Hashable
+      
+        # Matches values of the parent parameter with type 'CATEGORICAL'.
+        # All values must exist in `categorical_value_spec` of parent parameter.
+        # Corresponds to the JSON property `values`
+        # @return [Array<String>]
+        attr_accessor :values
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @values = args[:values] if args.key?(:values)
+        end
+      end
+      
+      # Represents the spec to match discrete values from parent parameter.
+      class GoogleCloudMlV1StudyConfigParameterSpecMatchingParentDiscreteValueSpec
+        include Google::Apis::Core::Hashable
+      
+        # Matches values of the parent parameter with type 'DISCRETE'.
+        # All values must exist in `discrete_value_spec` of parent parameter.
+        # Corresponds to the JSON property `values`
+        # @return [Array<Float>]
+        attr_accessor :values
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @values = args[:values] if args.key?(:values)
+        end
+      end
+      
+      # Represents the spec to match integer values from parent parameter.
+      class GoogleCloudMlV1StudyConfigParameterSpecMatchingParentIntValueSpec
+        include Google::Apis::Core::Hashable
+      
+        # Matches values of the parent parameter with type 'INTEGER'.
+        # All values must lie in `integer_value_spec` of parent parameter.
+        # Corresponds to the JSON property `values`
+        # @return [Array<Fixnum>]
+        attr_accessor :values
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @values = args[:values] if args.key?(:values)
+        end
+      end
+      
+      # Represents a metric to optimize.
+      class GoogleCloudMlV1StudyConfigMetricSpec
+        include Google::Apis::Core::Hashable
+      
+        # Required. The optimization goal of the metric.
+        # Corresponds to the JSON property `goal`
+        # @return [String]
+        attr_accessor :goal
+      
+        # Required. The name of the metric.
+        # Corresponds to the JSON property `metric`
+        # @return [String]
+        attr_accessor :metric
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @goal = args[:goal] if args.key?(:goal)
+          @metric = args[:metric] if args.key?(:metric)
+        end
+      end
+      
+      # Represents a single parameter to optimize.
+      class GoogleCloudMlV1StudyConfigParameterSpec
+        include Google::Apis::Core::Hashable
+      
+        # The value spec for a 'CATEGORICAL' parameter.
+        # Corresponds to the JSON property `categoricalValueSpec`
+        # @return [Google::Apis::MlV1::GoogleCloudMlV1StudyConfigParameterSpecCategoricalValueSpec]
+        attr_accessor :categorical_value_spec
+      
+        # A child node is active if the parameter's value matches the child node's
+        # matching_parent_values.
+        # If two items in child_parameter_specs have the same name, they must have
+        # disjoint matching_parent_values.
+        # Corresponds to the JSON property `childParameterSpecs`
+        # @return [Array<Google::Apis::MlV1::GoogleCloudMlV1StudyConfigParameterSpec>]
+        attr_accessor :child_parameter_specs
+      
+        # The value spec for a 'DISCRETE' parameter.
+        # Corresponds to the JSON property `discreteValueSpec`
+        # @return [Google::Apis::MlV1::GoogleCloudMlV1StudyConfigParameterSpecDiscreteValueSpec]
+        attr_accessor :discrete_value_spec
+      
+        # The value spec for a 'DOUBLE' parameter.
+        # Corresponds to the JSON property `doubleValueSpec`
+        # @return [Google::Apis::MlV1::GoogleCloudMlV1StudyConfigParameterSpecDoubleValueSpec]
+        attr_accessor :double_value_spec
+      
+        # The value spec for an 'INTEGER' parameter.
+        # Corresponds to the JSON property `integerValueSpec`
+        # @return [Google::Apis::MlV1::GoogleCloudMlV1StudyConfigParameterSpecIntegerValueSpec]
+        attr_accessor :integer_value_spec
+      
+        # Required. The parameter name must be unique amongst all ParameterSpecs.
+        # Corresponds to the JSON property `parameter`
+        # @return [String]
+        attr_accessor :parameter
+      
+        # Represents the spec to match categorical values from parent parameter.
+        # Corresponds to the JSON property `parentCategoricalValues`
+        # @return [Google::Apis::MlV1::GoogleCloudMlV1StudyConfigParameterSpecMatchingParentCategoricalValueSpec]
+        attr_accessor :parent_categorical_values
+      
+        # Represents the spec to match discrete values from parent parameter.
+        # Corresponds to the JSON property `parentDiscreteValues`
+        # @return [Google::Apis::MlV1::GoogleCloudMlV1StudyConfigParameterSpecMatchingParentDiscreteValueSpec]
+        attr_accessor :parent_discrete_values
+      
+        # Represents the spec to match integer values from parent parameter.
+        # Corresponds to the JSON property `parentIntValues`
+        # @return [Google::Apis::MlV1::GoogleCloudMlV1StudyConfigParameterSpecMatchingParentIntValueSpec]
+        attr_accessor :parent_int_values
+      
+        # How the parameter should be scaled.
+        # Leave unset for categorical parameters.
+        # Corresponds to the JSON property `scaleType`
+        # @return [String]
+        attr_accessor :scale_type
+      
+        # Required. The type of the parameter.
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @categorical_value_spec = args[:categorical_value_spec] if args.key?(:categorical_value_spec)
+          @child_parameter_specs = args[:child_parameter_specs] if args.key?(:child_parameter_specs)
+          @discrete_value_spec = args[:discrete_value_spec] if args.key?(:discrete_value_spec)
+          @double_value_spec = args[:double_value_spec] if args.key?(:double_value_spec)
+          @integer_value_spec = args[:integer_value_spec] if args.key?(:integer_value_spec)
+          @parameter = args[:parameter] if args.key?(:parameter)
+          @parent_categorical_values = args[:parent_categorical_values] if args.key?(:parent_categorical_values)
+          @parent_discrete_values = args[:parent_discrete_values] if args.key?(:parent_discrete_values)
+          @parent_int_values = args[:parent_int_values] if args.key?(:parent_int_values)
+          @scale_type = args[:scale_type] if args.key?(:scale_type)
+          @type = args[:type] if args.key?(:type)
+        end
+      end
+      
+      # A message representing a parameter to be tuned. Contains the name of
+      # the parameter and the suggested value to use for this trial.
+      class GoogleCloudMlV1TrialParameter
+        include Google::Apis::Core::Hashable
+      
+        # Must be set if ParameterType is DOUBLE or DISCRETE.
+        # Corresponds to the JSON property `floatValue`
+        # @return [Float]
+        attr_accessor :float_value
+      
+        # Must be set if ParameterType is INTEGER
+        # Corresponds to the JSON property `intValue`
+        # @return [Fixnum]
+        attr_accessor :int_value
+      
+        # The name of the parameter.
+        # Corresponds to the JSON property `parameter`
+        # @return [String]
+        attr_accessor :parameter
+      
+        # Must be set if ParameterTypeis CATEGORICAL
+        # Corresponds to the JSON property `stringValue`
+        # @return [String]
+        attr_accessor :string_value
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @float_value = args[:float_value] if args.key?(:float_value)
+          @int_value = args[:int_value] if args.key?(:int_value)
+          @parameter = args[:parameter] if args.key?(:parameter)
+          @string_value = args[:string_value] if args.key?(:string_value)
+        end
+      end
+      
       # Represents a hardware accelerator request config.
-      # Note that the AcceleratorConfig could be used in both Jobs and Versions.
+      # Note that the AcceleratorConfig can be used in both Jobs and Versions.
+      # Learn more about [accelerators for training](/ml-engine/docs/using-gpus) and
+      # [accelerators for online
+      # prediction](/ml-engine/docs/machine-types-online-prediction#gpus).
       class GoogleCloudMlV1AcceleratorConfig
         include Google::Apis::Core::Hashable
       
@@ -134,6 +511,25 @@ module Google
         end
       end
       
+      # The request message for the AddTrialMeasurement service method.
+      class GoogleCloudMlV1AddTrialMeasurementRequest
+        include Google::Apis::Core::Hashable
+      
+        # A message representing a measurement.
+        # Corresponds to the JSON property `measurement`
+        # @return [Google::Apis::MlV1::GoogleCloudMlV1Measurement]
+        attr_accessor :measurement
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @measurement = args[:measurement] if args.key?(:measurement)
+        end
+      end
+      
       # Options for automatically scaling a model.
       class GoogleCloudMlV1AutoScaling
         include Google::Apis::Core::Hashable
@@ -151,9 +547,18 @@ module Google
         # increased load as well as scale back as traffic drops, always maintaining
         # at least `min_nodes`. You will be charged for the time in which additional
         # nodes are used.
-        # If not specified, `min_nodes` defaults to 0, in which case, when traffic
-        # to a model stops (and after a cool-down period), nodes will be shut down
-        # and no charges will be incurred until traffic to the model resumes.
+        # If `min_nodes` is not specified and AutoScaling is used with a [legacy
+        # (MLS1) machine type](/ml-engine/docs/machine-types-online-prediction),
+        # `min_nodes` defaults to 0, in which case, when traffic to a model stops
+        # (and after a cool-down period), nodes will be shut down and no charges will
+        # be incurred until traffic to the model resumes.
+        # If `min_nodes` is not specified and AutoScaling is used with a [Compute
+        # Engine (N1) machine type](/ml-engine/docs/machine-types-online-prediction),
+        # `min_nodes` defaults to 1. `min_nodes` must be at least 1 for use with a
+        # Compute Engine machine type.
+        # Note that you cannot use AutoScaling if your version uses
+        # [GPUs](#Version.FIELDS.accelerator_config). Instead, you must use
+        # ManualScaling.
         # You can set `min_nodes` when creating the model version, and you can also
         # update `min_nodes` for an existing version:
         # <pre>
@@ -165,7 +570,7 @@ module Google
         # `
         # </pre>
         # HTTP request:
-        # <pre>
+        # <pre style="max-width: 626px;">
         # PATCH
         # https://ml.googleapis.com/v1/`name=projects/*/models/*/versions/*`?update_mask=
         # autoScaling.minNodes
@@ -185,6 +590,36 @@ module Google
         end
       end
       
+      # Configuration for Automated Early Stopping of Trials. If no
+      # implementation_config is set, automated early stopping will not be run.
+      class GoogleCloudMlV1AutomatedStoppingConfig
+        include Google::Apis::Core::Hashable
+      
+        # 
+        # Corresponds to the JSON property `decayCurveStoppingConfig`
+        # @return [Google::Apis::MlV1::GoogleCloudMlV1AutomatedStoppingConfigDecayCurveAutomatedStoppingConfig]
+        attr_accessor :decay_curve_stopping_config
+      
+        # The median automated stopping rule stops a pending trial if the trial's
+        # best objective_value is strictly below the median 'performance' of all
+        # completed trials reported up to the trial's last measurement.
+        # Currently, 'performance' refers to the running average of the objective
+        # values reported by the trial in each measurement.
+        # Corresponds to the JSON property `medianAutomatedStoppingConfig`
+        # @return [Google::Apis::MlV1::GoogleCloudMlV1AutomatedStoppingConfigMedianAutomatedStoppingConfig]
+        attr_accessor :median_automated_stopping_config
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @decay_curve_stopping_config = args[:decay_curve_stopping_config] if args.key?(:decay_curve_stopping_config)
+          @median_automated_stopping_config = args[:median_automated_stopping_config] if args.key?(:median_automated_stopping_config)
+        end
+      end
+      
       # Represents output related to a built-in algorithm Job.
       class GoogleCloudMlV1BuiltInAlgorithmOutput
         include Google::Apis::Core::Hashable
@@ -263,6 +698,120 @@ module Google
         end
       end
       
+      # This message will be placed in the metadata field of a
+      # google.longrunning.Operation associated with a CheckTrialEarlyStoppingState
+      # request.
+      class GoogleCloudMlV1CheckTrialEarlyStoppingStateMetatdata
+        include Google::Apis::Core::Hashable
+      
+        # The time at which the operation was submitted.
+        # Corresponds to the JSON property `createTime`
+        # @return [String]
+        attr_accessor :create_time
+      
+        # The name of the study that the trial belongs to.
+        # Corresponds to the JSON property `study`
+        # @return [String]
+        attr_accessor :study
+      
+        # The trial name.
+        # Corresponds to the JSON property `trial`
+        # @return [String]
+        attr_accessor :trial
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @create_time = args[:create_time] if args.key?(:create_time)
+          @study = args[:study] if args.key?(:study)
+          @trial = args[:trial] if args.key?(:trial)
+        end
+      end
+      
+      # The request message for the CheckTrialEarlyStoppingState service method.
+      class GoogleCloudMlV1CheckTrialEarlyStoppingStateRequest
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # The message will be placed in the response field of a completed
+      # google.longrunning.Operation associated with a CheckTrialEarlyStoppingState
+      # request.
+      class GoogleCloudMlV1CheckTrialEarlyStoppingStateResponse
+        include Google::Apis::Core::Hashable
+      
+        # The time at which operation processing completed.
+        # Corresponds to the JSON property `endTime`
+        # @return [String]
+        attr_accessor :end_time
+      
+        # True if the Trial should stop.
+        # Corresponds to the JSON property `shouldStop`
+        # @return [Boolean]
+        attr_accessor :should_stop
+        alias_method :should_stop?, :should_stop
+      
+        # The time at which the operation was started.
+        # Corresponds to the JSON property `startTime`
+        # @return [String]
+        attr_accessor :start_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @end_time = args[:end_time] if args.key?(:end_time)
+          @should_stop = args[:should_stop] if args.key?(:should_stop)
+          @start_time = args[:start_time] if args.key?(:start_time)
+        end
+      end
+      
+      # The request message for the CompleteTrial service method.
+      class GoogleCloudMlV1CompleteTrialRequest
+        include Google::Apis::Core::Hashable
+      
+        # A message representing a measurement.
+        # Corresponds to the JSON property `finalMeasurement`
+        # @return [Google::Apis::MlV1::GoogleCloudMlV1Measurement]
+        attr_accessor :final_measurement
+      
+        # Optional. A human readable reason why the trial was infeasible. This should
+        # only be provided if `trial_infeasible` is true.
+        # Corresponds to the JSON property `infeasibleReason`
+        # @return [String]
+        attr_accessor :infeasible_reason
+      
+        # Optional. True if the trial cannot be run with the given Parameter, and
+        # final_measurement will be ignored.
+        # Corresponds to the JSON property `trialInfeasible`
+        # @return [Boolean]
+        attr_accessor :trial_infeasible
+        alias_method :trial_infeasible?, :trial_infeasible
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @final_measurement = args[:final_measurement] if args.key?(:final_measurement)
+          @infeasible_reason = args[:infeasible_reason] if args.key?(:infeasible_reason)
+          @trial_infeasible = args[:trial_infeasible] if args.key?(:trial_infeasible)
+        end
+      end
+      
       # 
       class GoogleCloudMlV1Config
         include Google::Apis::Core::Hashable
@@ -282,6 +831,119 @@ module Google
         end
       end
       
+      # Represents a custom encryption key configuration that can be applied to
+      # a resource.
+      class GoogleCloudMlV1EncryptionConfig
+        include Google::Apis::Core::Hashable
+      
+        # The Cloud KMS resource identifier of the customer-managed encryption key
+        # used to protect a resource, such as a training job. It has the following
+        # format:
+        # `projects/`PROJECT_ID`/locations/`REGION`/keyRings/`KEY_RING_NAME`/cryptoKeys/`
+        # KEY_NAME``
+        # Corresponds to the JSON property `kmsKeyName`
+        # @return [String]
+        attr_accessor :kms_key_name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @kms_key_name = args[:kms_key_name] if args.key?(:kms_key_name)
+        end
+      end
+      
+      # Request for explanations to be issued against a trained model.
+      class GoogleCloudMlV1ExplainRequest
+        include Google::Apis::Core::Hashable
+      
+        # Message that represents an arbitrary HTTP body. It should only be used for
+        # payload formats that can't be represented as JSON, such as raw binary or
+        # an HTML page.
+        # This message can be used both in streaming and non-streaming API methods in
+        # the request as well as the response.
+        # It can be used as a top-level request field, which is convenient if one
+        # wants to extract parameters from either the URL or HTTP template into the
+        # request fields and also want access to the raw HTTP body.
+        # Example:
+        # message GetResourceRequest `
+        # // A unique request id.
+        # string request_id = 1;
+        # // The raw HTTP body is bound to this field.
+        # google.api.HttpBody http_body = 2;
+        # `
+        # service ResourceService `
+        # rpc GetResource(GetResourceRequest) returns (google.api.HttpBody);
+        # rpc UpdateResource(google.api.HttpBody) returns
+        # (google.protobuf.Empty);
+        # `
+        # Example with streaming methods:
+        # service CaldavService `
+        # rpc GetCalendar(stream google.api.HttpBody)
+        # returns (stream google.api.HttpBody);
+        # rpc UpdateCalendar(stream google.api.HttpBody)
+        # returns (stream google.api.HttpBody);
+        # `
+        # Use of this type only changes how the request and response bodies are
+        # handled, all other features will continue to work unchanged.
+        # Corresponds to the JSON property `httpBody`
+        # @return [Google::Apis::MlV1::GoogleApiHttpBody]
+        attr_accessor :http_body
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @http_body = args[:http_body] if args.key?(:http_body)
+        end
+      end
+      
+      # Message holding configuration options for explaining model predictions.
+      # There are two feature attribution methods supported for TensorFlow models:
+      # integrated gradients and sampled Shapley.
+      # [Learn more about feature
+      # attributions.](/ai-platform/prediction/docs/ai-explanations/overview)
+      class GoogleCloudMlV1ExplanationConfig
+        include Google::Apis::Core::Hashable
+      
+        # Attributes credit by computing the Aumann-Shapley value taking advantage
+        # of the model's fully differentiable structure. Refer to this paper for
+        # more details: https://arxiv.org/abs/1703.01365
+        # Corresponds to the JSON property `integratedGradientsAttribution`
+        # @return [Google::Apis::MlV1::GoogleCloudMlV1IntegratedGradientsAttribution]
+        attr_accessor :integrated_gradients_attribution
+      
+        # An attribution method that approximates Shapley values for features that
+        # contribute to the label being predicted. A sampling strategy is used to
+        # approximate the value rather than considering all subsets of features.
+        # Corresponds to the JSON property `sampledShapleyAttribution`
+        # @return [Google::Apis::MlV1::GoogleCloudMlV1SampledShapleyAttribution]
+        attr_accessor :sampled_shapley_attribution
+      
+        # Attributes credit by computing the XRAI taking advantage
+        # of the model's fully differentiable structure. Refer to this paper for
+        # more details: https://arxiv.org/abs/1906.02825
+        # Currently only implemented for models with natural image inputs.
+        # Corresponds to the JSON property `xraiAttribution`
+        # @return [Google::Apis::MlV1::GoogleCloudMlV1XraiAttribution]
+        attr_accessor :xrai_attribution
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @integrated_gradients_attribution = args[:integrated_gradients_attribution] if args.key?(:integrated_gradients_attribution)
+          @sampled_shapley_attribution = args[:sampled_shapley_attribution] if args.key?(:sampled_shapley_attribution)
+          @xrai_attribution = args[:xrai_attribution] if args.key?(:xrai_attribution)
+        end
+      end
+      
       # Returns service account information associated with a project.
       class GoogleCloudMlV1GetConfigResponse
         include Google::Apis::Core::Hashable
@@ -478,6 +1140,29 @@ module Google
         end
       end
       
+      # Attributes credit by computing the Aumann-Shapley value taking advantage
+      # of the model's fully differentiable structure. Refer to this paper for
+      # more details: https://arxiv.org/abs/1703.01365
+      class GoogleCloudMlV1IntegratedGradientsAttribution
+        include Google::Apis::Core::Hashable
+      
+        # Number of steps for approximating the path integral.
+        # A good value to start is 50 and gradually increase until the
+        # sum to diff property is met within the desired error range.
+        # Corresponds to the JSON property `numIntegralSteps`
+        # @return [Fixnum]
+        attr_accessor :num_integral_steps
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @num_integral_steps = args[:num_integral_steps] if args.key?(:num_integral_steps)
+        end
+      end
+      
       # Represents a training or prediction job.
       class GoogleCloudMlV1Job
         include Google::Apis::Core::Hashable
@@ -543,13 +1228,11 @@ module Google
         # @return [String]
         attr_accessor :state
       
-        # Represents input parameters for a training job. When using the
-        # gcloud command to submit your training job, you can specify
-        # the input parameters as command-line arguments and/or in a YAML configuration
-        # file referenced from the --config command-line argument. For
-        # details, see the guide to
-        # <a href="/ml-engine/docs/tensorflow/training-jobs">submitting a training
-        # job</a>.
+        # Represents input parameters for a training job. When using the gcloud command
+        # to submit your training job, you can specify the input parameters as
+        # command-line arguments and/or in a YAML configuration file referenced from
+        # the --config command-line argument. For details, see the guide to [submitting
+        # a training job](/ai-platform/training/docs/training-jobs).
         # Corresponds to the JSON property `trainingInput`
         # @return [Google::Apis::MlV1::GoogleCloudMlV1TrainingInput]
         attr_accessor :training_input
@@ -658,6 +1341,44 @@ module Google
         end
       end
       
+      # 
+      class GoogleCloudMlV1ListStudiesResponse
+        include Google::Apis::Core::Hashable
+      
+        # The studies associated with the project.
+        # Corresponds to the JSON property `studies`
+        # @return [Array<Google::Apis::MlV1::GoogleCloudMlV1Study>]
+        attr_accessor :studies
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @studies = args[:studies] if args.key?(:studies)
+        end
+      end
+      
+      # The response message for the ListTrials method.
+      class GoogleCloudMlV1ListTrialsResponse
+        include Google::Apis::Core::Hashable
+      
+        # The trials associated with the study.
+        # Corresponds to the JSON property `trials`
+        # @return [Array<Google::Apis::MlV1::GoogleCloudMlV1Trial>]
+        attr_accessor :trials
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @trials = args[:trials] if args.key?(:trials)
+        end
+      end
+      
       # Response message for the ListVersions method.
       class GoogleCloudMlV1ListVersionsResponse
         include Google::Apis::Core::Hashable
@@ -704,22 +1425,54 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @capabilities = args[:capabilities] if args.key?(:capabilities)
-          @name = args[:name] if args.key?(:name)
+          @capabilities = args[:capabilities] if args.key?(:capabilities)
+          @name = args[:name] if args.key?(:name)
+        end
+      end
+      
+      # Options for manually scaling a model.
+      class GoogleCloudMlV1ManualScaling
+        include Google::Apis::Core::Hashable
+      
+        # The number of nodes to allocate for this model. These nodes are always up,
+        # starting from the time the model is deployed, so the cost of operating
+        # this model will be proportional to `nodes` * number of hours since
+        # last billing cycle plus the cost for each prediction performed.
+        # Corresponds to the JSON property `nodes`
+        # @return [Fixnum]
+        attr_accessor :nodes
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @nodes = args[:nodes] if args.key?(:nodes)
         end
       end
       
-      # Options for manually scaling a model.
-      class GoogleCloudMlV1ManualScaling
+      # A message representing a measurement.
+      class GoogleCloudMlV1Measurement
         include Google::Apis::Core::Hashable
       
-        # The number of nodes to allocate for this model. These nodes are always up,
-        # starting from the time the model is deployed, so the cost of operating
-        # this model will be proportional to `nodes` * number of hours since
-        # last billing cycle plus the cost for each prediction performed.
-        # Corresponds to the JSON property `nodes`
+        # Output only. Time that the trial has been running at the point of
+        # this measurement.
+        # Corresponds to the JSON property `elapsedTime`
+        # @return [String]
+        attr_accessor :elapsed_time
+      
+        # Provides a list of metrics that act as inputs into the objective
+        # function.
+        # Corresponds to the JSON property `metrics`
+        # @return [Array<Google::Apis::MlV1::GoogleCloudMlV1MeasurementMetric>]
+        attr_accessor :metrics
+      
+        # The number of steps a machine learning model has been trained for.
+        # Must be non-negative.
+        # Corresponds to the JSON property `stepCount`
         # @return [Fixnum]
-        attr_accessor :nodes
+        attr_accessor :step_count
       
         def initialize(**args)
            update!(**args)
@@ -727,7 +1480,9 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @nodes = args[:nodes] if args.key?(:nodes)
+          @elapsed_time = args[:elapsed_time] if args.key?(:elapsed_time)
+          @metrics = args[:metrics] if args.key?(:metrics)
+          @step_count = args[:step_count] if args.key?(:step_count)
         end
       end
       
@@ -742,8 +1497,7 @@ module Google
         # Each version is a trained model deployed in the cloud, ready to handle
         # prediction requests. A model can have multiple versions. You can get
         # information about all of the versions of a given model by calling
-        # [projects.models.versions.list](/ml-engine/reference/rest/v1/projects.models.
-        # versions/list).
+        # projects.models.versions.list.
         # Corresponds to the JSON property `defaultVersion`
         # @return [Google::Apis::MlV1::GoogleCloudMlV1Version]
         attr_accessor :default_version
@@ -806,7 +1560,7 @@ module Google
         alias_method :online_prediction_logging?, :online_prediction_logging
       
         # Optional. The list of regions where the model is going to be deployed.
-        # Currently only one region per model is supported.
+        # Only one region per model is supported.
         # Defaults to 'us-central1' if nothing is set.
         # See the <a href="/ml-engine/docs/tensorflow/regions">available regions</a>
         # for AI Platform services.
@@ -887,8 +1641,7 @@ module Google
         # Each version is a trained model deployed in the cloud, ready to handle
         # prediction requests. A model can have multiple versions. You can get
         # information about all of the versions of a given model by calling
-        # [projects.models.versions.list](/ml-engine/reference/rest/v1/projects.models.
-        # versions/list).
+        # projects.models.versions.list.
         # Corresponds to the JSON property `version`
         # @return [Google::Apis::MlV1::GoogleCloudMlV1Version]
         attr_accessor :version
@@ -1176,14 +1929,49 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Represents a hardware accelerator request config.
-        # Note that the AcceleratorConfig could be used in both Jobs and Versions.
+        # Note that the AcceleratorConfig can be used in both Jobs and Versions.
+        # Learn more about [accelerators for training](/ml-engine/docs/using-gpus) and
+        # [accelerators for online
+        # prediction](/ml-engine/docs/machine-types-online-prediction#gpus).
         # Corresponds to the JSON property `acceleratorConfig`
         # @return [Google::Apis::MlV1::GoogleCloudMlV1AcceleratorConfig]
         attr_accessor :accelerator_config
       
+        # Arguments to the entrypoint command.
+        # The following rules apply for container_command and container_args:
+        # - If you do not supply command or args:
+        # The defaults defined in the Docker image are used.
+        # - If you supply a command but no args:
+        # The default EntryPoint and the default Cmd defined in the Docker image
+        # are ignored. Your command is run without any arguments.
+        # - If you supply only args:
+        # The default Entrypoint defined in the Docker image is run with the args
+        # that you supplied.
+        # - If you supply a command and args:
+        # The default Entrypoint and the default Cmd defined in the Docker image
+        # are ignored. Your command is run with your args.
+        # It cannot be set if custom container image is
+        # not provided.
+        # Note that this field and [TrainingInput.args] are mutually exclusive, i.e.,
+        # both cannot be set at the same time.
+        # Corresponds to the JSON property `containerArgs`
+        # @return [Array<String>]
+        attr_accessor :container_args
+      
+        # The command with which the replica's custom container is run.
+        # If provided, it will override default ENTRYPOINT of the docker image.
+        # If not provided, the docker image's ENTRYPOINT is used.
+        # It cannot be set if custom container image is
+        # not provided.
+        # Note that this field and [TrainingInput.args] are mutually exclusive, i.e.,
+        # both cannot be set at the same time.
+        # Corresponds to the JSON property `containerCommand`
+        # @return [Array<String>]
+        attr_accessor :container_command
+      
         # The Docker image to run on the replica. This image must be in Container
         # Registry. Learn more about [configuring custom
-        # containers](/ml-engine/docs/distributed-training-containers).
+        # containers](/ai-platform/training/docs/distributed-training-containers).
         # Corresponds to the JSON property `imageUri`
         # @return [String]
         attr_accessor :image_uri
@@ -1213,6 +2001,8 @@ module Google
         # Update properties of this object
         def update!(**args)
           @accelerator_config = args[:accelerator_config] if args.key?(:accelerator_config)
+          @container_args = args[:container_args] if args.key?(:container_args)
+          @container_command = args[:container_command] if args.key?(:container_command)
           @image_uri = args[:image_uri] if args.key?(:image_uri)
           @tpu_tf_version = args[:tpu_tf_version] if args.key?(:tpu_tf_version)
         end
@@ -1234,7 +2024,7 @@ module Google
       
         # Required. Fully qualified BigQuery table name in the following format:
         # "<var>project_id</var>.<var>dataset_name</var>.<var>table_name</var>"
-        # The specifcied table must already exist, and the "Cloud ML Service Agent"
+        # The specified table must already exist, and the "Cloud ML Service Agent"
         # for your project must have permission to write to it. The table must have
         # the following [schema](/bigquery/docs/schemas):
         # <table>
@@ -1269,6 +2059,72 @@ module Google
         end
       end
       
+      # An attribution method that approximates Shapley values for features that
+      # contribute to the label being predicted. A sampling strategy is used to
+      # approximate the value rather than considering all subsets of features.
+      class GoogleCloudMlV1SampledShapleyAttribution
+        include Google::Apis::Core::Hashable
+      
+        # The number of feature permutations to consider when approximating the
+        # Shapley values.
+        # Corresponds to the JSON property `numPaths`
+        # @return [Fixnum]
+        attr_accessor :num_paths
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @num_paths = args[:num_paths] if args.key?(:num_paths)
+        end
+      end
+      
+      # All parameters related to scheduling of training jobs.
+      class GoogleCloudMlV1Scheduling
+        include Google::Apis::Core::Hashable
+      
+        # Optional. The maximum job running time, expressed in seconds. The field can
+        # contain up to nine fractional digits, terminated by `s`. If not specified,
+        # this field defaults to `604800s` (seven days).
+        # If the training job is still running after this duration, AI Platform
+        # Training cancels it.
+        # For example, if you want to ensure your job runs for no more than 2 hours,
+        # set this field to `7200s` (2 hours * 60 minutes / hour * 60 seconds /
+        # minute).
+        # If you submit your training job using the `gcloud` tool, you can [provide
+        # this field in a `config.yaml`
+        # file](/ai-platform/training/docs/training-jobs#
+        # formatting_your_configuration_parameters).
+        # For example:
+        # ```yaml
+        # trainingInput:
+        # ...
+        # scheduling:
+        # maxRunningTime: 7200s
+        # ...
+        # ```
+        # Corresponds to the JSON property `maxRunningTime`
+        # @return [String]
+        attr_accessor :max_running_time
+      
+        # 
+        # Corresponds to the JSON property `maxWaitTime`
+        # @return [String]
+        attr_accessor :max_wait_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @max_running_time = args[:max_running_time] if args.key?(:max_running_time)
+          @max_wait_time = args[:max_wait_time] if args.key?(:max_wait_time)
+        end
+      end
+      
       # Request message for the SetDefaultVersion request.
       class GoogleCloudMlV1SetDefaultVersionRequest
         include Google::Apis::Core::Hashable
@@ -1282,21 +2138,256 @@ module Google
         end
       end
       
-      # Represents input parameters for a training job. When using the
-      # gcloud command to submit your training job, you can specify
-      # the input parameters as command-line arguments and/or in a YAML configuration
-      # file referenced from the --config command-line argument. For
-      # details, see the guide to
-      # <a href="/ml-engine/docs/tensorflow/training-jobs">submitting a training
-      # job</a>.
+      # 
+      class GoogleCloudMlV1StopTrialRequest
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # A message representing a Study.
+      class GoogleCloudMlV1Study
+        include Google::Apis::Core::Hashable
+      
+        # Output only. Time at which the study was created.
+        # Corresponds to the JSON property `createTime`
+        # @return [String]
+        attr_accessor :create_time
+      
+        # Output only. A human readable reason why the Study is inactive.
+        # This should be empty if a study is ACTIVE or COMPLETED.
+        # Corresponds to the JSON property `inactiveReason`
+        # @return [String]
+        attr_accessor :inactive_reason
+      
+        # Output only. The name of a study.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # Output only. The detailed state of a study.
+        # Corresponds to the JSON property `state`
+        # @return [String]
+        attr_accessor :state
+      
+        # Represents configuration of a study.
+        # Corresponds to the JSON property `studyConfig`
+        # @return [Google::Apis::MlV1::GoogleCloudMlV1StudyConfig]
+        attr_accessor :study_config
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @create_time = args[:create_time] if args.key?(:create_time)
+          @inactive_reason = args[:inactive_reason] if args.key?(:inactive_reason)
+          @name = args[:name] if args.key?(:name)
+          @state = args[:state] if args.key?(:state)
+          @study_config = args[:study_config] if args.key?(:study_config)
+        end
+      end
+      
+      # Represents configuration of a study.
+      class GoogleCloudMlV1StudyConfig
+        include Google::Apis::Core::Hashable
+      
+        # The search algorithm specified for the study.
+        # Corresponds to the JSON property `algorithm`
+        # @return [String]
+        attr_accessor :algorithm
+      
+        # Configuration for Automated Early Stopping of Trials. If no
+        # implementation_config is set, automated early stopping will not be run.
+        # Corresponds to the JSON property `automatedStoppingConfig`
+        # @return [Google::Apis::MlV1::GoogleCloudMlV1AutomatedStoppingConfig]
+        attr_accessor :automated_stopping_config
+      
+        # Metric specs for the study.
+        # Corresponds to the JSON property `metrics`
+        # @return [Array<Google::Apis::MlV1::GoogleCloudMlV1StudyConfigMetricSpec>]
+        attr_accessor :metrics
+      
+        # Required. The set of parameters to tune.
+        # Corresponds to the JSON property `parameters`
+        # @return [Array<Google::Apis::MlV1::GoogleCloudMlV1StudyConfigParameterSpec>]
+        attr_accessor :parameters
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @algorithm = args[:algorithm] if args.key?(:algorithm)
+          @automated_stopping_config = args[:automated_stopping_config] if args.key?(:automated_stopping_config)
+          @metrics = args[:metrics] if args.key?(:metrics)
+          @parameters = args[:parameters] if args.key?(:parameters)
+        end
+      end
+      
+      # Metadata field of a google.longrunning.Operation associated
+      # with a SuggestTrialsRequest.
+      class GoogleCloudMlV1SuggestTrialsMetadata
+        include Google::Apis::Core::Hashable
+      
+        # The identifier of the client that is requesting the suggestion.
+        # Corresponds to the JSON property `clientId`
+        # @return [String]
+        attr_accessor :client_id
+      
+        # The time operation was submitted.
+        # Corresponds to the JSON property `createTime`
+        # @return [String]
+        attr_accessor :create_time
+      
+        # The name of the study that the trial belongs to.
+        # Corresponds to the JSON property `study`
+        # @return [String]
+        attr_accessor :study
+      
+        # The number of suggestions requested.
+        # Corresponds to the JSON property `suggestionCount`
+        # @return [Fixnum]
+        attr_accessor :suggestion_count
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @client_id = args[:client_id] if args.key?(:client_id)
+          @create_time = args[:create_time] if args.key?(:create_time)
+          @study = args[:study] if args.key?(:study)
+          @suggestion_count = args[:suggestion_count] if args.key?(:suggestion_count)
+        end
+      end
+      
+      # The request message for the SuggestTrial service method.
+      class GoogleCloudMlV1SuggestTrialsRequest
+        include Google::Apis::Core::Hashable
+      
+        # Required. The identifier of the client that is requesting the suggestion.
+        # If multiple SuggestTrialsRequests have the same `client_id`,
+        # the service will return the identical suggested trial if the trial is
+        # pending, and provide a new trial if the last suggested trial was completed.
+        # Corresponds to the JSON property `clientId`
+        # @return [String]
+        attr_accessor :client_id
+      
+        # Required. The number of suggestions requested.
+        # Corresponds to the JSON property `suggestionCount`
+        # @return [Fixnum]
+        attr_accessor :suggestion_count
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @client_id = args[:client_id] if args.key?(:client_id)
+          @suggestion_count = args[:suggestion_count] if args.key?(:suggestion_count)
+        end
+      end
+      
+      # This message will be placed in the response field of a completed
+      # google.longrunning.Operation associated with a SuggestTrials request.
+      class GoogleCloudMlV1SuggestTrialsResponse
+        include Google::Apis::Core::Hashable
+      
+        # The time at which operation processing completed.
+        # Corresponds to the JSON property `endTime`
+        # @return [String]
+        attr_accessor :end_time
+      
+        # The time at which the operation was started.
+        # Corresponds to the JSON property `startTime`
+        # @return [String]
+        attr_accessor :start_time
+      
+        # The state of the study.
+        # Corresponds to the JSON property `studyState`
+        # @return [String]
+        attr_accessor :study_state
+      
+        # A list of trials.
+        # Corresponds to the JSON property `trials`
+        # @return [Array<Google::Apis::MlV1::GoogleCloudMlV1Trial>]
+        attr_accessor :trials
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @end_time = args[:end_time] if args.key?(:end_time)
+          @start_time = args[:start_time] if args.key?(:start_time)
+          @study_state = args[:study_state] if args.key?(:study_state)
+          @trials = args[:trials] if args.key?(:trials)
+        end
+      end
+      
+      # Represents input parameters for a training job. When using the gcloud command
+      # to submit your training job, you can specify the input parameters as
+      # command-line arguments and/or in a YAML configuration file referenced from
+      # the --config command-line argument. For details, see the guide to [submitting
+      # a training job](/ai-platform/training/docs/training-jobs).
       class GoogleCloudMlV1TrainingInput
         include Google::Apis::Core::Hashable
       
-        # Optional. Command line arguments to pass to the program.
+        # Optional. Command-line arguments passed to the training application when it
+        # starts. If your job uses a custom container, then the arguments are passed
+        # to the container's <a class="external" target="_blank"
+        # href="https://docs.docker.com/engine/reference/builder/#entrypoint">
+        # `ENTRYPOINT`</a> command.
         # Corresponds to the JSON property `args`
         # @return [Array<String>]
         attr_accessor :args
       
+        # Represents a custom encryption key configuration that can be applied to
+        # a resource.
+        # Corresponds to the JSON property `encryptionConfig`
+        # @return [Google::Apis::MlV1::GoogleCloudMlV1EncryptionConfig]
+        attr_accessor :encryption_config
+      
+        # Represents the configuration for a replica in a cluster.
+        # Corresponds to the JSON property `evaluatorConfig`
+        # @return [Google::Apis::MlV1::GoogleCloudMlV1ReplicaConfig]
+        attr_accessor :evaluator_config
+      
+        # Optional. The number of evaluator replicas to use for the training job.
+        # Each replica in the cluster will be of the type specified in
+        # `evaluator_type`.
+        # This value can only be used when `scale_tier` is set to `CUSTOM`. If you
+        # set this value, you must also set `evaluator_type`.
+        # The default value is zero.
+        # Corresponds to the JSON property `evaluatorCount`
+        # @return [Fixnum]
+        attr_accessor :evaluator_count
+      
+        # Optional. Specifies the type of virtual machine to use for your training
+        # job's evaluator nodes.
+        # The supported values are the same as those described in the entry for
+        # `masterType`.
+        # This value must be consistent with the category of machine type that
+        # `masterType` uses. In other words, both must be Compute Engine machine
+        # types or both must be legacy machine types.
+        # This value must be present when `scaleTier` is set to `CUSTOM` and
+        # `evaluatorCount` is greater than zero.
+        # Corresponds to the JSON property `evaluatorType`
+        # @return [String]
+        attr_accessor :evaluator_type
+      
         # Represents a set of hyperparameters to optimize.
         # Corresponds to the JSON property `hyperparameters`
         # @return [Google::Apis::MlV1::GoogleCloudMlV1HyperparameterSpec]
@@ -1316,92 +2407,10 @@ module Google
         attr_accessor :master_config
       
         # Optional. Specifies the type of virtual machine to use for your training
-        # job's master worker.
+        # job's master worker. You must specify this field when `scaleTier` is set to
+        # `CUSTOM`.
+        # You can use certain Compute Engine machine types directly in this field.
         # The following types are supported:
-        # <dl>
-        # <dt>standard</dt>
-        # <dd>
-        # A basic machine configuration suitable for training simple models with
-        # small to moderate datasets.
-        # </dd>
-        # <dt>large_model</dt>
-        # <dd>
-        # A machine with a lot of memory, specially suited for parameter servers
-        # when your model is large (having many hidden layers or layers with very
-        # large numbers of nodes).
-        # </dd>
-        # <dt>complex_model_s</dt>
-        # <dd>
-        # A machine suitable for the master and workers of the cluster when your
-        # model requires more computation than the standard machine can handle
-        # satisfactorily.
-        # </dd>
-        # <dt>complex_model_m</dt>
-        # <dd>
-        # A machine with roughly twice the number of cores and roughly double the
-        # memory of <i>complex_model_s</i>.
-        # </dd>
-        # <dt>complex_model_l</dt>
-        # <dd>
-        # A machine with roughly twice the number of cores and roughly double the
-        # memory of <i>complex_model_m</i>.
-        # </dd>
-        # <dt>standard_gpu</dt>
-        # <dd>
-        # A machine equivalent to <i>standard</i> that
-        # also includes a single NVIDIA Tesla K80 GPU. See more about
-        # <a href="/ml-engine/docs/tensorflow/using-gpus">using GPUs to
-        # train your model</a>.
-        # </dd>
-        # <dt>complex_model_m_gpu</dt>
-        # <dd>
-        # A machine equivalent to <i>complex_model_m</i> that also includes
-        # four NVIDIA Tesla K80 GPUs.
-        # </dd>
-        # <dt>complex_model_l_gpu</dt>
-        # <dd>
-        # A machine equivalent to <i>complex_model_l</i> that also includes
-        # eight NVIDIA Tesla K80 GPUs.
-        # </dd>
-        # <dt>standard_p100</dt>
-        # <dd>
-        # A machine equivalent to <i>standard</i> that
-        # also includes a single NVIDIA Tesla P100 GPU.
-        # </dd>
-        # <dt>complex_model_m_p100</dt>
-        # <dd>
-        # A machine equivalent to <i>complex_model_m</i> that also includes
-        # four NVIDIA Tesla P100 GPUs.
-        # </dd>
-        # <dt>standard_v100</dt>
-        # <dd>
-        # A machine equivalent to <i>standard</i> that
-        # also includes a single NVIDIA Tesla V100 GPU.
-        # </dd>
-        # <dt>large_model_v100</dt>
-        # <dd>
-        # A machine equivalent to <i>large_model</i> that
-        # also includes a single NVIDIA Tesla V100 GPU.
-        # </dd>
-        # <dt>complex_model_m_v100</dt>
-        # <dd>
-        # A machine equivalent to <i>complex_model_m</i> that
-        # also includes four NVIDIA Tesla V100 GPUs.
-        # </dd>
-        # <dt>complex_model_l_v100</dt>
-        # <dd>
-        # A machine equivalent to <i>complex_model_l</i> that
-        # also includes eight NVIDIA Tesla V100 GPUs.
-        # </dd>
-        # <dt>cloud_tpu</dt>
-        # <dd>
-        # A TPU VM including one Cloud TPU. See more about
-        # <a href="/ml-engine/docs/tensorflow/using-tpus">using TPUs to train
-        # your model</a>.
-        # </dd>
-        # </dl>
-        # You may also use certain Compute Engine machine types directly in this
-        # field. The following types are supported:
         # - `n1-standard-4`
         # - `n1-standard-8`
         # - `n1-standard-16`
@@ -1419,13 +2428,46 @@ module Google
         # - `n1-highcpu-32`
         # - `n1-highcpu-64`
         # - `n1-highcpu-96`
-        # See more about [using Compute Engine machine
-        # types](/ml-engine/docs/tensorflow/machine-types#compute-engine-machine-types).
-        # You must set this value when `scaleTier` is set to `CUSTOM`.
+        # Learn more about [using Compute Engine machine
+        # types](/ml-engine/docs/machine-types#compute-engine-machine-types).
+        # Alternatively, you can use the following legacy machine types:
+        # - `standard`
+        # - `large_model`
+        # - `complex_model_s`
+        # - `complex_model_m`
+        # - `complex_model_l`
+        # - `standard_gpu`
+        # - `complex_model_m_gpu`
+        # - `complex_model_l_gpu`
+        # - `standard_p100`
+        # - `complex_model_m_p100`
+        # - `standard_v100`
+        # - `large_model_v100`
+        # - `complex_model_m_v100`
+        # - `complex_model_l_v100`
+        # Learn more about [using legacy machine
+        # types](/ml-engine/docs/machine-types#legacy-machine-types).
+        # Finally, if you want to use a TPU for training, specify `cloud_tpu` in this
+        # field. Learn more about the [special configuration options for training
+        # with
+        # TPUs](/ml-engine/docs/tensorflow/using-tpus#configuring_a_custom_tpu_machine).
         # Corresponds to the JSON property `masterType`
         # @return [String]
         attr_accessor :master_type
       
+        # Optional. The full name of the Google Compute Engine
+        # [network](/compute/docs/networks-and-firewalls#networks) to which the Job
+        # is peered. For example, projects/12345/global/networks/myVPC. Format is of
+        # the form projects/`project`/global/networks/`network`. Where `project` is a
+        # project number, as in '12345', and `network` is network name.".
+        # Private services access must already be configured for the network. If left
+        # unspecified, the Job is not peered with any network. Learn more -
+        # Connecting Job to user network over private
+        # IP.
+        # Corresponds to the JSON property `network`
+        # @return [String]
+        attr_accessor :network
+      
         # Required. The Google Cloud Storage location of the packages with
         # the training program and any additional dependencies.
         # The maximum number of package URIs is 100.
@@ -1441,7 +2483,7 @@ module Google
         # Optional. The number of parameter server replicas to use for the training
         # job. Each replica in the cluster will be of the type specified in
         # `parameter_server_type`.
-        # This value can only be used when `scale_tier` is set to `CUSTOM`.If you
+        # This value can only be used when `scale_tier` is set to `CUSTOM`. If you
         # set this value, you must also set `parameter_server_type`.
         # The default value is zero.
         # Corresponds to the JSON property `parameterServerCount`
@@ -1453,8 +2495,8 @@ module Google
         # The supported values are the same as those described in the entry for
         # `master_type`.
         # This value must be consistent with the category of machine type that
-        # `masterType` uses. In other words, both must be AI Platform machine
-        # types or both must be Compute Engine machine types.
+        # `masterType` uses. In other words, both must be Compute Engine machine
+        # types or both must be legacy machine types.
         # This value must be present when `scaleTier` is set to `CUSTOM` and
         # `parameter_server_count` is greater than zero.
         # Corresponds to the JSON property `parameterServerType`
@@ -1466,27 +2508,32 @@ module Google
         # @return [String]
         attr_accessor :python_module
       
-        # Optional. The version of Python used in training. If not set, the default
-        # version is '2.7'. Python '3.5' is available when `runtime_version` is set
-        # to '1.4' and above. Python '2.7' works with all supported
-        # <a href="/ml-engine/docs/runtime-version-list">runtime versions</a>.
+        # Optional. The version of Python used in training. You must either specify
+        # this field or specify `masterConfig.imageUri`.
+        # The following Python versions are available:
+        # * Python '3.7' is available when `runtime_version` is set to '1.15' or
+        # later.
+        # * Python '3.5' is available when `runtime_version` is set to a version
+        # from '1.4' to '1.14'.
+        # * Python '2.7' is available when `runtime_version` is set to '1.15' or
+        # earlier.
+        # Read more about the Python versions available for [each runtime
+        # version](/ml-engine/docs/runtime-version-list).
         # Corresponds to the JSON property `pythonVersion`
         # @return [String]
         attr_accessor :python_version
       
-        # Required. The Google Compute Engine region to run the training job in.
-        # See the <a href="/ml-engine/docs/tensorflow/regions">available regions</a>
-        # for AI Platform services.
+        # Required. The region to run the training job in. See the [available
+        # regions](/ai-platform/training/docs/regions) for AI Platform Training.
         # Corresponds to the JSON property `region`
         # @return [String]
         attr_accessor :region
       
-        # Optional. The AI Platform runtime version to use for training. If not
-        # set, AI Platform uses the default stable version, 1.0. For more
-        # information, see the
-        # <a href="/ml-engine/docs/runtime-version-list">runtime version list</a>
-        # and
-        # <a href="/ml-engine/docs/versioning">how to manage runtime versions</a>.
+        # Optional. The AI Platform runtime version to use for training. You must
+        # either specify this field or specify `masterConfig.imageUri`.
+        # For more information, see the [runtime version
+        # list](/ai-platform/training/docs/runtime-version-list) and learn [how to
+        # manage runtime versions](/ai-platform/training/docs/versioning).
         # Corresponds to the JSON property `runtimeVersion`
         # @return [String]
         attr_accessor :runtime_version
@@ -1497,6 +2544,23 @@ module Google
         # @return [String]
         attr_accessor :scale_tier
       
+        # All parameters related to scheduling of training jobs.
+        # Corresponds to the JSON property `scheduling`
+        # @return [Google::Apis::MlV1::GoogleCloudMlV1Scheduling]
+        attr_accessor :scheduling
+      
+        # Optional. Use `chief` instead of `master` in the `TF_CONFIG` environment
+        # variable when training with a custom container. Defaults to `false`. [Learn
+        # more about this
+        # field.](/ai-platform/training/docs/distributed-training-details#chief-versus-
+        # master)
+        # This field has no effect for training jobs that don't use a custom
+        # container.
+        # Corresponds to the JSON property `useChiefInTfConfig`
+        # @return [Boolean]
+        attr_accessor :use_chief_in_tf_config
+        alias_method :use_chief_in_tf_config?, :use_chief_in_tf_config
+      
         # Represents the configuration for a replica in a cluster.
         # Corresponds to the JSON property `workerConfig`
         # @return [Google::Apis::MlV1::GoogleCloudMlV1ReplicaConfig]
@@ -1516,8 +2580,8 @@ module Google
         # The supported values are the same as those described in the entry for
         # `masterType`.
         # This value must be consistent with the category of machine type that
-        # `masterType` uses. In other words, both must be AI Platform machine
-        # types or both must be Compute Engine machine types.
+        # `masterType` uses. In other words, both must be Compute Engine machine
+        # types or both must be legacy machine types.
         # If you use `cloud_tpu` for this value, see special instructions for
         # [configuring a custom TPU
         # machine](/ml-engine/docs/tensorflow/using-tpus#
@@ -1535,10 +2599,15 @@ module Google
         # Update properties of this object
         def update!(**args)
           @args = args[:args] if args.key?(:args)
+          @encryption_config = args[:encryption_config] if args.key?(:encryption_config)
+          @evaluator_config = args[:evaluator_config] if args.key?(:evaluator_config)
+          @evaluator_count = args[:evaluator_count] if args.key?(:evaluator_count)
+          @evaluator_type = args[:evaluator_type] if args.key?(:evaluator_type)
           @hyperparameters = args[:hyperparameters] if args.key?(:hyperparameters)
           @job_dir = args[:job_dir] if args.key?(:job_dir)
           @master_config = args[:master_config] if args.key?(:master_config)
           @master_type = args[:master_type] if args.key?(:master_type)
+          @network = args[:network] if args.key?(:network)
           @package_uris = args[:package_uris] if args.key?(:package_uris)
           @parameter_server_config = args[:parameter_server_config] if args.key?(:parameter_server_config)
           @parameter_server_count = args[:parameter_server_count] if args.key?(:parameter_server_count)
@@ -1548,6 +2617,8 @@ module Google
           @region = args[:region] if args.key?(:region)
           @runtime_version = args[:runtime_version] if args.key?(:runtime_version)
           @scale_tier = args[:scale_tier] if args.key?(:scale_tier)
+          @scheduling = args[:scheduling] if args.key?(:scheduling)
+          @use_chief_in_tf_config = args[:use_chief_in_tf_config] if args.key?(:use_chief_in_tf_config)
           @worker_config = args[:worker_config] if args.key?(:worker_config)
           @worker_count = args[:worker_count] if args.key?(:worker_count)
           @worker_type = args[:worker_type] if args.key?(:worker_type)
@@ -1617,17 +2688,96 @@ module Google
         end
       end
       
+      # A message representing a trial.
+      class GoogleCloudMlV1Trial
+        include Google::Apis::Core::Hashable
+      
+        # Output only. The identifier of the client that originally requested this trial.
+        # Corresponds to the JSON property `clientId`
+        # @return [String]
+        attr_accessor :client_id
+      
+        # Output only. Time at which the trial's status changed to COMPLETED.
+        # Corresponds to the JSON property `endTime`
+        # @return [String]
+        attr_accessor :end_time
+      
+        # A message representing a measurement.
+        # Corresponds to the JSON property `finalMeasurement`
+        # @return [Google::Apis::MlV1::GoogleCloudMlV1Measurement]
+        attr_accessor :final_measurement
+      
+        # Output only. A human readable string describing why the trial is
+        # infeasible. This should only be set if trial_infeasible is true.
+        # Corresponds to the JSON property `infeasibleReason`
+        # @return [String]
+        attr_accessor :infeasible_reason
+      
+        # A list of measurements that are strictly lexicographically
+        # ordered by their induced tuples (steps, elapsed_time).
+        # These are used for early stopping computations.
+        # Corresponds to the JSON property `measurements`
+        # @return [Array<Google::Apis::MlV1::GoogleCloudMlV1Measurement>]
+        attr_accessor :measurements
+      
+        # Output only. Name of the trial assigned by the service.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # The parameters of the trial.
+        # Corresponds to the JSON property `parameters`
+        # @return [Array<Google::Apis::MlV1::GoogleCloudMlV1TrialParameter>]
+        attr_accessor :parameters
+      
+        # Output only. Time at which the trial was started.
+        # Corresponds to the JSON property `startTime`
+        # @return [String]
+        attr_accessor :start_time
+      
+        # The detailed state of a trial.
+        # Corresponds to the JSON property `state`
+        # @return [String]
+        attr_accessor :state
+      
+        # Output only. If true, the parameters in this trial are not attempted again.
+        # Corresponds to the JSON property `trialInfeasible`
+        # @return [Boolean]
+        attr_accessor :trial_infeasible
+        alias_method :trial_infeasible?, :trial_infeasible
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @client_id = args[:client_id] if args.key?(:client_id)
+          @end_time = args[:end_time] if args.key?(:end_time)
+          @final_measurement = args[:final_measurement] if args.key?(:final_measurement)
+          @infeasible_reason = args[:infeasible_reason] if args.key?(:infeasible_reason)
+          @measurements = args[:measurements] if args.key?(:measurements)
+          @name = args[:name] if args.key?(:name)
+          @parameters = args[:parameters] if args.key?(:parameters)
+          @start_time = args[:start_time] if args.key?(:start_time)
+          @state = args[:state] if args.key?(:state)
+          @trial_infeasible = args[:trial_infeasible] if args.key?(:trial_infeasible)
+        end
+      end
+      
       # Represents a version of the model.
       # Each version is a trained model deployed in the cloud, ready to handle
       # prediction requests. A model can have multiple versions. You can get
       # information about all of the versions of a given model by calling
-      # [projects.models.versions.list](/ml-engine/reference/rest/v1/projects.models.
-      # versions/list).
+      # projects.models.versions.list.
       class GoogleCloudMlV1Version
         include Google::Apis::Core::Hashable
       
         # Represents a hardware accelerator request config.
-        # Note that the AcceleratorConfig could be used in both Jobs and Versions.
+        # Note that the AcceleratorConfig can be used in both Jobs and Versions.
+        # Learn more about [accelerators for training](/ml-engine/docs/using-gpus) and
+        # [accelerators for online
+        # prediction](/ml-engine/docs/machine-types-online-prediction#gpus).
         # Corresponds to the JSON property `acceleratorConfig`
         # @return [Google::Apis::MlV1::GoogleCloudMlV1AcceleratorConfig]
         attr_accessor :accelerator_config
@@ -1648,8 +2798,7 @@ module Google
         # deployment](/ml-engine/docs/tensorflow/deploying-models) for more
         # information.
         # When passing Version to
-        # [projects.models.versions.create](/ml-engine/reference/rest/v1/projects.models.
-        # versions/create)
+        # projects.models.versions.create
         # the model service uses the specified location as the source of the model.
         # Once deployed, the model version is hosted by the prediction service, so
         # this location is useful only as a historical record.
@@ -1680,6 +2829,15 @@ module Google
         # @return [String]
         attr_accessor :etag
       
+        # Message holding configuration options for explaining model predictions.
+        # There are two feature attribution methods supported for TensorFlow models:
+        # integrated gradients and sampled Shapley.
+        # [Learn more about feature
+        # attributions.](/ai-platform/prediction/docs/ai-explanations/overview)
+        # Corresponds to the JSON property `explanationConfig`
+        # @return [Google::Apis::MlV1::GoogleCloudMlV1ExplanationConfig]
+        attr_accessor :explanation_config
+      
         # Optional. The machine learning framework AI Platform uses to train
         # this version of the model. Valid values are `TENSORFLOW`, `SCIKIT_LEARN`,
         # `XGBOOST`. If you do not specify a framework, AI Platform
@@ -1688,6 +2846,10 @@ module Google
         # of the model to 1.4 or greater.
         # Do **not** specify a framework if you're deploying a [custom
         # prediction routine](/ml-engine/docs/tensorflow/custom-prediction-routines).
+        # If you specify a [Compute Engine (N1) machine
+        # type](/ml-engine/docs/machine-types-online-prediction) in the
+        # `machineType` field, you must specify `TENSORFLOW`
+        # for the framework.
         # Corresponds to the JSON property `framework`
         # @return [String]
         attr_accessor :framework
@@ -1695,8 +2857,7 @@ module Google
         # Output only. If true, this version will be used to handle prediction
         # requests that do not specify a version.
         # You can change the default version by calling
-        # [projects.methods.versions.setDefault](/ml-engine/reference/rest/v1/projects.
-        # models.versions/setDefault).
+        # projects.methods.versions.setDefault.
         # Corresponds to the JSON property `isDefault`
         # @return [Boolean]
         attr_accessor :is_default
@@ -1717,19 +2878,29 @@ module Google
         attr_accessor :last_use_time
       
         # Optional. The type of machine on which to serve the model. Currently only
-        # applies to online prediction service.
-        # <dl>
-        # <dt>mls1-c1-m2</dt>
-        # <dd>
-        # The <b>default</b> machine type, with 1 core and 2 GB RAM. The deprecated
-        # name for this machine type is "mls1-highmem-1".
-        # </dd>
-        # <dt>mls1-c4-m2</dt>
-        # <dd>
-        # In <b>Beta</b>. This machine type has 4 cores and 2 GB RAM. The
-        # deprecated name for this machine type is "mls1-highcpu-4".
-        # </dd>
-        # </dl>
+        # applies to online prediction service. If this field is not specified, it
+        # defaults to `mls1-c1-m2`.
+        # Online prediction supports the following machine types:
+        # * `mls1-c1-m2`
+        # * `mls1-c4-m2`
+        # * `n1-standard-2`
+        # * `n1-standard-4`
+        # * `n1-standard-8`
+        # * `n1-standard-16`
+        # * `n1-standard-32`
+        # * `n1-highmem-2`
+        # * `n1-highmem-4`
+        # * `n1-highmem-8`
+        # * `n1-highmem-16`
+        # * `n1-highmem-32`
+        # * `n1-highcpu-2`
+        # * `n1-highcpu-4`
+        # * `n1-highcpu-8`
+        # * `n1-highcpu-16`
+        # * `n1-highcpu-32`
+        # `mls1-c1-m2` is generally available. All other machine types are available
+        # in beta. Learn more about the [differences between machine
+        # types](/ml-engine/docs/machine-types-online-prediction).
         # Corresponds to the JSON property `machineType`
         # @return [String]
         attr_accessor :machine_type
@@ -1769,9 +2940,11 @@ module Google
         # Specify this field if and only if you are deploying a [custom prediction
         # routine (beta)](/ml-engine/docs/tensorflow/custom-prediction-routines).
         # If you specify this field, you must set
-        # [`runtimeVersion`](#Version.FIELDS.runtime_version) to 1.4 or greater.
+        # [`runtimeVersion`](#Version.FIELDS.runtime_version) to 1.4 or greater and
+        # you must set `machineType` to a [legacy (MLS1)
+        # machine type](/ml-engine/docs/machine-types-online-prediction).
         # The following code sample provides the Predictor interface:
-        # ```py
+        # <pre style="max-width: 626px;">
         # class Predictor(object):
         # """Interface for constructing custom predictors."""
         # def predict(self, instances, **kwargs):
@@ -1799,16 +2972,23 @@ module Google
         # An instance implementing this Predictor class.
         # """
         # raise NotImplementedError()
-        # ```
+        # </pre>
         # Learn more about [the Predictor interface and custom prediction
         # routines](/ml-engine/docs/tensorflow/custom-prediction-routines).
         # Corresponds to the JSON property `predictionClass`
         # @return [String]
         attr_accessor :prediction_class
       
-        # Optional. The version of Python used in prediction. If not set, the default
-        # version is '2.7'. Python '3.5' is available when `runtime_version` is set
-        # to '1.4' and above. Python '2.7' works with all supported runtime versions.
+        # Required. The version of Python used in prediction.
+        # The following Python versions are available:
+        # * Python '3.7' is available when `runtime_version` is set to '1.15' or
+        # later.
+        # * Python '3.5' is available when `runtime_version` is set to a version
+        # from '1.4' to '1.14'.
+        # * Python '2.7' is available when `runtime_version` is set to '1.15' or
+        # earlier.
+        # Read more about the Python versions available for [each runtime
+        # version](/ml-engine/docs/runtime-version-list).
         # Corresponds to the JSON property `pythonVersion`
         # @return [String]
         attr_accessor :python_version
@@ -1828,9 +3008,8 @@ module Google
         # @return [Google::Apis::MlV1::GoogleCloudMlV1RequestLoggingConfig]
         attr_accessor :request_logging_config
       
-        # Optional. The AI Platform runtime version to use for this deployment.
-        # If not set, AI Platform uses the default stable version, 1.0. For more
-        # information, see the
+        # Required. The AI Platform runtime version to use for this deployment.
+        # For more information, see the
         # [runtime version list](/ml-engine/docs/runtime-version-list) and
         # [how to manage runtime versions](/ml-engine/docs/versioning).
         # Corresponds to the JSON property `runtimeVersion`
@@ -1860,6 +3039,7 @@ module Google
           @description = args[:description] if args.key?(:description)
           @error_message = args[:error_message] if args.key?(:error_message)
           @etag = args[:etag] if args.key?(:etag)
+          @explanation_config = args[:explanation_config] if args.key?(:explanation_config)
           @framework = args[:framework] if args.key?(:framework)
           @is_default = args[:is_default] if args.key?(:is_default)
           @labels = args[:labels] if args.key?(:labels)
@@ -1877,6 +3057,30 @@ module Google
         end
       end
       
+      # Attributes credit by computing the XRAI taking advantage
+      # of the model's fully differentiable structure. Refer to this paper for
+      # more details: https://arxiv.org/abs/1906.02825
+      # Currently only implemented for models with natural image inputs.
+      class GoogleCloudMlV1XraiAttribution
+        include Google::Apis::Core::Hashable
+      
+        # Number of steps for approximating the path integral.
+        # A good value to start is 50 and gradually increase until the
+        # sum to diff property is met within the desired error range.
+        # Corresponds to the JSON property `numIntegralSteps`
+        # @return [Fixnum]
+        attr_accessor :num_integral_steps
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @num_integral_steps = args[:num_integral_steps] if args.key?(:num_integral_steps)
+        end
+      end
+      
       # Specifies the audit configuration for a service.
       # The configuration determines which permission types are logged, and what
       # identities, if any, are exempted from logging.
@@ -1997,10 +3201,28 @@ module Google
       class GoogleIamV1Binding
         include Google::Apis::Core::Hashable
       
-        # Represents an expression text. Example:
-        # title: "User account presence"
-        # description: "Determines whether the request has a user account"
-        # expression: "size(request.user) > 0"
+        # Represents a textual expression in the Common Expression Language (CEL)
+        # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
+        # are documented at https://github.com/google/cel-spec.
+        # Example (Comparison):
+        # title: "Summary size limit"
+        # description: "Determines if a summary is less than 100 chars"
+        # expression: "document.summary.size() < 100"
+        # Example (Equality):
+        # title: "Requestor is owner"
+        # description: "Determines if requestor is the document owner"
+        # expression: "document.owner == request.auth.claims.email"
+        # Example (Logic):
+        # title: "Public documents"
+        # description: "Determine whether the document should be publicly visible"
+        # expression: "document.type != 'private' && document.type != 'internal'"
+        # Example (Data Manipulation):
+        # title: "Notification string"
+        # description: "Create a notification string with a timestamp."
+        # expression: "'New message received at ' + string(document.create_time)"
+        # The exact variables and functions that may be referenced within an expression
+        # are determined by the service that evaluates it. See the service
+        # documentation for additional information.
         # Corresponds to the JSON property `condition`
         # @return [Google::Apis::MlV1::GoogleTypeExpr]
         attr_accessor :condition
@@ -2017,6 +3239,23 @@ module Google
         # account. For example, `my-other-app@appspot.gserviceaccount.com`.
         # * `group:`emailid``: An email address that represents a Google group.
         # For example, `admins@example.com`.
+        # * `deleted:user:`emailid`?uid=`uniqueid``: An email address (plus unique
+        # identifier) representing a user that has been recently deleted. For
+        # example, `alice@example.com?uid=123456789012345678901`. If the user is
+        # recovered, this value reverts to `user:`emailid`` and the recovered user
+        # retains the role in the binding.
+        # * `deleted:serviceAccount:`emailid`?uid=`uniqueid``: An email address (plus
+        # unique identifier) representing a service account that has been recently
+        # deleted. For example,
+        # `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`.
+        # If the service account is undeleted, this value reverts to
+        # `serviceAccount:`emailid`` and the undeleted service account retains the
+        # role in the binding.
+        # * `deleted:group:`emailid`?uid=`uniqueid``: An email address (plus unique
+        # identifier) representing a Google group that has been recently
+        # deleted. For example, `admins@example.com?uid=123456789012345678901`. If
+        # the group is recovered, this value reverts to `group:`emailid`` and the
+        # recovered group retains the role in the binding.
         # * `domain:`domain``: The G Suite domain (primary) that represents all the
         # users of that domain. For example, `google.com` or `example.com`.
         # Corresponds to the JSON property `members`
@@ -2041,16 +3280,21 @@ module Google
         end
       end
       
-      # Defines an Identity and Access Management (IAM) policy. It is used to
-      # specify access control policies for Cloud Platform resources.
+      # An Identity and Access Management (IAM) policy, which specifies access
+      # controls for Google Cloud resources.
       # A `Policy` is a collection of `bindings`. A `binding` binds one or more
       # `members` to a single `role`. Members can be user accounts, service accounts,
       # Google groups, and domains (such as G Suite). A `role` is a named list of
-      # permissions (defined by IAM or configured by users). A `binding` can
-      # optionally specify a `condition`, which is a logic expression that further
-      # constrains the role binding based on attributes about the request and/or
-      # target resource.
-      # **JSON Example**
+      # permissions; each `role` can be an IAM predefined role or a user-created
+      # custom role.
+      # For some types of Google Cloud resources, a `binding` can also specify a
+      # `condition`, which is a logical expression that allows access to a resource
+      # only if the expression evaluates to `true`. A condition can add constraints
+      # based on attributes of the request, the resource, or both. To learn which
+      # resources support conditions in their IAM policies, see the
+      # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
+      # policies).
+      # **JSON example:**
       # `
       # "bindings": [
       # `
@@ -2064,17 +3308,21 @@ module Google
       # `,
       # `
       # "role": "roles/resourcemanager.organizationViewer",
-      # "members": ["user:eve@example.com"],
+      # "members": [
+      # "user:eve@example.com"
+      # ],
       # "condition": `
       # "title": "expirable access",
       # "description": "Does not grant access after Sep 2020",
-      # "expression": "request.time <
-      # timestamp('2020-10-01T00:00:00.000Z')",
+      # "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')
+      # ",
       # `
       # `
-      # ]
+      # ],
+      # "etag": "BwWWja0YfJA=",
+      # "version": 3
       # `
-      # **YAML Example**
+      # **YAML example:**
       # bindings:
       # - members:
       # - user:mike@example.com
@@ -2089,8 +3337,10 @@ module Google
       # title: expirable access
       # description: Does not grant access after Sep 2020
       # expression: request.time < timestamp('2020-10-01T00:00:00.000Z')
+      # - etag: BwWWja0YfJA=
+      # - version: 3
       # For a description of IAM and its features, see the
-      # [IAM developer's guide](https://cloud.google.com/iam/docs).
+      # [IAM documentation](https://cloud.google.com/iam/docs/).
       class GoogleIamV1Policy
         include Google::Apis::Core::Hashable
       
@@ -2099,9 +3349,9 @@ module Google
         # @return [Array<Google::Apis::MlV1::GoogleIamV1AuditConfig>]
         attr_accessor :audit_configs
       
-        # Associates a list of `members` to a `role`. Optionally may specify a
-        # `condition` that determines when binding is in effect.
-        # `bindings` with no members will result in an error.
+        # Associates a list of `members` to a `role`. Optionally, may specify a
+        # `condition` that determines how and when the `bindings` are applied. Each
+        # of the `bindings` must contain at least one member.
         # Corresponds to the JSON property `bindings`
         # @return [Array<Google::Apis::MlV1::GoogleIamV1Binding>]
         attr_accessor :bindings
@@ -2113,25 +3363,34 @@ module Google
         # conditions: An `etag` is returned in the response to `getIamPolicy`, and
         # systems are expected to put that etag in the request to `setIamPolicy` to
         # ensure that their change will be applied to the same version of the policy.
-        # If no `etag` is provided in the call to `setIamPolicy`, then the existing
-        # policy is overwritten. Due to blind-set semantics of an etag-less policy,
-        # 'setIamPolicy' will not fail even if either of incoming or stored policy
-        # does not meet the version requirements.
+        # **Important:** If you use IAM Conditions, you must include the `etag` field
+        # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
+        # you to overwrite a version `3` policy with a version `1` policy, and all of
+        # the conditions in the version `3` policy are lost.
         # Corresponds to the JSON property `etag`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
         attr_accessor :etag
       
         # Specifies the format of the policy.
-        # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
-        # rejected.
-        # Operations affecting conditional bindings must specify version 3. This can
-        # be either setting a conditional policy, modifying a conditional binding,
-        # or removing a conditional binding from the stored conditional policy.
-        # Operations on non-conditional policies may specify any valid value or
-        # leave the field unset.
-        # If no etag is provided in the call to `setIamPolicy`, any version
-        # compliance checks on the incoming and/or stored policy is skipped.
+        # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
+        # are rejected.
+        # Any operation that affects conditional role bindings must specify version
+        # `3`. This requirement applies to the following operations:
+        # * Getting a policy that includes a conditional role binding
+        # * Adding a conditional role binding to a policy
+        # * Changing a conditional role binding in a policy
+        # * Removing any role binding, with or without a condition, from a policy
+        # that includes conditions
+        # **Important:** If you use IAM Conditions, you must include the `etag` field
+        # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
+        # you to overwrite a version `3` policy with a version `1` policy, and all of
+        # the conditions in the version `3` policy are lost.
+        # If a policy does not include any conditions, operations on that policy may
+        # specify any valid version or leave the field unset.
+        # To learn which resources support conditions in their IAM policies, see the
+        # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
+        # policies).
         # Corresponds to the JSON property `version`
         # @return [Fixnum]
         attr_accessor :version
@@ -2153,16 +3412,21 @@ module Google
       class GoogleIamV1SetIamPolicyRequest
         include Google::Apis::Core::Hashable
       
-        # Defines an Identity and Access Management (IAM) policy. It is used to
-        # specify access control policies for Cloud Platform resources.
+        # An Identity and Access Management (IAM) policy, which specifies access
+        # controls for Google Cloud resources.
         # A `Policy` is a collection of `bindings`. A `binding` binds one or more
         # `members` to a single `role`. Members can be user accounts, service accounts,
         # Google groups, and domains (such as G Suite). A `role` is a named list of
-        # permissions (defined by IAM or configured by users). A `binding` can
-        # optionally specify a `condition`, which is a logic expression that further
-        # constrains the role binding based on attributes about the request and/or
-        # target resource.
-        # **JSON Example**
+        # permissions; each `role` can be an IAM predefined role or a user-created
+        # custom role.
+        # For some types of Google Cloud resources, a `binding` can also specify a
+        # `condition`, which is a logical expression that allows access to a resource
+        # only if the expression evaluates to `true`. A condition can add constraints
+        # based on attributes of the request, the resource, or both. To learn which
+        # resources support conditions in their IAM policies, see the
+        # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
+        # policies).
+        # **JSON example:**
         # `
         # "bindings": [
         # `
@@ -2176,17 +3440,21 @@ module Google
         # `,
         # `
         # "role": "roles/resourcemanager.organizationViewer",
-        # "members": ["user:eve@example.com"],
+        # "members": [
+        # "user:eve@example.com"
+        # ],
         # "condition": `
         # "title": "expirable access",
         # "description": "Does not grant access after Sep 2020",
-        # "expression": "request.time <
-        # timestamp('2020-10-01T00:00:00.000Z')",
+        # "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')
+        # ",
         # `
         # `
-        # ]
+        # ],
+        # "etag": "BwWWja0YfJA=",
+        # "version": 3
         # `
-        # **YAML Example**
+        # **YAML example:**
         # bindings:
         # - members:
         # - user:mike@example.com
@@ -2201,8 +3469,10 @@ module Google
         # title: expirable access
         # description: Does not grant access after Sep 2020
         # expression: request.time < timestamp('2020-10-01T00:00:00.000Z')
+        # - etag: BwWWja0YfJA=
+        # - version: 3
         # For a description of IAM and its features, see the
-        # [IAM developer's guide](https://cloud.google.com/iam/docs).
+        # [IAM documentation](https://cloud.google.com/iam/docs/).
         # Corresponds to the JSON property `policy`
         # @return [Google::Apis::MlV1::GoogleIamV1Policy]
         attr_accessor :policy
@@ -2210,8 +3480,7 @@ module Google
         # OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only
         # the fields in the mask will be modified. If no mask is provided, the
         # following default mask is used:
-        # paths: "bindings, etag"
-        # This field is only used by Cloud IAM.
+        # `paths: "bindings, etag"`
         # Corresponds to the JSON property `updateMask`
         # @return [String]
         attr_accessor :update_mask
@@ -2416,34 +3685,50 @@ module Google
         end
       end
       
-      # Represents an expression text. Example:
-      # title: "User account presence"
-      # description: "Determines whether the request has a user account"
-      # expression: "size(request.user) > 0"
+      # Represents a textual expression in the Common Expression Language (CEL)
+      # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
+      # are documented at https://github.com/google/cel-spec.
+      # Example (Comparison):
+      # title: "Summary size limit"
+      # description: "Determines if a summary is less than 100 chars"
+      # expression: "document.summary.size() < 100"
+      # Example (Equality):
+      # title: "Requestor is owner"
+      # description: "Determines if requestor is the document owner"
+      # expression: "document.owner == request.auth.claims.email"
+      # Example (Logic):
+      # title: "Public documents"
+      # description: "Determine whether the document should be publicly visible"
+      # expression: "document.type != 'private' && document.type != 'internal'"
+      # Example (Data Manipulation):
+      # title: "Notification string"
+      # description: "Create a notification string with a timestamp."
+      # expression: "'New message received at ' + string(document.create_time)"
+      # The exact variables and functions that may be referenced within an expression
+      # are determined by the service that evaluates it. See the service
+      # documentation for additional information.
       class GoogleTypeExpr
         include Google::Apis::Core::Hashable
       
-        # An optional description of the expression. This is a longer text which
+        # Optional. Description of the expression. This is a longer text which
         # describes the expression, e.g. when hovered over it in a UI.
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
       
-        # Textual representation of an expression in
-        # Common Expression Language syntax.
-        # The application context of the containing message determines which
-        # well-known feature set of CEL is supported.
+        # Textual representation of an expression in Common Expression Language
+        # syntax.
         # Corresponds to the JSON property `expression`
         # @return [String]
         attr_accessor :expression
       
-        # An optional string indicating the location of the expression for error
+        # Optional. String indicating the location of the expression for error
         # reporting, e.g. a file name and a position in the file.
         # Corresponds to the JSON property `location`
         # @return [String]
         attr_accessor :location
       
-        # An optional title for the expression, i.e. a short string describing
+        # Optional. Title for the expression, i.e. a short string describing
         # its purpose. This can be used e.g. in UIs which allow to enter the
         # expression.
         # Corresponds to the JSON property `title`