google-api-client 0.42.0 → 0.43.0

data/generated/google/apis/classroom_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/classroom/
     module ClassroomV1
       VERSION = 'V1'
-      REVISION = '20200706'
+      REVISION = '20200801'
 
       # View and manage announcements in Google Classroom
       AUTH_CLASSROOM_ANNOUNCEMENTS = 'https://www.googleapis.com/auth/classroom.announcements'

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

@@ -1626,7 +1626,9 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The list of APIs usable within the Service Perimeter. Must be empty
-        # unless 'enable_restriction' is True.
+        # unless 'enable_restriction' is True. You can specify a list of individual
+        # services, as well as include the 'RESTRICTED-SERVICES' value, which
+        # automatically includes all of the services protected by the perimeter.
         # Corresponds to the JSON property `allowedServices`
         # @return [Array<String>]
         attr_accessor :allowed_services
@@ -2111,21 +2113,23 @@ module Google
         end
       end
       
-      # A result of Resource Search, containing information of a cloud resoure.
+      # A result of Resource Search, containing information of a cloud resource.
       class ResourceSearchResult
         include Google::Apis::Core::Hashable
       
-        # The additional attributes of this resource. The attributes may vary from
-        # one resource type to another. Examples: `projectId` for Project,
+        # The additional searchable attributes of this resource. The attributes may
+        # vary from one resource type to another. Examples: `projectId` for Project,
         # `dnsName` for DNS ManagedZone. This field contains a subset of the resource
         # metadata fields that are returned by the List or Get APIs provided by the
-        # corresponding GCP service (e.g., Compute Engine). see [API
-        # references](https://cloud.google.com/asset-inventory/docs/supported-asset-
-        # types#supported_resource_types)
-        # of CAIS supported resource types. You can search values of these fields
-        # through free text search. However, you should not consume the field
-        # programically as the field names and values may change as the GCP service
-        # (e.g., Compute Engine) updates to a new incompatible API version.
+        # corresponding GCP service (e.g., Compute Engine). see [API references and
+        # supported searchable
+        # attributes](https://cloud.google.com/asset-inventory/docs/supported-asset-
+        # types#searchable_asset_types)
+        # for more information.
+        # You can search values of these fields through free text search. However,
+        # you should not consume the field programically as the field names and
+        # values may change as the GCP service updates to a new incompatible API
+        # version.
         # To search against the `additional_attributes`:
         # * use a free text query to match the attributes values. Example: to search
         # `additional_attributes = ` dnsName: "foobar" ``, you can issue a query

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

@@ -355,18 +355,23 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Searches all the IAM policies within the given accessible scope (e.g., a
-        # project, a folder or an organization). Callers should have
-        # `cloud.assets.SearchAllIamPolicies` permission upon the requested scope,
+        # Searches all IAM policies within the specified scope, such as a project,
+        # folder, or organization. The caller must be granted the
+        # `cloudasset.assets.searchAllIamPolicies` permission on the desired scope,
         # otherwise the request will be rejected.
         # @param [String] scope
-        #   Required. A scope can be a project, a folder or an organization. The search is
-        #   limited to the IAM policies within the `scope`.
+        #   Required. A scope can be a project, a folder, or an organization. The search
+        #   is
+        #   limited to the IAM policies within the `scope`. The caller must be granted
+        #   the
+        #   [`cloudasset.assets.searchAllIamPolicies`](http://cloud.google.com/asset-
+        #   inventory/docs/access-control#required_permissions)
+        #   permission on the desired scope.
         #   The allowed values are:
-        #   * projects/`PROJECT_ID`
-        #   * projects/`PROJECT_NUMBER`
-        #   * folders/`FOLDER_NUMBER`
-        #   * organizations/`ORGANIZATION_NUMBER`
+        #   * projects/`PROJECT_ID` (e.g., "projects/foo-bar")
+        #   * projects/`PROJECT_NUMBER` (e.g., "projects/12345678")
+        #   * folders/`FOLDER_NUMBER` (e.g., "folders/1234567")
+        #   * organizations/`ORGANIZATION_NUMBER` (e.g., "organizations/123456")
         # @param [Fixnum] page_size
         #   Optional. The page size for search result pagination. Page size is capped at
         #   500 even
@@ -380,26 +385,31 @@ module Google
         #   previous response. The values of all other method parameters must be
         #   identical to those in the previous call.
         # @param [String] query
-        #   Optional. The query statement. An empty query can be specified to search all
-        #   the IAM
-        #   policies within the given `scope`.
-        #   Examples:
-        #   * `policy : "amy@gmail.com"` to find Cloud IAM policy bindings that
-        #   specify user "amy@gmail.com".
-        #   * `policy : "roles/compute.admin"` to find Cloud IAM policy bindings that
-        #   specify the Compute Admin role.
-        #   * `policy.role.permissions : "storage.buckets.update"` to find Cloud IAM
-        #   policy bindings that specify a role containing "storage.buckets.update"
-        #   permission.
-        #   * `resource : "organizations/123"` to find Cloud IAM policy bindings that
-        #   are set on "organizations/123".
-        #   * `(resource : ("organizations/123" OR "folders/1234") AND policy : "amy")`
-        #   to find Cloud IAM policy bindings that are set on "organizations/123" or
-        #   "folders/1234", and also specify user "amy".
-        #   See [how to construct a
+        #   Optional. The query statement. See [how to construct a
         #   query](https://cloud.google.com/asset-inventory/docs/searching-iam-policies#
         #   how_to_construct_a_query)
-        #   for more details.
+        #   for more information. If not specified or empty, it will search all the
+        #   IAM policies within the specified `scope`.
+        #   Examples:
+        #   * `policy : "amy@gmail.com"` to find IAM policy bindings that specify user
+        #   "amy@gmail.com".
+        #   * `policy : "roles/compute.admin"` to find IAM policy bindings that specify
+        #   the Compute Admin role.
+        #   * `policy.role.permissions : "storage.buckets.update"` to find IAM policy
+        #   bindings that specify a role containing "storage.buckets.update"
+        #   permission. Note that if callers don't have `iam.roles.get` access to a
+        #   role's included permissions, policy bindings that specify this role will
+        #   be dropped from the search results.
+        #   * `resource : "organizations/123456"` to find IAM policy bindings
+        #   that are set on "organizations/123456".
+        #   * `"Important"` to find IAM policy bindings that contain "Important" as a
+        #   word in any of the searchable fields (except for the included
+        #   permissions).
+        #   * `"*por*"` to find IAM policy bindings which contain "por" as a substring
+        #   in any of the searchable fields (except for the included permissions).
+        #   * `(resource : ("instance1" OR "instance2") AND policy : "amy")` to find
+        #   IAM policy bindings that are set on resources "instance1" or
+        #   "instance2" and also specify user "amy".
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -430,18 +440,22 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Searches all the resources within the given accessible scope (e.g., a
-        # project, a folder or an organization). Callers should have
-        # `cloud.assets.SearchAllResources` permission upon the requested scope,
+        # Searches all Cloud resources within the specified scope, such as a project,
+        # folder, or organization. The caller must be granted the
+        # `cloudasset.assets.searchAllResources` permission on the desired scope,
         # otherwise the request will be rejected.
         # @param [String] scope
-        #   Required. A scope can be a project, a folder or an organization. The search is
-        #   limited to the resources within the `scope`.
+        #   Required. A scope can be a project, a folder, or an organization. The search
+        #   is
+        #   limited to the resources within the `scope`. The caller must be granted the
+        #   [`cloudasset.assets.searchAllResources`](http://cloud.google.com/asset-
+        #   inventory/docs/access-control#required_permissions)
+        #   permission on the desired scope.
         #   The allowed values are:
-        #   * projects/`PROJECT_ID`
-        #   * projects/`PROJECT_NUMBER`
-        #   * folders/`FOLDER_NUMBER`
-        #   * organizations/`ORGANIZATION_NUMBER`
+        #   * projects/`PROJECT_ID` (e.g., "projects/foo-bar")
+        #   * projects/`PROJECT_NUMBER` (e.g., "projects/12345678")
+        #   * folders/`FOLDER_NUMBER` (e.g., "folders/1234567")
+        #   * organizations/`ORGANIZATION_NUMBER` (e.g., "organizations/123456")
         # @param [Array<String>, String] asset_types
         #   Optional. A list of asset types that this request searches for. If empty, it
         #   will
@@ -470,14 +484,21 @@ module Google
         #   the previous response. The values of all other method parameters, must be
         #   identical to those in the previous call.
         # @param [String] query
-        #   Optional. The query statement. An empty query can be specified to search all
-        #   the
-        #   resources of certain `asset_types` within the given `scope`.
+        #   Optional. The query statement. See [how to construct a
+        #   query](http://cloud.google.com/asset-inventory/docs/searching-resources#
+        #   how_to_construct_a_query)
+        #   for more information. If not specified or empty, it will search all the
+        #   resources within the specified `scope`. Note that the query string is
+        #   compared against each Cloud IAM policy binding, including its members,
+        #   roles, and Cloud IAM conditions. The returned Cloud IAM policies will only
+        #   contain the bindings that match your query. To learn more about the IAM
+        #   policy structure, see [IAM policy
+        #   doc](https://cloud.google.com/iam/docs/policies#structure).
         #   Examples:
         #   * `name : "Important"` to find Cloud resources whose name contains
         #   "Important" as a word.
         #   * `displayName : "Impor*"` to find Cloud resources whose display name
-        #   contains "Impor" as a word prefix.
+        #   contains "Impor" as a prefix.
         #   * `description : "*por*"` to find Cloud resources whose description
         #   contains "por" as a substring.
         #   * `location : "us-west*"` to find Cloud resources whose location is
@@ -489,7 +510,7 @@ module Google
         #   * `labels.env : *` to find Cloud resources which have a label "env".
         #   * `"Important"` to find Cloud resources which contain "Important" as a word
         #   in any of the searchable fields.
-        #   * `"Impor*"` to find Cloud resources which contain "Impor" as a word prefix
+        #   * `"Impor*"` to find Cloud resources which contain "Impor" as a prefix
         #   in any of the searchable fields.
         #   * `"*por*"` to find Cloud resources which contain "por" as a substring in
         #   any of the searchable fields.
@@ -497,10 +518,6 @@ module Google
         #   resources which contain "Important" as a word in any of the searchable
         #   fields and are also located in the "us-west1" region or the "global"
         #   location.
-        #   See [how to construct a
-        #   query](https://cloud.google.com/asset-inventory/docs/searching-resources#
-        #   how_to_construct_a_query)
-        #   for more details.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user

data/generated/google/apis/cloudasset_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/asset-inventory/docs/quickstart
     module CloudassetV1
       VERSION = 'V1'
-      REVISION = '20200619'
+      REVISION = '20200731'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -1370,7 +1370,9 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The list of APIs usable within the Service Perimeter. Must be empty
-        # unless 'enable_restriction' is True.
+        # unless 'enable_restriction' is True. You can specify a list of individual
+        # services, as well as include the 'RESTRICTED-SERVICES' value, which
+        # automatically includes all of the services protected by the perimeter.
         # Corresponds to the JSON property `allowedServices`
         # @return [Array<String>]
         attr_accessor :allowed_services

data/generated/google/apis/cloudasset_v1beta1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/asset-inventory/docs/quickstart
     module CloudassetV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20200613'
+      REVISION = '20200731'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/cloudasset_v1p4beta1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/asset-inventory/docs/quickstart
     module CloudassetV1p4beta1
       VERSION = 'V1p4beta1'
-      REVISION = '20200613'
+      REVISION = '20200731'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'