google-api-client 0.31.0 → 0.32.0

data/generated/google/apis/cloudfunctions_v1/service.rb

@@ -173,7 +173,7 @@ module Google
         # the actual limits, refer to
         # [Rate Limits](https://cloud.google.com/functions/quotas#rate_limits).
         # @param [String] name
-        #   The name of the function to be called.
+        #   Required. The name of the function to be called.
         # @param [Google::Apis::CloudfunctionsV1::CallFunctionRequest] call_function_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -208,7 +208,8 @@ module Google
         # the specified project, the long running operation will return
         # `ALREADY_EXISTS` error.
         # @param [String] location
-        #   The project and location in which the function should be created, specified
+        #   Required. The project and location in which the function should be created,
+        #   specified
         #   in the format `projects/*/locations/*`
         # @param [Google::Apis::CloudfunctionsV1::CloudFunction] cloud_function_object
         # @param [String] fields
@@ -244,7 +245,7 @@ module Google
         # given function is used by some trigger, the trigger will be updated to
         # remove this function.
         # @param [String] name
-        #   The name of the function which should be deleted.
+        #   Required. The name of the function which should be deleted.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -364,7 +365,7 @@ module Google
         
         # Returns a function with the given name from the requested project.
         # @param [String] name
-        #   The name of the function which details should be obtained.
+        #   Required. The name of the function which details should be obtained.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -400,9 +401,11 @@ module Google
         #   See the operation documentation for the appropriate value for this field.
         # @param [Fixnum] options_requested_policy_version
         #   Optional. The policy format version to be returned.
-        #   Acceptable values are 0, 1, and 3.
-        #   If the value is 0, or the field is omitted, policy format version 1 will 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.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user

data/generated/google/apis/cloudfunctions_v1beta2.rb

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

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

@@ -26,7 +26,7 @@ module Google
       class CallFunctionRequest
         include Google::Apis::Core::Hashable
       
-        # Input to be passed to the function.
+        # Required. Input to be passed to the function.
         # Corresponds to the JSON property `data`
         # @return [String]
         attr_accessor :data

data/generated/google/apis/cloudfunctions_v1beta2/service.rb

@@ -173,7 +173,7 @@ module Google
         # the actual limits refer to [API Calls](
         # https://cloud.google.com/functions/quotas#rate_limits).
         # @param [String] name
-        #   The name of the function to be called.
+        #   Required. The name of the function to be called.
         # @param [Google::Apis::CloudfunctionsV1beta2::CallFunctionRequest] call_function_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -208,7 +208,8 @@ module Google
         # the specified project, the long running operation will return
         # `ALREADY_EXISTS` error.
         # @param [String] location
-        #   The project and location in which the function should be created, specified
+        #   Required. The project and location in which the function should be created,
+        #   specified
         #   in the format `projects/*/locations/*`
         # @param [Google::Apis::CloudfunctionsV1beta2::CloudFunction] cloud_function_object
         # @param [String] fields
@@ -244,7 +245,7 @@ module Google
         # given function is used by some trigger, the trigger will be updated to
         # remove this function.
         # @param [String] name
-        #   The name of the function which should be deleted.
+        #   Required. The name of the function which should be deleted.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -364,7 +365,7 @@ module Google
         
         # Returns a function with the given name from the requested project.
         # @param [String] name
-        #   The name of the function which details should be obtained.
+        #   Required. The name of the function which details should be obtained.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -394,7 +395,7 @@ module Google
         
         # Returns a list of functions that belong to the requested project.
         # @param [String] location
-        #   The project and location from which the function should be listed,
+        #   Required. The project and location from which the function should be listed,
         #   specified in the format `projects/*/locations/*`
         #   If you want to list functions in all locations, use "-" in place of a
         #   location.
@@ -436,7 +437,7 @@ module Google
         
         # Updates existing function.
         # @param [String] name
-        #   The name of the function to be updated.
+        #   Required. The name of the function to be updated.
         # @param [Google::Apis::CloudfunctionsV1beta2::CloudFunction] cloud_function_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.

data/generated/google/apis/cloudidentity_v1.rb

@@ -25,13 +25,16 @@ module Google
     # @see https://cloud.google.com/identity/
     module CloudidentityV1
       VERSION = 'V1'
-      REVISION = '20190529'
+      REVISION = '20190924'
 
       # See, change, create, and delete any of the Cloud Identity Groups that you can access, including the members of each group
       AUTH_CLOUD_IDENTITY_GROUPS = 'https://www.googleapis.com/auth/cloud-identity.groups'
 
       # See any Cloud Identity Groups that you can access, including group members and their emails
       AUTH_CLOUD_IDENTITY_GROUPS_READONLY = 'https://www.googleapis.com/auth/cloud-identity.groups.readonly'
+
+      # View and manage your data across Google Cloud Platform services
+      AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
     end
   end
 end

data/generated/google/apis/cloudidentity_v1beta1.rb

@@ -25,13 +25,16 @@ module Google
     # @see https://cloud.google.com/identity/
     module CloudidentityV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20190529'
+      REVISION = '20190924'
 
       # See, change, create, and delete any of the Cloud Identity Groups that you can access, including the members of each group
       AUTH_CLOUD_IDENTITY_GROUPS = 'https://www.googleapis.com/auth/cloud-identity.groups'
 
       # See any Cloud Identity Groups that you can access, including group members and their emails
       AUTH_CLOUD_IDENTITY_GROUPS_READONLY = 'https://www.googleapis.com/auth/cloud-identity.groups.readonly'
+
+      # View and manage your data across Google Cloud Platform services
+      AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
     end
   end
 end

data/generated/google/apis/cloudiot_v1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/iot
     module CloudiotV1
       VERSION = 'V1'
-      REVISION = '20190828'
+      REVISION = '20190924'
 
       # 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,14 +26,14 @@ module Google
       class BindDeviceToGatewayRequest
         include Google::Apis::Core::Hashable
       
-        # The device to associate with the specified gateway. The value of
+        # 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]
         attr_accessor :device_id
       
-        # The value of `gateway_id` can be either the device numeric ID or the
+        # Required. The value of `gateway_id` can be either the device numeric ID or the
         # user-defined device identifier.
         # Corresponds to the JSON property `gatewayId`
         # @return [String]
@@ -747,7 +747,7 @@ module Google
       class ModifyCloudToDeviceConfigRequest
         include Google::Apis::Core::Hashable
       
-        # The configuration data for the device.
+        # Required. The configuration data for the device.
         # Corresponds to the JSON property `binaryData`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
@@ -795,25 +795,34 @@ module Google
       
       # Defines an Identity and Access Management (IAM) policy. It is used to
       # specify access control policies for Cloud Platform resources.
-      # A `Policy` consists of a list of `bindings`. A `binding` binds a list of
-      # `members` to a `role`, where the members can be user accounts, Google groups,
-      # Google domains, and service accounts. A `role` is a named list of permissions
-      # defined by IAM.
+      # A `Policy` is a collection of `bindings`. A `binding` binds one or more
+      # `members` to a single `role`. Members can be user accounts, service accounts,
+      # Google groups, and domains (such as G Suite). A `role` is a named list of
+      # permissions (defined by IAM or configured by users). A `binding` can
+      # optionally specify a `condition`, which is a logic expression that further
+      # constrains the role binding based on attributes about the request and/or
+      # target resource.
       # **JSON Example**
       # `
       # "bindings": [
       # `
-      # "role": "roles/owner",
+      # "role": "roles/resourcemanager.organizationAdmin",
       # "members": [
       # "user:mike@example.com",
       # "group:admins@example.com",
       # "domain:google.com",
-      # "serviceAccount:my-other-app@appspot.gserviceaccount.com"
+      # "serviceAccount:my-project-id@appspot.gserviceaccount.com"
       # ]
       # `,
       # `
-      # "role": "roles/viewer",
-      # "members": ["user:sean@example.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')",
+      # `
       # `
       # ]
       # `
@@ -823,17 +832,22 @@ module Google
       # - user:mike@example.com
       # - group:admins@example.com
       # - domain:google.com
-      # - serviceAccount:my-other-app@appspot.gserviceaccount.com
-      # role: roles/owner
+      # - serviceAccount:my-project-id@appspot.gserviceaccount.com
+      # role: roles/resourcemanager.organizationAdmin
       # - members:
-      # - user:sean@example.com
-      # role: roles/viewer
+      # - 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')
       # For a description of IAM and its features, see the
       # [IAM developer's guide](https://cloud.google.com/iam/docs).
       class Policy
         include Google::Apis::Core::Hashable
       
-        # Associates a list of `members` to a `role`.
+        # Associates a list of `members` to a `role`. Optionally may specify a
+        # `condition` that determines when binding is in effect.
         # `bindings` with no members will result in an error.
         # Corresponds to the JSON property `bindings`
         # @return [Array<Google::Apis::CloudiotV1::Binding>]
@@ -847,7 +861,9 @@ 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.
+        # 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.
         # Corresponds to the JSON property `etag`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
@@ -856,9 +872,13 @@ module Google
         # Specifies the format of the policy.
         # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
         # rejected.
-        # Policies with any conditional bindings must specify version 3. Policies
-        # without any conditional bindings may specify any valid value or leave the
-        # field unset.
+        # Operations affecting conditional bindings must specify version 3. This can
+        # be either setting a conditional policy, modifying a conditional binding,
+        # or removing a conditional binding from the stored conditional policy.
+        # Operations on non-conditional policies may specify any valid value or
+        # leave the field unset.
+        # If no etag is provided in the call to `setIamPolicy`, any version
+        # compliance checks on the incoming and/or stored policy is skipped.
         # Corresponds to the JSON property `version`
         # @return [Fixnum]
         attr_accessor :version
@@ -954,7 +974,7 @@ module Google
       class SendCommandToDeviceRequest
         include Google::Apis::Core::Hashable
       
-        # The command data to send to the device.
+        # Required. The command data to send to the device.
         # Corresponds to the JSON property `binaryData`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
@@ -999,25 +1019,34 @@ module Google
       
         # Defines an Identity and Access Management (IAM) policy. It is used to
         # specify access control policies for Cloud Platform resources.
-        # A `Policy` consists of a list of `bindings`. A `binding` binds a list of
-        # `members` to a `role`, where the members can be user accounts, Google groups,
-        # Google domains, and service accounts. A `role` is a named list of permissions
-        # defined by IAM.
+        # A `Policy` is a collection of `bindings`. A `binding` binds one or more
+        # `members` to a single `role`. Members can be user accounts, service accounts,
+        # Google groups, and domains (such as G Suite). A `role` is a named list of
+        # permissions (defined by IAM or configured by users). A `binding` can
+        # optionally specify a `condition`, which is a logic expression that further
+        # constrains the role binding based on attributes about the request and/or
+        # target resource.
         # **JSON Example**
         # `
         # "bindings": [
         # `
-        # "role": "roles/owner",
+        # "role": "roles/resourcemanager.organizationAdmin",
         # "members": [
         # "user:mike@example.com",
         # "group:admins@example.com",
         # "domain:google.com",
-        # "serviceAccount:my-other-app@appspot.gserviceaccount.com"
+        # "serviceAccount:my-project-id@appspot.gserviceaccount.com"
         # ]
         # `,
         # `
-        # "role": "roles/viewer",
-        # "members": ["user:sean@example.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')",
+        # `
         # `
         # ]
         # `
@@ -1027,11 +1056,15 @@ module Google
         # - user:mike@example.com
         # - group:admins@example.com
         # - domain:google.com
-        # - serviceAccount:my-other-app@appspot.gserviceaccount.com
-        # role: roles/owner
+        # - serviceAccount:my-project-id@appspot.gserviceaccount.com
+        # role: roles/resourcemanager.organizationAdmin
         # - members:
-        # - user:sean@example.com
-        # role: roles/viewer
+        # - 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')
         # For a description of IAM and its features, see the
         # [IAM developer's guide](https://cloud.google.com/iam/docs).
         # Corresponds to the JSON property `policy`
@@ -1153,14 +1186,14 @@ module Google
       class UnbindDeviceFromGatewayRequest
         include Google::Apis::Core::Hashable
       
-        # The device to disassociate from the specified gateway. The value of
+        # 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]
         attr_accessor :device_id
       
-        # The value of `gateway_id` can be either the device numeric ID or the
+        # Required. The value of `gateway_id` can be either the device numeric ID or the
         # user-defined device identifier.
         # Corresponds to the JSON property `gatewayId`
         # @return [String]

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

@@ -50,7 +50,7 @@ module Google
         
         # Associates the device with the gateway.
         # @param [String] parent
-        #   The name of the registry. For example,
+        #   Required. The name of the registry. For example,
         #   `projects/example-project/locations/us-central1/registries/my-registry`.
         # @param [Google::Apis::CloudiotV1::BindDeviceToGatewayRequest] bind_device_to_gateway_request_object
         # @param [String] fields
@@ -84,7 +84,8 @@ module Google
         
         # Creates a device registry that contains devices.
         # @param [String] parent
-        #   The project and cloud region where this device registry must be created.
+        #   Required. The project and cloud region where this device registry must be
+        #   created.
         #   For example, `projects/example-project/locations/us-central1`.
         # @param [Google::Apis::CloudiotV1::DeviceRegistry] device_registry_object
         # @param [String] fields
@@ -118,7 +119,7 @@ module Google
         
         # Deletes a device registry configuration.
         # @param [String] name
-        #   The name of the device registry. For example,
+        #   Required. The name of the device registry. For example,
         #   `projects/example-project/locations/us-central1/registries/my-registry`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -149,7 +150,7 @@ module Google
         
         # Gets a device registry configuration.
         # @param [String] name
-        #   The name of the device registry. For example,
+        #   Required. The name of the device registry. For example,
         #   `projects/example-project/locations/us-central1/registries/my-registry`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -216,7 +217,7 @@ module Google
         
         # Lists device registries.
         # @param [String] parent
-        #   The project and cloud region path. For example,
+        #   Required. The project and cloud region path. For example,
         #   `projects/example-project/locations/us-central1`.
         # @param [Fixnum] page_size
         #   The maximum number of registries to return in the response. If this value
@@ -262,7 +263,7 @@ module Google
         #   `projects/example-project/locations/us-central1/registries/my-registry`.
         # @param [Google::Apis::CloudiotV1::DeviceRegistry] device_registry_object
         # @param [String] update_mask
-        #   Only updates the `device_registry` fields indicated by this mask.
+        #   Required. Only updates the `device_registry` fields indicated by this mask.
         #   The field mask must not be empty, and it must not contain fields that
         #   are immutable or only set by the server.
         #   Mutable top-level fields: `event_notification_config`, `http_config`,
@@ -370,7 +371,7 @@ module Google
         
         # Deletes the association between the device and the gateway.
         # @param [String] parent
-        #   The name of the registry. For example,
+        #   Required. The name of the registry. For example,
         #   `projects/example-project/locations/us-central1/registries/my-registry`.
         # @param [Google::Apis::CloudiotV1::UnbindDeviceFromGatewayRequest] unbind_device_from_gateway_request_object
         # @param [String] fields
@@ -404,7 +405,7 @@ module Google
         
         # Creates a device in a device registry.
         # @param [String] parent
-        #   The name of the device registry where this device should be created.
+        #   Required. The name of the device registry where this device should be created.
         #   For example,
         #   `projects/example-project/locations/us-central1/registries/my-registry`.
         # @param [Google::Apis::CloudiotV1::Device] device_object
@@ -439,7 +440,7 @@ module Google
         
         # Deletes a device.
         # @param [String] name
-        #   The name of the device. For example,
+        #   Required. The name of the device. For example,
         #   `projects/p0/locations/us-central1/registries/registry0/devices/device0` or
         #   `projects/p0/locations/us-central1/registries/registry0/devices/`num_id``.
         # @param [String] fields
@@ -471,7 +472,7 @@ module Google
         
         # Gets details about a device.
         # @param [String] name
-        #   The name of the device. For example,
+        #   Required. The name of the device. For example,
         #   `projects/p0/locations/us-central1/registries/registry0/devices/device0` or
         #   `projects/p0/locations/us-central1/registries/registry0/devices/`num_id``.
         # @param [String] field_mask
@@ -507,7 +508,7 @@ module Google
         
         # List devices in a device registry.
         # @param [String] parent
-        #   The device registry path. Required. For example,
+        #   Required. The device registry path. Required. For example,
         #   `projects/my-project/locations/us-central1/registries/my-registry`.
         # @param [Array<String>, String] device_ids
         #   A list of device string IDs. For example, `['device0', 'device12']`.
@@ -581,7 +582,7 @@ module Google
         # the Cloud IoT Core servers. Returns the modified configuration version and
         # its metadata.
         # @param [String] name
-        #   The name of the device. For example,
+        #   Required. The name of the device. For example,
         #   `projects/p0/locations/us-central1/registries/registry0/devices/device0` or
         #   `projects/p0/locations/us-central1/registries/registry0/devices/`num_id``.
         # @param [Google::Apis::CloudiotV1::ModifyCloudToDeviceConfigRequest] modify_cloud_to_device_config_request_object
@@ -623,7 +624,7 @@ module Google
         #   in the device numeric ID.
         # @param [Google::Apis::CloudiotV1::Device] device_object
         # @param [String] update_mask
-        #   Only updates the `device` fields indicated by this mask.
+        #   Required. Only updates the `device` fields indicated by this mask.
         #   The field mask must not be empty, and it must not contain fields that
         #   are immutable or only set by the server.
         #   Mutable top-level fields: `credentials`, `blocked`, and `metadata`
@@ -671,7 +672,7 @@ module Google
         # return OK. If the subscription is QoS 1, at least once delivery will be
         # guaranteed; for QoS 0, no acknowledgment will be expected from the device.
         # @param [String] name
-        #   The name of the device. For example,
+        #   Required. The name of the device. For example,
         #   `projects/p0/locations/us-central1/registries/registry0/devices/device0` or
         #   `projects/p0/locations/us-central1/registries/registry0/devices/`num_id``.
         # @param [Google::Apis::CloudiotV1::SendCommandToDeviceRequest] send_command_to_device_request_object
@@ -707,7 +708,7 @@ module Google
         # Lists the last few versions of the device configuration in descending
         # order (i.e.: newest first).
         # @param [String] name
-        #   The name of the device. For example,
+        #   Required. The name of the device. For example,
         #   `projects/p0/locations/us-central1/registries/registry0/devices/device0` or
         #   `projects/p0/locations/us-central1/registries/registry0/devices/`num_id``.
         # @param [Fixnum] num_versions
@@ -745,7 +746,7 @@ module Google
         # Lists the last few versions of the device state in descending order (i.e.:
         # newest first).
         # @param [String] name
-        #   The name of the device. For example,
+        #   Required. The name of the device. For example,
         #   `projects/p0/locations/us-central1/registries/registry0/devices/device0` or
         #   `projects/p0/locations/us-central1/registries/registry0/devices/`num_id``.
         # @param [Fixnum] num_states
@@ -889,7 +890,7 @@ module Google
         
         # List devices in a device registry.
         # @param [String] parent
-        #   The device registry path. Required. For example,
+        #   Required. The device registry path. Required. For example,
         #   `projects/my-project/locations/us-central1/registries/my-registry`.
         # @param [Array<String>, String] device_ids
         #   A list of device string IDs. For example, `['device0', 'device12']`.