google-api-client 0.34.1 → 0.35.0

data/generated/google/apis/healthcare_v1beta1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/healthcare
     module HealthcareV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20191021'
+      REVISION = '20191114'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -944,8 +944,8 @@ module Google
         # field[x]) we use two separate components. For example,
         # "deceasedAge.unit" is matched by "Deceased.Age.unit".
         # Supported types are: AdministrativeGenderCode, Code, Date, DateTime,
-        # Decimal, HumanName, Id, LanguageCode, Markdown, MimeTypeCode, Oid,
-        # String, Uri, Uuid, Xhtml.
+        # Decimal, HumanName, Id, LanguageCode, Markdown, Oid, String, Uri, Uuid,
+        # Xhtml.
         # Corresponds to the JSON property `paths`
         # @return [Array<String>]
         attr_accessor :paths
@@ -2251,8 +2251,8 @@ module Google
         # 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.
+        # 'setIamPolicy' will not fail even if the incoming policy version does not
+        # meet the requirements for modifying the stored policy.
         # Corresponds to the JSON property `etag`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
@@ -2263,11 +2263,12 @@ module Google
         # 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.
+        # or removing a binding (conditional or unconditional) 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.
+        # If no etag is provided in the call to `setIamPolicy`, version compliance
+        # checks against the stored policy is skipped.
         # Corresponds to the JSON property `version`
         # @return [Fixnum]
         attr_accessor :version

data/generated/google/apis/homegraph_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/actions/smarthome/create-app#request-sync
     module HomegraphV1
       VERSION = 'V1'
-      REVISION = '20190827'
+      REVISION = '20191115'
     end
   end
 end

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

@@ -78,7 +78,7 @@ module Google
         # Custom JSON data provided by the manufacturer and attached to QUERY and
         # EXECUTE requests in AoG.
         # Corresponds to the JSON property `customData`
-        # @return [String]
+        # @return [Hash<String,Object>]
         attr_accessor :custom_data
       
         # Device information.
@@ -96,6 +96,19 @@ module Google
         # @return [Google::Apis::HomegraphV1::DeviceNames]
         attr_accessor :name
       
+        # Indicates whether the device is capable of sending notifications. This
+        # field will be set by the agent (partner) on an incoming SYNC. If a device
+        # is not capable of generating notifications, the partner should set this
+        # flag to false. If a partner is not capable of calling
+        # ReportStateAndNotification to send notifications to Google, the partner
+        # should set this flag to false. If there is a user setting in the partner
+        # app to enable notifications and it is turned off, the partner should set
+        # this flag to false.
+        # Corresponds to the JSON property `notificationSupportedByAgent`
+        # @return [Boolean]
+        attr_accessor :notification_supported_by_agent
+        alias_method :notification_supported_by_agent?, :notification_supported_by_agent
+      
         # IDs of other devices associated with this device. This is used to
         # represent a device group (e.g. bonded zone) or "facets" synced
         # through different flows (e.g. Google Nest Hub Max with a Nest Camera).
@@ -145,6 +158,7 @@ module Google
           @device_info = args[:device_info] if args.key?(:device_info)
           @id = args[:id] if args.key?(:id)
           @name = args[:name] if args.key?(:name)
+          @notification_supported_by_agent = args[:notification_supported_by_agent] if args.key?(:notification_supported_by_agent)
           @other_device_ids = args[:other_device_ids] if args.key?(:other_device_ids)
           @room_hint = args[:room_hint] if args.key?(:room_hint)
           @structure_hint = args[:structure_hint] if args.key?(:structure_hint)

data/generated/google/apis/homegraph_v1/representations.rb

@@ -161,12 +161,13 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           hash :attributes, as: 'attributes'
-          property :custom_data, as: 'customData'
+          hash :custom_data, as: 'customData'
           property :device_info, as: 'deviceInfo', class: Google::Apis::HomegraphV1::DeviceInfo, decorator: Google::Apis::HomegraphV1::DeviceInfo::Representation
       
           property :id, as: 'id'
           property :name, as: 'name', class: Google::Apis::HomegraphV1::DeviceNames, decorator: Google::Apis::HomegraphV1::DeviceNames::Representation
       
+          property :notification_supported_by_agent, as: 'notificationSupportedByAgent'
           collection :other_device_ids, as: 'otherDeviceIds', class: Google::Apis::HomegraphV1::AgentOtherDeviceId, decorator: Google::Apis::HomegraphV1::AgentOtherDeviceId::Representation
       
           property :room_hint, as: 'roomHint'

data/generated/google/apis/iam_v1.rb

@@ -27,7 +27,7 @@ module Google
     # @see https://cloud.google.com/iam/
     module IamV1
       VERSION = 'V1'
-      REVISION = '20191025'
+      REVISION = '20191115'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -958,8 +958,8 @@ module Google
         # 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.
+        # 'setIamPolicy' will not fail even if the incoming policy version does not
+        # meet the requirements for modifying the stored policy.
         # Corresponds to the JSON property `etag`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
@@ -970,11 +970,12 @@ module Google
         # 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.
+        # or removing a binding (conditional or unconditional) 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.
+        # If no etag is provided in the call to `setIamPolicy`, version compliance
+        # checks against the stored policy is skipped.
         # Corresponds to the JSON property `version`
         # @return [Fixnum]
         attr_accessor :version

data/generated/google/apis/logging_v2.rb

@@ -28,7 +28,7 @@ module Google
     # @see https://cloud.google.com/logging/docs/
     module LoggingV2
       VERSION = 'V2'
-      REVISION = '20191007'
+      REVISION = '20191115'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -911,7 +911,7 @@ module Google
       
         # Required. A client-assigned identifier, such as "load-balancer-exclusion".
         # Identifiers are limited to 100 characters and can include only letters, digits,
-        # underscores, hyphens, and periods.
+        # underscores, hyphens, and periods. First character has to be alphanumeric.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -1120,6 +1120,12 @@ module Google
         # @return [String]
         attr_accessor :create_time
       
+        # Optional. A description of this sink. The maximum length of the description is
+        # 8000 characters.
+        # Corresponds to the JSON property `description`
+        # @return [String]
+        attr_accessor :description
+      
         # Required. The export destination:
         # "storage.googleapis.com/[GCS_BUCKET]"
         # "bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]"
@@ -1131,6 +1137,13 @@ module Google
         # @return [String]
         attr_accessor :destination
       
+        # Optional. If set to True, then this sink is disabled and it does not export
+        # any log entries.
+        # Corresponds to the JSON property `disabled`
+        # @return [Boolean]
+        attr_accessor :disabled
+        alias_method :disabled?, :disabled
+      
         # Do not use. This field is ignored.
         # Corresponds to the JSON property `endTime`
         # @return [String]
@@ -1164,7 +1177,8 @@ module Google
         # Required. The client-assigned sink identifier, unique within the project.
         # Example: "my-syslog-errors-to-pubsub". Sink identifiers are limited to 100
         # characters and can include only the following characters: upper and lower-case
-        # alphanumeric characters, underscores, hyphens, and periods.
+        # alphanumeric characters, underscores, hyphens, and periods. First character
+        # has to be alphanumeric.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -1206,7 +1220,9 @@ module Google
         def update!(**args)
           @bigquery_options = args[:bigquery_options] if args.key?(:bigquery_options)
           @create_time = args[:create_time] if args.key?(:create_time)
+          @description = args[:description] if args.key?(:description)
           @destination = args[:destination] if args.key?(:destination)
+          @disabled = args[:disabled] if args.key?(:disabled)
           @end_time = args[:end_time] if args.key?(:end_time)
           @filter = args[:filter] if args.key?(:filter)
           @include_children = args[:include_children] if args.key?(:include_children)

data/generated/google/apis/logging_v2/representations.rb

@@ -453,7 +453,9 @@ module Google
           property :bigquery_options, as: 'bigqueryOptions', class: Google::Apis::LoggingV2::BigQueryOptions, decorator: Google::Apis::LoggingV2::BigQueryOptions::Representation
       
           property :create_time, as: 'createTime'
+          property :description, as: 'description'
           property :destination, as: 'destination'
+          property :disabled, as: 'disabled'
           property :end_time, as: 'endTime'
           property :filter, as: 'filter'
           property :include_children, as: 'includeChildren'

data/generated/google/apis/ml_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/ml/
     module MlV1
       VERSION = 'V1'
-      REVISION = '20191025'
+      REVISION = '20191112'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -294,6 +294,87 @@ module Google
         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.
+      # Currently, the only supported mechanism to explain a model's prediction is
+      # through attributing its output back to its inputs which is essentially a
+      # credit assignment task. We support multiple attribution methods, some
+      # specific to particular frameworks like Tensorflow and XGBoost.
+      # Next idx: 7.
+      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: http://proceedings.mlr.press/v70/sundararajan17a.html
+        # 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
+      
+        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)
+        end
+      end
+      
       # Returns service account information associated with a project.
       class GoogleCloudMlV1GetConfigResponse
         include Google::Apis::Core::Hashable
@@ -490,6 +571,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: http://proceedings.mlr.press/v70/sundararajan17a.html
+      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
@@ -1284,6 +1388,28 @@ 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
+      
       # Request message for the SetDefaultVersion request.
       class GoogleCloudMlV1SetDefaultVersionRequest
         include Google::Apis::Core::Hashable
@@ -1331,92 +1457,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`
@@ -1434,9 +1478,29 @@ 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
@@ -1468,8 +1532,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`
@@ -1539,8 +1603,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#
@@ -1707,6 +1771,16 @@ module Google
         # @return [String]
         attr_accessor :etag
       
+        # Message holding configuration options for explaining model predictions.
+        # Currently, the only supported mechanism to explain a model's prediction is
+        # through attributing its output back to its inputs which is essentially a
+        # credit assignment task. We support multiple attribution methods, some
+        # specific to particular frameworks like Tensorflow and XGBoost.
+        # Next idx: 7.
+        # 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
@@ -1903,6 +1977,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)
@@ -2158,8 +2233,8 @@ module Google
         # 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.
+        # 'setIamPolicy' will not fail even if the incoming policy version does not
+        # meet the requirements for modifying the stored policy.
         # Corresponds to the JSON property `etag`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
@@ -2170,11 +2245,12 @@ module Google
         # 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.
+        # or removing a binding (conditional or unconditional) 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.
+        # If no etag is provided in the call to `setIamPolicy`, version compliance
+        # checks against the stored policy is skipped.
         # Corresponds to the JSON property `version`
         # @return [Fixnum]
         attr_accessor :version