google-api-client 0.42.2 → 0.45.0

data/generated/google/apis/cloudiot_v1.rb

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

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

@@ -26,8 +26,8 @@ module Google
       class BindDeviceToGatewayRequest
         include Google::Apis::Core::Hashable
       
-        # Required. The device to associate with the specified gateway. The value of
-        # `device_id` can be either the device numeric ID or the user-defined device
+        # Required. The device to associate with the specified gateway. The value of `
+        # device_id` can be either the device numeric ID or the user-defined device
         # identifier.
         # Corresponds to the JSON property `deviceId`
         # @return [String]
@@ -67,69 +67,63 @@ module Google
       class Binding
         include Google::Apis::Core::Hashable
       
-        # 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.
+        # A client-specified ID for this binding. Expected to be globally unique to
+        # support the internal bindings-by-ID API.
+        # Corresponds to the JSON property `bindingId`
+        # @return [String]
+        attr_accessor :binding_id
+      
+        # 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::CloudiotV1::Expr]
         attr_accessor :condition
       
-        # Specifies the identities requesting access for a Cloud Platform resource.
-        # `members` can have the following values:
-        # * `allUsers`: A special identifier that represents anyone who is
-        # on the internet; with or without a Google account.
-        # * `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@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.
-        # 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`.
+        # Specifies the identities requesting access for a Cloud Platform resource. `
+        # members` can have the following values: * `allUsers`: A special identifier
+        # that represents anyone who is on the internet; with or without a Google
+        # account. * `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@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. 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`
         # @return [Array<String>]
         attr_accessor :members
       
-        # Role that is assigned to `members`.
-        # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+        # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`
+        # , or `roles/owner`.
         # Corresponds to the JSON property `role`
         # @return [String]
         attr_accessor :role
@@ -140,6 +134,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @binding_id = args[:binding_id] if args.key?(:binding_id)
           @condition = args[:condition] if args.key?(:condition)
           @members = args[:members] if args.key?(:members)
           @role = args[:role] if args.key?(:role)
@@ -151,8 +146,8 @@ module Google
         include Google::Apis::Core::Hashable
       
         # If a device is blocked, connections or requests from this device will fail.
-        # Can be used to temporarily prevent the device from connecting if, for
-        # example, the sensor is generating bad data and needs maintenance.
+        # Can be used to temporarily prevent the device from connecting if, for example,
+        # the sensor is generating bad data and needs maintenance.
         # Corresponds to the JSON property `blocked`
         # @return [Boolean]
         attr_accessor :blocked
@@ -163,12 +158,12 @@ module Google
         # @return [Google::Apis::CloudiotV1::DeviceConfig]
         attr_accessor :config
       
-        # The credentials used to authenticate this device. To allow credential
-        # rotation without interruption, multiple device credentials can be bound to
-        # this device. No more than 3 credentials can be bound to a single device at
-        # a time. When new credentials are added to a device, they are verified
-        # against the registry credentials. For details, see the description of the
-        # `DeviceRegistry.credentials` field.
+        # The credentials used to authenticate this device. To allow credential rotation
+        # without interruption, multiple device credentials can be bound to this device.
+        # No more than 3 credentials can be bound to a single device at a time. When new
+        # credentials are added to a device, they are verified against the registry
+        # credentials. For details, see the description of the `DeviceRegistry.
+        # credentials` field.
         # Corresponds to the JSON property `credentials`
         # @return [Array<Google::Apis::CloudiotV1::DeviceCredential>]
         attr_accessor :credentials
@@ -178,38 +173,37 @@ module Google
         # @return [Google::Apis::CloudiotV1::GatewayConfig]
         attr_accessor :gateway_config
       
-        # The user-defined device identifier. The device ID must be unique
-        # within a device registry.
+        # The user-defined device identifier. The device ID must be unique within a
+        # device registry.
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
       
         # [Output only] The last time a cloud-to-device config version acknowledgment
-        # was received from the device. This field is only for configurations
-        # sent through MQTT.
+        # was received from the device. This field is only for configurations sent
+        # through MQTT.
         # Corresponds to the JSON property `lastConfigAckTime`
         # @return [String]
         attr_accessor :last_config_ack_time
       
-        # [Output only] The last time a cloud-to-device config version was sent to
-        # the device.
+        # [Output only] The last time a cloud-to-device config version was sent to the
+        # device.
         # Corresponds to the JSON property `lastConfigSendTime`
         # @return [String]
         attr_accessor :last_config_send_time
       
-        # The `Status` type defines a logical error model that is suitable for
-        # different programming environments, including REST APIs and RPC APIs. It is
-        # used by [gRPC](https://github.com/grpc). Each `Status` message contains
-        # three pieces of data: error code, error message, and error details.
-        # You can find out more about this error model and how to work with it in the
-        # [API Design Guide](https://cloud.google.com/apis/design/errors).
+        # The `Status` type defines a logical error model that is suitable for different
+        # programming environments, including REST APIs and RPC APIs. It is used by [
+        # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
+        # data: error code, error message, and error details. You can find out more
+        # about this error model and how to work with it in the [API Design Guide](https:
+        # //cloud.google.com/apis/design/errors).
         # Corresponds to the JSON property `lastErrorStatus`
         # @return [Google::Apis::CloudiotV1::Status]
         attr_accessor :last_error_status
       
         # [Output only] The time the most recent error occurred, such as a failure to
-        # publish to Cloud Pub/Sub. This field is the timestamp of
-        # 'last_error_status'.
+        # publish to Cloud Pub/Sub. This field is the timestamp of 'last_error_status'.
         # Corresponds to the JSON property `lastErrorTime`
         # @return [String]
         attr_accessor :last_error_time
@@ -221,11 +215,11 @@ module Google
         # @return [String]
         attr_accessor :last_event_time
       
-        # [Output only] The last time an MQTT `PINGREQ` was received. This field
-        # applies only to devices connecting through MQTT. MQTT clients usually only
-        # send `PINGREQ` messages if the connection is idle, and no other messages
-        # have been sent. Timestamps are periodically collected and written to
-        # storage; they may be stale by a few minutes.
+        # [Output only] The last time an MQTT `PINGREQ` was received. This field applies
+        # only to devices connecting through MQTT. MQTT clients usually only send `
+        # PINGREQ` messages if the connection is idle, and no other messages have been
+        # sent. Timestamps are periodically collected and written to storage; they may
+        # be stale by a few minutes.
         # Corresponds to the JSON property `lastHeartbeatTime`
         # @return [String]
         attr_accessor :last_heartbeat_time
@@ -237,8 +231,7 @@ module Google
         # @return [String]
         attr_accessor :last_state_time
       
-        # **Beta Feature**
-        # The logging verbosity for device activity. If unspecified,
+        # **Beta Feature** The logging verbosity for device activity. If unspecified,
         # DeviceRegistry.log_level will be used.
         # Corresponds to the JSON property `logLevel`
         # @return [String]
@@ -246,22 +239,19 @@ module Google
       
         # The metadata key-value pairs assigned to the device. This metadata is not
         # interpreted or indexed by Cloud IoT Core. It can be used to add contextual
-        # information for the device.
-        # Keys must conform to the regular expression a-zA-Z+ and
-        # be less than 128 bytes in length.
-        # Values are free-form strings. Each value must be less than or equal to 32
-        # KB in size.
-        # The total size of all keys and values must be less than 256 KB, and the
-        # maximum number of key-value pairs is 500.
+        # information for the device. Keys must conform to the regular expression a-zA-Z+
+        # and be less than 128 bytes in length. Values are free-form strings. Each
+        # value must be less than or equal to 32 KB in size. The total size of all keys
+        # and values must be less than 256 KB, and the maximum number of key-value pairs
+        # is 500.
         # Corresponds to the JSON property `metadata`
         # @return [Hash<String,String>]
         attr_accessor :metadata
       
-        # The resource path name. For example,
-        # `projects/p1/locations/us-central1/registries/registry0/devices/dev0` or
-        # `projects/p1/locations/us-central1/registries/registry0/devices/`num_id``.
-        # When `name` is populated as a response from the service, it always ends
-        # in the device numeric ID.
+        # The resource path name. For example, `projects/p1/locations/us-central1/
+        # registries/registry0/devices/dev0` or `projects/p1/locations/us-central1/
+        # registries/registry0/devices/`num_id``. When `name` is populated as a response
+        # from the service, it always ends in the device numeric ID.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -319,23 +309,22 @@ module Google
         # @return [String]
         attr_accessor :cloud_update_time
       
-        # [Output only] The time at which Cloud IoT Core received the
-        # acknowledgment from the device, indicating that the device has received
-        # this configuration version. If this field is not present, the device has
-        # not yet acknowledged that it received this version. Note that when
-        # the config was sent to the device, many config versions may have been
-        # available in Cloud IoT Core while the device was disconnected, and on
-        # connection, only the latest version is sent to the device. Some
-        # versions may never be sent to the device, and therefore are never
-        # acknowledged. This timestamp is set by Cloud IoT Core.
+        # [Output only] The time at which Cloud IoT Core received the acknowledgment
+        # from the device, indicating that the device has received this configuration
+        # version. If this field is not present, the device has not yet acknowledged
+        # that it received this version. Note that when the config was sent to the
+        # device, many config versions may have been available in Cloud IoT Core while
+        # the device was disconnected, and on connection, only the latest version is
+        # sent to the device. Some versions may never be sent to the device, and
+        # therefore are never acknowledged. This timestamp is set by Cloud IoT Core.
         # Corresponds to the JSON property `deviceAckTime`
         # @return [String]
         attr_accessor :device_ack_time
       
         # [Output only] The version of this update. The version number is assigned by
-        # the server, and is always greater than 0 after device creation. The
-        # version must be 0 on the `CreateDevice` request if a `config` is
-        # specified; the response of `CreateDevice` will always have a value of 1.
+        # the server, and is always greater than 0 after device creation. The version
+        # must be 0 on the `CreateDevice` request if a `config` is specified; the
+        # response of `CreateDevice` will always have a value of 1.
         # Corresponds to the JSON property `version`
         # @return [Fixnum]
         attr_accessor :version
@@ -357,9 +346,9 @@ module Google
       class DeviceCredential
         include Google::Apis::Core::Hashable
       
-        # [Optional] The time at which this credential becomes invalid. This
-        # credential will be ignored for new client authentication requests after
-        # this timestamp; however, it will not be automatically deleted.
+        # [Optional] The time at which this credential becomes invalid. This credential
+        # will be ignored for new client authentication requests after this timestamp;
+        # however, it will not be automatically deleted.
         # Corresponds to the JSON property `expirationTime`
         # @return [String]
         attr_accessor :expiration_time
@@ -388,25 +377,23 @@ module Google
         # credentials can be bound to a single registry at a time. The verification
         # process occurs at the time of device creation or update. If this field is
         # empty, no verification is performed. Otherwise, the credentials of a newly
-        # created device or added credentials of an updated device should be signed
-        # with one of these registry credentials.
-        # Note, however, that existing devices will never be affected by
-        # modifications to this list of credentials: after a device has been
-        # successfully created in a registry, it should be able to connect even if
-        # its registry credentials are revoked, deleted, or modified.
+        # created device or added credentials of an updated device should be signed with
+        # one of these registry credentials. Note, however, that existing devices will
+        # never be affected by modifications to this list of credentials: after a device
+        # has been successfully created in a registry, it should be able to connect even
+        # if its registry credentials are revoked, deleted, or modified.
         # Corresponds to the JSON property `credentials`
         # @return [Array<Google::Apis::CloudiotV1::RegistryCredential>]
         attr_accessor :credentials
       
         # The configuration for notification of telemetry events received from the
-        # device. All telemetry events that were successfully published by the
-        # device and acknowledged by Cloud IoT Core are guaranteed to be
-        # delivered to Cloud Pub/Sub. If multiple configurations match a message,
-        # only the first matching configuration is used. If you try to publish a
-        # device telemetry event using MQTT without specifying a Cloud Pub/Sub topic
-        # for the device's registry, the connection closes automatically. If you try
-        # to do so using an HTTP connection, an error is returned. Up to 10
-        # configurations may be provided.
+        # device. All telemetry events that were successfully published by the device
+        # and acknowledged by Cloud IoT Core are guaranteed to be delivered to Cloud Pub/
+        # Sub. If multiple configurations match a message, only the first matching
+        # configuration is used. If you try to publish a device telemetry event using
+        # MQTT without specifying a Cloud Pub/Sub topic for the device's registry, the
+        # connection closes automatically. If you try to do so using an HTTP connection,
+        # an error is returned. Up to 10 configurations may be provided.
         # Corresponds to the JSON property `eventNotificationConfigs`
         # @return [Array<Google::Apis::CloudiotV1::EventNotificationConfig>]
         attr_accessor :event_notification_configs
@@ -421,9 +408,8 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # **Beta Feature**
-        # The default logging verbosity for activity from devices in this registry.
-        # The verbosity level can be overridden by Device.log_level.
+        # **Beta Feature** The default logging verbosity for activity from devices in
+        # this registry. The verbosity level can be overridden by Device.log_level.
         # Corresponds to the JSON property `logLevel`
         # @return [String]
         attr_accessor :log_level
@@ -433,8 +419,8 @@ module Google
         # @return [Google::Apis::CloudiotV1::MqttConfig]
         attr_accessor :mqtt_config
       
-        # The resource path name. For example,
-        # `projects/example-project/locations/us-central1/registries/my-registry`.
+        # The resource path name. For example, `projects/example-project/locations/us-
+        # central1/registries/my-registry`.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -471,8 +457,8 @@ module Google
         # @return [String]
         attr_accessor :binary_data
       
-        # [Output only] The time at which this state version was updated in Cloud
-        # IoT Core.
+        # [Output only] The time at which this state version was updated in Cloud IoT
+        # Core.
         # Corresponds to the JSON property `updateTime`
         # @return [String]
         attr_accessor :update_time
@@ -488,13 +474,11 @@ module Google
         end
       end
       
-      # A generic empty message that you can re-use to avoid defining duplicated
-      # empty messages in your APIs. A typical example is to use it as the request
-      # or the response type of an API method. For instance:
-      # service Foo `
-      # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
-      # `
-      # The JSON representation for `Empty` is empty JSON object ````.
+      # A generic empty message that you can re-use to avoid defining duplicated empty
+      # messages in your APIs. A typical example is to use it as the request or the
+      # response type of an API method. For instance: service Foo ` rpc Bar(google.
+      # protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for
+      # `Empty` is empty JSON object ````.
       class Empty
         include Google::Apis::Core::Hashable
       
@@ -511,16 +495,16 @@ module Google
       class EventNotificationConfig
         include Google::Apis::Core::Hashable
       
-        # A Cloud Pub/Sub topic name. For example,
-        # `projects/myProject/topics/deviceEvents`.
+        # A Cloud Pub/Sub topic name. For example, `projects/myProject/topics/
+        # deviceEvents`.
         # Corresponds to the JSON property `pubsubTopicName`
         # @return [String]
         attr_accessor :pubsub_topic_name
       
-        # If the subfolder name matches this string exactly, this configuration will
-        # be used. The string must not include the leading '/' character. If empty,
-        # all strings are matched. This field is used only for telemetry events;
-        # subfolders are not supported for state changes.
+        # If the subfolder name matches this string exactly, this configuration will be
+        # used. The string must not include the leading '/' character. If empty, all
+        # strings are matched. This field is used only for telemetry events; subfolders
+        # are not supported for state changes.
         # Corresponds to the JSON property `subfolderMatches`
         # @return [String]
         attr_accessor :subfolder_matches
@@ -536,52 +520,43 @@ module Google
         end
       end
       
-      # 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.
+      # 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 Expr
         include Google::Apis::Core::Hashable
       
-        # Optional. Description of the expression. This is a longer text which
-        # describes the expression, e.g. when hovered over it in a UI.
+        # 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.
+        # Textual representation of an expression in Common Expression Language syntax.
         # Corresponds to the JSON property `expression`
         # @return [String]
         attr_accessor :expression
       
-        # Optional. String indicating the location of the expression for error
-        # reporting, e.g. a file name and a position in the file.
+        # 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
       
-        # 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.
+        # 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`
         # @return [String]
         attr_accessor :title
@@ -603,8 +578,7 @@ module Google
       class GatewayConfig
         include Google::Apis::Core::Hashable
       
-        # Indicates how to authorize and/or authenticate devices to access the
-        # gateway.
+        # Indicates how to authorize and/or authenticate devices to access the gateway.
         # Corresponds to the JSON property `gatewayAuthMethod`
         # @return [String]
         attr_accessor :gateway_auth_method
@@ -661,15 +635,13 @@ module Google
       class GetPolicyOptions
         include Google::Apis::Core::Hashable
       
-        # Optional. The policy format version to be returned.
-        # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
-        # rejected.
-        # Requests for policies with any conditional bindings must specify version 3.
-        # Policies without any conditional bindings may specify any valid value 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).
+        # Optional. The policy format version to be returned. Valid values are 0, 1, and
+        # 3. Requests specifying an invalid value will be rejected. Requests for
+        # policies with any conditional bindings must specify version 3. Policies
+        # without any conditional bindings may specify any valid value 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 `requestedPolicyVersion`
         # @return [Fixnum]
         attr_accessor :requested_policy_version
@@ -708,8 +680,8 @@ module Google
       class ListDeviceConfigVersionsResponse
         include Google::Apis::Core::Hashable
       
-        # The device configuration for the last few versions. Versions are listed
-        # in decreasing order, starting from the most recent one.
+        # The device configuration for the last few versions. Versions are listed in
+        # decreasing order, starting from the most recent one.
         # Corresponds to the JSON property `deviceConfigs`
         # @return [Array<Google::Apis::CloudiotV1::DeviceConfig>]
         attr_accessor :device_configs
@@ -734,8 +706,7 @@ module Google
         attr_accessor :device_registries
       
         # If not empty, indicates that there may be more registries that match the
-        # request; this value should be passed in a new
-        # `ListDeviceRegistriesRequest`.
+        # request; this value should be passed in a new `ListDeviceRegistriesRequest`.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -780,8 +751,8 @@ module Google
         # @return [Array<Google::Apis::CloudiotV1::Device>]
         attr_accessor :devices
       
-        # If not empty, indicates that there may be more devices that match the
-        # request; this value should be passed in a new `ListDevicesRequest`.
+        # If not empty, indicates that there may be more devices that match the request;
+        # this value should be passed in a new `ListDevicesRequest`.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -848,111 +819,73 @@ module Google
       end
       
       # 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; 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": [
-      # `
-      # "role": "roles/resourcemanager.organizationAdmin",
-      # "members": [
-      # "user:mike@example.com",
-      # "group:admins@example.com",
-      # "domain:google.com",
-      # "serviceAccount:my-project-id@appspot.gserviceaccount.com"
-      # ]
-      # `,
-      # `
-      # "role": "roles/resourcemanager.organizationViewer",
-      # "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')
-      # ",
-      # `
-      # `
-      # ],
-      # "etag": "BwWWja0YfJA=",
-      # "version": 3
-      # `
-      # **YAML example:**
-      # bindings:
-      # - members:
-      # - user:mike@example.com
-      # - group:admins@example.com
-      # - domain:google.com
-      # - serviceAccount:my-project-id@appspot.gserviceaccount.com
-      # role: roles/resourcemanager.organizationAdmin
-      # - members:
-      # - user:eve@example.com
-      # role: roles/resourcemanager.organizationViewer
-      # condition:
-      # 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 documentation](https://cloud.google.com/iam/docs/).
+      # 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; 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": [ ` "role": "roles/
+      # resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "
+      # group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@
+      # appspot.gserviceaccount.com" ] `, ` "role": "roles/resourcemanager.
+      # organizationViewer", "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')", `
+      # ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:** bindings: -
+      # members: - user:mike@example.com - group:admins@example.com - domain:google.
+      # com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/
+      # resourcemanager.organizationAdmin - members: - user:eve@example.com role:
+      # roles/resourcemanager.organizationViewer condition: 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 documentation](https://cloud.
+      # google.com/iam/docs/).
       class Policy
         include Google::Apis::Core::Hashable
       
-        # 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.
+        # 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::CloudiotV1::Binding>]
         attr_accessor :bindings
       
-        # `etag` is used for optimistic concurrency control as a way to help
-        # prevent simultaneous updates of a policy from overwriting each other.
-        # It is strongly suggested that systems make use of the `etag` in the
-        # read-modify-write cycle to perform policy updates in order to avoid race
-        # 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.
-        # **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.
+        # `etag` is used for optimistic concurrency control as a way to help prevent
+        # simultaneous updates of a policy from overwriting each other. It is strongly
+        # suggested that systems make use of the `etag` in the read-modify-write cycle
+        # to perform policy updates in order to avoid race 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. **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 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).
+        # Specifies the format of the policy. 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
@@ -1054,11 +987,11 @@ module Google
         # @return [String]
         attr_accessor :binary_data
       
-        # Optional subfolder for the command. If empty, the command will be delivered
-        # to the /devices/`device-id`/commands topic, otherwise it will be delivered
-        # to the /devices/`device-id`/commands/`subfolder` topic. Multi-level
-        # subfolders are allowed. This field must not have more than 256 characters,
-        # and must not contain any MQTT wildcards ("+" or "#") or null characters.
+        # Optional subfolder for the command. If empty, the command will be delivered to
+        # the /devices/`device-id`/commands topic, otherwise it will be delivered to the
+        # /devices/`device-id`/commands/`subfolder` topic. Multi-level subfolders are
+        # allowed. This field must not have more than 256 characters, and must not
+        # contain any MQTT wildcards ("+" or "#") or null characters.
         # Corresponds to the JSON property `subfolder`
         # @return [String]
         attr_accessor :subfolder
@@ -1092,66 +1025,32 @@ module Google
         include Google::Apis::Core::Hashable
       
         # 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; 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": [
-        # `
-        # "role": "roles/resourcemanager.organizationAdmin",
-        # "members": [
-        # "user:mike@example.com",
-        # "group:admins@example.com",
-        # "domain:google.com",
-        # "serviceAccount:my-project-id@appspot.gserviceaccount.com"
-        # ]
-        # `,
-        # `
-        # "role": "roles/resourcemanager.organizationViewer",
-        # "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')
-        # ",
-        # `
-        # `
-        # ],
-        # "etag": "BwWWja0YfJA=",
-        # "version": 3
-        # `
-        # **YAML example:**
-        # bindings:
-        # - members:
-        # - user:mike@example.com
-        # - group:admins@example.com
-        # - domain:google.com
-        # - serviceAccount:my-project-id@appspot.gserviceaccount.com
-        # role: roles/resourcemanager.organizationAdmin
-        # - members:
-        # - user:eve@example.com
-        # role: roles/resourcemanager.organizationViewer
-        # condition:
-        # 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 documentation](https://cloud.google.com/iam/docs/).
+        # 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; 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": [ ` "role": "roles/
+        # resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "
+        # group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@
+        # appspot.gserviceaccount.com" ] `, ` "role": "roles/resourcemanager.
+        # organizationViewer", "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')", `
+        # ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:** bindings: -
+        # members: - user:mike@example.com - group:admins@example.com - domain:google.
+        # com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/
+        # resourcemanager.organizationAdmin - members: - user:eve@example.com role:
+        # roles/resourcemanager.organizationViewer condition: 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 documentation](https://cloud.
+        # google.com/iam/docs/).
         # Corresponds to the JSON property `policy`
         # @return [Google::Apis::CloudiotV1::Policy]
         attr_accessor :policy
@@ -1170,8 +1069,8 @@ module Google
       class StateNotificationConfig
         include Google::Apis::Core::Hashable
       
-        # A Cloud Pub/Sub topic name. For example,
-        # `projects/myProject/topics/deviceEvents`.
+        # A Cloud Pub/Sub topic name. For example, `projects/myProject/topics/
+        # deviceEvents`.
         # Corresponds to the JSON property `pubsubTopicName`
         # @return [String]
         attr_accessor :pubsub_topic_name
@@ -1186,12 +1085,12 @@ module Google
         end
       end
       
-      # The `Status` type defines a logical error model that is suitable for
-      # different programming environments, including REST APIs and RPC APIs. It is
-      # used by [gRPC](https://github.com/grpc). Each `Status` message contains
-      # three pieces of data: error code, error message, and error details.
-      # You can find out more about this error model and how to work with it in the
-      # [API Design Guide](https://cloud.google.com/apis/design/errors).
+      # The `Status` type defines a logical error model that is suitable for different
+      # programming environments, including REST APIs and RPC APIs. It is used by [
+      # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
+      # data: error code, error message, and error details. You can find out more
+      # about this error model and how to work with it in the [API Design Guide](https:
+      # //cloud.google.com/apis/design/errors).
       class Status
         include Google::Apis::Core::Hashable
       
@@ -1200,15 +1099,15 @@ module Google
         # @return [Fixnum]
         attr_accessor :code
       
-        # A list of messages that carry the error details.  There is a common set of
+        # A list of messages that carry the error details. There is a common set of
         # message types for APIs to use.
         # Corresponds to the JSON property `details`
         # @return [Array<Hash<String,Object>>]
         attr_accessor :details
       
-        # A developer-facing error message, which should be in English. Any
-        # user-facing error message should be localized and sent in the
-        # google.rpc.Status.details field, or localized by the client.
+        # A developer-facing error message, which should be in English. Any user-facing
+        # error message should be localized and sent in the google.rpc.Status.details
+        # field, or localized by the client.
         # Corresponds to the JSON property `message`
         # @return [String]
         attr_accessor :message
@@ -1229,10 +1128,9 @@ module Google
       class TestIamPermissionsRequest
         include Google::Apis::Core::Hashable
       
-        # The set of permissions to check for the `resource`. Permissions with
-        # wildcards (such as '*' or 'storage.*') are not allowed. For more
-        # information see
-        # [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
+        # The set of permissions to check for the `resource`. Permissions with wildcards
+        # (such as '*' or 'storage.*') are not allowed. For more information see [IAM
+        # Overview](https://cloud.google.com/iam/docs/overview#permissions).
         # Corresponds to the JSON property `permissions`
         # @return [Array<String>]
         attr_accessor :permissions
@@ -1251,8 +1149,7 @@ module Google
       class TestIamPermissionsResponse
         include Google::Apis::Core::Hashable
       
-        # A subset of `TestPermissionsRequest.permissions` that the caller is
-        # allowed.
+        # A subset of `TestPermissionsRequest.permissions` that the caller is allowed.
         # Corresponds to the JSON property `permissions`
         # @return [Array<String>]
         attr_accessor :permissions
@@ -1271,8 +1168,8 @@ module Google
       class UnbindDeviceFromGatewayRequest
         include Google::Apis::Core::Hashable
       
-        # Required. The device to disassociate from the specified gateway. The value of
-        # `device_id` can be either the device numeric ID or the user-defined device
+        # Required. The device to disassociate from the specified gateway. The value of `
+        # device_id` can be either the device numeric ID or the user-defined device
         # identifier.
         # Corresponds to the JSON property `deviceId`
         # @return [String]