google-api-client 0.40.1 → 0.40.2

data/generated/google/apis/cloudasset_v1p1beta1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/asset-inventory/docs/quickstart
     module CloudassetV1p1beta1
       VERSION = 'V1p1beta1'
-      REVISION = '20200515'
+      REVISION = '20200605'
 
       # 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_v1p1beta1/classes.rb

@@ -34,7 +34,7 @@ module Google
       # `
       # "audit_configs": [
       # `
-      # "service": "allServices"
+      # "service": "allServices",
       # "audit_log_configs": [
       # `
       # "log_type": "DATA_READ",
@@ -43,18 +43,18 @@ module Google
       # ]
       # `,
       # `
-      # "log_type": "DATA_WRITE",
+      # "log_type": "DATA_WRITE"
       # `,
       # `
-      # "log_type": "ADMIN_READ",
+      # "log_type": "ADMIN_READ"
       # `
       # ]
       # `,
       # `
-      # "service": "sampleservice.googleapis.com"
+      # "service": "sampleservice.googleapis.com",
       # "audit_log_configs": [
       # `
-      # "log_type": "DATA_READ",
+      # "log_type": "DATA_READ"
       # `,
       # `
       # "log_type": "DATA_WRITE",
@@ -106,7 +106,7 @@ module Google
       # ]
       # `,
       # `
-      # "log_type": "DATA_WRITE",
+      # "log_type": "DATA_WRITE"
       # `
       # ]
       # `

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

@@ -47,12 +47,12 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Searches all the IAM policies under a given accessible CRM scope
-        # (project/folder/organization). This RPC gives callers
-        # especially admins the ability to search all the IAM policies under a scope,
-        # even if they don't have .getIamPolicy permission of all the IAM policies.
-        # Callers should have cloud.assets.SearchAllIamPolicies permission on the
-        # requested scope, otherwise it will be rejected.
+        # Searches all the IAM policies within a given accessible CRM scope
+        # (project/folder/organization). This RPC gives callers especially
+        # administrators the ability to search all the IAM policies within a scope,
+        # even if they don't have `.getIamPolicy` permission of all the IAM policies.
+        # Callers should have `cloud.assets.SearchAllIamPolicies` permission on the
+        # requested scope, otherwise the request will be rejected.
         # @param [String] scope
         #   Required. The relative name of an asset. The search is limited to the
         #   resources
@@ -74,8 +74,7 @@ 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.
-        #   Examples:
+        #   Optional. The query statement. Examples:
         #   * "policy:myuser@mydomain.com"
         #   * "policy:(myuser@mydomain.com viewer)"
         # @param [String] fields
@@ -108,12 +107,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Searches all the resources under a given accessible CRM scope
-        # (project/folder/organization). This RPC gives callers
-        # especially admins the ability to search all the resources under a scope,
-        # even if they don't have .get permission of all the resources. Callers
-        # should have cloud.assets.SearchAllResources permission on the requested
-        # scope, otherwise it will be rejected.
+        # Searches all the resources within a given accessible CRM scope
+        # (project/folder/organization). This RPC gives callers especially
+        # administrators the ability to search all the resources within a scope, even
+        # if they don't have `.get` permission of all the resources. Callers should
+        # have `cloud.assets.SearchAllResources` permission on the requested scope,
+        # otherwise the request will be rejected.
         # @param [String] scope
         #   Required. The relative name of an asset. The search is limited to the
         #   resources
@@ -128,9 +127,9 @@ module Google
         #   search all the supported asset types.
         # @param [String] order_by
         #   Optional. A comma separated list of fields specifying the sorting order of the
-        #   results. The default order is ascending. Add " desc" after the field name
+        #   results. The default order is ascending. Add ` DESC` after the field name
         #   to indicate descending order. Redundant space characters are ignored. For
-        #   example, "  foo ,  bar  desc  ".
+        #   example, `  location DESC ,  name  `.
         # @param [Fixnum] page_size
         #   Optional. The page size for search result pagination. Page size is capped at
         #   500 even

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 = '20200515'
+      REVISION = '20200605'
 
       # 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/classes.rb

@@ -511,7 +511,8 @@ module Google
         # @return [Google::Apis::CloudassetV1p4beta1::GoogleCloudAssetV1p4beta1AnalysisState]
         attr_accessor :analysis_state
       
-        # The [full resource name](https://aip.dev/122#full-resource-names).
+        # The [full resource
+        # name](https://cloud.google.com/asset-inventory/docs/resource-name-format)
         # Corresponds to the JSON property `fullResourceName`
         # @return [String]
         attr_accessor :full_resource_name
@@ -603,14 +604,20 @@ module Google
         # within
         # the parent will be analyzed. This can only be an organization number (such
         # as "organizations/123") or a folder number (such as "folders/123").
+        # To know how to get organization id, visit [here
+        # ](https://cloud.google.com/resource-manager/docs/creating-managing-
+        # organization#retrieving_your_organization_id).
+        # To know how to get folder id, visit [here
+        # ](https://cloud.google.com/resource-manager/docs/creating-managing-folders#
+        # viewing_or_listing_folders_and_projects).
         # Corresponds to the JSON property `parent`
         # @return [String]
         attr_accessor :parent
       
         # Specifies the resource to analyze for access policies, which may be set
         # directly on the resource, or on ancestors such as organizations, folders or
-        # projects. At least one of ResourceSelector, IdentitySelector or
-        # AccessSelector must be specified in a request.
+        # projects. Either ResourceSelector or IdentitySelector must be
+        # specified in a request.
         # Corresponds to the JSON property `resourceSelector`
         # @return [Google::Apis::CloudassetV1p4beta1::ResourceSelector]
         attr_accessor :resource_selector
@@ -639,7 +646,9 @@ module Google
         # @return [Array<Google::Apis::CloudassetV1p4beta1::GoogleCloudAssetV1p4beta1AccessControlList>]
         attr_accessor :access_control_lists
       
-        # The full name of the resource to which the iam_binding policy attaches.
+        # The [full resource
+        # name](https://cloud.google.com/asset-inventory/docs/resource-name-format)
+        # of the resource to which the iam_binding policy attaches.
         # Corresponds to the JSON property `attachedResourceFullName`
         # @return [String]
         attr_accessor :attached_resource_full_name
@@ -685,6 +694,13 @@ module Google
         # Required. The identity appear in the form of members in
         # [IAM policy
         # binding](https://cloud.google.com/iam/reference/rest/v1/Binding).
+        # The examples of supported forms are:
+        # "user:mike@example.com",
+        # "group:admins@example.com",
+        # "domain:google.com",
+        # "serviceAccount:my-project-id@appspot.gserviceaccount.com".
+        # Notice that wildcard characters (such as * and ?) are not supported.
+        # You must give a specific identity.
         # Corresponds to the JSON property `identity`
         # @return [String]
         attr_accessor :identity
@@ -859,14 +875,16 @@ module Google
       
       # Specifies the resource to analyze for access policies, which may be set
       # directly on the resource, or on ancestors such as organizations, folders or
-      # projects. At least one of ResourceSelector, IdentitySelector or
-      # AccessSelector must be specified in a request.
+      # projects. Either ResourceSelector or IdentitySelector must be
+      # specified in a request.
       class ResourceSelector
         include Google::Apis::Core::Hashable
       
         # Required. The [full resource
-        # name](https://cloud.google.com/apis/design/resource_names#full_resource_name)
-        # .
+        # name](https://cloud.google.com/asset-inventory/docs/resource-name-format)
+        # of a resource of [supported resource
+        # types](https://cloud.google.com/asset-inventory/docs/supported-asset-types#
+        # analyzable_asset_types).
         # Corresponds to the JSON property `fullResourceName`
         # @return [String]
         attr_accessor :full_resource_name

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

@@ -54,6 +54,12 @@ module Google
         #   within
         #   the parent will be analyzed. This can only be an organization number (such
         #   as "organizations/123") or a folder number (such as "folders/123").
+        #   To know how to get organization id, visit [here
+        #   ](https://cloud.google.com/resource-manager/docs/creating-managing-
+        #   organization#retrieving_your_organization_id).
+        #   To know how to get folder id, visit [here
+        #   ](https://cloud.google.com/resource-manager/docs/creating-managing-folders#
+        #   viewing_or_listing_folders_and_projects).
         # @param [Array<String>, String] analysis_query_access_selector_permissions
         #   Optional. The permissions to appear in result.
         # @param [Array<String>, String] analysis_query_access_selector_roles
@@ -62,16 +68,25 @@ module Google
         #   Required. The identity appear in the form of members in
         #   [IAM policy
         #   binding](https://cloud.google.com/iam/reference/rest/v1/Binding).
+        #   The examples of supported forms are:
+        #   "user:mike@example.com",
+        #   "group:admins@example.com",
+        #   "domain:google.com",
+        #   "serviceAccount:my-project-id@appspot.gserviceaccount.com".
+        #   Notice that wildcard characters (such as * and ?) are not supported.
+        #   You must give a specific identity.
         # @param [String] analysis_query_resource_selector_full_resource_name
         #   Required. The [full resource
-        #   name](https://cloud.google.com/apis/design/resource_names#full_resource_name)
-        #   .
+        #   name](https://cloud.google.com/asset-inventory/docs/resource-name-format)
+        #   of a resource of [supported resource
+        #   types](https://cloud.google.com/asset-inventory/docs/supported-asset-types#
+        #   analyzable_asset_types).
         # @param [Boolean] options_analyze_service_account_impersonation
         #   Optional. If true, the response will include access analysis from identities
         #   to
         #   resources via service account impersonation. This is a very expensive
         #   operation, because many derived queries will be executed. We highly
-        #   recommend you use ExportIamPolicyAnalysis rpc instead.
+        #   recommend you use AssetService.ExportIamPolicyAnalysis rpc instead.
         #   For example, if the request analyzes for which resources user A has
         #   permission P, and there's an IAM policy states user A has
         #   iam.serviceAccounts.getAccessToken permission to a service account SA,
@@ -175,6 +190,12 @@ module Google
         #   within
         #   the parent will be analyzed. This can only be an organization number (such
         #   as "organizations/123") or a folder number (such as "folders/123").
+        #   To know how to get organization id, visit [here
+        #   ](https://cloud.google.com/resource-manager/docs/creating-managing-
+        #   organization#retrieving_your_organization_id).
+        #   To know how to get folder id, visit [here
+        #   ](https://cloud.google.com/resource-manager/docs/creating-managing-folders#
+        #   viewing_or_listing_folders_and_projects).
         # @param [Google::Apis::CloudassetV1p4beta1::ExportIamPolicyAnalysisRequest] export_iam_policy_analysis_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.

data/generated/google/apis/cloudbuild_v1.rb

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

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

@@ -381,8 +381,8 @@ module Google
         # @return [String]
         attr_accessor :log_streaming_option
       
-        # Option to specify the logging mode, which determines where the logs are
-        # stored.
+        # Option to specify the logging mode, which determines if and where build
+        # logs are stored.
         # Corresponds to the JSON property `logging`
         # @return [String]
         attr_accessor :logging

data/generated/google/apis/cloudbuild_v1alpha1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/cloud-build/docs/
     module CloudbuildV1alpha1
       VERSION = 'V1alpha1'
-      REVISION = '20200601'
+      REVISION = '20200606'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -381,8 +381,8 @@ module Google
         # @return [String]
         attr_accessor :log_streaming_option
       
-        # Option to specify the logging mode, which determines where the logs are
-        # stored.
+        # Option to specify the logging mode, which determines if and where build
+        # logs are stored.
         # Corresponds to the JSON property `logging`
         # @return [String]
         attr_accessor :logging

data/generated/google/apis/cloudbuild_v1alpha2.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/cloud-build/docs/
     module CloudbuildV1alpha2
       VERSION = 'V1alpha2'
-      REVISION = '20200601'
+      REVISION = '20200606'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -381,8 +381,8 @@ module Google
         # @return [String]
         attr_accessor :log_streaming_option
       
-        # Option to specify the logging mode, which determines where the logs are
-        # stored.
+        # Option to specify the logging mode, which determines if and where build
+        # logs are stored.
         # Corresponds to the JSON property `logging`
         # @return [String]
         attr_accessor :logging

data/generated/google/apis/cloudkms_v1.rb

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

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

@@ -225,7 +225,7 @@ module Google
       # `
       # "audit_configs": [
       # `
-      # "service": "allServices"
+      # "service": "allServices",
       # "audit_log_configs": [
       # `
       # "log_type": "DATA_READ",
@@ -234,18 +234,18 @@ module Google
       # ]
       # `,
       # `
-      # "log_type": "DATA_WRITE",
+      # "log_type": "DATA_WRITE"
       # `,
       # `
-      # "log_type": "ADMIN_READ",
+      # "log_type": "ADMIN_READ"
       # `
       # ]
       # `,
       # `
-      # "service": "sampleservice.googleapis.com"
+      # "service": "sampleservice.googleapis.com",
       # "audit_log_configs": [
       # `
-      # "log_type": "DATA_READ",
+      # "log_type": "DATA_READ"
       # `,
       # `
       # "log_type": "DATA_WRITE",
@@ -297,7 +297,7 @@ module Google
       # ]
       # `,
       # `
-      # "log_type": "DATA_WRITE",
+      # "log_type": "DATA_WRITE"
       # `
       # ]
       # `
@@ -425,7 +425,7 @@ module Google
         attr_accessor :create_time
       
         # Labels with user-defined metadata. For more information, see
-        # [Labeling Keys](/kms/docs/labeling-keys).
+        # [Labeling Keys](https://cloud.google.com/kms/docs/labeling-keys).
         # Corresponds to the JSON property `labels`
         # @return [Hash<String,String>]
         attr_accessor :labels

data/generated/google/apis/cloudresourcemanager_v1.rb

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

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

@@ -56,7 +56,7 @@ module Google
       # `
       # "audit_configs": [
       # `
-      # "service": "allServices"
+      # "service": "allServices",
       # "audit_log_configs": [
       # `
       # "log_type": "DATA_READ",
@@ -65,18 +65,18 @@ module Google
       # ]
       # `,
       # `
-      # "log_type": "DATA_WRITE",
+      # "log_type": "DATA_WRITE"
       # `,
       # `
-      # "log_type": "ADMIN_READ",
+      # "log_type": "ADMIN_READ"
       # `
       # ]
       # `,
       # `
-      # "service": "sampleservice.googleapis.com"
+      # "service": "sampleservice.googleapis.com",
       # "audit_log_configs": [
       # `
-      # "log_type": "DATA_READ",
+      # "log_type": "DATA_READ"
       # `,
       # `
       # "log_type": "DATA_WRITE",
@@ -128,7 +128,7 @@ module Google
       # ]
       # `,
       # `
-      # "log_type": "DATA_WRITE",
+      # "log_type": "DATA_WRITE"
       # `
       # ]
       # `

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

@@ -1272,8 +1272,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Sets the IAM access control policy for the specified Project. Overwrites
-        # any existing policy.
+        # Sets the IAM access control policy for the specified Project.
+        # CAUTION: This method will replace the existing policy, and cannot be used
+        # to append additional IAM settings.
+        # NOTE: Removing service accounts from policies or changing their roles can
+        # render services completely inoperable. It is important to understand how
+        # the service account is being used before removing or updating its roles.
         # The following constraints apply when using `setIamPolicy()`:
         # + Project does not support `allUsers` and `allAuthenticatedUsers` as
         # `members` in a `Binding` of a `Policy`.
@@ -1302,12 +1306,6 @@ module Google
         # projects that no longer have owners who have accepted the ToS. Edits to
         # IAM policies will be rejected until the lack of a ToS-accepting owner is
         # rectified.
-        # + This method will replace the existing policy, and cannot be used to
-        # append additional IAM settings.
-        # Note: Removing service accounts from policies or changing their roles
-        # can render services completely inoperable. It is important to understand
-        # how the service account is being used before removing or updating its
-        # roles.
         # Authorization requires the Google IAM permission
         # `resourcemanager.projects.setIamPolicy` on the project
         # @param [String] resource