Autogenerated update (2019-08-03)

Update:
- androidmanagement_v1
- bigquery_v2
- cloudkms_v1
- pubsub_v1
- pubsub_v1beta2
- servicemanagement_v1

generated/google/apis/androidmanagement_v1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://developers.google.com/android/management
     module AndroidmanagementV1
       VERSION = 'V1'
-      REVISION = '20190720'
+      REVISION = '20190801'
 
       # Manage Android devices and apps for your customers
       AUTH_ANDROIDMANAGEMENT = 'https://www.googleapis.com/auth/androidmanagement'

generated/google/apis/androidmanagement_v1/classes.rb

@@ -701,6 +701,11 @@ module Google
         # @return [Array<String>]
         attr_accessor :previous_device_names
       
+        # . Device's security posture value that reflects how secure the device is.
+        # Corresponds to the JSON property `securityPosture`
+        # @return [Google::Apis::AndroidmanagementV1::SecurityPosture]
+        attr_accessor :security_posture
+      
         # Information about device software.
         # Corresponds to the JSON property `softwareInfo`
         # @return [Google::Apis::AndroidmanagementV1::SoftwareInfo]
@@ -762,6 +767,7 @@ module Google
           @policy_name = args[:policy_name] if args.key?(:policy_name)
           @power_management_events = args[:power_management_events] if args.key?(:power_management_events)
           @previous_device_names = args[:previous_device_names] if args.key?(:previous_device_names)
+          @security_posture = args[:security_posture] if args.key?(:security_posture)
           @software_info = args[:software_info] if args.key?(:software_info)
           @state = args[:state] if args.key?(:state)
           @system_properties = args[:system_properties] if args.key?(:system_properties)
@@ -2590,6 +2596,32 @@ module Google
         end
       end
       
+      # Detail that provides further information if the device is not in the most
+      # secure state.
+      class PostureDetail
+        include Google::Apis::Core::Hashable
+      
+        # Corresponding pieces of advice to mitigate the security risk.
+        # Corresponds to the JSON property `advice`
+        # @return [Array<Google::Apis::AndroidmanagementV1::UserFacingMessage>]
+        attr_accessor :advice
+      
+        # The risk that makes the device not in the most secure state.
+        # Corresponds to the JSON property `securityRisk`
+        # @return [String]
+        attr_accessor :security_risk
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @advice = args[:advice] if args.key?(:advice)
+          @security_risk = args[:security_risk] if args.key?(:security_risk)
+        end
+      end
+      
       # A power management event.
       class PowerManagementEvent
         include Google::Apis::Core::Hashable
@@ -2660,6 +2692,32 @@ module Google
         end
       end
       
+      # . Device's security posture value that reflects how secure the device is.
+      class SecurityPosture
+        include Google::Apis::Core::Hashable
+      
+        # Device's security posture value.
+        # Corresponds to the JSON property `devicePosture`
+        # @return [String]
+        attr_accessor :device_posture
+      
+        # Details that provide further information if the device is not in the most
+        # secure state.
+        # Corresponds to the JSON property `postureDetails`
+        # @return [Array<Google::Apis::AndroidmanagementV1::PostureDetail>]
+        attr_accessor :posture_details
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @device_posture = args[:device_posture] if args.key?(:device_posture)
+          @posture_details = args[:posture_details] if args.key?(:posture_details)
+        end
+      end
+      
       # An action executed during setup.
       class SetupAction
         include Google::Apis::Core::Hashable

generated/google/apis/androidmanagement_v1/representations.rb

@@ -274,6 +274,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class PostureDetail
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class PowerManagementEvent
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -286,6 +292,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class SecurityPosture
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class SetupAction
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -539,6 +551,8 @@ module Google
           collection :power_management_events, as: 'powerManagementEvents', class: Google::Apis::AndroidmanagementV1::PowerManagementEvent, decorator: Google::Apis::AndroidmanagementV1::PowerManagementEvent::Representation
       
           collection :previous_device_names, as: 'previousDeviceNames'
+          property :security_posture, as: 'securityPosture', class: Google::Apis::AndroidmanagementV1::SecurityPosture, decorator: Google::Apis::AndroidmanagementV1::SecurityPosture::Representation
+      
           property :software_info, as: 'softwareInfo', class: Google::Apis::AndroidmanagementV1::SoftwareInfo, decorator: Google::Apis::AndroidmanagementV1::SoftwareInfo::Representation
       
           property :state, as: 'state'
@@ -955,6 +969,15 @@ module Google
         end
       end
       
+      class PostureDetail
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :advice, as: 'advice', class: Google::Apis::AndroidmanagementV1::UserFacingMessage, decorator: Google::Apis::AndroidmanagementV1::UserFacingMessage::Representation
+      
+          property :security_risk, as: 'securityRisk'
+        end
+      end
+      
       class PowerManagementEvent
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -974,6 +997,15 @@ module Google
         end
       end
       
+      class SecurityPosture
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :device_posture, as: 'devicePosture'
+          collection :posture_details, as: 'postureDetails', class: Google::Apis::AndroidmanagementV1::PostureDetail, decorator: Google::Apis::AndroidmanagementV1::PostureDetail::Representation
+      
+        end
+      end
+      
       class SetupAction
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

generated/google/apis/bigquery_v2.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/bigquery/
     module BigqueryV2
       VERSION = 'V2'
-      REVISION = '20190712'
+      REVISION = '20190724'
 
       # View and manage your data in Google BigQuery
       AUTH_BIGQUERY = 'https://www.googleapis.com/auth/bigquery'
@@ -33,6 +33,9 @@ module Google
       # Insert data into Google BigQuery
       AUTH_BIGQUERY_INSERTDATA = 'https://www.googleapis.com/auth/bigquery.insertdata'
 
+      # View your data in Google BigQuery
+      AUTH_BIGQUERY_READONLY = 'https://www.googleapis.com/auth/bigquery.readonly'
+
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
 

generated/google/apis/bigquery_v2/classes.rb

@@ -1270,7 +1270,8 @@ module Google
         # @return [Google::Apis::BigqueryV2::MultiClassClassificationMetrics]
         attr_accessor :multi_class_classification_metrics
       
-        # Evaluation metrics for regression models.
+        # Evaluation metrics for regression and explicit feedback type matrix
+        # factorization models.
         # Corresponds to the JSON property `regressionMetrics`
         # @return [Google::Apis::BigqueryV2::RegressionMetrics]
         attr_accessor :regression_metrics
@@ -4096,7 +4097,8 @@ module Google
         end
       end
       
-      # Evaluation metrics for regression models.
+      # Evaluation metrics for regression and explicit feedback type matrix
+      # factorization models.
       class RegressionMetrics
         include Google::Apis::Core::Hashable
       

generated/google/apis/cloudkms_v1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/kms/
     module CloudkmsV1
       VERSION = 'V1'
-      REVISION = '20190626'
+      REVISION = '20190727'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/cloudkms_v1/classes.rb

@@ -86,6 +86,12 @@ module Google
       class AsymmetricSignResponse
         include Google::Apis::Core::Hashable
       
+        # The resource name of the CryptoKeyVersion used for signing. Check
+        # this field to verify that the intended resource was used for signing.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
         # The created signature.
         # Corresponds to the JSON property `signature`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
@@ -98,6 +104,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @name = args[:name] if args.key?(:name)
           @signature = args[:signature] if args.key?(:signature)
         end
       end
@@ -119,7 +126,7 @@ module Google
       # `
       # "log_type": "DATA_READ",
       # "exempted_members": [
-      # "user:foo@gmail.com"
+      # "user:jose@example.com"
       # ]
       # `,
       # `
@@ -131,7 +138,7 @@ module Google
       # ]
       # `,
       # `
-      # "service": "fooservice.googleapis.com"
+      # "service": "sampleservice.googleapis.com"
       # "audit_log_configs": [
       # `
       # "log_type": "DATA_READ",
@@ -139,16 +146,16 @@ module Google
       # `
       # "log_type": "DATA_WRITE",
       # "exempted_members": [
-      # "user:bar@gmail.com"
+      # "user:aliya@example.com"
       # ]
       # `
       # ]
       # `
       # ]
       # `
-      # For fooservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
+      # For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
-      # logging. It also exempts foo@gmail.com from DATA_READ logging, and
+      # logging. It also exempts jose@example.com from DATA_READ logging, and
-      # bar@gmail.com from DATA_WRITE logging.
+      # aliya@example.com from DATA_WRITE logging.
       class AuditConfig
         include Google::Apis::Core::Hashable
       
@@ -182,7 +189,7 @@ module Google
       # `
       # "log_type": "DATA_READ",
       # "exempted_members": [
-      # "user:foo@gmail.com"
+      # "user:jose@example.com"
       # ]
       # `,
       # `
@@ -191,7 +198,7 @@ module Google
       # ]
       # `
       # This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting
-      # foo@gmail.com from DATA_READ logging.
+      # jose@example.com from DATA_READ logging.
       class AuditLogConfig
         include Google::Apis::Core::Hashable
       
@@ -237,7 +244,7 @@ module Google
         # * `allAuthenticatedUsers`: A special identifier that represents anyone
         # who is authenticated with a Google account or a service account.
         # * `user:`emailid``: An email address that represents a specific Google
-        # account. For example, `alice@gmail.com` .
+        # account. For example, `alice@example.com` .
         # * `serviceAccount:`emailid``: An email address that represents a service
         # account. For example, `my-other-app@appspot.gserviceaccount.com`.
         # * `group:`emailid``: An email address that represents a Google group.
@@ -643,7 +650,8 @@ module Google
         # @return [String]
         attr_accessor :ciphertext
       
-        # The resource name of the CryptoKeyVersion used in encryption.
+        # The resource name of the CryptoKeyVersion used in encryption. Check
+        # this field to verify that the intended resource was used for encryption.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -1202,7 +1210,7 @@ module Google
         # 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 blindly.
+        # policy is overwritten.
         # Corresponds to the JSON property `etag`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
@@ -1237,6 +1245,12 @@ module Google
         # @return [String]
         attr_accessor :algorithm
       
+        # The name of the CryptoKeyVersion public key.
+        # Provided here for verification.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
         # The public key, encoded in PEM format. For more information, see the
         # [RFC 7468](https://tools.ietf.org/html/rfc7468) sections for
         # [General Considerations](https://tools.ietf.org/html/rfc7468#section-2) and
@@ -1253,6 +1267,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @algorithm = args[:algorithm] if args.key?(:algorithm)
+          @name = args[:name] if args.key?(:name)
           @pem = args[:pem] if args.key?(:pem)
         end
       end

generated/google/apis/cloudkms_v1/representations.rb

@@ -263,6 +263,7 @@ module Google
       class AsymmetricSignResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :name, as: 'name'
           property :signature, :base64 => true, as: 'signature'
         end
       end
@@ -519,6 +520,7 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :algorithm, as: 'algorithm'
+          property :name, as: 'name'
           property :pem, as: 'pem'
         end
       end

generated/google/apis/cloudkms_v1/service.rb

@@ -229,12 +229,15 @@ module Google
         #   Required. The resource name of the location associated with the
         #   KeyRings, in the format `projects/*/locations/*`.
         # @param [String] filter
-        #   Optional. Only include resources that match the filter in the response
+        #   Optional. Only include resources that match the filter in the response. For
-        #   (https://cloud.google.com/kms/docs/sorting-and-filtering).
+        #   more information, see
+        #   [Sorting and filtering list
+        #   results](https://cloud.google.com/kms/docs/sorting-and-filtering).
         # @param [String] order_by
         #   Optional. Specify how the results should be sorted. If not specified, the
-        #   results will be sorted in the default order
+        #   results will be sorted in the default order.  For more information, see
-        #   (https://cloud.google.com/kms/docs/sorting-and-filtering).
+        #   [Sorting and filtering list
+        #   results](https://cloud.google.com/kms/docs/sorting-and-filtering).
         # @param [Fixnum] page_size
         #   Optional limit on the number of KeyRings to include in the
         #   response.  Further KeyRings can subsequently be obtained by
@@ -544,12 +547,15 @@ module Google
         #   Required. The resource name of the KeyRing to list, in the format
         #   `projects/*/locations/*/keyRings/*`.
         # @param [String] filter
-        #   Optional. Only include resources that match the filter in the response
+        #   Optional. Only include resources that match the filter in the response. For
-        #   (https://cloud.google.com/kms/docs/sorting-and-filtering).
+        #   more information, see
+        #   [Sorting and filtering list
+        #   results](https://cloud.google.com/kms/docs/sorting-and-filtering).
         # @param [String] order_by
         #   Optional. Specify how the results should be sorted. If not specified, the
-        #   results will be sorted in the default order
+        #   results will be sorted in the default order. For more information, see
-        #   (https://cloud.google.com/kms/docs/sorting-and-filtering).
+        #   [Sorting and filtering list
+        #   results](https://cloud.google.com/kms/docs/sorting-and-filtering).
         # @param [Fixnum] page_size
         #   Optional limit on the number of CryptoKeys to include in the
         #   response.  Further CryptoKeys can subsequently be obtained by
@@ -993,12 +999,15 @@ module Google
         #   Required. The resource name of the CryptoKey to list, in the format
         #   `projects/*/locations/*/keyRings/*/cryptoKeys/*`.
         # @param [String] filter
-        #   Optional. Only include resources that match the filter in the response
+        #   Optional. Only include resources that match the filter in the response. For
-        #   (https://cloud.google.com/kms/docs/sorting-and-filtering).
+        #   more information, see
+        #   [Sorting and filtering list
+        #   results](https://cloud.google.com/kms/docs/sorting-and-filtering).
         # @param [String] order_by
         #   Optional. Specify how the results should be sorted. If not specified, the
-        #   results will be sorted in the default order
+        #   results will be sorted in the default order. For more information, see
-        #   (https://cloud.google.com/kms/docs/sorting-and-filtering).
+        #   [Sorting and filtering list
+        #   results](https://cloud.google.com/kms/docs/sorting-and-filtering).
         # @param [Fixnum] page_size
         #   Optional limit on the number of CryptoKeyVersions to
         #   include in the response. Further CryptoKeyVersions can
@@ -1235,12 +1244,15 @@ module Google
         #   Required. The resource name of the KeyRing to list, in the format
         #   `projects/*/locations/*/keyRings/*`.
         # @param [String] filter
-        #   Optional. Only include resources that match the filter in the response
+        #   Optional. Only include resources that match the filter in the response. For
-        #   (https://cloud.google.com/kms/docs/sorting-and-filtering).
+        #   more information, see
+        #   [Sorting and filtering list
+        #   results](https://cloud.google.com/kms/docs/sorting-and-filtering).
         # @param [String] order_by
         #   Optional. Specify how the results should be sorted. If not specified, the
-        #   results will be sorted in the default order
+        #   results will be sorted in the default order. For more information, see
-        #   (https://cloud.google.com/kms/docs/sorting-and-filtering).
+        #   [Sorting and filtering list
+        #   results](https://cloud.google.com/kms/docs/sorting-and-filtering).
         # @param [Fixnum] page_size
         #   Optional limit on the number of ImportJobs to include in the
         #   response. Further ImportJobs can subsequently be obtained by

generated/google/apis/pubsub_v1.rb

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

generated/google/apis/pubsub_v1/classes.rb

@@ -61,7 +61,7 @@ module Google
         # * `allAuthenticatedUsers`: A special identifier that represents anyone
         # who is authenticated with a Google account or a service account.
         # * `user:`emailid``: An email address that represents a specific Google
-        # account. For example, `alice@gmail.com` .
+        # account. For example, `alice@example.com` .
         # * `serviceAccount:`emailid``: An email address that represents a service
         # account. For example, `my-other-app@appspot.gserviceaccount.com`.
         # * `group:`emailid``: An email address that represents a Google group.
@@ -512,7 +512,7 @@ module Google
         # 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 blindly.
+        # policy is overwritten.
         # Corresponds to the JSON property `etag`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
@@ -682,22 +682,22 @@ module Google
       class PushConfig
         include Google::Apis::Core::Hashable
       
-        # Endpoint configuration attributes.
+        # Endpoint configuration attributes that can be used to control different
-        # Every endpoint has a set of API supported attributes that can be used to
+        # aspects of the message delivery.
-        # control different aspects of the message delivery.
+        # The only currently supported attribute is `x-goog-version`, which you can
-        # The currently supported attribute is `x-goog-version`, which you can
         # use to change the format of the pushed message. This attribute
         # indicates the version of the data expected by the endpoint. This
         # controls the shape of the pushed message (i.e., its fields and metadata).
-        # The endpoint version is based on the version of the Pub/Sub API.
         # If not present during the `CreateSubscription` call, it will default to
-        # the version of the API used to make such call. If not present during a
+        # the version of the Pub/Sub API used to make such call. If not present in a
         # `ModifyPushConfig` call, its value will not be changed. `GetSubscription`
         # calls will always return a valid version, even if the subscription was
         # created without this attribute.
-        # The possible values for this attribute are:
+        # The only supported values for the `x-goog-version` attribute are:
         # * `v1beta1`: uses the push format defined in the v1beta1 Pub/Sub API.
         # * `v1` or `v1beta2`: uses the push format defined in the v1 Pub/Sub API.
+        # For example:
+        # <pre><code>attributes ` "x-goog-version": "v1" ` </code></pre>
         # Corresponds to the JSON property `attributes`
         # @return [Hash<String,String>]
         attr_accessor :attributes

generated/google/apis/pubsub_v1beta2.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/pubsub/docs
     module PubsubV1beta2
       VERSION = 'V1beta2'
-      REVISION = '20190701'
+      REVISION = '20190723'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/pubsub_v1beta2/classes.rb

@@ -61,7 +61,7 @@ module Google
         # * `allAuthenticatedUsers`: A special identifier that represents anyone
         # who is authenticated with a Google account or a service account.
         # * `user:`emailid``: An email address that represents a specific Google
-        # account. For example, `alice@gmail.com` .
+        # account. For example, `alice@example.com` .
         # * `serviceAccount:`emailid``: An email address that represents a service
         # account. For example, `my-other-app@appspot.gserviceaccount.com`.
         # * `group:`emailid``: An email address that represents a Google group.
@@ -381,7 +381,7 @@ module Google
         # 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 blindly.
+        # policy is overwritten.
         # Corresponds to the JSON property `etag`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]

generated/google/apis/servicemanagement_v1.rb

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

generated/google/apis/servicemanagement_v1/classes.rb

@@ -140,7 +140,7 @@ module Google
       # `
       # "log_type": "DATA_READ",
       # "exempted_members": [
-      # "user:foo@gmail.com"
+      # "user:jose@example.com"
       # ]
       # `,
       # `
@@ -152,7 +152,7 @@ module Google
       # ]
       # `,
       # `
-      # "service": "fooservice.googleapis.com"
+      # "service": "sampleservice.googleapis.com"
       # "audit_log_configs": [
       # `
       # "log_type": "DATA_READ",
@@ -160,16 +160,16 @@ module Google
       # `
       # "log_type": "DATA_WRITE",
       # "exempted_members": [
-      # "user:bar@gmail.com"
+      # "user:aliya@example.com"
       # ]
       # `
       # ]
       # `
       # ]
       # `
-      # For fooservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
+      # For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
-      # logging. It also exempts foo@gmail.com from DATA_READ logging, and
+      # logging. It also exempts jose@example.com from DATA_READ logging, and
-      # bar@gmail.com from DATA_WRITE logging.
+      # aliya@example.com from DATA_WRITE logging.
       class AuditConfig
         include Google::Apis::Core::Hashable
       
@@ -203,7 +203,7 @@ module Google
       # `
       # "log_type": "DATA_READ",
       # "exempted_members": [
-      # "user:foo@gmail.com"
+      # "user:jose@example.com"
       # ]
       # `,
       # `
@@ -212,7 +212,7 @@ module Google
       # ]
       # `
       # This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting
-      # foo@gmail.com from DATA_READ logging.
+      # jose@example.com from DATA_READ logging.
       class AuditLogConfig
         include Google::Apis::Core::Hashable
       
@@ -627,7 +627,7 @@ module Google
         # * `allAuthenticatedUsers`: A special identifier that represents anyone
         # who is authenticated with a Google account or a service account.
         # * `user:`emailid``: An email address that represents a specific Google
-        # account. For example, `alice@gmail.com` .
+        # account. For example, `alice@example.com` .
         # * `serviceAccount:`emailid``: An email address that represents a service
         # account. For example, `my-other-app@appspot.gserviceaccount.com`.
         # * `group:`emailid``: An email address that represents a Google group.
@@ -3107,7 +3107,7 @@ module Google
         # 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 blindly.
+        # policy is overwritten.
         # Corresponds to the JSON property `etag`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]