Autogenerated update (2020-08-13)

Delete:
- accessapproval_v1beta1
- oauth2_v2
- storage_v1beta2

Update:
- accessapproval_v1
- appsmarket_v2
- bigquery_v2
- bigqueryconnection_v1beta1
- binaryauthorization_v1
- binaryauthorization_v1beta1
- cloudiot_v1
- cloudtasks_v2beta2
- cloudtasks_v2beta3
- compute_alpha
- compute_beta
- compute_v1
- containeranalysis_v1alpha1
- containeranalysis_v1beta1
- content_v2
- content_v2_1
- documentai_v1beta2
- firebasehosting_v1beta1
- games_configuration_v1configuration
- games_management_v1management
- games_v1
- gmail_v1
- gmailpostmastertools_v1beta1
- iap_v1
- iap_v1beta1
- redis_v1
- redis_v1beta1
- script_v1
- servicecontrol_v1
- servicemanagement_v1
- storagetransfer_v1

api_names_out.yaml

@@ -14040,6 +14040,7 @@
 "/bigquery:v2/TimePartitioning/type": type
 "/bigquery:v2/TrainingOptions": training_options
 "/bigquery:v2/TrainingOptions/autoArima": auto_arima
+"/bigquery:v2/TrainingOptions/autoArimaMaxOrder": auto_arima_max_order
 "/bigquery:v2/TrainingOptions/batchSize": batch_size
 "/bigquery:v2/TrainingOptions/dataFrequency": data_frequency
 "/bigquery:v2/TrainingOptions/dataSplitColumn": data_split_column
@@ -26624,6 +26625,8 @@
 "/compute:alpha/BackendBucket/bucketName": bucket_name
 "/compute:alpha/BackendBucket/cdnPolicy": cdn_policy
 "/compute:alpha/BackendBucket/creationTimestamp": creation_timestamp
+"/compute:alpha/BackendBucket/customResponseHeaders": custom_response_headers
+"/compute:alpha/BackendBucket/customResponseHeaders/custom_response_header": custom_response_header
 "/compute:alpha/BackendBucket/description": description
 "/compute:alpha/BackendBucket/enableCdn": enable_cdn
 "/compute:alpha/BackendBucket/id": id
@@ -26632,10 +26635,20 @@
 "/compute:alpha/BackendBucket/selfLink": self_link
 "/compute:alpha/BackendBucket/selfLinkWithId": self_link_with_id
 "/compute:alpha/BackendBucketCdnPolicy": backend_bucket_cdn_policy
+"/compute:alpha/BackendBucketCdnPolicy/cacheMode": cache_mode
+"/compute:alpha/BackendBucketCdnPolicy/clientTtl": client_ttl
+"/compute:alpha/BackendBucketCdnPolicy/defaultTtl": default_ttl
+"/compute:alpha/BackendBucketCdnPolicy/maxTtl": max_ttl
+"/compute:alpha/BackendBucketCdnPolicy/negativeCaching": negative_caching
+"/compute:alpha/BackendBucketCdnPolicy/negativeCachingPolicys": negative_caching_policys
+"/compute:alpha/BackendBucketCdnPolicy/negativeCachingPolicys/negative_caching_policy": negative_caching_policy
 "/compute:alpha/BackendBucketCdnPolicy/requestCoalescing": request_coalescing
 "/compute:alpha/BackendBucketCdnPolicy/signedUrlCacheMaxAgeSec": signed_url_cache_max_age_sec
 "/compute:alpha/BackendBucketCdnPolicy/signedUrlKeyNames": signed_url_key_names
 "/compute:alpha/BackendBucketCdnPolicy/signedUrlKeyNames/signed_url_key_name": signed_url_key_name
+"/compute:alpha/BackendBucketCdnPolicyNegativeCachingPolicy": backend_bucket_cdn_policy_negative_caching_policy
+"/compute:alpha/BackendBucketCdnPolicyNegativeCachingPolicy/code": code
+"/compute:alpha/BackendBucketCdnPolicyNegativeCachingPolicy/ttl": ttl
 "/compute:alpha/BackendBucketList": backend_bucket_list
 "/compute:alpha/BackendBucketList/id": id
 "/compute:alpha/BackendBucketList/items": items
@@ -26663,6 +26676,8 @@
 "/compute:alpha/BackendService/creationTimestamp": creation_timestamp
 "/compute:alpha/BackendService/customRequestHeaders": custom_request_headers
 "/compute:alpha/BackendService/customRequestHeaders/custom_request_header": custom_request_header
+"/compute:alpha/BackendService/customResponseHeaders": custom_response_headers
+"/compute:alpha/BackendService/customResponseHeaders/custom_response_header": custom_response_header
 "/compute:alpha/BackendService/description": description
 "/compute:alpha/BackendService/enableCDN": enable_cdn
 "/compute:alpha/BackendService/failoverPolicy": failover_policy
@@ -26711,10 +26726,20 @@
 "/compute:alpha/BackendServiceAppEngineBackend/version": version
 "/compute:alpha/BackendServiceCdnPolicy": backend_service_cdn_policy
 "/compute:alpha/BackendServiceCdnPolicy/cacheKeyPolicy": cache_key_policy
+"/compute:alpha/BackendServiceCdnPolicy/cacheMode": cache_mode
+"/compute:alpha/BackendServiceCdnPolicy/clientTtl": client_ttl
+"/compute:alpha/BackendServiceCdnPolicy/defaultTtl": default_ttl
+"/compute:alpha/BackendServiceCdnPolicy/maxTtl": max_ttl
+"/compute:alpha/BackendServiceCdnPolicy/negativeCaching": negative_caching
+"/compute:alpha/BackendServiceCdnPolicy/negativeCachingPolicys": negative_caching_policys
+"/compute:alpha/BackendServiceCdnPolicy/negativeCachingPolicys/negative_caching_policy": negative_caching_policy
 "/compute:alpha/BackendServiceCdnPolicy/requestCoalescing": request_coalescing
 "/compute:alpha/BackendServiceCdnPolicy/signedUrlCacheMaxAgeSec": signed_url_cache_max_age_sec
 "/compute:alpha/BackendServiceCdnPolicy/signedUrlKeyNames": signed_url_key_names
 "/compute:alpha/BackendServiceCdnPolicy/signedUrlKeyNames/signed_url_key_name": signed_url_key_name
+"/compute:alpha/BackendServiceCdnPolicyNegativeCachingPolicy": backend_service_cdn_policy_negative_caching_policy
+"/compute:alpha/BackendServiceCdnPolicyNegativeCachingPolicy/code": code
+"/compute:alpha/BackendServiceCdnPolicyNegativeCachingPolicy/ttl": ttl
 "/compute:alpha/BackendServiceCloudFunctionBackend": backend_service_cloud_function_backend
 "/compute:alpha/BackendServiceCloudFunctionBackend/functionName": function_name
 "/compute:alpha/BackendServiceCloudFunctionBackend/targetProject": target_project
@@ -35755,6 +35780,8 @@
 "/compute:beta/BackendBucket/bucketName": bucket_name
 "/compute:beta/BackendBucket/cdnPolicy": cdn_policy
 "/compute:beta/BackendBucket/creationTimestamp": creation_timestamp
+"/compute:beta/BackendBucket/customResponseHeaders": custom_response_headers
+"/compute:beta/BackendBucket/customResponseHeaders/custom_response_header": custom_response_header
 "/compute:beta/BackendBucket/description": description
 "/compute:beta/BackendBucket/enableCdn": enable_cdn
 "/compute:beta/BackendBucket/id": id
@@ -35762,9 +35789,19 @@
 "/compute:beta/BackendBucket/name": name
 "/compute:beta/BackendBucket/selfLink": self_link
 "/compute:beta/BackendBucketCdnPolicy": backend_bucket_cdn_policy
+"/compute:beta/BackendBucketCdnPolicy/cacheMode": cache_mode
+"/compute:beta/BackendBucketCdnPolicy/clientTtl": client_ttl
+"/compute:beta/BackendBucketCdnPolicy/defaultTtl": default_ttl
+"/compute:beta/BackendBucketCdnPolicy/maxTtl": max_ttl
+"/compute:beta/BackendBucketCdnPolicy/negativeCaching": negative_caching
+"/compute:beta/BackendBucketCdnPolicy/negativeCachingPolicys": negative_caching_policys
+"/compute:beta/BackendBucketCdnPolicy/negativeCachingPolicys/negative_caching_policy": negative_caching_policy
 "/compute:beta/BackendBucketCdnPolicy/signedUrlCacheMaxAgeSec": signed_url_cache_max_age_sec
 "/compute:beta/BackendBucketCdnPolicy/signedUrlKeyNames": signed_url_key_names
 "/compute:beta/BackendBucketCdnPolicy/signedUrlKeyNames/signed_url_key_name": signed_url_key_name
+"/compute:beta/BackendBucketCdnPolicyNegativeCachingPolicy": backend_bucket_cdn_policy_negative_caching_policy
+"/compute:beta/BackendBucketCdnPolicyNegativeCachingPolicy/code": code
+"/compute:beta/BackendBucketCdnPolicyNegativeCachingPolicy/ttl": ttl
 "/compute:beta/BackendBucketList": backend_bucket_list
 "/compute:beta/BackendBucketList/id": id
 "/compute:beta/BackendBucketList/items": items
@@ -35790,6 +35827,8 @@
 "/compute:beta/BackendService/creationTimestamp": creation_timestamp
 "/compute:beta/BackendService/customRequestHeaders": custom_request_headers
 "/compute:beta/BackendService/customRequestHeaders/custom_request_header": custom_request_header
+"/compute:beta/BackendService/customResponseHeaders": custom_response_headers
+"/compute:beta/BackendService/customResponseHeaders/custom_response_header": custom_response_header
 "/compute:beta/BackendService/description": description
 "/compute:beta/BackendService/enableCDN": enable_cdn
 "/compute:beta/BackendService/failoverPolicy": failover_policy
@@ -35830,9 +35869,19 @@
 "/compute:beta/BackendServiceAggregatedList/warning/message": message
 "/compute:beta/BackendServiceCdnPolicy": backend_service_cdn_policy
 "/compute:beta/BackendServiceCdnPolicy/cacheKeyPolicy": cache_key_policy
+"/compute:beta/BackendServiceCdnPolicy/cacheMode": cache_mode
+"/compute:beta/BackendServiceCdnPolicy/clientTtl": client_ttl
+"/compute:beta/BackendServiceCdnPolicy/defaultTtl": default_ttl
+"/compute:beta/BackendServiceCdnPolicy/maxTtl": max_ttl
+"/compute:beta/BackendServiceCdnPolicy/negativeCaching": negative_caching
+"/compute:beta/BackendServiceCdnPolicy/negativeCachingPolicys": negative_caching_policys
+"/compute:beta/BackendServiceCdnPolicy/negativeCachingPolicys/negative_caching_policy": negative_caching_policy
 "/compute:beta/BackendServiceCdnPolicy/signedUrlCacheMaxAgeSec": signed_url_cache_max_age_sec
 "/compute:beta/BackendServiceCdnPolicy/signedUrlKeyNames": signed_url_key_names
 "/compute:beta/BackendServiceCdnPolicy/signedUrlKeyNames/signed_url_key_name": signed_url_key_name
+"/compute:beta/BackendServiceCdnPolicyNegativeCachingPolicy": backend_service_cdn_policy_negative_caching_policy
+"/compute:beta/BackendServiceCdnPolicyNegativeCachingPolicy/code": code
+"/compute:beta/BackendServiceCdnPolicyNegativeCachingPolicy/ttl": ttl
 "/compute:beta/BackendServiceFailoverPolicy": backend_service_failover_policy
 "/compute:beta/BackendServiceFailoverPolicy/disableConnectionDrainOnFailover": disable_connection_drain_on_failover
 "/compute:beta/BackendServiceFailoverPolicy/dropTrafficIfUnhealthy": drop_traffic_if_unhealthy
@@ -35937,11 +35986,13 @@
 "/compute:beta/Commitment": commitment
 "/compute:beta/Commitment/allocations": allocations
 "/compute:beta/Commitment/allocations/allocation": allocation
+"/compute:beta/Commitment/category": category
 "/compute:beta/Commitment/creationTimestamp": creation_timestamp
 "/compute:beta/Commitment/description": description
 "/compute:beta/Commitment/endTimestamp": end_timestamp
 "/compute:beta/Commitment/id": id
 "/compute:beta/Commitment/kind": kind
+"/compute:beta/Commitment/licenseResource": license_resource
 "/compute:beta/Commitment/name": name
 "/compute:beta/Commitment/plan": plan
 "/compute:beta/Commitment/region": region
@@ -37430,6 +37481,10 @@
 "/compute:beta/LicenseCodeLicenseAlias": license_code_license_alias
 "/compute:beta/LicenseCodeLicenseAlias/description": description
 "/compute:beta/LicenseCodeLicenseAlias/selfLink": self_link
+"/compute:beta/LicenseResourceCommitment": license_resource_commitment
+"/compute:beta/LicenseResourceCommitment/amount": amount
+"/compute:beta/LicenseResourceCommitment/coresPerLicense": cores_per_license
+"/compute:beta/LicenseResourceCommitment/license": license
 "/compute:beta/LicenseResourceRequirements": license_resource_requirements
 "/compute:beta/LicenseResourceRequirements/minGuestCpuCount": min_guest_cpu_count
 "/compute:beta/LicenseResourceRequirements/minMemoryMb": min_memory_mb
@@ -43362,11 +43417,13 @@
 "/compute:v1/CircuitBreakers/maxRequestsPerConnection": max_requests_per_connection
 "/compute:v1/CircuitBreakers/maxRetries": max_retries
 "/compute:v1/Commitment": commitment
+"/compute:v1/Commitment/category": category
 "/compute:v1/Commitment/creationTimestamp": creation_timestamp
 "/compute:v1/Commitment/description": description
 "/compute:v1/Commitment/endTimestamp": end_timestamp
 "/compute:v1/Commitment/id": id
 "/compute:v1/Commitment/kind": kind
+"/compute:v1/Commitment/licenseResource": license_resource
 "/compute:v1/Commitment/name": name
 "/compute:v1/Commitment/plan": plan
 "/compute:v1/Commitment/region": region
@@ -44278,6 +44335,7 @@
 "/compute:v1/InstanceGroupManager/namedPorts/named_port": named_port
 "/compute:v1/InstanceGroupManager/region": region
 "/compute:v1/InstanceGroupManager/selfLink": self_link
+"/compute:v1/InstanceGroupManager/statefulPolicy": stateful_policy
 "/compute:v1/InstanceGroupManager/status": status
 "/compute:v1/InstanceGroupManager/targetPools": target_pools
 "/compute:v1/InstanceGroupManager/targetPools/target_pool": target_pool
@@ -44330,7 +44388,13 @@
 "/compute:v1/InstanceGroupManagerStatus": instance_group_manager_status
 "/compute:v1/InstanceGroupManagerStatus/autoscaler": autoscaler
 "/compute:v1/InstanceGroupManagerStatus/isStable": is_stable
+"/compute:v1/InstanceGroupManagerStatus/stateful": stateful
 "/compute:v1/InstanceGroupManagerStatus/versionTarget": version_target
+"/compute:v1/InstanceGroupManagerStatusStateful": instance_group_manager_status_stateful
+"/compute:v1/InstanceGroupManagerStatusStateful/hasStatefulConfig": has_stateful_config
+"/compute:v1/InstanceGroupManagerStatusStateful/perInstanceConfigs": per_instance_configs
+"/compute:v1/InstanceGroupManagerStatusStatefulPerInstanceConfigs": instance_group_manager_status_stateful_per_instance_configs
+"/compute:v1/InstanceGroupManagerStatusStatefulPerInstanceConfigs/allEffective": all_effective
 "/compute:v1/InstanceGroupManagerStatusVersionTarget": instance_group_manager_status_version_target
 "/compute:v1/InstanceGroupManagerStatusVersionTarget/isReached": is_reached
 "/compute:v1/InstanceGroupManagerUpdatePolicy": instance_group_manager_update_policy
@@ -44358,6 +44422,9 @@
 "/compute:v1/InstanceGroupManagersDeleteInstancesRequest": instance_group_managers_delete_instances_request
 "/compute:v1/InstanceGroupManagersDeleteInstancesRequest/instances": instances
 "/compute:v1/InstanceGroupManagersDeleteInstancesRequest/instances/instance": instance
+"/compute:v1/InstanceGroupManagersDeletePerInstanceConfigsReq": instance_group_managers_delete_per_instance_configs_req
+"/compute:v1/InstanceGroupManagersDeletePerInstanceConfigsReq/names": names
+"/compute:v1/InstanceGroupManagersDeletePerInstanceConfigsReq/names/name": name
 "/compute:v1/InstanceGroupManagersListErrorsResponse": instance_group_managers_list_errors_response
 "/compute:v1/InstanceGroupManagersListErrorsResponse/items": items
 "/compute:v1/InstanceGroupManagersListErrorsResponse/items/item": item
@@ -44366,6 +44433,20 @@
 "/compute:v1/InstanceGroupManagersListManagedInstancesResponse/managedInstances": managed_instances
 "/compute:v1/InstanceGroupManagersListManagedInstancesResponse/managedInstances/managed_instance": managed_instance
 "/compute:v1/InstanceGroupManagersListManagedInstancesResponse/nextPageToken": next_page_token
+"/compute:v1/InstanceGroupManagersListPerInstanceConfigsResp": instance_group_managers_list_per_instance_configs_resp
+"/compute:v1/InstanceGroupManagersListPerInstanceConfigsResp/items": items
+"/compute:v1/InstanceGroupManagersListPerInstanceConfigsResp/items/item": item
+"/compute:v1/InstanceGroupManagersListPerInstanceConfigsResp/nextPageToken": next_page_token
+"/compute:v1/InstanceGroupManagersListPerInstanceConfigsResp/warning": warning
+"/compute:v1/InstanceGroupManagersListPerInstanceConfigsResp/warning/code": code
+"/compute:v1/InstanceGroupManagersListPerInstanceConfigsResp/warning/data": data
+"/compute:v1/InstanceGroupManagersListPerInstanceConfigsResp/warning/data/datum": datum
+"/compute:v1/InstanceGroupManagersListPerInstanceConfigsResp/warning/data/datum/key": key
+"/compute:v1/InstanceGroupManagersListPerInstanceConfigsResp/warning/data/datum/value": value
+"/compute:v1/InstanceGroupManagersListPerInstanceConfigsResp/warning/message": message
+"/compute:v1/InstanceGroupManagersPatchPerInstanceConfigsReq": instance_group_managers_patch_per_instance_configs_req
+"/compute:v1/InstanceGroupManagersPatchPerInstanceConfigsReq/perInstanceConfigs": per_instance_configs
+"/compute:v1/InstanceGroupManagersPatchPerInstanceConfigsReq/perInstanceConfigs/per_instance_config": per_instance_config
 "/compute:v1/InstanceGroupManagersRecreateInstancesRequest": instance_group_managers_recreate_instances_request
 "/compute:v1/InstanceGroupManagersRecreateInstancesRequest/instances": instances
 "/compute:v1/InstanceGroupManagersRecreateInstancesRequest/instances/instance": instance
@@ -44385,6 +44466,9 @@
 "/compute:v1/InstanceGroupManagersSetTargetPoolsRequest/fingerprint": fingerprint
 "/compute:v1/InstanceGroupManagersSetTargetPoolsRequest/targetPools": target_pools
 "/compute:v1/InstanceGroupManagersSetTargetPoolsRequest/targetPools/target_pool": target_pool
+"/compute:v1/InstanceGroupManagersUpdatePerInstanceConfigsReq": instance_group_managers_update_per_instance_configs_req
+"/compute:v1/InstanceGroupManagersUpdatePerInstanceConfigsReq/perInstanceConfigs": per_instance_configs
+"/compute:v1/InstanceGroupManagersUpdatePerInstanceConfigsReq/perInstanceConfigs/per_instance_config": per_instance_config
 "/compute:v1/InstanceGroupsAddInstancesRequest": instance_groups_add_instances_request
 "/compute:v1/InstanceGroupsAddInstancesRequest/instances": instances
 "/compute:v1/InstanceGroupsAddInstancesRequest/instances/instance": instance
@@ -44764,6 +44848,10 @@
 "/compute:v1/LicenseCodeLicenseAlias": license_code_license_alias
 "/compute:v1/LicenseCodeLicenseAlias/description": description
 "/compute:v1/LicenseCodeLicenseAlias/selfLink": self_link
+"/compute:v1/LicenseResourceCommitment": license_resource_commitment
+"/compute:v1/LicenseResourceCommitment/amount": amount
+"/compute:v1/LicenseResourceCommitment/coresPerLicense": cores_per_license
+"/compute:v1/LicenseResourceCommitment/license": license
 "/compute:v1/LicenseResourceRequirements": license_resource_requirements
 "/compute:v1/LicenseResourceRequirements/minGuestCpuCount": min_guest_cpu_count
 "/compute:v1/LicenseResourceRequirements/minMemoryMb": min_memory_mb
@@ -44865,6 +44953,8 @@
 "/compute:v1/ManagedInstance/instanceHealth/instance_health": instance_health
 "/compute:v1/ManagedInstance/instanceStatus": instance_status
 "/compute:v1/ManagedInstance/lastAttempt": last_attempt
+"/compute:v1/ManagedInstance/preservedStateFromConfig": preserved_state_from_config
+"/compute:v1/ManagedInstance/preservedStateFromPolicy": preserved_state_from_policy
 "/compute:v1/ManagedInstance/version": version
 "/compute:v1/ManagedInstanceInstanceHealth": managed_instance_instance_health
 "/compute:v1/ManagedInstanceInstanceHealth/detailedHealthState": detailed_health_state
@@ -44921,6 +45011,9 @@
 "/compute:v1/NetworkEndpointGroup": network_endpoint_group
 "/compute:v1/NetworkEndpointGroup/annotations": annotations
 "/compute:v1/NetworkEndpointGroup/annotations/annotation": annotation
+"/compute:v1/NetworkEndpointGroup/appEngine": app_engine
+"/compute:v1/NetworkEndpointGroup/cloudFunction": cloud_function
+"/compute:v1/NetworkEndpointGroup/cloudRun": cloud_run
 "/compute:v1/NetworkEndpointGroup/creationTimestamp": creation_timestamp
 "/compute:v1/NetworkEndpointGroup/defaultPort": default_port
 "/compute:v1/NetworkEndpointGroup/description": description
@@ -44929,6 +45022,7 @@
 "/compute:v1/NetworkEndpointGroup/name": name
 "/compute:v1/NetworkEndpointGroup/network": network
 "/compute:v1/NetworkEndpointGroup/networkEndpointType": network_endpoint_type
+"/compute:v1/NetworkEndpointGroup/region": region
 "/compute:v1/NetworkEndpointGroup/selfLink": self_link
 "/compute:v1/NetworkEndpointGroup/size": size
 "/compute:v1/NetworkEndpointGroup/subnetwork": subnetwork
@@ -44947,6 +45041,17 @@
 "/compute:v1/NetworkEndpointGroupAggregatedList/warning/data/datum/key": key
 "/compute:v1/NetworkEndpointGroupAggregatedList/warning/data/datum/value": value
 "/compute:v1/NetworkEndpointGroupAggregatedList/warning/message": message
+"/compute:v1/NetworkEndpointGroupAppEngine": network_endpoint_group_app_engine
+"/compute:v1/NetworkEndpointGroupAppEngine/service": service
+"/compute:v1/NetworkEndpointGroupAppEngine/urlMask": url_mask
+"/compute:v1/NetworkEndpointGroupAppEngine/version": version
+"/compute:v1/NetworkEndpointGroupCloudFunction": network_endpoint_group_cloud_function
+"/compute:v1/NetworkEndpointGroupCloudFunction/function": function
+"/compute:v1/NetworkEndpointGroupCloudFunction/urlMask": url_mask
+"/compute:v1/NetworkEndpointGroupCloudRun": network_endpoint_group_cloud_run
+"/compute:v1/NetworkEndpointGroupCloudRun/service": service
+"/compute:v1/NetworkEndpointGroupCloudRun/tag": tag
+"/compute:v1/NetworkEndpointGroupCloudRun/urlMask": url_mask
 "/compute:v1/NetworkEndpointGroupList": network_endpoint_group_list
 "/compute:v1/NetworkEndpointGroupList/id": id
 "/compute:v1/NetworkEndpointGroupList/items": items
@@ -45091,6 +45196,7 @@
 "/compute:v1/NodeGroupList/warning/data/datum/value": value
 "/compute:v1/NodeGroupList/warning/message": message
 "/compute:v1/NodeGroupNode": node_group_node
+"/compute:v1/NodeGroupNode/cpuOvercommitType": cpu_overcommit_type
 "/compute:v1/NodeGroupNode/instances": instances
 "/compute:v1/NodeGroupNode/instances/instance": instance
 "/compute:v1/NodeGroupNode/name": name
@@ -45130,6 +45236,7 @@
 "/compute:v1/NodeGroupsSetNodeTemplateRequest": node_groups_set_node_template_request
 "/compute:v1/NodeGroupsSetNodeTemplateRequest/nodeTemplate": node_template
 "/compute:v1/NodeTemplate": node_template
+"/compute:v1/NodeTemplate/cpuOvercommitType": cpu_overcommit_type
 "/compute:v1/NodeTemplate/creationTimestamp": creation_timestamp
 "/compute:v1/NodeTemplate/description": description
 "/compute:v1/NodeTemplate/id": id
@@ -45448,6 +45555,8 @@
 "/compute:v1/PerInstanceConfig": per_instance_config
 "/compute:v1/PerInstanceConfig/fingerprint": fingerprint
 "/compute:v1/PerInstanceConfig/name": name
+"/compute:v1/PerInstanceConfig/preservedState": preserved_state
+"/compute:v1/PerInstanceConfig/status": status
 "/compute:v1/Policy": policy
 "/compute:v1/Policy/auditConfigs": audit_configs
 "/compute:v1/Policy/auditConfigs/audit_config": audit_config
@@ -45461,6 +45570,15 @@
 "/compute:v1/PreconfiguredWafSet": preconfigured_waf_set
 "/compute:v1/PreconfiguredWafSet/expressionSets": expression_sets
 "/compute:v1/PreconfiguredWafSet/expressionSets/expression_set": expression_set
+"/compute:v1/PreservedState": preserved_state
+"/compute:v1/PreservedState/disks": disks
+"/compute:v1/PreservedState/disks/disk": disk
+"/compute:v1/PreservedState/metadata": metadata
+"/compute:v1/PreservedState/metadata/metadatum": metadatum
+"/compute:v1/PreservedStatePreservedDisk": preserved_state_preserved_disk
+"/compute:v1/PreservedStatePreservedDisk/autoDelete": auto_delete
+"/compute:v1/PreservedStatePreservedDisk/mode": mode
+"/compute:v1/PreservedStatePreservedDisk/source": source
 "/compute:v1/Project": project
 "/compute:v1/Project/commonInstanceMetadata": common_instance_metadata
 "/compute:v1/Project/creationTimestamp": creation_timestamp
@@ -45563,6 +45681,9 @@
 "/compute:v1/RegionInstanceGroupList/warning/data/datum/key": key
 "/compute:v1/RegionInstanceGroupList/warning/data/datum/value": value
 "/compute:v1/RegionInstanceGroupList/warning/message": message
+"/compute:v1/RegionInstanceGroupManagerDeleteInstanceConfigReq": region_instance_group_manager_delete_instance_config_req
+"/compute:v1/RegionInstanceGroupManagerDeleteInstanceConfigReq/names": names
+"/compute:v1/RegionInstanceGroupManagerDeleteInstanceConfigReq/names/name": name
 "/compute:v1/RegionInstanceGroupManagerList": region_instance_group_manager_list
 "/compute:v1/RegionInstanceGroupManagerList/id": id
 "/compute:v1/RegionInstanceGroupManagerList/items": items
@@ -45577,6 +45698,12 @@
 "/compute:v1/RegionInstanceGroupManagerList/warning/data/datum/key": key
 "/compute:v1/RegionInstanceGroupManagerList/warning/data/datum/value": value
 "/compute:v1/RegionInstanceGroupManagerList/warning/message": message
+"/compute:v1/RegionInstanceGroupManagerPatchInstanceConfigReq": region_instance_group_manager_patch_instance_config_req
+"/compute:v1/RegionInstanceGroupManagerPatchInstanceConfigReq/perInstanceConfigs": per_instance_configs
+"/compute:v1/RegionInstanceGroupManagerPatchInstanceConfigReq/perInstanceConfigs/per_instance_config": per_instance_config
+"/compute:v1/RegionInstanceGroupManagerUpdateInstanceConfigReq": region_instance_group_manager_update_instance_config_req
+"/compute:v1/RegionInstanceGroupManagerUpdateInstanceConfigReq/perInstanceConfigs": per_instance_configs
+"/compute:v1/RegionInstanceGroupManagerUpdateInstanceConfigReq/perInstanceConfigs/per_instance_config": per_instance_config
 "/compute:v1/RegionInstanceGroupManagersAbandonInstancesRequest": region_instance_group_managers_abandon_instances_request
 "/compute:v1/RegionInstanceGroupManagersAbandonInstancesRequest/instances": instances
 "/compute:v1/RegionInstanceGroupManagersAbandonInstancesRequest/instances/instance": instance
@@ -45595,6 +45722,17 @@
 "/compute:v1/RegionInstanceGroupManagersListErrorsResponse/items": items
 "/compute:v1/RegionInstanceGroupManagersListErrorsResponse/items/item": item
 "/compute:v1/RegionInstanceGroupManagersListErrorsResponse/nextPageToken": next_page_token
+"/compute:v1/RegionInstanceGroupManagersListInstanceConfigsResp": region_instance_group_managers_list_instance_configs_resp
+"/compute:v1/RegionInstanceGroupManagersListInstanceConfigsResp/items": items
+"/compute:v1/RegionInstanceGroupManagersListInstanceConfigsResp/items/item": item
+"/compute:v1/RegionInstanceGroupManagersListInstanceConfigsResp/nextPageToken": next_page_token
+"/compute:v1/RegionInstanceGroupManagersListInstanceConfigsResp/warning": warning
+"/compute:v1/RegionInstanceGroupManagersListInstanceConfigsResp/warning/code": code
+"/compute:v1/RegionInstanceGroupManagersListInstanceConfigsResp/warning/data": data
+"/compute:v1/RegionInstanceGroupManagersListInstanceConfigsResp/warning/data/datum": datum
+"/compute:v1/RegionInstanceGroupManagersListInstanceConfigsResp/warning/data/datum/key": key
+"/compute:v1/RegionInstanceGroupManagersListInstanceConfigsResp/warning/data/datum/value": value
+"/compute:v1/RegionInstanceGroupManagersListInstanceConfigsResp/warning/message": message
 "/compute:v1/RegionInstanceGroupManagersListInstancesResponse": region_instance_group_managers_list_instances_response
 "/compute:v1/RegionInstanceGroupManagersListInstancesResponse/managedInstances": managed_instances
 "/compute:v1/RegionInstanceGroupManagersListInstancesResponse/managedInstances/managed_instance": managed_instance
@@ -46021,6 +46159,7 @@
 "/compute:v1/SSLHealthCheck/response": response
 "/compute:v1/Scheduling": scheduling
 "/compute:v1/Scheduling/automaticRestart": automatic_restart
+"/compute:v1/Scheduling/minNodeCpus": min_node_cpus
 "/compute:v1/Scheduling/nodeAffinities": node_affinities
 "/compute:v1/Scheduling/nodeAffinities/node_affinity": node_affinity
 "/compute:v1/Scheduling/onHostMaintenance": on_host_maintenance
@@ -46248,6 +46387,13 @@
 "/compute:v1/SslPolicy/warnings/warning/message": message
 "/compute:v1/SslPolicyReference": ssl_policy_reference
 "/compute:v1/SslPolicyReference/sslPolicy": ssl_policy
+"/compute:v1/StatefulPolicy": stateful_policy
+"/compute:v1/StatefulPolicy/preservedState": preserved_state
+"/compute:v1/StatefulPolicyPreservedState": stateful_policy_preserved_state
+"/compute:v1/StatefulPolicyPreservedState/disks": disks
+"/compute:v1/StatefulPolicyPreservedState/disks/disk": disk
+"/compute:v1/StatefulPolicyPreservedStateDiskDevice": stateful_policy_preserved_state_disk_device
+"/compute:v1/StatefulPolicyPreservedStateDiskDevice/autoDelete": auto_delete
 "/compute:v1/Subnetwork": subnetwork
 "/compute:v1/Subnetwork/creationTimestamp": creation_timestamp
 "/compute:v1/Subnetwork/description": description
@@ -47598,6 +47744,10 @@
 "/compute:v1/compute.instanceGroupManagers.deleteInstances/project": project
 "/compute:v1/compute.instanceGroupManagers.deleteInstances/requestId": request_id
 "/compute:v1/compute.instanceGroupManagers.deleteInstances/zone": zone
+"/compute:v1/compute.instanceGroupManagers.deletePerInstanceConfigs": delete_instance_group_manager_per_instance_configs
+"/compute:v1/compute.instanceGroupManagers.deletePerInstanceConfigs/instanceGroupManager": instance_group_manager
+"/compute:v1/compute.instanceGroupManagers.deletePerInstanceConfigs/project": project
+"/compute:v1/compute.instanceGroupManagers.deletePerInstanceConfigs/zone": zone
 "/compute:v1/compute.instanceGroupManagers.get": get_instance_group_manager
 "/compute:v1/compute.instanceGroupManagers.get/instanceGroupManager": instance_group_manager
 "/compute:v1/compute.instanceGroupManagers.get/project": project
@@ -47630,11 +47780,24 @@
 "/compute:v1/compute.instanceGroupManagers.listManagedInstances/pageToken": page_token
 "/compute:v1/compute.instanceGroupManagers.listManagedInstances/project": project
 "/compute:v1/compute.instanceGroupManagers.listManagedInstances/zone": zone
+"/compute:v1/compute.instanceGroupManagers.listPerInstanceConfigs": list_instance_group_manager_per_instance_configs
+"/compute:v1/compute.instanceGroupManagers.listPerInstanceConfigs/filter": filter
+"/compute:v1/compute.instanceGroupManagers.listPerInstanceConfigs/instanceGroupManager": instance_group_manager
+"/compute:v1/compute.instanceGroupManagers.listPerInstanceConfigs/maxResults": max_results
+"/compute:v1/compute.instanceGroupManagers.listPerInstanceConfigs/orderBy": order_by
+"/compute:v1/compute.instanceGroupManagers.listPerInstanceConfigs/pageToken": page_token
+"/compute:v1/compute.instanceGroupManagers.listPerInstanceConfigs/project": project
+"/compute:v1/compute.instanceGroupManagers.listPerInstanceConfigs/zone": zone
 "/compute:v1/compute.instanceGroupManagers.patch": patch_instance_group_manager
 "/compute:v1/compute.instanceGroupManagers.patch/instanceGroupManager": instance_group_manager
 "/compute:v1/compute.instanceGroupManagers.patch/project": project
 "/compute:v1/compute.instanceGroupManagers.patch/requestId": request_id
 "/compute:v1/compute.instanceGroupManagers.patch/zone": zone
+"/compute:v1/compute.instanceGroupManagers.patchPerInstanceConfigs": patch_instance_group_manager_per_instance_configs
+"/compute:v1/compute.instanceGroupManagers.patchPerInstanceConfigs/instanceGroupManager": instance_group_manager
+"/compute:v1/compute.instanceGroupManagers.patchPerInstanceConfigs/project": project
+"/compute:v1/compute.instanceGroupManagers.patchPerInstanceConfigs/requestId": request_id
+"/compute:v1/compute.instanceGroupManagers.patchPerInstanceConfigs/zone": zone
 "/compute:v1/compute.instanceGroupManagers.recreateInstances": recreate_instance_group_manager_instances
 "/compute:v1/compute.instanceGroupManagers.recreateInstances/instanceGroupManager": instance_group_manager
 "/compute:v1/compute.instanceGroupManagers.recreateInstances/project": project
@@ -47656,6 +47819,11 @@
 "/compute:v1/compute.instanceGroupManagers.setTargetPools/project": project
 "/compute:v1/compute.instanceGroupManagers.setTargetPools/requestId": request_id
 "/compute:v1/compute.instanceGroupManagers.setTargetPools/zone": zone
+"/compute:v1/compute.instanceGroupManagers.updatePerInstanceConfigs": update_instance_group_manager_per_instance_configs
+"/compute:v1/compute.instanceGroupManagers.updatePerInstanceConfigs/instanceGroupManager": instance_group_manager
+"/compute:v1/compute.instanceGroupManagers.updatePerInstanceConfigs/project": project
+"/compute:v1/compute.instanceGroupManagers.updatePerInstanceConfigs/requestId": request_id
+"/compute:v1/compute.instanceGroupManagers.updatePerInstanceConfigs/zone": zone
 "/compute:v1/compute.instanceGroups.addInstances": add_instance_group_instances
 "/compute:v1/compute.instanceGroups.addInstances/instanceGroup": instance_group
 "/compute:v1/compute.instanceGroups.addInstances/project": project
@@ -48596,6 +48764,10 @@
 "/compute:v1/compute.regionInstanceGroupManagers.deleteInstances/project": project
 "/compute:v1/compute.regionInstanceGroupManagers.deleteInstances/region": region
 "/compute:v1/compute.regionInstanceGroupManagers.deleteInstances/requestId": request_id
+"/compute:v1/compute.regionInstanceGroupManagers.deletePerInstanceConfigs": delete_region_instance_group_manager_per_instance_configs
+"/compute:v1/compute.regionInstanceGroupManagers.deletePerInstanceConfigs/instanceGroupManager": instance_group_manager
+"/compute:v1/compute.regionInstanceGroupManagers.deletePerInstanceConfigs/project": project
+"/compute:v1/compute.regionInstanceGroupManagers.deletePerInstanceConfigs/region": region
 "/compute:v1/compute.regionInstanceGroupManagers.get": get_region_instance_group_manager
 "/compute:v1/compute.regionInstanceGroupManagers.get/instanceGroupManager": instance_group_manager
 "/compute:v1/compute.regionInstanceGroupManagers.get/project": project
@@ -48628,11 +48800,24 @@
 "/compute:v1/compute.regionInstanceGroupManagers.listManagedInstances/pageToken": page_token
 "/compute:v1/compute.regionInstanceGroupManagers.listManagedInstances/project": project
 "/compute:v1/compute.regionInstanceGroupManagers.listManagedInstances/region": region
+"/compute:v1/compute.regionInstanceGroupManagers.listPerInstanceConfigs": list_region_instance_group_manager_per_instance_configs
+"/compute:v1/compute.regionInstanceGroupManagers.listPerInstanceConfigs/filter": filter
+"/compute:v1/compute.regionInstanceGroupManagers.listPerInstanceConfigs/instanceGroupManager": instance_group_manager
+"/compute:v1/compute.regionInstanceGroupManagers.listPerInstanceConfigs/maxResults": max_results
+"/compute:v1/compute.regionInstanceGroupManagers.listPerInstanceConfigs/orderBy": order_by
+"/compute:v1/compute.regionInstanceGroupManagers.listPerInstanceConfigs/pageToken": page_token
+"/compute:v1/compute.regionInstanceGroupManagers.listPerInstanceConfigs/project": project
+"/compute:v1/compute.regionInstanceGroupManagers.listPerInstanceConfigs/region": region
 "/compute:v1/compute.regionInstanceGroupManagers.patch": patch_region_instance_group_manager
 "/compute:v1/compute.regionInstanceGroupManagers.patch/instanceGroupManager": instance_group_manager
 "/compute:v1/compute.regionInstanceGroupManagers.patch/project": project
 "/compute:v1/compute.regionInstanceGroupManagers.patch/region": region
 "/compute:v1/compute.regionInstanceGroupManagers.patch/requestId": request_id
+"/compute:v1/compute.regionInstanceGroupManagers.patchPerInstanceConfigs": patch_region_instance_group_manager_per_instance_configs
+"/compute:v1/compute.regionInstanceGroupManagers.patchPerInstanceConfigs/instanceGroupManager": instance_group_manager
+"/compute:v1/compute.regionInstanceGroupManagers.patchPerInstanceConfigs/project": project
+"/compute:v1/compute.regionInstanceGroupManagers.patchPerInstanceConfigs/region": region
+"/compute:v1/compute.regionInstanceGroupManagers.patchPerInstanceConfigs/requestId": request_id
 "/compute:v1/compute.regionInstanceGroupManagers.recreateInstances": recreate_region_instance_group_manager_instances
 "/compute:v1/compute.regionInstanceGroupManagers.recreateInstances/instanceGroupManager": instance_group_manager
 "/compute:v1/compute.regionInstanceGroupManagers.recreateInstances/project": project
@@ -48654,6 +48839,11 @@
 "/compute:v1/compute.regionInstanceGroupManagers.setTargetPools/project": project
 "/compute:v1/compute.regionInstanceGroupManagers.setTargetPools/region": region
 "/compute:v1/compute.regionInstanceGroupManagers.setTargetPools/requestId": request_id
+"/compute:v1/compute.regionInstanceGroupManagers.updatePerInstanceConfigs": update_region_instance_group_manager_per_instance_configs
+"/compute:v1/compute.regionInstanceGroupManagers.updatePerInstanceConfigs/instanceGroupManager": instance_group_manager
+"/compute:v1/compute.regionInstanceGroupManagers.updatePerInstanceConfigs/project": project
+"/compute:v1/compute.regionInstanceGroupManagers.updatePerInstanceConfigs/region": region
+"/compute:v1/compute.regionInstanceGroupManagers.updatePerInstanceConfigs/requestId": request_id
 "/compute:v1/compute.regionInstanceGroups.get": get_region_instance_group
 "/compute:v1/compute.regionInstanceGroups.get/instanceGroup": instance_group
 "/compute:v1/compute.regionInstanceGroups.get/project": project
@@ -48678,6 +48868,26 @@
 "/compute:v1/compute.regionInstanceGroups.setNamedPorts/project": project
 "/compute:v1/compute.regionInstanceGroups.setNamedPorts/region": region
 "/compute:v1/compute.regionInstanceGroups.setNamedPorts/requestId": request_id
+"/compute:v1/compute.regionNetworkEndpointGroups.delete": delete_region_network_endpoint_group
+"/compute:v1/compute.regionNetworkEndpointGroups.delete/networkEndpointGroup": network_endpoint_group
+"/compute:v1/compute.regionNetworkEndpointGroups.delete/project": project
+"/compute:v1/compute.regionNetworkEndpointGroups.delete/region": region
+"/compute:v1/compute.regionNetworkEndpointGroups.delete/requestId": request_id
+"/compute:v1/compute.regionNetworkEndpointGroups.get": get_region_network_endpoint_group
+"/compute:v1/compute.regionNetworkEndpointGroups.get/networkEndpointGroup": network_endpoint_group
+"/compute:v1/compute.regionNetworkEndpointGroups.get/project": project
+"/compute:v1/compute.regionNetworkEndpointGroups.get/region": region
+"/compute:v1/compute.regionNetworkEndpointGroups.insert": insert_region_network_endpoint_group
+"/compute:v1/compute.regionNetworkEndpointGroups.insert/project": project
+"/compute:v1/compute.regionNetworkEndpointGroups.insert/region": region
+"/compute:v1/compute.regionNetworkEndpointGroups.insert/requestId": request_id
+"/compute:v1/compute.regionNetworkEndpointGroups.list": list_region_network_endpoint_groups
+"/compute:v1/compute.regionNetworkEndpointGroups.list/filter": filter
+"/compute:v1/compute.regionNetworkEndpointGroups.list/maxResults": max_results
+"/compute:v1/compute.regionNetworkEndpointGroups.list/orderBy": order_by
+"/compute:v1/compute.regionNetworkEndpointGroups.list/pageToken": page_token
+"/compute:v1/compute.regionNetworkEndpointGroups.list/project": project
+"/compute:v1/compute.regionNetworkEndpointGroups.list/region": region
 "/compute:v1/compute.regionNotificationEndpoints.delete": delete_region_notification_endpoint
 "/compute:v1/compute.regionNotificationEndpoints.delete/notificationEndpoint": notification_endpoint
 "/compute:v1/compute.regionNotificationEndpoints.delete/project": project
@@ -52246,9 +52456,12 @@
 "/content:v2.1/Account/adsLinks/ads_link": ads_link
 "/content:v2.1/Account/adultContent": adult_content
 "/content:v2.1/Account/businessInformation": business_information
+"/content:v2.1/Account/cssId": css_id
 "/content:v2.1/Account/googleMyBusinessLink": google_my_business_link
 "/content:v2.1/Account/id": id
 "/content:v2.1/Account/kind": kind
+"/content:v2.1/Account/labelIds": label_ids
+"/content:v2.1/Account/labelIds/label_id": label_id
 "/content:v2.1/Account/name": name
 "/content:v2.1/Account/sellerId": seller_id
 "/content:v2.1/Account/users": users
@@ -52357,6 +52570,7 @@
 "/content:v2.1/AccountsCustomBatchRequestEntry/merchantId": merchant_id
 "/content:v2.1/AccountsCustomBatchRequestEntry/method": method_prop
 "/content:v2.1/AccountsCustomBatchRequestEntry/overwrite": overwrite
+"/content:v2.1/AccountsCustomBatchRequestEntry/view": view
 "/content:v2.1/AccountsCustomBatchRequestEntryLinkRequest": accounts_custom_batch_request_entry_link_request
 "/content:v2.1/AccountsCustomBatchRequestEntryLinkRequest/action": action
 "/content:v2.1/AccountsCustomBatchRequestEntryLinkRequest/linkType": link_type
@@ -52390,6 +52604,11 @@
 "/content:v2.1/AccountsListResponse/nextPageToken": next_page_token
 "/content:v2.1/AccountsListResponse/resources": resources
 "/content:v2.1/AccountsListResponse/resources/resource": resource
+"/content:v2.1/AccountsUpdateLabelsRequest": accounts_update_labels_request
+"/content:v2.1/AccountsUpdateLabelsRequest/labelIds": label_ids
+"/content:v2.1/AccountsUpdateLabelsRequest/labelIds/label_id": label_id
+"/content:v2.1/AccountsUpdateLabelsResponse": accounts_update_labels_response
+"/content:v2.1/AccountsUpdateLabelsResponse/kind": kind
 "/content:v2.1/AccountstatusesCustomBatchRequest": accountstatuses_custom_batch_request
 "/content:v2.1/AccountstatusesCustomBatchRequest/entries": entries
 "/content:v2.1/AccountstatusesCustomBatchRequest/entries/entry": entry
@@ -53514,9 +53733,17 @@
 "/content:v2.1/ProductStatus/productId": product_id
 "/content:v2.1/ProductStatus/title": title
 "/content:v2.1/ProductStatusDestinationStatus": product_status_destination_status
+"/content:v2.1/ProductStatusDestinationStatus/approvedCountrys": approved_countrys
+"/content:v2.1/ProductStatusDestinationStatus/approvedCountrys/approved_country": approved_country
 "/content:v2.1/ProductStatusDestinationStatus/destination": destination
+"/content:v2.1/ProductStatusDestinationStatus/disapprovedCountrys": disapproved_countrys
+"/content:v2.1/ProductStatusDestinationStatus/disapprovedCountrys/disapproved_country": disapproved_country
+"/content:v2.1/ProductStatusDestinationStatus/pendingCountrys": pending_countrys
+"/content:v2.1/ProductStatusDestinationStatus/pendingCountrys/pending_country": pending_country
 "/content:v2.1/ProductStatusDestinationStatus/status": status
 "/content:v2.1/ProductStatusItemLevelIssue": product_status_item_level_issue
+"/content:v2.1/ProductStatusItemLevelIssue/applicableCountrys": applicable_countrys
+"/content:v2.1/ProductStatusItemLevelIssue/applicableCountrys/applicable_country": applicable_country
 "/content:v2.1/ProductStatusItemLevelIssue/attributeName": attribute_name
 "/content:v2.1/ProductStatusItemLevelIssue/code": code
 "/content:v2.1/ProductStatusItemLevelIssue/description": description
@@ -53979,15 +54206,18 @@
 "/content:v2.1/content.accounts.get": get_account
 "/content:v2.1/content.accounts.get/accountId": account_id
 "/content:v2.1/content.accounts.get/merchantId": merchant_id
+"/content:v2.1/content.accounts.get/view": view
 "/content:v2.1/content.accounts.insert": insert_account
 "/content:v2.1/content.accounts.insert/merchantId": merchant_id
 "/content:v2.1/content.accounts.link": link_account
 "/content:v2.1/content.accounts.link/accountId": account_id
 "/content:v2.1/content.accounts.link/merchantId": merchant_id
 "/content:v2.1/content.accounts.list": list_accounts
+"/content:v2.1/content.accounts.list/label": label
 "/content:v2.1/content.accounts.list/maxResults": max_results
 "/content:v2.1/content.accounts.list/merchantId": merchant_id
 "/content:v2.1/content.accounts.list/pageToken": page_token
+"/content:v2.1/content.accounts.list/view": view
 "/content:v2.1/content.accounts.listlinks": listlinks_account
 "/content:v2.1/content.accounts.listlinks/accountId": account_id
 "/content:v2.1/content.accounts.listlinks/maxResults": max_results
@@ -53996,6 +54226,9 @@
 "/content:v2.1/content.accounts.update": update_account
 "/content:v2.1/content.accounts.update/accountId": account_id
 "/content:v2.1/content.accounts.update/merchantId": merchant_id
+"/content:v2.1/content.accounts.updatelabels": updatelabels_account
+"/content:v2.1/content.accounts.updatelabels/accountId": account_id
+"/content:v2.1/content.accounts.updatelabels/merchantId": merchant_id
 "/content:v2.1/content.accountstatuses.custombatch": custombatch_accountstatus
 "/content:v2.1/content.accountstatuses.get": get_accountstatus
 "/content:v2.1/content.accountstatuses.get/accountId": account_id
@@ -90080,6 +90313,42 @@
 "/docs:v1/fields": fields
 "/docs:v1/key": key
 "/docs:v1/quotaUser": quota_user
+"/documentai:v1beta2/GoogleCloudDocumentaiUiv1beta3CreateLabelerPoolOperationMetadata": google_cloud_documentai_uiv1beta3_create_labeler_pool_operation_metadata
+"/documentai:v1beta2/GoogleCloudDocumentaiUiv1beta3CreateLabelerPoolOperationMetadata/createTime": create_time
+"/documentai:v1beta2/GoogleCloudDocumentaiUiv1beta3CreateLabelerPoolOperationMetadata/state": state
+"/documentai:v1beta2/GoogleCloudDocumentaiUiv1beta3CreateLabelerPoolOperationMetadata/stateMessage": state_message
+"/documentai:v1beta2/GoogleCloudDocumentaiUiv1beta3CreateLabelerPoolOperationMetadata/updateTime": update_time
+"/documentai:v1beta2/GoogleCloudDocumentaiUiv1beta3CreateProcessorVersionMetadata": google_cloud_documentai_uiv1beta3_create_processor_version_metadata
+"/documentai:v1beta2/GoogleCloudDocumentaiUiv1beta3CreateProcessorVersionMetadata/createTime": create_time
+"/documentai:v1beta2/GoogleCloudDocumentaiUiv1beta3CreateProcessorVersionMetadata/state": state
+"/documentai:v1beta2/GoogleCloudDocumentaiUiv1beta3CreateProcessorVersionMetadata/updateTime": update_time
+"/documentai:v1beta2/GoogleCloudDocumentaiUiv1beta3DeleteLabelerPoolOperationMetadata": google_cloud_documentai_uiv1beta3_delete_labeler_pool_operation_metadata
+"/documentai:v1beta2/GoogleCloudDocumentaiUiv1beta3DeleteLabelerPoolOperationMetadata/createTime": create_time
+"/documentai:v1beta2/GoogleCloudDocumentaiUiv1beta3DeleteLabelerPoolOperationMetadata/state": state
+"/documentai:v1beta2/GoogleCloudDocumentaiUiv1beta3DeleteLabelerPoolOperationMetadata/stateMessage": state_message
+"/documentai:v1beta2/GoogleCloudDocumentaiUiv1beta3DeleteLabelerPoolOperationMetadata/updateTime": update_time
+"/documentai:v1beta2/GoogleCloudDocumentaiUiv1beta3DeleteProcessorMetadata": google_cloud_documentai_uiv1beta3_delete_processor_metadata
+"/documentai:v1beta2/GoogleCloudDocumentaiUiv1beta3DeleteProcessorMetadata/createTime": create_time
+"/documentai:v1beta2/GoogleCloudDocumentaiUiv1beta3DeleteProcessorMetadata/state": state
+"/documentai:v1beta2/GoogleCloudDocumentaiUiv1beta3DeleteProcessorMetadata/stateMessage": state_message
+"/documentai:v1beta2/GoogleCloudDocumentaiUiv1beta3DeleteProcessorMetadata/updateTime": update_time
+"/documentai:v1beta2/GoogleCloudDocumentaiUiv1beta3DisableProcessorMetadata": google_cloud_documentai_uiv1beta3_disable_processor_metadata
+"/documentai:v1beta2/GoogleCloudDocumentaiUiv1beta3DisableProcessorMetadata/createTime": create_time
+"/documentai:v1beta2/GoogleCloudDocumentaiUiv1beta3DisableProcessorMetadata/state": state
+"/documentai:v1beta2/GoogleCloudDocumentaiUiv1beta3DisableProcessorMetadata/stateMessage": state_message
+"/documentai:v1beta2/GoogleCloudDocumentaiUiv1beta3DisableProcessorMetadata/updateTime": update_time
+"/documentai:v1beta2/GoogleCloudDocumentaiUiv1beta3DisableProcessorResponse": google_cloud_documentai_uiv1beta3_disable_processor_response
+"/documentai:v1beta2/GoogleCloudDocumentaiUiv1beta3EnableProcessorMetadata": google_cloud_documentai_uiv1beta3_enable_processor_metadata
+"/documentai:v1beta2/GoogleCloudDocumentaiUiv1beta3EnableProcessorMetadata/createTime": create_time
+"/documentai:v1beta2/GoogleCloudDocumentaiUiv1beta3EnableProcessorMetadata/state": state
+"/documentai:v1beta2/GoogleCloudDocumentaiUiv1beta3EnableProcessorMetadata/stateMessage": state_message
+"/documentai:v1beta2/GoogleCloudDocumentaiUiv1beta3EnableProcessorMetadata/updateTime": update_time
+"/documentai:v1beta2/GoogleCloudDocumentaiUiv1beta3EnableProcessorResponse": google_cloud_documentai_uiv1beta3_enable_processor_response
+"/documentai:v1beta2/GoogleCloudDocumentaiUiv1beta3UpdateLabelerPoolOperationMetadata": google_cloud_documentai_uiv1beta3_update_labeler_pool_operation_metadata
+"/documentai:v1beta2/GoogleCloudDocumentaiUiv1beta3UpdateLabelerPoolOperationMetadata/createTime": create_time
+"/documentai:v1beta2/GoogleCloudDocumentaiUiv1beta3UpdateLabelerPoolOperationMetadata/state": state
+"/documentai:v1beta2/GoogleCloudDocumentaiUiv1beta3UpdateLabelerPoolOperationMetadata/stateMessage": state_message
+"/documentai:v1beta2/GoogleCloudDocumentaiUiv1beta3UpdateLabelerPoolOperationMetadata/updateTime": update_time
 "/documentai:v1beta2/GoogleCloudDocumentaiV1beta1BatchProcessDocumentsResponse": google_cloud_documentai_v1beta1_batch_process_documents_response
 "/documentai:v1beta2/GoogleCloudDocumentaiV1beta1BatchProcessDocumentsResponse/responses": responses
 "/documentai:v1beta2/GoogleCloudDocumentaiV1beta1BatchProcessDocumentsResponse/responses/response": response
@@ -90109,8 +90378,15 @@
 "/documentai:v1beta2/GoogleCloudDocumentaiV1beta1DocumentEntity/confidence": confidence
 "/documentai:v1beta2/GoogleCloudDocumentaiV1beta1DocumentEntity/mentionId": mention_id
 "/documentai:v1beta2/GoogleCloudDocumentaiV1beta1DocumentEntity/mentionText": mention_text
+"/documentai:v1beta2/GoogleCloudDocumentaiV1beta1DocumentEntity/normalizedValue": normalized_value
+"/documentai:v1beta2/GoogleCloudDocumentaiV1beta1DocumentEntity/redacted": redacted
 "/documentai:v1beta2/GoogleCloudDocumentaiV1beta1DocumentEntity/textAnchor": text_anchor
 "/documentai:v1beta2/GoogleCloudDocumentaiV1beta1DocumentEntity/type": type
+"/documentai:v1beta2/GoogleCloudDocumentaiV1beta1DocumentEntityNormalizedValue": google_cloud_documentai_v1beta1_document_entity_normalized_value
+"/documentai:v1beta2/GoogleCloudDocumentaiV1beta1DocumentEntityNormalizedValue/dateValue": date_value
+"/documentai:v1beta2/GoogleCloudDocumentaiV1beta1DocumentEntityNormalizedValue/datetimeValue": datetime_value
+"/documentai:v1beta2/GoogleCloudDocumentaiV1beta1DocumentEntityNormalizedValue/moneyValue": money_value
+"/documentai:v1beta2/GoogleCloudDocumentaiV1beta1DocumentEntityNormalizedValue/text": text
 "/documentai:v1beta2/GoogleCloudDocumentaiV1beta1DocumentEntityRelation": google_cloud_documentai_v1beta1_document_entity_relation
 "/documentai:v1beta2/GoogleCloudDocumentaiV1beta1DocumentEntityRelation/objectId": object_id_prop
 "/documentai:v1beta2/GoogleCloudDocumentaiV1beta1DocumentEntityRelation/relation": relation
@@ -90280,8 +90556,15 @@
 "/documentai:v1beta2/GoogleCloudDocumentaiV1beta2DocumentEntity/confidence": confidence
 "/documentai:v1beta2/GoogleCloudDocumentaiV1beta2DocumentEntity/mentionId": mention_id
 "/documentai:v1beta2/GoogleCloudDocumentaiV1beta2DocumentEntity/mentionText": mention_text
+"/documentai:v1beta2/GoogleCloudDocumentaiV1beta2DocumentEntity/normalizedValue": normalized_value
+"/documentai:v1beta2/GoogleCloudDocumentaiV1beta2DocumentEntity/redacted": redacted
 "/documentai:v1beta2/GoogleCloudDocumentaiV1beta2DocumentEntity/textAnchor": text_anchor
 "/documentai:v1beta2/GoogleCloudDocumentaiV1beta2DocumentEntity/type": type
+"/documentai:v1beta2/GoogleCloudDocumentaiV1beta2DocumentEntityNormalizedValue": google_cloud_documentai_v1beta2_document_entity_normalized_value
+"/documentai:v1beta2/GoogleCloudDocumentaiV1beta2DocumentEntityNormalizedValue/dateValue": date_value
+"/documentai:v1beta2/GoogleCloudDocumentaiV1beta2DocumentEntityNormalizedValue/datetimeValue": datetime_value
+"/documentai:v1beta2/GoogleCloudDocumentaiV1beta2DocumentEntityNormalizedValue/moneyValue": money_value
+"/documentai:v1beta2/GoogleCloudDocumentaiV1beta2DocumentEntityNormalizedValue/text": text
 "/documentai:v1beta2/GoogleCloudDocumentaiV1beta2DocumentEntityRelation": google_cloud_documentai_v1beta2_document_entity_relation
 "/documentai:v1beta2/GoogleCloudDocumentaiV1beta2DocumentEntityRelation/objectId": object_id_prop
 "/documentai:v1beta2/GoogleCloudDocumentaiV1beta2DocumentEntityRelation/relation": relation
@@ -90456,6 +90739,18 @@
 "/documentai:v1beta2/GoogleCloudDocumentaiV1beta2Vertex": google_cloud_documentai_v1beta2_vertex
 "/documentai:v1beta2/GoogleCloudDocumentaiV1beta2Vertex/x": x
 "/documentai:v1beta2/GoogleCloudDocumentaiV1beta2Vertex/y": y
+"/documentai:v1beta2/GoogleCloudDocumentaiV1beta3BatchProcessMetadata": google_cloud_documentai_v1beta3_batch_process_metadata
+"/documentai:v1beta2/GoogleCloudDocumentaiV1beta3BatchProcessMetadata/createTime": create_time
+"/documentai:v1beta2/GoogleCloudDocumentaiV1beta3BatchProcessMetadata/individualProcessStatuses": individual_process_statuses
+"/documentai:v1beta2/GoogleCloudDocumentaiV1beta3BatchProcessMetadata/individualProcessStatuses/individual_process_status": individual_process_status
+"/documentai:v1beta2/GoogleCloudDocumentaiV1beta3BatchProcessMetadata/state": state
+"/documentai:v1beta2/GoogleCloudDocumentaiV1beta3BatchProcessMetadata/stateMessage": state_message
+"/documentai:v1beta2/GoogleCloudDocumentaiV1beta3BatchProcessMetadata/updateTime": update_time
+"/documentai:v1beta2/GoogleCloudDocumentaiV1beta3BatchProcessMetadataIndividualProcessStatus": google_cloud_documentai_v1beta3_batch_process_metadata_individual_process_status
+"/documentai:v1beta2/GoogleCloudDocumentaiV1beta3BatchProcessMetadataIndividualProcessStatus/inputGcsSource": input_gcs_source
+"/documentai:v1beta2/GoogleCloudDocumentaiV1beta3BatchProcessMetadataIndividualProcessStatus/outputGcsDestination": output_gcs_destination
+"/documentai:v1beta2/GoogleCloudDocumentaiV1beta3BatchProcessMetadataIndividualProcessStatus/status": status
+"/documentai:v1beta2/GoogleCloudDocumentaiV1beta3BatchProcessResponse": google_cloud_documentai_v1beta3_batch_process_response
 "/documentai:v1beta2/GoogleLongrunningOperation": google_longrunning_operation
 "/documentai:v1beta2/GoogleLongrunningOperation/done": done
 "/documentai:v1beta2/GoogleLongrunningOperation/error": error
@@ -90464,6 +90759,7 @@
 "/documentai:v1beta2/GoogleLongrunningOperation/name": name
 "/documentai:v1beta2/GoogleLongrunningOperation/response": response
 "/documentai:v1beta2/GoogleLongrunningOperation/response/response": response
+"/documentai:v1beta2/GoogleProtobufEmpty": google_protobuf_empty
 "/documentai:v1beta2/GoogleRpcStatus": google_rpc_status
 "/documentai:v1beta2/GoogleRpcStatus/code": code
 "/documentai:v1beta2/GoogleRpcStatus/details": details
@@ -90475,6 +90771,27 @@
 "/documentai:v1beta2/GoogleTypeColor/blue": blue
 "/documentai:v1beta2/GoogleTypeColor/green": green
 "/documentai:v1beta2/GoogleTypeColor/red": red
+"/documentai:v1beta2/GoogleTypeDate": google_type_date
+"/documentai:v1beta2/GoogleTypeDate/day": day
+"/documentai:v1beta2/GoogleTypeDate/month": month
+"/documentai:v1beta2/GoogleTypeDate/year": year
+"/documentai:v1beta2/GoogleTypeDateTime": google_type_date_time
+"/documentai:v1beta2/GoogleTypeDateTime/day": day
+"/documentai:v1beta2/GoogleTypeDateTime/hours": hours
+"/documentai:v1beta2/GoogleTypeDateTime/minutes": minutes
+"/documentai:v1beta2/GoogleTypeDateTime/month": month
+"/documentai:v1beta2/GoogleTypeDateTime/nanos": nanos
+"/documentai:v1beta2/GoogleTypeDateTime/seconds": seconds
+"/documentai:v1beta2/GoogleTypeDateTime/timeZone": time_zone
+"/documentai:v1beta2/GoogleTypeDateTime/utcOffset": utc_offset
+"/documentai:v1beta2/GoogleTypeDateTime/year": year
+"/documentai:v1beta2/GoogleTypeMoney": google_type_money
+"/documentai:v1beta2/GoogleTypeMoney/currencyCode": currency_code
+"/documentai:v1beta2/GoogleTypeMoney/nanos": nanos
+"/documentai:v1beta2/GoogleTypeMoney/units": units
+"/documentai:v1beta2/GoogleTypeTimeZone": google_type_time_zone
+"/documentai:v1beta2/GoogleTypeTimeZone/id": id
+"/documentai:v1beta2/GoogleTypeTimeZone/version": version
 "/documentai:v1beta2/documentai.projects.documents.batchProcess": batch_project_document_process
 "/documentai:v1beta2/documentai.projects.documents.batchProcess/parent": parent
 "/documentai:v1beta2/documentai.projects.documents.process": process_project_document
@@ -93784,6 +94101,8 @@
 "/firebasehosting:v1beta1/Header/headers": headers
 "/firebasehosting:v1beta1/Header/headers/header": header
 "/firebasehosting:v1beta1/Header/regex": regex
+"/firebasehosting:v1beta1/I18nConfig": i18n_config
+"/firebasehosting:v1beta1/I18nConfig/root": root
 "/firebasehosting:v1beta1/ListDomainsResponse": list_domains_response
 "/firebasehosting:v1beta1/ListDomainsResponse/domains": domains
 "/firebasehosting:v1beta1/ListDomainsResponse/domains/domain": domain
@@ -93842,6 +94161,7 @@
 "/firebasehosting:v1beta1/ServingConfig/cleanUrls": clean_urls
 "/firebasehosting:v1beta1/ServingConfig/headers": headers
 "/firebasehosting:v1beta1/ServingConfig/headers/header": header
+"/firebasehosting:v1beta1/ServingConfig/i18n": i18n
 "/firebasehosting:v1beta1/ServingConfig/redirects": redirects
 "/firebasehosting:v1beta1/ServingConfig/redirects/redirect": redirect
 "/firebasehosting:v1beta1/ServingConfig/rewrites": rewrites
@@ -96217,6 +96537,7 @@
 "/games:v1/PlayerExperienceInfo/lastLevelUpTimestampMillis": last_level_up_timestamp_millis
 "/games:v1/PlayerExperienceInfo/nextLevel": next_level
 "/games:v1/PlayerLeaderboardScore": player_leaderboard_score
+"/games:v1/PlayerLeaderboardScore/friendsRank": friends_rank
 "/games:v1/PlayerLeaderboardScore/kind": kind
 "/games:v1/PlayerLeaderboardScore/leaderboard_id": leaderboard_id
 "/games:v1/PlayerLeaderboardScore/publicRank": public_rank

generated/google/apis/accessapproval_v1.rb

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

generated/google/apis/accessapproval_v1/classes.rb

@@ -28,42 +28,38 @@ module Google
       
         # Output only. This field is read only (not settable via
         # UpdateAccessAccessApprovalSettings method). If the field is true, that
-        # indicates that at least one service is enrolled for Access Approval in one
+        # indicates that at least one service is enrolled for Access Approval in one or
-        # or more ancestors of the Project or Folder (this field will always be
+        # more ancestors of the Project or Folder (this field will always be unset for
-        # unset for the organization since organizations do not have ancestors).
+        # the organization since organizations do not have ancestors).
         # Corresponds to the JSON property `enrolledAncestor`
         # @return [Boolean]
         attr_accessor :enrolled_ancestor
         alias_method :enrolled_ancestor?, :enrolled_ancestor
       
         # A list of Google Cloud Services for which the given resource has Access
-        # Approval enrolled. Access requests for the resource given by name against
+        # Approval enrolled. Access requests for the resource given by name against any
-        # any of these services contained here will be required to have explicit
+        # of these services contained here will be required to have explicit approval.
-        # approval. If name refers to an organization, enrollment can be done for
+        # If name refers to an organization, enrollment can be done for individual
-        # individual services. If name refers to a folder or project, enrollment can
+        # services. If name refers to a folder or project, enrollment can only be done
-        # only be done on an all or nothing basis.
+        # on an all or nothing basis. If a cloud_product is repeated in this list, the
-        # If a cloud_product is repeated in this list, the first entry will be
+        # first entry will be honored and all following entries will be discarded. A
-        # honored and all following entries will be discarded. A maximum of 10
+        # maximum of 10 enrolled services will be enforced, to be expanded as the set of
-        # enrolled services will be enforced, to be expanded as the set of supported
+        # supported services is expanded.
-        # services is expanded.
         # Corresponds to the JSON property `enrolledServices`
         # @return [Array<Google::Apis::AccessapprovalV1::EnrolledService>]
         attr_accessor :enrolled_services
       
-        # The resource name of the settings. Format is one of:
+        # The resource name of the settings. Format is one of: 1. "projects/`project_id`/
-        # <ol>
+        # accessApprovalSettings" 2. "folders/`folder_id`/accessApprovalSettings" 3. "
-        # <li>"projects/`project_id`/accessApprovalSettings"</li>
+        # organizations/`organization_id`/accessApprovalSettings"
-        # <li>"folders/`folder_id`/accessApprovalSettings"</li>
-        # <li>"organizations/`organization_id`/accessApprovalSettings"</li>
-        # <ol>
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # A list of email addresses to which notifications relating to approval
+        # A list of email addresses to which notifications relating to approval requests
-        # requests should be sent. Notifications relating to a resource will be sent
+        # should be sent. Notifications relating to a resource will be sent to all
-        # to all emails in the settings of ancestor resources of that resource. A
+        # emails in the settings of ancestor resources of that resource. A maximum of 50
-        # maximum of 50 email addresses are allowed.
+        # email addresses are allowed.
         # Corresponds to the JSON property `notificationEmails`
         # @return [Array<String>]
         attr_accessor :notification_emails
@@ -85,40 +81,22 @@ module Google
       class AccessLocations
         include Google::Apis::Core::Hashable
       
-        # The "home office" location of the principal. A two-letter country code
+        # The "home office" location of the principal. A two-letter country code (ISO
-        # (ISO 3166-1 alpha-2), such as "US", "DE" or "GB" or a region code. In some
+        # 3166-1 alpha-2), such as "US", "DE" or "GB" or a region code. In some limited
-        # limited situations Google systems may refer refer to a region code instead
+        # situations Google systems may refer refer to a region code instead of a
-        # of a country code.
+        # country code. Possible Region Codes: 1. ASI: Asia 2. EUR: Europe 3. OCE:
-        # Possible Region Codes:
+        # Oceania 4. AFR: Africa 5. NAM: North America 6. SAM: South America 7. ANT:
-        # <ol>
+        # Antarctica 8. ANY: Any location
-        # <li>ASI: Asia</li>
-        # <li>EUR: Europe</li>
-        # <li>OCE: Oceania</li>
-        # <li>AFR: Africa</li>
-        # <li>NAM: North America</li>
-        # <li>SAM: South America</li>
-        # <li>ANT: Antarctica</li>
-        # <li>ANY: Any location</li>
-        # </ol>
         # Corresponds to the JSON property `principalOfficeCountry`
         # @return [String]
         attr_accessor :principal_office_country
       
-        # Physical location of the principal at the time of the access. A
+        # Physical location of the principal at the time of the access. A two-letter
-        # two-letter country code (ISO 3166-1 alpha-2), such as "US", "DE" or "GB" or
+        # country code (ISO 3166-1 alpha-2), such as "US", "DE" or "GB" or a region code.
-        # a region code. In some limited situations Google systems may refer refer to
+        # In some limited situations Google systems may refer refer to a region code
-        # a region code instead of a country code.
+        # instead of a country code. Possible Region Codes: 1. ASI: Asia 2. EUR: Europe
-        # Possible Region Codes:
+        # 3. OCE: Oceania 4. AFR: Africa 5. NAM: North America 6. SAM: South America 7.
-        # <ol>
+        # ANT: Antarctica 8. ANY: Any location
-        # <li>ASI: Asia</li>
-        # <li>EUR: Europe</li>
-        # <li>OCE: Oceania</li>
-        # <li>AFR: Africa</li>
-        # <li>NAM: North America</li>
-        # <li>SAM: South America</li>
-        # <li>ANT: Antarctica</li>
-        # <li>ANY: Any location</li>
-        # </ol>
         # Corresponds to the JSON property `principalPhysicalLocationCountry`
         # @return [String]
         attr_accessor :principal_physical_location_country
@@ -173,8 +151,8 @@ module Google
         # @return [Google::Apis::AccessapprovalV1::DismissDecision]
         attr_accessor :dismiss
       
-        # The resource name of the request. Format is
+        # The resource name of the request. Format is "`projects|folders|organizations`/`
-        # "`projects|folders|organizations`/`id`/approvalRequests/`approval_request_id`".
+        # id`/approvalRequests/`approval_request_id`".
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -184,8 +162,8 @@ module Google
         # @return [String]
         attr_accessor :request_time
       
-        # The requested expiration for the approval. If the request is approved,
+        # The requested expiration for the approval. If the request is approved, access
-        # access will be granted from the time of approval until the expiration time.
+        # will be granted from the time of approval until the expiration time.
         # Corresponds to the JSON property `requestedExpiration`
         # @return [String]
         attr_accessor :requested_expiration
@@ -200,13 +178,11 @@ module Google
         # @return [Google::Apis::AccessapprovalV1::AccessReason]
         attr_accessor :requested_reason
       
-        # The resource for which approval is being requested. The format of the
+        # The resource for which approval is being requested. The format of the resource
-        # resource name is defined at
+        # name is defined at https://cloud.google.com/apis/design/resource_names. The
-        # https://cloud.google.com/apis/design/resource_names. The resource name here
+        # resource name here may either be a "full" resource name (e.g. "//library.
-        # may either be a "full" resource name (e.g.
+        # googleapis.com/shelves/shelf1/books/book2") or a "relative" resource name (e.g.
-        # "//library.googleapis.com/shelves/shelf1/books/book2") or a "relative"
+        # "shelves/shelf1/books/book2") as described in the resource name specification.
-        # resource name (e.g. "shelves/shelf1/books/book2") as described in the
-        # resource name specification.
         # Corresponds to the JSON property `requestedResourceName`
         # @return [String]
         attr_accessor :requested_resource_name
@@ -300,9 +276,9 @@ module Google
         # @return [String]
         attr_accessor :dismiss_time
       
-        # This field will be true if the ApprovalRequest was implcitly dismissed due
+        # This field will be true if the ApprovalRequest was implcitly dismissed due to
-        # to inaction by the access approval approvers (the request is not acted
+        # inaction by the access approval approvers (the request is not acted on by the
-        # on by the approvers before the exiration time).
+        # approvers before the exiration time).
         # Corresponds to the JSON property `implicit`
         # @return [Boolean]
         attr_accessor :implicit
@@ -319,13 +295,11 @@ module Google
         end
       end
       
-      # A generic empty message that you can re-use to avoid defining duplicated
+      # A generic empty message that you can re-use to avoid defining duplicated empty
-      # empty messages in your APIs. A typical example is to use it as the request
+      # messages in your APIs. A typical example is to use it as the request or the
-      # or the response type of an API method. For instance:
+      # response type of an API method. For instance: service Foo ` rpc Bar(google.
-      # service Foo `
+      # protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for
-      # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      # `Empty` is empty JSON object ````.
-      # `
-      # The JSON representation for `Empty` is empty JSON object ````.
       class Empty
         include Google::Apis::Core::Hashable
       
@@ -343,19 +317,10 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The product for which Access Approval will be enrolled. Allowed values are
-        # listed below (case-sensitive):
+        # listed below (case-sensitive): 1. all 2. appengine.googleapis.com 3. bigquery.
-        # <ol>
+        # googleapis.com 4. bigtable.googleapis.com 5. cloudkms.googleapis.com 6.
-        # <li>all</li>
+        # compute.googleapis.com 7. dataflow.googleapis.com 8. iam.googleapis.com 9.
-        # <li>appengine.googleapis.com</li>
+        # pubsub.googleapis.com 10. storage.googleapis.com
-        # <li>bigquery.googleapis.com</li>
-        # <li>bigtable.googleapis.com</li>
-        # <li>cloudkms.googleapis.com</li>
-        # <li>compute.googleapis.com</li>
-        # <li>dataflow.googleapis.com</li>
-        # <li>iam.googleapis.com</li>
-        # <li>pubsub.googleapis.com</li>
-        # <li>storage.googleapis.com</li>
-        # <ol>
         # Corresponds to the JSON property `cloudProduct`
         # @return [String]
         attr_accessor :cloud_product

generated/google/apis/accessapproval_v1/service.rb

@@ -47,12 +47,11 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Deletes the settings associated with a project, folder, or organization.
+        # Deletes the settings associated with a project, folder, or organization. This
-        # This will have the effect of disabling Access Approval for the project,
+        # will have the effect of disabling Access Approval for the project, folder, or
-        # folder, or organization, but only if all ancestors also have Access
+        # organization, but only if all ancestors also have Access Approval disabled. If
-        # Approval disabled. If Access Approval is enabled at a higher level of the
+        # Access Approval is enabled at a higher level of the hierarchy, then Access
-        # hierarchy, then Access Approval will still be enabled at this level as
+        # Approval will still be enabled at this level as the settings are inherited.
-        # the settings are inherited.
         # @param [String] name
         #   Name of the AccessApprovalSettings to delete.
         # @param [String] fields
@@ -115,24 +114,18 @@ module Google
         # Updates the settings associated with a project, folder, or organization.
         # Settings to update are determined by the value of field_mask.
         # @param [String] name
-        #   The resource name of the settings. Format is one of:
+        #   The resource name of the settings. Format is one of: 1. "projects/`project_id`/
-        #   <ol>
+        #   accessApprovalSettings" 2. "folders/`folder_id`/accessApprovalSettings" 3. "
-        #   <li>"projects/`project_id`/accessApprovalSettings"</li>
+        #   organizations/`organization_id`/accessApprovalSettings"
-        #   <li>"folders/`folder_id`/accessApprovalSettings"</li>
-        #   <li>"organizations/`organization_id`/accessApprovalSettings"</li>
-        #   <ol>
         # @param [Google::Apis::AccessapprovalV1::AccessApprovalSettings] access_approval_settings_object
         # @param [String] update_mask
         #   The update mask applies to the settings. Only the top level fields of
-        #   AccessApprovalSettings (notification_emails & enrolled_services) are
+        #   AccessApprovalSettings (notification_emails & enrolled_services) are supported.
-        #   supported. For each field, if it is included, the currently stored value
+        #   For each field, if it is included, the currently stored value will be
-        #   will be entirely overwritten with the value of the field passed in this
+        #   entirely overwritten with the value of the field passed in this request. For
-        #   request.
+        #   the `FieldMask` definition, see https://developers.google.com/protocol-buffers/
-        #   For the `FieldMask` definition, see
+        #   docs/reference/google.protobuf#fieldmask If this field is left unset, only the
-        #   https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
+        #   notification_emails field will be updated.
-        #   fieldmask
-        #   If this field is left unset, only the notification_emails field will be
-        #   updated.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -163,9 +156,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Approves a request and returns the updated ApprovalRequest.
+        # Approves a request and returns the updated ApprovalRequest. Returns NOT_FOUND
-        # Returns NOT_FOUND if the request does not exist. Returns
+        # if the request does not exist. Returns FAILED_PRECONDITION if the request
-        # FAILED_PRECONDITION if the request exists but is not in a pending state.
+        # exists but is not in a pending state.
         # @param [String] name
         #   Name of the approval request to approve.
         # @param [Google::Apis::AccessapprovalV1::ApproveApprovalRequestMessage] approve_approval_request_message_object
@@ -198,13 +191,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Dismisses a request. Returns the updated ApprovalRequest.
+        # Dismisses a request. Returns the updated ApprovalRequest. NOTE: This does not
-        # NOTE: This does not deny access to the resource if another request has been
+        # deny access to the resource if another request has been made and approved. It
-        # made and approved. It is equivalent in effect to ignoring the request
+        # is equivalent in effect to ignoring the request altogether. Returns NOT_FOUND
-        # altogether.
+        # if the request does not exist. Returns FAILED_PRECONDITION if the request
-        # Returns NOT_FOUND if the request does not exist.
+        # exists but is not in a pending state.
-        # Returns FAILED_PRECONDITION if the request exists but is not in a pending
-        # state.
         # @param [String] name
         #   Name of the ApprovalRequest to dismiss.
         # @param [Google::Apis::AccessapprovalV1::DismissApprovalRequestMessage] dismiss_approval_request_message_object
@@ -268,22 +259,18 @@ module Google
         end
         
         # Lists approval requests associated with a project, folder, or organization.
-        # Approval requests can be filtered by state (pending, active, dismissed).
+        # Approval requests can be filtered by state (pending, active, dismissed). The
-        # The order is reverse chronological.
+        # order is reverse chronological.
         # @param [String] parent
-        #   The parent resource. This may be "projects/`project_id`",
+        #   The parent resource. This may be "projects/`project_id`", "folders/`folder_id`"
-        #   "folders/`folder_id`", or "organizations/`organization_id`".
+        #   , or "organizations/`organization_id`".
         # @param [String] filter
         #   A filter on the type of approval requests to retrieve. Must be one of the
-        #   following values:
+        #   following values: 1. [not set]: Requests that are pending or have active
-        #   <ol>
+        #   approvals. 2. ALL: All requests. 3. PENDING: Only pending requests. 4. ACTIVE:
-        #   <li>[not set]: Requests that are pending or have active approvals.</li>
+        #   Only active (i.e. currently approved) requests. 5. DISMISSED: Only dismissed (
-        #   <li>ALL: All requests.</li>
+        #   including expired) requests. 6. HISTORY: Active and dismissed (including
-        #   <li>PENDING: Only pending requests.</li>
+        #   expired) requests.
-        #   <li>ACTIVE: Only active (i.e. currently approved) requests.</li>
-        #   <li>DISMISSED: Only dismissed (including expired) requests.</li>
-        #   <li>HISTORY: Active and dismissed (including expired) requests.</li>
-        #   </ol>
         # @param [Fixnum] page_size
         #   Requested page size.
         # @param [String] page_token
@@ -318,12 +305,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes the settings associated with a project, folder, or organization.
+        # Deletes the settings associated with a project, folder, or organization. This
-        # This will have the effect of disabling Access Approval for the project,
+        # will have the effect of disabling Access Approval for the project, folder, or
-        # folder, or organization, but only if all ancestors also have Access
+        # organization, but only if all ancestors also have Access Approval disabled. If
-        # Approval disabled. If Access Approval is enabled at a higher level of the
+        # Access Approval is enabled at a higher level of the hierarchy, then Access
-        # hierarchy, then Access Approval will still be enabled at this level as
+        # Approval will still be enabled at this level as the settings are inherited.
-        # the settings are inherited.
         # @param [String] name
         #   Name of the AccessApprovalSettings to delete.
         # @param [String] fields
@@ -386,24 +372,18 @@ module Google
         # Updates the settings associated with a project, folder, or organization.
         # Settings to update are determined by the value of field_mask.
         # @param [String] name
-        #   The resource name of the settings. Format is one of:
+        #   The resource name of the settings. Format is one of: 1. "projects/`project_id`/
-        #   <ol>
+        #   accessApprovalSettings" 2. "folders/`folder_id`/accessApprovalSettings" 3. "
-        #   <li>"projects/`project_id`/accessApprovalSettings"</li>
+        #   organizations/`organization_id`/accessApprovalSettings"
-        #   <li>"folders/`folder_id`/accessApprovalSettings"</li>
-        #   <li>"organizations/`organization_id`/accessApprovalSettings"</li>
-        #   <ol>
         # @param [Google::Apis::AccessapprovalV1::AccessApprovalSettings] access_approval_settings_object
         # @param [String] update_mask
         #   The update mask applies to the settings. Only the top level fields of
-        #   AccessApprovalSettings (notification_emails & enrolled_services) are
+        #   AccessApprovalSettings (notification_emails & enrolled_services) are supported.
-        #   supported. For each field, if it is included, the currently stored value
+        #   For each field, if it is included, the currently stored value will be
-        #   will be entirely overwritten with the value of the field passed in this
+        #   entirely overwritten with the value of the field passed in this request. For
-        #   request.
+        #   the `FieldMask` definition, see https://developers.google.com/protocol-buffers/
-        #   For the `FieldMask` definition, see
+        #   docs/reference/google.protobuf#fieldmask If this field is left unset, only the
-        #   https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
+        #   notification_emails field will be updated.
-        #   fieldmask
-        #   If this field is left unset, only the notification_emails field will be
-        #   updated.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -434,9 +414,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Approves a request and returns the updated ApprovalRequest.
+        # Approves a request and returns the updated ApprovalRequest. Returns NOT_FOUND
-        # Returns NOT_FOUND if the request does not exist. Returns
+        # if the request does not exist. Returns FAILED_PRECONDITION if the request
-        # FAILED_PRECONDITION if the request exists but is not in a pending state.
+        # exists but is not in a pending state.
         # @param [String] name
         #   Name of the approval request to approve.
         # @param [Google::Apis::AccessapprovalV1::ApproveApprovalRequestMessage] approve_approval_request_message_object
@@ -469,13 +449,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Dismisses a request. Returns the updated ApprovalRequest.
+        # Dismisses a request. Returns the updated ApprovalRequest. NOTE: This does not
-        # NOTE: This does not deny access to the resource if another request has been
+        # deny access to the resource if another request has been made and approved. It
-        # made and approved. It is equivalent in effect to ignoring the request
+        # is equivalent in effect to ignoring the request altogether. Returns NOT_FOUND
-        # altogether.
+        # if the request does not exist. Returns FAILED_PRECONDITION if the request
-        # Returns NOT_FOUND if the request does not exist.
+        # exists but is not in a pending state.
-        # Returns FAILED_PRECONDITION if the request exists but is not in a pending
-        # state.
         # @param [String] name
         #   Name of the ApprovalRequest to dismiss.
         # @param [Google::Apis::AccessapprovalV1::DismissApprovalRequestMessage] dismiss_approval_request_message_object
@@ -539,22 +517,18 @@ module Google
         end
         
         # Lists approval requests associated with a project, folder, or organization.
-        # Approval requests can be filtered by state (pending, active, dismissed).
+        # Approval requests can be filtered by state (pending, active, dismissed). The
-        # The order is reverse chronological.
+        # order is reverse chronological.
         # @param [String] parent
-        #   The parent resource. This may be "projects/`project_id`",
+        #   The parent resource. This may be "projects/`project_id`", "folders/`folder_id`"
-        #   "folders/`folder_id`", or "organizations/`organization_id`".
+        #   , or "organizations/`organization_id`".
         # @param [String] filter
         #   A filter on the type of approval requests to retrieve. Must be one of the
-        #   following values:
+        #   following values: 1. [not set]: Requests that are pending or have active
-        #   <ol>
+        #   approvals. 2. ALL: All requests. 3. PENDING: Only pending requests. 4. ACTIVE:
-        #   <li>[not set]: Requests that are pending or have active approvals.</li>
+        #   Only active (i.e. currently approved) requests. 5. DISMISSED: Only dismissed (
-        #   <li>ALL: All requests.</li>
+        #   including expired) requests. 6. HISTORY: Active and dismissed (including
-        #   <li>PENDING: Only pending requests.</li>
+        #   expired) requests.
-        #   <li>ACTIVE: Only active (i.e. currently approved) requests.</li>
-        #   <li>DISMISSED: Only dismissed (including expired) requests.</li>
-        #   <li>HISTORY: Active and dismissed (including expired) requests.</li>
-        #   </ol>
         # @param [Fixnum] page_size
         #   Requested page size.
         # @param [String] page_token
@@ -589,12 +563,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes the settings associated with a project, folder, or organization.
+        # Deletes the settings associated with a project, folder, or organization. This
-        # This will have the effect of disabling Access Approval for the project,
+        # will have the effect of disabling Access Approval for the project, folder, or
-        # folder, or organization, but only if all ancestors also have Access
+        # organization, but only if all ancestors also have Access Approval disabled. If
-        # Approval disabled. If Access Approval is enabled at a higher level of the
+        # Access Approval is enabled at a higher level of the hierarchy, then Access
-        # hierarchy, then Access Approval will still be enabled at this level as
+        # Approval will still be enabled at this level as the settings are inherited.
-        # the settings are inherited.
         # @param [String] name
         #   Name of the AccessApprovalSettings to delete.
         # @param [String] fields
@@ -657,24 +630,18 @@ module Google
         # Updates the settings associated with a project, folder, or organization.
         # Settings to update are determined by the value of field_mask.
         # @param [String] name
-        #   The resource name of the settings. Format is one of:
+        #   The resource name of the settings. Format is one of: 1. "projects/`project_id`/
-        #   <ol>
+        #   accessApprovalSettings" 2. "folders/`folder_id`/accessApprovalSettings" 3. "
-        #   <li>"projects/`project_id`/accessApprovalSettings"</li>
+        #   organizations/`organization_id`/accessApprovalSettings"
-        #   <li>"folders/`folder_id`/accessApprovalSettings"</li>
-        #   <li>"organizations/`organization_id`/accessApprovalSettings"</li>
-        #   <ol>
         # @param [Google::Apis::AccessapprovalV1::AccessApprovalSettings] access_approval_settings_object
         # @param [String] update_mask
         #   The update mask applies to the settings. Only the top level fields of
-        #   AccessApprovalSettings (notification_emails & enrolled_services) are
+        #   AccessApprovalSettings (notification_emails & enrolled_services) are supported.
-        #   supported. For each field, if it is included, the currently stored value
+        #   For each field, if it is included, the currently stored value will be
-        #   will be entirely overwritten with the value of the field passed in this
+        #   entirely overwritten with the value of the field passed in this request. For
-        #   request.
+        #   the `FieldMask` definition, see https://developers.google.com/protocol-buffers/
-        #   For the `FieldMask` definition, see
+        #   docs/reference/google.protobuf#fieldmask If this field is left unset, only the
-        #   https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
+        #   notification_emails field will be updated.
-        #   fieldmask
-        #   If this field is left unset, only the notification_emails field will be
-        #   updated.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -705,9 +672,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Approves a request and returns the updated ApprovalRequest.
+        # Approves a request and returns the updated ApprovalRequest. Returns NOT_FOUND
-        # Returns NOT_FOUND if the request does not exist. Returns
+        # if the request does not exist. Returns FAILED_PRECONDITION if the request
-        # FAILED_PRECONDITION if the request exists but is not in a pending state.
+        # exists but is not in a pending state.
         # @param [String] name
         #   Name of the approval request to approve.
         # @param [Google::Apis::AccessapprovalV1::ApproveApprovalRequestMessage] approve_approval_request_message_object
@@ -740,13 +707,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Dismisses a request. Returns the updated ApprovalRequest.
+        # Dismisses a request. Returns the updated ApprovalRequest. NOTE: This does not
-        # NOTE: This does not deny access to the resource if another request has been
+        # deny access to the resource if another request has been made and approved. It
-        # made and approved. It is equivalent in effect to ignoring the request
+        # is equivalent in effect to ignoring the request altogether. Returns NOT_FOUND
-        # altogether.
+        # if the request does not exist. Returns FAILED_PRECONDITION if the request
-        # Returns NOT_FOUND if the request does not exist.
+        # exists but is not in a pending state.
-        # Returns FAILED_PRECONDITION if the request exists but is not in a pending
-        # state.
         # @param [String] name
         #   Name of the ApprovalRequest to dismiss.
         # @param [Google::Apis::AccessapprovalV1::DismissApprovalRequestMessage] dismiss_approval_request_message_object
@@ -810,22 +775,18 @@ module Google
         end
         
         # Lists approval requests associated with a project, folder, or organization.
-        # Approval requests can be filtered by state (pending, active, dismissed).
+        # Approval requests can be filtered by state (pending, active, dismissed). The
-        # The order is reverse chronological.
+        # order is reverse chronological.
         # @param [String] parent
-        #   The parent resource. This may be "projects/`project_id`",
+        #   The parent resource. This may be "projects/`project_id`", "folders/`folder_id`"
-        #   "folders/`folder_id`", or "organizations/`organization_id`".
+        #   , or "organizations/`organization_id`".
         # @param [String] filter
         #   A filter on the type of approval requests to retrieve. Must be one of the
-        #   following values:
+        #   following values: 1. [not set]: Requests that are pending or have active
-        #   <ol>
+        #   approvals. 2. ALL: All requests. 3. PENDING: Only pending requests. 4. ACTIVE:
-        #   <li>[not set]: Requests that are pending or have active approvals.</li>
+        #   Only active (i.e. currently approved) requests. 5. DISMISSED: Only dismissed (
-        #   <li>ALL: All requests.</li>
+        #   including expired) requests. 6. HISTORY: Active and dismissed (including
-        #   <li>PENDING: Only pending requests.</li>
+        #   expired) requests.
-        #   <li>ACTIVE: Only active (i.e. currently approved) requests.</li>
-        #   <li>DISMISSED: Only dismissed (including expired) requests.</li>
-        #   <li>HISTORY: Active and dismissed (including expired) requests.</li>
-        #   </ol>
         # @param [Fixnum] page_size
         #   Requested page size.
         # @param [String] page_token

generated/google/apis/accessapproval_v1beta1.rb

@@ -1,34 +0,0 @@
-# Copyright 2015 Google Inc.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#      http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-require 'google/apis/accessapproval_v1beta1/service.rb'
-require 'google/apis/accessapproval_v1beta1/classes.rb'
-require 'google/apis/accessapproval_v1beta1/representations.rb'
-
-module Google
-  module Apis
-    # Access Approval API
-    #
-    # An API for controlling access to data by Google personnel.
-    #
-    # @see https://cloud.google.com/access-approval/docs
-    module AccessapprovalV1beta1
-      VERSION = 'V1beta1'
-      REVISION = '20200708'
-
-      # View and manage your data across Google Cloud Platform services
-      AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
-    end
-  end
-end

generated/google/apis/accessapproval_v1beta1/classes.rb

@@ -1,417 +0,0 @@
-# Copyright 2015 Google Inc.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#      http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-require 'date'
-require 'google/apis/core/base_service'
-require 'google/apis/core/json_representation'
-require 'google/apis/core/hashable'
-require 'google/apis/errors'
-
-module Google
-  module Apis
-    module AccessapprovalV1beta1
-      
-      # Settings on a Project/Folder/Organization related to Access Approval.
-      class AccessApprovalSettings
-        include Google::Apis::Core::Hashable
-      
-        # Output only. This field is read only (not settable via
-        # UpdateAccessAccessApprovalSettings method). If the field is true, that
-        # indicates that at least one service is enrolled for Access Approval in one
-        # or more ancestors of the Project or Folder (this field will always be
-        # unset for the organization since organizations do not have ancestors).
-        # Corresponds to the JSON property `enrolledAncestor`
-        # @return [Boolean]
-        attr_accessor :enrolled_ancestor
-        alias_method :enrolled_ancestor?, :enrolled_ancestor
-      
-        # A list of Google Cloud Services for which the given resource has Access
-        # Approval enrolled. Access requests for the resource given by name against
-        # any of these services contained here will be required to have explicit
-        # approval. If name refers to an organization, enrollment can be done for
-        # individual services. If name refers to a folder or project, enrollment can
-        # only be done on an all or nothing basis.
-        # If a cloud_product is repeated in this list, the first entry will be
-        # honored and all following entries will be discarded. A maximum of 10
-        # enrolled services will be enforced, to be expanded as the set of supported
-        # services is expanded.
-        # Corresponds to the JSON property `enrolledServices`
-        # @return [Array<Google::Apis::AccessapprovalV1beta1::EnrolledService>]
-        attr_accessor :enrolled_services
-      
-        # The resource name of the settings. Format is one of:
-        # <ol>
-        # <li>"projects/`project_id`/accessApprovalSettings"</li>
-        # <li>"folders/`folder_id`/accessApprovalSettings"</li>
-        # <li>"organizations/`organization_id`/accessApprovalSettings"</li>
-        # <ol>
-        # Corresponds to the JSON property `name`
-        # @return [String]
-        attr_accessor :name
-      
-        # A list of email addresses to which notifications relating to approval
-        # requests should be sent. Notifications relating to a resource will be sent
-        # to all emails in the settings of ancestor resources of that resource. A
-        # maximum of 50 email addresses are allowed.
-        # Corresponds to the JSON property `notificationEmails`
-        # @return [Array<String>]
-        attr_accessor :notification_emails
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @enrolled_ancestor = args[:enrolled_ancestor] if args.key?(:enrolled_ancestor)
-          @enrolled_services = args[:enrolled_services] if args.key?(:enrolled_services)
-          @name = args[:name] if args.key?(:name)
-          @notification_emails = args[:notification_emails] if args.key?(:notification_emails)
-        end
-      end
-      
-      # Home office and physical location of the principal.
-      class AccessLocations
-        include Google::Apis::Core::Hashable
-      
-        # The "home office" location of the principal. A two-letter country code
-        # (ISO 3166-1 alpha-2), such as "US", "DE" or "GB" or a region code. In some
-        # limited situations Google systems may refer refer to a region code instead
-        # of a country code.
-        # Possible Region Codes:
-        # <ol>
-        # <li>ASI: Asia</li>
-        # <li>EUR: Europe</li>
-        # <li>OCE: Oceania</li>
-        # <li>AFR: Africa</li>
-        # <li>NAM: North America</li>
-        # <li>SAM: South America</li>
-        # <li>ANT: Antarctica</li>
-        # <li>ANY: Any location</li>
-        # </ol>
-        # Corresponds to the JSON property `principalOfficeCountry`
-        # @return [String]
-        attr_accessor :principal_office_country
-      
-        # Physical location of the principal at the time of the access. A
-        # two-letter country code (ISO 3166-1 alpha-2), such as "US", "DE" or "GB" or
-        # a region code. In some limited situations Google systems may refer refer to
-        # a region code instead of a country code.
-        # Possible Region Codes:
-        # <ol>
-        # <li>ASI: Asia</li>
-        # <li>EUR: Europe</li>
-        # <li>OCE: Oceania</li>
-        # <li>AFR: Africa</li>
-        # <li>NAM: North America</li>
-        # <li>SAM: South America</li>
-        # <li>ANT: Antarctica</li>
-        # <li>ANY: Any location</li>
-        # </ol>
-        # Corresponds to the JSON property `principalPhysicalLocationCountry`
-        # @return [String]
-        attr_accessor :principal_physical_location_country
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @principal_office_country = args[:principal_office_country] if args.key?(:principal_office_country)
-          @principal_physical_location_country = args[:principal_physical_location_country] if args.key?(:principal_physical_location_country)
-        end
-      end
-      
-      # 
-      class AccessReason
-        include Google::Apis::Core::Hashable
-      
-        # More detail about certain reason types. See comments for each type above.
-        # Corresponds to the JSON property `detail`
-        # @return [String]
-        attr_accessor :detail
-      
-        # Type of access justification.
-        # Corresponds to the JSON property `type`
-        # @return [String]
-        attr_accessor :type
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @detail = args[:detail] if args.key?(:detail)
-          @type = args[:type] if args.key?(:type)
-        end
-      end
-      
-      # A request for the customer to approve access to a resource.
-      class ApprovalRequest
-        include Google::Apis::Core::Hashable
-      
-        # A decision that has been made to approve access to a resource.
-        # Corresponds to the JSON property `approve`
-        # @return [Google::Apis::AccessapprovalV1beta1::ApproveDecision]
-        attr_accessor :approve
-      
-        # A decision that has been made to dismiss an approval request.
-        # Corresponds to the JSON property `dismiss`
-        # @return [Google::Apis::AccessapprovalV1beta1::DismissDecision]
-        attr_accessor :dismiss
-      
-        # The resource name of the request. Format is
-        # "`projects|folders|organizations`/`id`/approvalRequests/`approval_request_id`".
-        # Corresponds to the JSON property `name`
-        # @return [String]
-        attr_accessor :name
-      
-        # The time at which approval was requested.
-        # Corresponds to the JSON property `requestTime`
-        # @return [String]
-        attr_accessor :request_time
-      
-        # The requested expiration for the approval. If the request is approved,
-        # access will be granted from the time of approval until the expiration time.
-        # Corresponds to the JSON property `requestedExpiration`
-        # @return [String]
-        attr_accessor :requested_expiration
-      
-        # Home office and physical location of the principal.
-        # Corresponds to the JSON property `requestedLocations`
-        # @return [Google::Apis::AccessapprovalV1beta1::AccessLocations]
-        attr_accessor :requested_locations
-      
-        # The justification for which approval is being requested.
-        # Corresponds to the JSON property `requestedReason`
-        # @return [Google::Apis::AccessapprovalV1beta1::AccessReason]
-        attr_accessor :requested_reason
-      
-        # The resource for which approval is being requested. The format of the
-        # resource name is defined at
-        # https://cloud.google.com/apis/design/resource_names. The resource name here
-        # may either be a "full" resource name (e.g.
-        # "//library.googleapis.com/shelves/shelf1/books/book2") or a "relative"
-        # resource name (e.g. "shelves/shelf1/books/book2") as described in the
-        # resource name specification.
-        # Corresponds to the JSON property `requestedResourceName`
-        # @return [String]
-        attr_accessor :requested_resource_name
-      
-        # The properties associated with the resource of the request.
-        # Corresponds to the JSON property `requestedResourceProperties`
-        # @return [Google::Apis::AccessapprovalV1beta1::ResourceProperties]
-        attr_accessor :requested_resource_properties
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @approve = args[:approve] if args.key?(:approve)
-          @dismiss = args[:dismiss] if args.key?(:dismiss)
-          @name = args[:name] if args.key?(:name)
-          @request_time = args[:request_time] if args.key?(:request_time)
-          @requested_expiration = args[:requested_expiration] if args.key?(:requested_expiration)
-          @requested_locations = args[:requested_locations] if args.key?(:requested_locations)
-          @requested_reason = args[:requested_reason] if args.key?(:requested_reason)
-          @requested_resource_name = args[:requested_resource_name] if args.key?(:requested_resource_name)
-          @requested_resource_properties = args[:requested_resource_properties] if args.key?(:requested_resource_properties)
-        end
-      end
-      
-      # Request to approve an ApprovalRequest.
-      class ApproveApprovalRequestMessage
-        include Google::Apis::Core::Hashable
-      
-        # The expiration time of this approval.
-        # Corresponds to the JSON property `expireTime`
-        # @return [String]
-        attr_accessor :expire_time
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @expire_time = args[:expire_time] if args.key?(:expire_time)
-        end
-      end
-      
-      # A decision that has been made to approve access to a resource.
-      class ApproveDecision
-        include Google::Apis::Core::Hashable
-      
-        # The time at which approval was granted.
-        # Corresponds to the JSON property `approveTime`
-        # @return [String]
-        attr_accessor :approve_time
-      
-        # The time at which the approval expires.
-        # Corresponds to the JSON property `expireTime`
-        # @return [String]
-        attr_accessor :expire_time
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @approve_time = args[:approve_time] if args.key?(:approve_time)
-          @expire_time = args[:expire_time] if args.key?(:expire_time)
-        end
-      end
-      
-      # Request to dismiss an approval request.
-      class DismissApprovalRequestMessage
-        include Google::Apis::Core::Hashable
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-        end
-      end
-      
-      # A decision that has been made to dismiss an approval request.
-      class DismissDecision
-        include Google::Apis::Core::Hashable
-      
-        # The time at which the approval request was dismissed.
-        # Corresponds to the JSON property `dismissTime`
-        # @return [String]
-        attr_accessor :dismiss_time
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @dismiss_time = args[:dismiss_time] if args.key?(:dismiss_time)
-        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 ````.
-      class Empty
-        include Google::Apis::Core::Hashable
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-        end
-      end
-      
-      # Represents the enrollment of a cloud resource into a specific service.
-      class EnrolledService
-        include Google::Apis::Core::Hashable
-      
-        # The product for which Access Approval will be enrolled. Allowed values are
-        # listed below (case-sensitive):
-        # <ol>
-        # <li>all</li>
-        # <li>appengine.googleapis.com</li>
-        # <li>bigquery.googleapis.com</li>
-        # <li>bigtable.googleapis.com</li>
-        # <li>cloudkms.googleapis.com</li>
-        # <li>compute.googleapis.com</li>
-        # <li>dataflow.googleapis.com</li>
-        # <li>iam.googleapis.com</li>
-        # <li>pubsub.googleapis.com</li>
-        # <li>storage.googleapis.com</li>
-        # <ol>
-        # Corresponds to the JSON property `cloudProduct`
-        # @return [String]
-        attr_accessor :cloud_product
-      
-        # The enrollment level of the service.
-        # Corresponds to the JSON property `enrollmentLevel`
-        # @return [String]
-        attr_accessor :enrollment_level
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @cloud_product = args[:cloud_product] if args.key?(:cloud_product)
-          @enrollment_level = args[:enrollment_level] if args.key?(:enrollment_level)
-        end
-      end
-      
-      # Response to listing of ApprovalRequest objects.
-      class ListApprovalRequestsResponse
-        include Google::Apis::Core::Hashable
-      
-        # Approval request details.
-        # Corresponds to the JSON property `approvalRequests`
-        # @return [Array<Google::Apis::AccessapprovalV1beta1::ApprovalRequest>]
-        attr_accessor :approval_requests
-      
-        # Token to retrieve the next page of results, or empty if there are no more.
-        # Corresponds to the JSON property `nextPageToken`
-        # @return [String]
-        attr_accessor :next_page_token
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @approval_requests = args[:approval_requests] if args.key?(:approval_requests)
-          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
-        end
-      end
-      
-      # The properties associated with the resource of the request.
-      class ResourceProperties
-        include Google::Apis::Core::Hashable
-      
-        # Whether an approval will exclude the descendants of the resource being
-        # requested.
-        # Corresponds to the JSON property `excludesDescendants`
-        # @return [Boolean]
-        attr_accessor :excludes_descendants
-        alias_method :excludes_descendants?, :excludes_descendants
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @excludes_descendants = args[:excludes_descendants] if args.key?(:excludes_descendants)
-        end
-      end
-    end
-  end
-end

generated/google/apis/accessapproval_v1beta1/representations.rb

@@ -1,203 +0,0 @@
-# Copyright 2015 Google Inc.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#      http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-require 'date'
-require 'google/apis/core/base_service'
-require 'google/apis/core/json_representation'
-require 'google/apis/core/hashable'
-require 'google/apis/errors'
-
-module Google
-  module Apis
-    module AccessapprovalV1beta1
-      
-      class AccessApprovalSettings
-        class Representation < Google::Apis::Core::JsonRepresentation; end
-      
-        include Google::Apis::Core::JsonObjectSupport
-      end
-      
-      class AccessLocations
-        class Representation < Google::Apis::Core::JsonRepresentation; end
-      
-        include Google::Apis::Core::JsonObjectSupport
-      end
-      
-      class AccessReason
-        class Representation < Google::Apis::Core::JsonRepresentation; end
-      
-        include Google::Apis::Core::JsonObjectSupport
-      end
-      
-      class ApprovalRequest
-        class Representation < Google::Apis::Core::JsonRepresentation; end
-      
-        include Google::Apis::Core::JsonObjectSupport
-      end
-      
-      class ApproveApprovalRequestMessage
-        class Representation < Google::Apis::Core::JsonRepresentation; end
-      
-        include Google::Apis::Core::JsonObjectSupport
-      end
-      
-      class ApproveDecision
-        class Representation < Google::Apis::Core::JsonRepresentation; end
-      
-        include Google::Apis::Core::JsonObjectSupport
-      end
-      
-      class DismissApprovalRequestMessage
-        class Representation < Google::Apis::Core::JsonRepresentation; end
-      
-        include Google::Apis::Core::JsonObjectSupport
-      end
-      
-      class DismissDecision
-        class Representation < Google::Apis::Core::JsonRepresentation; end
-      
-        include Google::Apis::Core::JsonObjectSupport
-      end
-      
-      class Empty
-        class Representation < Google::Apis::Core::JsonRepresentation; end
-      
-        include Google::Apis::Core::JsonObjectSupport
-      end
-      
-      class EnrolledService
-        class Representation < Google::Apis::Core::JsonRepresentation; end
-      
-        include Google::Apis::Core::JsonObjectSupport
-      end
-      
-      class ListApprovalRequestsResponse
-        class Representation < Google::Apis::Core::JsonRepresentation; end
-      
-        include Google::Apis::Core::JsonObjectSupport
-      end
-      
-      class ResourceProperties
-        class Representation < Google::Apis::Core::JsonRepresentation; end
-      
-        include Google::Apis::Core::JsonObjectSupport
-      end
-      
-      class AccessApprovalSettings
-        # @private
-        class Representation < Google::Apis::Core::JsonRepresentation
-          property :enrolled_ancestor, as: 'enrolledAncestor'
-          collection :enrolled_services, as: 'enrolledServices', class: Google::Apis::AccessapprovalV1beta1::EnrolledService, decorator: Google::Apis::AccessapprovalV1beta1::EnrolledService::Representation
-      
-          property :name, as: 'name'
-          collection :notification_emails, as: 'notificationEmails'
-        end
-      end
-      
-      class AccessLocations
-        # @private
-        class Representation < Google::Apis::Core::JsonRepresentation
-          property :principal_office_country, as: 'principalOfficeCountry'
-          property :principal_physical_location_country, as: 'principalPhysicalLocationCountry'
-        end
-      end
-      
-      class AccessReason
-        # @private
-        class Representation < Google::Apis::Core::JsonRepresentation
-          property :detail, as: 'detail'
-          property :type, as: 'type'
-        end
-      end
-      
-      class ApprovalRequest
-        # @private
-        class Representation < Google::Apis::Core::JsonRepresentation
-          property :approve, as: 'approve', class: Google::Apis::AccessapprovalV1beta1::ApproveDecision, decorator: Google::Apis::AccessapprovalV1beta1::ApproveDecision::Representation
-      
-          property :dismiss, as: 'dismiss', class: Google::Apis::AccessapprovalV1beta1::DismissDecision, decorator: Google::Apis::AccessapprovalV1beta1::DismissDecision::Representation
-      
-          property :name, as: 'name'
-          property :request_time, as: 'requestTime'
-          property :requested_expiration, as: 'requestedExpiration'
-          property :requested_locations, as: 'requestedLocations', class: Google::Apis::AccessapprovalV1beta1::AccessLocations, decorator: Google::Apis::AccessapprovalV1beta1::AccessLocations::Representation
-      
-          property :requested_reason, as: 'requestedReason', class: Google::Apis::AccessapprovalV1beta1::AccessReason, decorator: Google::Apis::AccessapprovalV1beta1::AccessReason::Representation
-      
-          property :requested_resource_name, as: 'requestedResourceName'
-          property :requested_resource_properties, as: 'requestedResourceProperties', class: Google::Apis::AccessapprovalV1beta1::ResourceProperties, decorator: Google::Apis::AccessapprovalV1beta1::ResourceProperties::Representation
-      
-        end
-      end
-      
-      class ApproveApprovalRequestMessage
-        # @private
-        class Representation < Google::Apis::Core::JsonRepresentation
-          property :expire_time, as: 'expireTime'
-        end
-      end
-      
-      class ApproveDecision
-        # @private
-        class Representation < Google::Apis::Core::JsonRepresentation
-          property :approve_time, as: 'approveTime'
-          property :expire_time, as: 'expireTime'
-        end
-      end
-      
-      class DismissApprovalRequestMessage
-        # @private
-        class Representation < Google::Apis::Core::JsonRepresentation
-        end
-      end
-      
-      class DismissDecision
-        # @private
-        class Representation < Google::Apis::Core::JsonRepresentation
-          property :dismiss_time, as: 'dismissTime'
-        end
-      end
-      
-      class Empty
-        # @private
-        class Representation < Google::Apis::Core::JsonRepresentation
-        end
-      end
-      
-      class EnrolledService
-        # @private
-        class Representation < Google::Apis::Core::JsonRepresentation
-          property :cloud_product, as: 'cloudProduct'
-          property :enrollment_level, as: 'enrollmentLevel'
-        end
-      end
-      
-      class ListApprovalRequestsResponse
-        # @private
-        class Representation < Google::Apis::Core::JsonRepresentation
-          collection :approval_requests, as: 'approvalRequests', class: Google::Apis::AccessapprovalV1beta1::ApprovalRequest, decorator: Google::Apis::AccessapprovalV1beta1::ApprovalRequest::Representation
-      
-          property :next_page_token, as: 'nextPageToken'
-        end
-      end
-      
-      class ResourceProperties
-        # @private
-        class Representation < Google::Apis::Core::JsonRepresentation
-          property :excludes_descendants, as: 'excludesDescendants'
-        end
-      end
-    end
-  end
-end

generated/google/apis/accessapproval_v1beta1/service.rb

@@ -1,857 +0,0 @@
-# Copyright 2015 Google Inc.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#      http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-require 'google/apis/core/base_service'
-require 'google/apis/core/json_representation'
-require 'google/apis/core/hashable'
-require 'google/apis/errors'
-
-module Google
-  module Apis
-    module AccessapprovalV1beta1
-      # Access Approval API
-      #
-      # An API for controlling access to data by Google personnel.
-      #
-      # @example
-      #    require 'google/apis/accessapproval_v1beta1'
-      #
-      #    Accessapproval = Google::Apis::AccessapprovalV1beta1 # Alias the module
-      #    service = Accessapproval::AccessApprovalService.new
-      #
-      # @see https://cloud.google.com/access-approval/docs
-      class AccessApprovalService < Google::Apis::Core::BaseService
-        # @return [String]
-        #  API key. Your API key identifies your project and provides you with API access,
-        #  quota, and reports. Required unless you provide an OAuth 2.0 token.
-        attr_accessor :key
-
-        # @return [String]
-        #  Available to use for quota purposes for server-side applications. Can be any
-        #  arbitrary string assigned to a user, but should not exceed 40 characters.
-        attr_accessor :quota_user
-
-        def initialize
-          super('https://accessapproval.googleapis.com/', '')
-          @batch_path = 'batch'
-        end
-        
-        # Deletes the settings associated with a project, folder, or organization.
-        # This will have the effect of disabling Access Approval for the project,
-        # folder, or organization, but only if all ancestors also have Access
-        # Approval disabled. If Access Approval is enabled at a higher level of the
-        # hierarchy, then Access Approval will still be enabled at this level as
-        # the settings are inherited.
-        # @param [String] name
-        #   Name of the AccessApprovalSettings to delete.
-        # @param [String] fields
-        #   Selector specifying which fields to include in a partial response.
-        # @param [String] quota_user
-        #   Available to use for quota purposes for server-side applications. Can be any
-        #   arbitrary string assigned to a user, but should not exceed 40 characters.
-        # @param [Google::Apis::RequestOptions] options
-        #   Request-specific options
-        #
-        # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::AccessapprovalV1beta1::Empty] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::AccessapprovalV1beta1::Empty]
-        #
-        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
-        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
-        # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def delete_folder_access_approval_settings(name, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:delete, 'v1beta1/{+name}', options)
-          command.response_representation = Google::Apis::AccessapprovalV1beta1::Empty::Representation
-          command.response_class = Google::Apis::AccessapprovalV1beta1::Empty
-          command.params['name'] = name unless name.nil?
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          execute_or_queue_command(command, &block)
-        end
-        
-        # Gets the settings associated with a project, folder, or organization.
-        # @param [String] name
-        #   Name of the AccessApprovalSettings to retrieve.
-        # @param [String] fields
-        #   Selector specifying which fields to include in a partial response.
-        # @param [String] quota_user
-        #   Available to use for quota purposes for server-side applications. Can be any
-        #   arbitrary string assigned to a user, but should not exceed 40 characters.
-        # @param [Google::Apis::RequestOptions] options
-        #   Request-specific options
-        #
-        # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::AccessapprovalV1beta1::AccessApprovalSettings] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::AccessapprovalV1beta1::AccessApprovalSettings]
-        #
-        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
-        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
-        # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def get_folder_access_approval_settings(name, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:get, 'v1beta1/{+name}', options)
-          command.response_representation = Google::Apis::AccessapprovalV1beta1::AccessApprovalSettings::Representation
-          command.response_class = Google::Apis::AccessapprovalV1beta1::AccessApprovalSettings
-          command.params['name'] = name unless name.nil?
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          execute_or_queue_command(command, &block)
-        end
-        
-        # Updates the settings associated with a project, folder, or organization.
-        # Settings to update are determined by the value of field_mask.
-        # @param [String] name
-        #   The resource name of the settings. Format is one of:
-        #   <ol>
-        #   <li>"projects/`project_id`/accessApprovalSettings"</li>
-        #   <li>"folders/`folder_id`/accessApprovalSettings"</li>
-        #   <li>"organizations/`organization_id`/accessApprovalSettings"</li>
-        #   <ol>
-        # @param [Google::Apis::AccessapprovalV1beta1::AccessApprovalSettings] access_approval_settings_object
-        # @param [String] update_mask
-        #   For the `FieldMask` definition, see
-        #   https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
-        #   fieldmask
-        #   If this field is left unset, only the notification_emails field will be
-        #   updated.
-        # @param [String] fields
-        #   Selector specifying which fields to include in a partial response.
-        # @param [String] quota_user
-        #   Available to use for quota purposes for server-side applications. Can be any
-        #   arbitrary string assigned to a user, but should not exceed 40 characters.
-        # @param [Google::Apis::RequestOptions] options
-        #   Request-specific options
-        #
-        # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::AccessapprovalV1beta1::AccessApprovalSettings] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::AccessapprovalV1beta1::AccessApprovalSettings]
-        #
-        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
-        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
-        # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def update_folder_access_approval_settings(name, access_approval_settings_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:patch, 'v1beta1/{+name}', options)
-          command.request_representation = Google::Apis::AccessapprovalV1beta1::AccessApprovalSettings::Representation
-          command.request_object = access_approval_settings_object
-          command.response_representation = Google::Apis::AccessapprovalV1beta1::AccessApprovalSettings::Representation
-          command.response_class = Google::Apis::AccessapprovalV1beta1::AccessApprovalSettings
-          command.params['name'] = name unless name.nil?
-          command.query['updateMask'] = update_mask unless update_mask.nil?
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          execute_or_queue_command(command, &block)
-        end
-        
-        # Approves a request and returns the updated ApprovalRequest.
-        # Returns NOT_FOUND if the request does not exist. Returns
-        # FAILED_PRECONDITION if the request exists but is not in a pending state.
-        # @param [String] name
-        #   Name of the approval request to approve.
-        # @param [Google::Apis::AccessapprovalV1beta1::ApproveApprovalRequestMessage] approve_approval_request_message_object
-        # @param [String] fields
-        #   Selector specifying which fields to include in a partial response.
-        # @param [String] quota_user
-        #   Available to use for quota purposes for server-side applications. Can be any
-        #   arbitrary string assigned to a user, but should not exceed 40 characters.
-        # @param [Google::Apis::RequestOptions] options
-        #   Request-specific options
-        #
-        # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::AccessapprovalV1beta1::ApprovalRequest] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::AccessapprovalV1beta1::ApprovalRequest]
-        #
-        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
-        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
-        # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def approve_folder_approval_request(name, approve_approval_request_message_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:post, 'v1beta1/{+name}:approve', options)
-          command.request_representation = Google::Apis::AccessapprovalV1beta1::ApproveApprovalRequestMessage::Representation
-          command.request_object = approve_approval_request_message_object
-          command.response_representation = Google::Apis::AccessapprovalV1beta1::ApprovalRequest::Representation
-          command.response_class = Google::Apis::AccessapprovalV1beta1::ApprovalRequest
-          command.params['name'] = name unless name.nil?
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          execute_or_queue_command(command, &block)
-        end
-        
-        # Dismisses a request. Returns the updated ApprovalRequest.
-        # NOTE: This does not deny access to the resource if another request has been
-        # made and approved. It is equivalent in effect to ignoring the request
-        # altogether.
-        # Returns NOT_FOUND if the request does not exist.
-        # Returns FAILED_PRECONDITION if the request exists but is not in a pending
-        # state.
-        # @param [String] name
-        #   Name of the ApprovalRequest to dismiss.
-        # @param [Google::Apis::AccessapprovalV1beta1::DismissApprovalRequestMessage] dismiss_approval_request_message_object
-        # @param [String] fields
-        #   Selector specifying which fields to include in a partial response.
-        # @param [String] quota_user
-        #   Available to use for quota purposes for server-side applications. Can be any
-        #   arbitrary string assigned to a user, but should not exceed 40 characters.
-        # @param [Google::Apis::RequestOptions] options
-        #   Request-specific options
-        #
-        # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::AccessapprovalV1beta1::ApprovalRequest] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::AccessapprovalV1beta1::ApprovalRequest]
-        #
-        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
-        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
-        # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def dismiss_folder_approval_request(name, dismiss_approval_request_message_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:post, 'v1beta1/{+name}:dismiss', options)
-          command.request_representation = Google::Apis::AccessapprovalV1beta1::DismissApprovalRequestMessage::Representation
-          command.request_object = dismiss_approval_request_message_object
-          command.response_representation = Google::Apis::AccessapprovalV1beta1::ApprovalRequest::Representation
-          command.response_class = Google::Apis::AccessapprovalV1beta1::ApprovalRequest
-          command.params['name'] = name unless name.nil?
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          execute_or_queue_command(command, &block)
-        end
-        
-        # Gets an approval request. Returns NOT_FOUND if the request does not exist.
-        # @param [String] name
-        #   Name of the approval request to retrieve.
-        # @param [String] fields
-        #   Selector specifying which fields to include in a partial response.
-        # @param [String] quota_user
-        #   Available to use for quota purposes for server-side applications. Can be any
-        #   arbitrary string assigned to a user, but should not exceed 40 characters.
-        # @param [Google::Apis::RequestOptions] options
-        #   Request-specific options
-        #
-        # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::AccessapprovalV1beta1::ApprovalRequest] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::AccessapprovalV1beta1::ApprovalRequest]
-        #
-        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
-        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
-        # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def get_folder_approval_request(name, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:get, 'v1beta1/{+name}', options)
-          command.response_representation = Google::Apis::AccessapprovalV1beta1::ApprovalRequest::Representation
-          command.response_class = Google::Apis::AccessapprovalV1beta1::ApprovalRequest
-          command.params['name'] = name unless name.nil?
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          execute_or_queue_command(command, &block)
-        end
-        
-        # Lists approval requests associated with a project, folder, or organization.
-        # Approval requests can be filtered by state (pending, active, dismissed).
-        # The order is reverse chronological.
-        # @param [String] parent
-        #   The parent resource. This may be "projects/`project_id`",
-        #   "folders/`folder_id`", or "organizations/`organization_id`".
-        # @param [String] filter
-        #   A filter on the type of approval requests to retrieve. Must be one of the
-        #   following values:
-        #   <ol>
-        #   <li>[not set]: Requests that are pending or have active approvals.</li>
-        #   <li>ALL: All requests.</li>
-        #   <li>PENDING: Only pending requests.</li>
-        #   <li>ACTIVE: Only active (i.e. currently approved) requests.</li>
-        #   <li>DISMISSED: Only dismissed (including expired) requests.</li>
-        #   <li>HISTORY: Active and dismissed (including expired) requests.</li>
-        #   </ol>
-        # @param [Fixnum] page_size
-        #   Requested page size.
-        # @param [String] page_token
-        #   A token identifying the page of results to return.
-        # @param [String] fields
-        #   Selector specifying which fields to include in a partial response.
-        # @param [String] quota_user
-        #   Available to use for quota purposes for server-side applications. Can be any
-        #   arbitrary string assigned to a user, but should not exceed 40 characters.
-        # @param [Google::Apis::RequestOptions] options
-        #   Request-specific options
-        #
-        # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::AccessapprovalV1beta1::ListApprovalRequestsResponse] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::AccessapprovalV1beta1::ListApprovalRequestsResponse]
-        #
-        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
-        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
-        # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def list_folder_approval_requests(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:get, 'v1beta1/{+parent}/approvalRequests', options)
-          command.response_representation = Google::Apis::AccessapprovalV1beta1::ListApprovalRequestsResponse::Representation
-          command.response_class = Google::Apis::AccessapprovalV1beta1::ListApprovalRequestsResponse
-          command.params['parent'] = parent unless parent.nil?
-          command.query['filter'] = filter unless filter.nil?
-          command.query['pageSize'] = page_size unless page_size.nil?
-          command.query['pageToken'] = page_token unless page_token.nil?
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          execute_or_queue_command(command, &block)
-        end
-        
-        # Deletes the settings associated with a project, folder, or organization.
-        # This will have the effect of disabling Access Approval for the project,
-        # folder, or organization, but only if all ancestors also have Access
-        # Approval disabled. If Access Approval is enabled at a higher level of the
-        # hierarchy, then Access Approval will still be enabled at this level as
-        # the settings are inherited.
-        # @param [String] name
-        #   Name of the AccessApprovalSettings to delete.
-        # @param [String] fields
-        #   Selector specifying which fields to include in a partial response.
-        # @param [String] quota_user
-        #   Available to use for quota purposes for server-side applications. Can be any
-        #   arbitrary string assigned to a user, but should not exceed 40 characters.
-        # @param [Google::Apis::RequestOptions] options
-        #   Request-specific options
-        #
-        # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::AccessapprovalV1beta1::Empty] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::AccessapprovalV1beta1::Empty]
-        #
-        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
-        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
-        # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def delete_organization_access_approval_settings(name, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:delete, 'v1beta1/{+name}', options)
-          command.response_representation = Google::Apis::AccessapprovalV1beta1::Empty::Representation
-          command.response_class = Google::Apis::AccessapprovalV1beta1::Empty
-          command.params['name'] = name unless name.nil?
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          execute_or_queue_command(command, &block)
-        end
-        
-        # Gets the settings associated with a project, folder, or organization.
-        # @param [String] name
-        #   Name of the AccessApprovalSettings to retrieve.
-        # @param [String] fields
-        #   Selector specifying which fields to include in a partial response.
-        # @param [String] quota_user
-        #   Available to use for quota purposes for server-side applications. Can be any
-        #   arbitrary string assigned to a user, but should not exceed 40 characters.
-        # @param [Google::Apis::RequestOptions] options
-        #   Request-specific options
-        #
-        # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::AccessapprovalV1beta1::AccessApprovalSettings] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::AccessapprovalV1beta1::AccessApprovalSettings]
-        #
-        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
-        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
-        # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def get_organization_access_approval_settings(name, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:get, 'v1beta1/{+name}', options)
-          command.response_representation = Google::Apis::AccessapprovalV1beta1::AccessApprovalSettings::Representation
-          command.response_class = Google::Apis::AccessapprovalV1beta1::AccessApprovalSettings
-          command.params['name'] = name unless name.nil?
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          execute_or_queue_command(command, &block)
-        end
-        
-        # Updates the settings associated with a project, folder, or organization.
-        # Settings to update are determined by the value of field_mask.
-        # @param [String] name
-        #   The resource name of the settings. Format is one of:
-        #   <ol>
-        #   <li>"projects/`project_id`/accessApprovalSettings"</li>
-        #   <li>"folders/`folder_id`/accessApprovalSettings"</li>
-        #   <li>"organizations/`organization_id`/accessApprovalSettings"</li>
-        #   <ol>
-        # @param [Google::Apis::AccessapprovalV1beta1::AccessApprovalSettings] access_approval_settings_object
-        # @param [String] update_mask
-        #   For the `FieldMask` definition, see
-        #   https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
-        #   fieldmask
-        #   If this field is left unset, only the notification_emails field will be
-        #   updated.
-        # @param [String] fields
-        #   Selector specifying which fields to include in a partial response.
-        # @param [String] quota_user
-        #   Available to use for quota purposes for server-side applications. Can be any
-        #   arbitrary string assigned to a user, but should not exceed 40 characters.
-        # @param [Google::Apis::RequestOptions] options
-        #   Request-specific options
-        #
-        # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::AccessapprovalV1beta1::AccessApprovalSettings] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::AccessapprovalV1beta1::AccessApprovalSettings]
-        #
-        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
-        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
-        # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def update_organization_access_approval_settings(name, access_approval_settings_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:patch, 'v1beta1/{+name}', options)
-          command.request_representation = Google::Apis::AccessapprovalV1beta1::AccessApprovalSettings::Representation
-          command.request_object = access_approval_settings_object
-          command.response_representation = Google::Apis::AccessapprovalV1beta1::AccessApprovalSettings::Representation
-          command.response_class = Google::Apis::AccessapprovalV1beta1::AccessApprovalSettings
-          command.params['name'] = name unless name.nil?
-          command.query['updateMask'] = update_mask unless update_mask.nil?
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          execute_or_queue_command(command, &block)
-        end
-        
-        # Approves a request and returns the updated ApprovalRequest.
-        # Returns NOT_FOUND if the request does not exist. Returns
-        # FAILED_PRECONDITION if the request exists but is not in a pending state.
-        # @param [String] name
-        #   Name of the approval request to approve.
-        # @param [Google::Apis::AccessapprovalV1beta1::ApproveApprovalRequestMessage] approve_approval_request_message_object
-        # @param [String] fields
-        #   Selector specifying which fields to include in a partial response.
-        # @param [String] quota_user
-        #   Available to use for quota purposes for server-side applications. Can be any
-        #   arbitrary string assigned to a user, but should not exceed 40 characters.
-        # @param [Google::Apis::RequestOptions] options
-        #   Request-specific options
-        #
-        # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::AccessapprovalV1beta1::ApprovalRequest] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::AccessapprovalV1beta1::ApprovalRequest]
-        #
-        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
-        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
-        # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def approve_organization_approval_request(name, approve_approval_request_message_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:post, 'v1beta1/{+name}:approve', options)
-          command.request_representation = Google::Apis::AccessapprovalV1beta1::ApproveApprovalRequestMessage::Representation
-          command.request_object = approve_approval_request_message_object
-          command.response_representation = Google::Apis::AccessapprovalV1beta1::ApprovalRequest::Representation
-          command.response_class = Google::Apis::AccessapprovalV1beta1::ApprovalRequest
-          command.params['name'] = name unless name.nil?
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          execute_or_queue_command(command, &block)
-        end
-        
-        # Dismisses a request. Returns the updated ApprovalRequest.
-        # NOTE: This does not deny access to the resource if another request has been
-        # made and approved. It is equivalent in effect to ignoring the request
-        # altogether.
-        # Returns NOT_FOUND if the request does not exist.
-        # Returns FAILED_PRECONDITION if the request exists but is not in a pending
-        # state.
-        # @param [String] name
-        #   Name of the ApprovalRequest to dismiss.
-        # @param [Google::Apis::AccessapprovalV1beta1::DismissApprovalRequestMessage] dismiss_approval_request_message_object
-        # @param [String] fields
-        #   Selector specifying which fields to include in a partial response.
-        # @param [String] quota_user
-        #   Available to use for quota purposes for server-side applications. Can be any
-        #   arbitrary string assigned to a user, but should not exceed 40 characters.
-        # @param [Google::Apis::RequestOptions] options
-        #   Request-specific options
-        #
-        # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::AccessapprovalV1beta1::ApprovalRequest] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::AccessapprovalV1beta1::ApprovalRequest]
-        #
-        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
-        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
-        # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def dismiss_organization_approval_request(name, dismiss_approval_request_message_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:post, 'v1beta1/{+name}:dismiss', options)
-          command.request_representation = Google::Apis::AccessapprovalV1beta1::DismissApprovalRequestMessage::Representation
-          command.request_object = dismiss_approval_request_message_object
-          command.response_representation = Google::Apis::AccessapprovalV1beta1::ApprovalRequest::Representation
-          command.response_class = Google::Apis::AccessapprovalV1beta1::ApprovalRequest
-          command.params['name'] = name unless name.nil?
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          execute_or_queue_command(command, &block)
-        end
-        
-        # Gets an approval request. Returns NOT_FOUND if the request does not exist.
-        # @param [String] name
-        #   Name of the approval request to retrieve.
-        # @param [String] fields
-        #   Selector specifying which fields to include in a partial response.
-        # @param [String] quota_user
-        #   Available to use for quota purposes for server-side applications. Can be any
-        #   arbitrary string assigned to a user, but should not exceed 40 characters.
-        # @param [Google::Apis::RequestOptions] options
-        #   Request-specific options
-        #
-        # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::AccessapprovalV1beta1::ApprovalRequest] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::AccessapprovalV1beta1::ApprovalRequest]
-        #
-        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
-        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
-        # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def get_organization_approval_request(name, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:get, 'v1beta1/{+name}', options)
-          command.response_representation = Google::Apis::AccessapprovalV1beta1::ApprovalRequest::Representation
-          command.response_class = Google::Apis::AccessapprovalV1beta1::ApprovalRequest
-          command.params['name'] = name unless name.nil?
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          execute_or_queue_command(command, &block)
-        end
-        
-        # Lists approval requests associated with a project, folder, or organization.
-        # Approval requests can be filtered by state (pending, active, dismissed).
-        # The order is reverse chronological.
-        # @param [String] parent
-        #   The parent resource. This may be "projects/`project_id`",
-        #   "folders/`folder_id`", or "organizations/`organization_id`".
-        # @param [String] filter
-        #   A filter on the type of approval requests to retrieve. Must be one of the
-        #   following values:
-        #   <ol>
-        #   <li>[not set]: Requests that are pending or have active approvals.</li>
-        #   <li>ALL: All requests.</li>
-        #   <li>PENDING: Only pending requests.</li>
-        #   <li>ACTIVE: Only active (i.e. currently approved) requests.</li>
-        #   <li>DISMISSED: Only dismissed (including expired) requests.</li>
-        #   <li>HISTORY: Active and dismissed (including expired) requests.</li>
-        #   </ol>
-        # @param [Fixnum] page_size
-        #   Requested page size.
-        # @param [String] page_token
-        #   A token identifying the page of results to return.
-        # @param [String] fields
-        #   Selector specifying which fields to include in a partial response.
-        # @param [String] quota_user
-        #   Available to use for quota purposes for server-side applications. Can be any
-        #   arbitrary string assigned to a user, but should not exceed 40 characters.
-        # @param [Google::Apis::RequestOptions] options
-        #   Request-specific options
-        #
-        # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::AccessapprovalV1beta1::ListApprovalRequestsResponse] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::AccessapprovalV1beta1::ListApprovalRequestsResponse]
-        #
-        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
-        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
-        # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def list_organization_approval_requests(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:get, 'v1beta1/{+parent}/approvalRequests', options)
-          command.response_representation = Google::Apis::AccessapprovalV1beta1::ListApprovalRequestsResponse::Representation
-          command.response_class = Google::Apis::AccessapprovalV1beta1::ListApprovalRequestsResponse
-          command.params['parent'] = parent unless parent.nil?
-          command.query['filter'] = filter unless filter.nil?
-          command.query['pageSize'] = page_size unless page_size.nil?
-          command.query['pageToken'] = page_token unless page_token.nil?
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          execute_or_queue_command(command, &block)
-        end
-        
-        # Deletes the settings associated with a project, folder, or organization.
-        # This will have the effect of disabling Access Approval for the project,
-        # folder, or organization, but only if all ancestors also have Access
-        # Approval disabled. If Access Approval is enabled at a higher level of the
-        # hierarchy, then Access Approval will still be enabled at this level as
-        # the settings are inherited.
-        # @param [String] name
-        #   Name of the AccessApprovalSettings to delete.
-        # @param [String] fields
-        #   Selector specifying which fields to include in a partial response.
-        # @param [String] quota_user
-        #   Available to use for quota purposes for server-side applications. Can be any
-        #   arbitrary string assigned to a user, but should not exceed 40 characters.
-        # @param [Google::Apis::RequestOptions] options
-        #   Request-specific options
-        #
-        # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::AccessapprovalV1beta1::Empty] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::AccessapprovalV1beta1::Empty]
-        #
-        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
-        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
-        # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def delete_project_access_approval_settings(name, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:delete, 'v1beta1/{+name}', options)
-          command.response_representation = Google::Apis::AccessapprovalV1beta1::Empty::Representation
-          command.response_class = Google::Apis::AccessapprovalV1beta1::Empty
-          command.params['name'] = name unless name.nil?
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          execute_or_queue_command(command, &block)
-        end
-        
-        # Gets the settings associated with a project, folder, or organization.
-        # @param [String] name
-        #   Name of the AccessApprovalSettings to retrieve.
-        # @param [String] fields
-        #   Selector specifying which fields to include in a partial response.
-        # @param [String] quota_user
-        #   Available to use for quota purposes for server-side applications. Can be any
-        #   arbitrary string assigned to a user, but should not exceed 40 characters.
-        # @param [Google::Apis::RequestOptions] options
-        #   Request-specific options
-        #
-        # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::AccessapprovalV1beta1::AccessApprovalSettings] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::AccessapprovalV1beta1::AccessApprovalSettings]
-        #
-        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
-        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
-        # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def get_project_access_approval_settings(name, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:get, 'v1beta1/{+name}', options)
-          command.response_representation = Google::Apis::AccessapprovalV1beta1::AccessApprovalSettings::Representation
-          command.response_class = Google::Apis::AccessapprovalV1beta1::AccessApprovalSettings
-          command.params['name'] = name unless name.nil?
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          execute_or_queue_command(command, &block)
-        end
-        
-        # Updates the settings associated with a project, folder, or organization.
-        # Settings to update are determined by the value of field_mask.
-        # @param [String] name
-        #   The resource name of the settings. Format is one of:
-        #   <ol>
-        #   <li>"projects/`project_id`/accessApprovalSettings"</li>
-        #   <li>"folders/`folder_id`/accessApprovalSettings"</li>
-        #   <li>"organizations/`organization_id`/accessApprovalSettings"</li>
-        #   <ol>
-        # @param [Google::Apis::AccessapprovalV1beta1::AccessApprovalSettings] access_approval_settings_object
-        # @param [String] update_mask
-        #   For the `FieldMask` definition, see
-        #   https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
-        #   fieldmask
-        #   If this field is left unset, only the notification_emails field will be
-        #   updated.
-        # @param [String] fields
-        #   Selector specifying which fields to include in a partial response.
-        # @param [String] quota_user
-        #   Available to use for quota purposes for server-side applications. Can be any
-        #   arbitrary string assigned to a user, but should not exceed 40 characters.
-        # @param [Google::Apis::RequestOptions] options
-        #   Request-specific options
-        #
-        # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::AccessapprovalV1beta1::AccessApprovalSettings] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::AccessapprovalV1beta1::AccessApprovalSettings]
-        #
-        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
-        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
-        # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def update_project_access_approval_settings(name, access_approval_settings_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:patch, 'v1beta1/{+name}', options)
-          command.request_representation = Google::Apis::AccessapprovalV1beta1::AccessApprovalSettings::Representation
-          command.request_object = access_approval_settings_object
-          command.response_representation = Google::Apis::AccessapprovalV1beta1::AccessApprovalSettings::Representation
-          command.response_class = Google::Apis::AccessapprovalV1beta1::AccessApprovalSettings
-          command.params['name'] = name unless name.nil?
-          command.query['updateMask'] = update_mask unless update_mask.nil?
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          execute_or_queue_command(command, &block)
-        end
-        
-        # Approves a request and returns the updated ApprovalRequest.
-        # Returns NOT_FOUND if the request does not exist. Returns
-        # FAILED_PRECONDITION if the request exists but is not in a pending state.
-        # @param [String] name
-        #   Name of the approval request to approve.
-        # @param [Google::Apis::AccessapprovalV1beta1::ApproveApprovalRequestMessage] approve_approval_request_message_object
-        # @param [String] fields
-        #   Selector specifying which fields to include in a partial response.
-        # @param [String] quota_user
-        #   Available to use for quota purposes for server-side applications. Can be any
-        #   arbitrary string assigned to a user, but should not exceed 40 characters.
-        # @param [Google::Apis::RequestOptions] options
-        #   Request-specific options
-        #
-        # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::AccessapprovalV1beta1::ApprovalRequest] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::AccessapprovalV1beta1::ApprovalRequest]
-        #
-        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
-        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
-        # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def approve_project_approval_request(name, approve_approval_request_message_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:post, 'v1beta1/{+name}:approve', options)
-          command.request_representation = Google::Apis::AccessapprovalV1beta1::ApproveApprovalRequestMessage::Representation
-          command.request_object = approve_approval_request_message_object
-          command.response_representation = Google::Apis::AccessapprovalV1beta1::ApprovalRequest::Representation
-          command.response_class = Google::Apis::AccessapprovalV1beta1::ApprovalRequest
-          command.params['name'] = name unless name.nil?
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          execute_or_queue_command(command, &block)
-        end
-        
-        # Dismisses a request. Returns the updated ApprovalRequest.
-        # NOTE: This does not deny access to the resource if another request has been
-        # made and approved. It is equivalent in effect to ignoring the request
-        # altogether.
-        # Returns NOT_FOUND if the request does not exist.
-        # Returns FAILED_PRECONDITION if the request exists but is not in a pending
-        # state.
-        # @param [String] name
-        #   Name of the ApprovalRequest to dismiss.
-        # @param [Google::Apis::AccessapprovalV1beta1::DismissApprovalRequestMessage] dismiss_approval_request_message_object
-        # @param [String] fields
-        #   Selector specifying which fields to include in a partial response.
-        # @param [String] quota_user
-        #   Available to use for quota purposes for server-side applications. Can be any
-        #   arbitrary string assigned to a user, but should not exceed 40 characters.
-        # @param [Google::Apis::RequestOptions] options
-        #   Request-specific options
-        #
-        # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::AccessapprovalV1beta1::ApprovalRequest] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::AccessapprovalV1beta1::ApprovalRequest]
-        #
-        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
-        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
-        # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def dismiss_project_approval_request(name, dismiss_approval_request_message_object = nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:post, 'v1beta1/{+name}:dismiss', options)
-          command.request_representation = Google::Apis::AccessapprovalV1beta1::DismissApprovalRequestMessage::Representation
-          command.request_object = dismiss_approval_request_message_object
-          command.response_representation = Google::Apis::AccessapprovalV1beta1::ApprovalRequest::Representation
-          command.response_class = Google::Apis::AccessapprovalV1beta1::ApprovalRequest
-          command.params['name'] = name unless name.nil?
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          execute_or_queue_command(command, &block)
-        end
-        
-        # Gets an approval request. Returns NOT_FOUND if the request does not exist.
-        # @param [String] name
-        #   Name of the approval request to retrieve.
-        # @param [String] fields
-        #   Selector specifying which fields to include in a partial response.
-        # @param [String] quota_user
-        #   Available to use for quota purposes for server-side applications. Can be any
-        #   arbitrary string assigned to a user, but should not exceed 40 characters.
-        # @param [Google::Apis::RequestOptions] options
-        #   Request-specific options
-        #
-        # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::AccessapprovalV1beta1::ApprovalRequest] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::AccessapprovalV1beta1::ApprovalRequest]
-        #
-        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
-        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
-        # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def get_project_approval_request(name, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:get, 'v1beta1/{+name}', options)
-          command.response_representation = Google::Apis::AccessapprovalV1beta1::ApprovalRequest::Representation
-          command.response_class = Google::Apis::AccessapprovalV1beta1::ApprovalRequest
-          command.params['name'] = name unless name.nil?
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          execute_or_queue_command(command, &block)
-        end
-        
-        # Lists approval requests associated with a project, folder, or organization.
-        # Approval requests can be filtered by state (pending, active, dismissed).
-        # The order is reverse chronological.
-        # @param [String] parent
-        #   The parent resource. This may be "projects/`project_id`",
-        #   "folders/`folder_id`", or "organizations/`organization_id`".
-        # @param [String] filter
-        #   A filter on the type of approval requests to retrieve. Must be one of the
-        #   following values:
-        #   <ol>
-        #   <li>[not set]: Requests that are pending or have active approvals.</li>
-        #   <li>ALL: All requests.</li>
-        #   <li>PENDING: Only pending requests.</li>
-        #   <li>ACTIVE: Only active (i.e. currently approved) requests.</li>
-        #   <li>DISMISSED: Only dismissed (including expired) requests.</li>
-        #   <li>HISTORY: Active and dismissed (including expired) requests.</li>
-        #   </ol>
-        # @param [Fixnum] page_size
-        #   Requested page size.
-        # @param [String] page_token
-        #   A token identifying the page of results to return.
-        # @param [String] fields
-        #   Selector specifying which fields to include in a partial response.
-        # @param [String] quota_user
-        #   Available to use for quota purposes for server-side applications. Can be any
-        #   arbitrary string assigned to a user, but should not exceed 40 characters.
-        # @param [Google::Apis::RequestOptions] options
-        #   Request-specific options
-        #
-        # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::AccessapprovalV1beta1::ListApprovalRequestsResponse] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::AccessapprovalV1beta1::ListApprovalRequestsResponse]
-        #
-        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
-        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
-        # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def list_project_approval_requests(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:get, 'v1beta1/{+parent}/approvalRequests', options)
-          command.response_representation = Google::Apis::AccessapprovalV1beta1::ListApprovalRequestsResponse::Representation
-          command.response_class = Google::Apis::AccessapprovalV1beta1::ListApprovalRequestsResponse
-          command.params['parent'] = parent unless parent.nil?
-          command.query['filter'] = filter unless filter.nil?
-          command.query['pageSize'] = page_size unless page_size.nil?
-          command.query['pageToken'] = page_token unless page_token.nil?
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          execute_or_queue_command(command, &block)
-        end
-
-        protected
-
-        def apply_command_defaults(command)
-          command.query['key'] = key unless key.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-        end
-      end
-    end
-  end
-end

generated/google/apis/appsmarket_v2.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://developers.google.com/apps-marketplace
     module AppsmarketV2
       VERSION = 'V2'
-      REVISION = '20200803'
+      REVISION = '20200810'
 
       # View your installed application's licensing information
       AUTH_APPSMARKETPLACE_LICENSE = 'https://www.googleapis.com/auth/appsmarketplace.license'

generated/google/apis/bigquery_v2.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/bigquery/
     module BigqueryV2
       VERSION = 'V2'
-      REVISION = '20200719'
+      REVISION = '20200805'
 
       # View and manage your data in Google BigQuery
       AUTH_BIGQUERY = 'https://www.googleapis.com/auth/bigquery'

generated/google/apis/bigquery_v2/representations.rb

@@ -2376,6 +2376,7 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :auto_arima, as: 'autoArima'
+          property :auto_arima_max_order, :numeric_string => true, as: 'autoArimaMaxOrder'
           property :batch_size, :numeric_string => true, as: 'batchSize'
           property :data_frequency, as: 'dataFrequency'
           property :data_split_column, as: 'dataSplitColumn'

generated/google/apis/bigquery_v2/service.rb

@@ -657,18 +657,16 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists all models in the specified dataset. Requires the READER dataset
+        # Lists all models in the specified dataset. Requires the READER dataset role.
-        # role.
         # @param [String] project_id
         #   Required. Project ID of the models to list.
         # @param [String] dataset_id
         #   Required. Dataset ID of the models to list.
         # @param [Fixnum] max_results
-        #   The maximum number of results to return in a single response page.
+        #   The maximum number of results to return in a single response page. Leverage
-        #   Leverage the page tokens to iterate through the entire collection.
+        #   the page tokens to iterate through the entire collection.
         # @param [String] page_token
-        #   Page token, returned by a previous call to request the next page of
+        #   Page token, returned by a previous call to request the next page of results
-        #   results
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -859,8 +857,8 @@ module Google
         # @param [String] routine_id
         #   Required. Routine ID of the requested routine
         # @param [String] read_mask
-        #   If set, only the Routine fields in the field mask are returned in the
+        #   If set, only the Routine fields in the field mask are returned in the response.
-        #   response. If unset, all Routine fields are returned.
+        #   If unset, all Routine fields are returned.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -933,29 +931,25 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists all routines in the specified dataset. Requires the READER dataset
+        # Lists all routines in the specified dataset. Requires the READER dataset role.
-        # role.
         # @param [String] project_id
         #   Required. Project ID of the routines to list
         # @param [String] dataset_id
         #   Required. Dataset ID of the routines to list
         # @param [String] filter
-        #   If set, then only the Routines matching this filter are returned.
+        #   If set, then only the Routines matching this filter are returned. The current
-        #   The current supported form is either "routine_type:<RoutineType>" or
+        #   supported form is either "routine_type:" or "routineType:", where is a
-        #   "routineType:<RoutineType>", where <RoutineType> is a RoutineType enum.
+        #   RoutineType enum. Example: "routineType:SCALAR_FUNCTION".
-        #   Example: "routineType:SCALAR_FUNCTION".
         # @param [Fixnum] max_results
-        #   The maximum number of results to return in a single response page.
+        #   The maximum number of results to return in a single response page. Leverage
-        #   Leverage the page tokens to iterate through the entire collection.
+        #   the page tokens to iterate through the entire collection.
         # @param [String] page_token
-        #   Page token, returned by a previous call, to request the next page of
+        #   Page token, returned by a previous call, to request the next page of results
-        #   results
         # @param [String] read_mask
-        #   If set, then only the Routine fields in the field mask, as well as
+        #   If set, then only the Routine fields in the field mask, as well as project_id,
-        #   project_id, dataset_id and routine_id, are returned in the response.
+        #   dataset_id and routine_id, are returned in the response. If unset, then the
-        #   If unset, then the following Routine fields are returned:
+        #   following Routine fields are returned: etag, project_id, dataset_id,
-        #   etag, project_id, dataset_id, routine_id, routine_type, creation_time,
+        #   routine_id, routine_type, creation_time, last_modified_time, and language.
-        #   last_modified_time, and language.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1213,12 +1207,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the access control policy for a resource.
+        # Gets the access control policy for a resource. Returns an empty policy if the
-        # Returns an empty policy if the resource exists and does not have a policy
+        # resource exists and does not have a policy set.
-        # set.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being requested.
+        #   REQUIRED: The resource for which the policy is being requested. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::BigqueryV2::GetIamPolicyRequest] get_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1378,11 +1371,11 @@ module Google
         end
         
         # Sets the access control policy on the specified resource. Replaces any
-        # existing policy.
+        # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
-        # Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.
+        # PERMISSION_DENIED` errors.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being specified.
+        #   REQUIRED: The resource for which the policy is being specified. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::BigqueryV2::SetIamPolicyRequest] set_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1416,15 +1409,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns permissions that a caller has on the specified resource.
+        # Returns permissions that a caller has on the specified resource. If the
-        # If the resource does not exist, this will return an empty set of
+        # resource does not exist, this will return an empty set of permissions, not a `
-        # permissions, not a `NOT_FOUND` error.
+        # NOT_FOUND` error. Note: This operation is designed to be used for building
-        # Note: This operation is designed to be used for building permission-aware
+        # permission-aware UIs and command-line tools, not for authorization checking.
-        # UIs and command-line tools, not for authorization checking. This operation
+        # This operation may "fail open" without warning.
-        # may "fail open" without warning.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy detail is being requested.
+        #   REQUIRED: The resource for which the policy detail is being requested. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::BigqueryV2::TestIamPermissionsRequest] test_iam_permissions_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.

generated/google/apis/bigqueryconnection_v1beta1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/bigquery/
     module BigqueryconnectionV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20200617'
+      REVISION = '20200805'
 
       # View and manage your data in Google BigQuery
       AUTH_BIGQUERY = 'https://www.googleapis.com/auth/bigquery'

generated/google/apis/bigqueryconnection_v1beta1/classes.rb

@@ -22,53 +22,21 @@ module Google
   module Apis
     module BigqueryconnectionV1beta1
       
-      # Specifies the audit configuration for a service.
+      # Specifies the audit configuration for a service. The configuration determines
-      # The configuration determines which permission types are logged, and what
+      # which permission types are logged, and what identities, if any, are exempted
-      # identities, if any, are exempted from logging.
+      # from logging. An AuditConfig must have one or more AuditLogConfigs. If there
-      # An AuditConfig must have one or more AuditLogConfigs.
+      # are AuditConfigs for both `allServices` and a specific service, the union of
-      # If there are AuditConfigs for both `allServices` and a specific service,
+      # the two AuditConfigs is used for that service: the log_types specified in each
-      # the union of the two AuditConfigs is used for that service: the log_types
+      # AuditConfig are enabled, and the exempted_members in each AuditLogConfig are
-      # specified in each AuditConfig are enabled, and the exempted_members in each
+      # exempted. Example Policy with multiple AuditConfigs: ` "audit_configs": [ ` "
-      # AuditLogConfig are exempted.
+      # service": "allServices", "audit_log_configs": [ ` "log_type": "DATA_READ", "
-      # Example Policy with multiple AuditConfigs:
+      # exempted_members": [ "user:jose@example.com" ] `, ` "log_type": "DATA_WRITE" `,
-      # `
+      # ` "log_type": "ADMIN_READ" ` ] `, ` "service": "sampleservice.googleapis.com",
-      # "audit_configs": [
+      # "audit_log_configs": [ ` "log_type": "DATA_READ" `, ` "log_type": "DATA_WRITE"
-      # `
+      # , "exempted_members": [ "user:aliya@example.com" ] ` ] ` ] ` For sampleservice,
-      # "service": "allServices",
+      # this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also
-      # "audit_log_configs": [
+      # exempts jose@example.com from DATA_READ logging, and aliya@example.com from
-      # `
+      # DATA_WRITE logging.
-      # "log_type": "DATA_READ",
-      # "exempted_members": [
-      # "user:jose@example.com"
-      # ]
-      # `,
-      # `
-      # "log_type": "DATA_WRITE"
-      # `,
-      # `
-      # "log_type": "ADMIN_READ"
-      # `
-      # ]
-      # `,
-      # `
-      # "service": "sampleservice.googleapis.com",
-      # "audit_log_configs": [
-      # `
-      # "log_type": "DATA_READ"
-      # `,
-      # `
-      # "log_type": "DATA_WRITE",
-      # "exempted_members": [
-      # "user:aliya@example.com"
-      # ]
-      # `
-      # ]
-      # `
-      # ]
-      # `
-      # For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
-      # logging. It also exempts jose@example.com from DATA_READ logging, and
-      # aliya@example.com from DATA_WRITE logging.
       class AuditConfig
         include Google::Apis::Core::Hashable
       
@@ -77,9 +45,9 @@ module Google
         # @return [Array<Google::Apis::BigqueryconnectionV1beta1::AuditLogConfig>]
         attr_accessor :audit_log_configs
       
-        # Specifies a service that will be enabled for audit logging.
+        # Specifies a service that will be enabled for audit logging. For example, `
-        # For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.
+        # storage.googleapis.com`, `cloudsql.googleapis.com`. `allServices` is a special
-        # `allServices` is a special value that covers all services.
+        # value that covers all services.
         # Corresponds to the JSON property `service`
         # @return [String]
         attr_accessor :service
@@ -95,28 +63,15 @@ module Google
         end
       end
       
-      # Provides the configuration for logging a type of permissions.
+      # Provides the configuration for logging a type of permissions. Example: ` "
-      # Example:
+      # audit_log_configs": [ ` "log_type": "DATA_READ", "exempted_members": [ "user:
-      # `
+      # jose@example.com" ] `, ` "log_type": "DATA_WRITE" ` ] ` This enables '
-      # "audit_log_configs": [
+      # DATA_READ' and 'DATA_WRITE' logging, while exempting jose@example.com from
-      # `
+      # DATA_READ logging.
-      # "log_type": "DATA_READ",
-      # "exempted_members": [
-      # "user:jose@example.com"
-      # ]
-      # `,
-      # `
-      # "log_type": "DATA_WRITE"
-      # `
-      # ]
-      # `
-      # This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting
-      # jose@example.com from DATA_READ logging.
       class AuditLogConfig
         include Google::Apis::Core::Hashable
       
-        # Specifies the identities that do not cause logging for this type of
+        # Specifies the identities that do not cause logging for this type of permission.
-        # permission.
         # Follows the same format of Binding.members.
         # Corresponds to the JSON property `exemptedMembers`
         # @return [Array<String>]
@@ -142,69 +97,57 @@ module Google
       class Binding
         include Google::Apis::Core::Hashable
       
-        # Represents a textual expression in the Common Expression Language (CEL)
+        # Represents a textual expression in the Common Expression Language (CEL) syntax.
-        # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
+        # CEL is a C-like expression language. The syntax and semantics of CEL are
-        # are documented at https://github.com/google/cel-spec.
+        # documented at https://github.com/google/cel-spec. Example (Comparison): title:
-        # Example (Comparison):
+        # "Summary size limit" description: "Determines if a summary is less than 100
-        # title: "Summary size limit"
+        # chars" expression: "document.summary.size() < 100" Example (Equality): title: "
-        # description: "Determines if a summary is less than 100 chars"
+        # Requestor is owner" description: "Determines if requestor is the document
-        # expression: "document.summary.size() < 100"
+        # owner" expression: "document.owner == request.auth.claims.email" Example (
-        # Example (Equality):
+        # Logic): title: "Public documents" description: "Determine whether the document
-        # title: "Requestor is owner"
+        # should be publicly visible" expression: "document.type != 'private' &&
-        # description: "Determines if requestor is the document owner"
+        # document.type != 'internal'" Example (Data Manipulation): title: "Notification
-        # expression: "document.owner == request.auth.claims.email"
+        # string" description: "Create a notification string with a timestamp."
-        # Example (Logic):
+        # expression: "'New message received at ' + string(document.create_time)" The
-        # title: "Public documents"
+        # exact variables and functions that may be referenced within an expression are
-        # description: "Determine whether the document should be publicly visible"
+        # determined by the service that evaluates it. See the service documentation for
-        # expression: "document.type != 'private' && document.type != 'internal'"
+        # additional information.
-        # 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::BigqueryconnectionV1beta1::Expr]
         attr_accessor :condition
       
-        # Specifies the identities requesting access for a Cloud Platform resource.
+        # Specifies the identities requesting access for a Cloud Platform resource. `
-        # `members` can have the following values:
+        # members` can have the following values: * `allUsers`: A special identifier
-        # * `allUsers`: A special identifier that represents anyone who is
+        # that represents anyone who is on the internet; with or without a Google
-        # on the internet; with or without a Google account.
+        # account. * `allAuthenticatedUsers`: A special identifier that represents
-        # * `allAuthenticatedUsers`: A special identifier that represents anyone
+        # anyone who is authenticated with a Google account or a service account. * `
-        # who is authenticated with a Google account or a service account.
+        # user:`emailid``: An email address that represents a specific Google account.
-        # * `user:`emailid``: An email address that represents a specific Google
+        # For example, `alice@example.com` . * `serviceAccount:`emailid``: An email
-        # account. For example, `alice@example.com` .
+        # address that represents a service account. For example, `my-other-app@appspot.
-        # * `serviceAccount:`emailid``: An email address that represents a service
+        # gserviceaccount.com`. * `group:`emailid``: An email address that represents a
-        # account. For example, `my-other-app@appspot.gserviceaccount.com`.
+        # Google group. For example, `admins@example.com`. * `deleted:user:`emailid`?uid=
-        # * `group:`emailid``: An email address that represents a Google group.
+        # `uniqueid``: An email address (plus unique identifier) representing a user
-        # For example, `admins@example.com`.
+        # that has been recently deleted. For example, `alice@example.com?uid=
-        # * `deleted:user:`emailid`?uid=`uniqueid``: An email address (plus unique
+        # 123456789012345678901`. If the user is recovered, this value reverts to `user:`
-        # identifier) representing a user that has been recently deleted. For
+        # emailid`` and the recovered user retains the role in the binding. * `deleted:
-        # example, `alice@example.com?uid=123456789012345678901`. If the user is
+        # serviceAccount:`emailid`?uid=`uniqueid``: An email address (plus unique
-        # recovered, this value reverts to `user:`emailid`` and the recovered user
+        # identifier) representing a service account that has been recently deleted. For
-        # retains the role in the binding.
+        # example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`.
-        # * `deleted:serviceAccount:`emailid`?uid=`uniqueid``: An email address (plus
+        # If the service account is undeleted, this value reverts to `serviceAccount:`
-        # unique identifier) representing a service account that has been recently
+        # emailid`` and the undeleted service account retains the role in the binding. *
-        # deleted. For example,
+        # `deleted:group:`emailid`?uid=`uniqueid``: An email address (plus unique
-        # `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`.
+        # identifier) representing a Google group that has been recently deleted. For
-        # If the service account is undeleted, this value reverts to
+        # example, `admins@example.com?uid=123456789012345678901`. If the group is
-        # `serviceAccount:`emailid`` and the undeleted service account retains the
+        # recovered, this value reverts to `group:`emailid`` and the recovered group
-        # role in the binding.
+        # retains the role in the binding. * `domain:`domain``: The G Suite domain (
-        # * `deleted:group:`emailid`?uid=`uniqueid``: An email address (plus unique
+        # primary) that represents all the users of that domain. For example, `google.
-        # identifier) representing a Google group that has been recently
+        # com` or `example.com`.
-        # 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`.
+        # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`
-        # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+        # , or `roles/owner`.
         # Corresponds to the JSON property `role`
         # @return [String]
         attr_accessor :role
@@ -283,8 +226,8 @@ module Google
         end
       end
       
-      # Configuration parameters to establish connection with an external data
+      # Configuration parameters to establish connection with an external data source,
-      # source, except the credential attributes.
+      # except the credential attributes.
       class Connection
         include Google::Apis::Core::Hashable
       
@@ -319,8 +262,8 @@ module Google
         # @return [Fixnum]
         attr_accessor :last_modified_time
       
-        # The resource name of the connection in the form of:
+        # The resource name of the connection in the form of: `projects/`project_id`/
-        # `projects/`project_id`/locations/`location_id`/connections/`connection_id``
+        # locations/`location_id`/connections/`connection_id``
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -360,13 +303,11 @@ module Google
         end
       end
       
-      # A generic empty message that you can re-use to avoid defining duplicated
+      # A generic empty message that you can re-use to avoid defining duplicated empty
-      # empty messages in your APIs. A typical example is to use it as the request
+      # messages in your APIs. A typical example is to use it as the request or the
-      # or the response type of an API method. For instance:
+      # response type of an API method. For instance: service Foo ` rpc Bar(google.
-      # service Foo `
+      # protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for
-      # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      # `Empty` is empty JSON object ````.
-      # `
-      # The JSON representation for `Empty` is empty JSON object ````.
       class Empty
         include Google::Apis::Core::Hashable
       
@@ -379,52 +320,43 @@ module Google
         end
       end
       
-      # Represents a textual expression in the Common Expression Language (CEL)
+      # Represents a textual expression in the Common Expression Language (CEL) syntax.
-      # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
+      # CEL is a C-like expression language. The syntax and semantics of CEL are
-      # are documented at https://github.com/google/cel-spec.
+      # documented at https://github.com/google/cel-spec. Example (Comparison): title:
-      # Example (Comparison):
+      # "Summary size limit" description: "Determines if a summary is less than 100
-      # title: "Summary size limit"
+      # chars" expression: "document.summary.size() < 100" Example (Equality): title: "
-      # description: "Determines if a summary is less than 100 chars"
+      # Requestor is owner" description: "Determines if requestor is the document
-      # expression: "document.summary.size() < 100"
+      # owner" expression: "document.owner == request.auth.claims.email" Example (
-      # Example (Equality):
+      # Logic): title: "Public documents" description: "Determine whether the document
-      # title: "Requestor is owner"
+      # should be publicly visible" expression: "document.type != 'private' &&
-      # description: "Determines if requestor is the document owner"
+      # document.type != 'internal'" Example (Data Manipulation): title: "Notification
-      # expression: "document.owner == request.auth.claims.email"
+      # string" description: "Create a notification string with a timestamp."
-      # Example (Logic):
+      # expression: "'New message received at ' + string(document.create_time)" The
-      # title: "Public documents"
+      # exact variables and functions that may be referenced within an expression are
-      # description: "Determine whether the document should be publicly visible"
+      # determined by the service that evaluates it. See the service documentation for
-      # expression: "document.type != 'private' && document.type != 'internal'"
+      # additional information.
-      # 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
+        # Optional. Description of the expression. This is a longer text which describes
-        # describes the expression, e.g. when hovered over it in a UI.
+        # 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
+        # Textual representation of an expression in Common Expression Language syntax.
-        # syntax.
         # Corresponds to the JSON property `expression`
         # @return [String]
         attr_accessor :expression
       
-        # Optional. String indicating the location of the expression for error
+        # Optional. String indicating the location of the expression for error reporting,
-        # reporting, e.g. a file name and a position in the file.
+        # 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
+        # Optional. Title for the expression, i.e. a short string describing its purpose.
-        # its purpose. This can be used e.g. in UIs which allow to enter the
+        # This can be used e.g. in UIs which allow to enter the expression.
-        # expression.
         # Corresponds to the JSON property `title`
         # @return [String]
         attr_accessor :title
@@ -465,15 +397,13 @@ module Google
       class GetPolicyOptions
         include Google::Apis::Core::Hashable
       
-        # Optional. The policy format version to be returned.
+        # Optional. The policy format version to be returned. Valid values are 0, 1, and
-        # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
+        # 3. Requests specifying an invalid value will be rejected. Requests for
-        # rejected.
+        # policies with any conditional bindings must specify version 3. Policies
-        # Requests for policies with any conditional bindings must specify version 3.
+        # without any conditional bindings may specify any valid value or leave the
-        # Policies without any conditional bindings may specify any valid value or
+        # field unset. To learn which resources support conditions in their IAM policies,
-        # leave the field unset.
+        # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
-        # To learn which resources support conditions in their IAM policies, see the
+        # resource-policies).
-        # [IAM
-        # documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
         # Corresponds to the JSON property `requestedPolicyVersion`
         # @return [Fixnum]
         attr_accessor :requested_policy_version
@@ -514,66 +444,32 @@ module Google
       end
       
       # An Identity and Access Management (IAM) policy, which specifies access
-      # controls for Google Cloud resources.
+      # controls for Google Cloud resources. A `Policy` is a collection of `bindings`.
-      # A `Policy` is a collection of `bindings`. A `binding` binds one or more
+      # A `binding` binds one or more `members` to a single `role`. Members can be
-      # `members` to a single `role`. Members can be user accounts, service accounts,
+      # user accounts, service accounts, Google groups, and domains (such as G Suite).
-      # Google groups, and domains (such as G Suite). A `role` is a named list of
+      # A `role` is a named list of permissions; each `role` can be an IAM predefined
-      # permissions; each `role` can be an IAM predefined role or a user-created
+      # role or a user-created custom role. For some types of Google Cloud resources,
-      # custom role.
+      # a `binding` can also specify a `condition`, which is a logical expression that
-      # For some types of Google Cloud resources, a `binding` can also specify a
+      # allows access to a resource only if the expression evaluates to `true`. A
-      # `condition`, which is a logical expression that allows access to a resource
+      # condition can add constraints based on attributes of the request, the resource,
-      # only if the expression evaluates to `true`. A condition can add constraints
+      # or both. To learn which resources support conditions in their IAM policies,
-      # based on attributes of the request, the resource, or both. To learn which
+      # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
-      # resources support conditions in their IAM policies, see the
+      # resource-policies). **JSON example:** ` "bindings": [ ` "role": "roles/
-      # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
+      # resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "
-      # policies).
+      # group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@
-      # **JSON example:**
+      # appspot.gserviceaccount.com" ] `, ` "role": "roles/resourcemanager.
-      # `
+      # organizationViewer", "members": [ "user:eve@example.com" ], "condition": ` "
-      # "bindings": [
+      # title": "expirable access", "description": "Does not grant access after Sep
-      # `
+      # 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", `
-      # "role": "roles/resourcemanager.organizationAdmin",
+      # ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:** bindings: -
-      # "members": [
+      # members: - user:mike@example.com - group:admins@example.com - domain:google.
-      # "user:mike@example.com",
+      # com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/
-      # "group:admins@example.com",
+      # resourcemanager.organizationAdmin - members: - user:eve@example.com role:
-      # "domain:google.com",
+      # roles/resourcemanager.organizationViewer condition: title: expirable access
-      # "serviceAccount:my-project-id@appspot.gserviceaccount.com"
+      # 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/).
-      # "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
       
@@ -582,48 +478,44 @@ module Google
         # @return [Array<Google::Apis::BigqueryconnectionV1beta1::AuditConfig>]
         attr_accessor :audit_configs
       
-        # Associates a list of `members` to a `role`. Optionally, may specify a
+        # Associates a list of `members` to a `role`. Optionally, may specify a `
-        # `condition` that determines how and when the `bindings` are applied. Each
+        # condition` that determines how and when the `bindings` are applied. Each of
-        # of the `bindings` must contain at least one member.
+        # the `bindings` must contain at least one member.
         # Corresponds to the JSON property `bindings`
         # @return [Array<Google::Apis::BigqueryconnectionV1beta1::Binding>]
         attr_accessor :bindings
       
-        # `etag` is used for optimistic concurrency control as a way to help
+        # `etag` is used for optimistic concurrency control as a way to help prevent
-        # prevent simultaneous updates of a policy from overwriting each other.
+        # simultaneous updates of a policy from overwriting each other. It is strongly
-        # It is strongly suggested that systems make use of the `etag` in the
+        # suggested that systems make use of the `etag` in the read-modify-write cycle
-        # read-modify-write cycle to perform policy updates in order to avoid race
+        # to perform policy updates in order to avoid race conditions: An `etag` is
-        # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+        # returned in the response to `getIamPolicy`, and systems are expected to put
-        # systems are expected to put that etag in the request to `setIamPolicy` to
+        # that etag in the request to `setIamPolicy` to ensure that their change will be
-        # ensure that their change will be applied to the same version of the policy.
+        # applied to the same version of the policy. **Important:** If you use IAM
-        # **Important:** If you use IAM Conditions, you must include the `etag` field
+        # Conditions, you must include the `etag` field whenever you call `setIamPolicy`.
-        # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
+        # If you omit this field, then IAM allows you to overwrite a version `3` policy
-        # you to overwrite a version `3` policy with a version `1` policy, and all of
+        # with a version `1` policy, and all of the conditions in the version `3` policy
-        # the conditions in the version `3` policy are lost.
+        # 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.
+        # Specifies the format of the policy. Valid values are `0`, `1`, and `3`.
-        # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
+        # Requests that specify an invalid value are rejected. Any operation that
-        # are rejected.
+        # affects conditional role bindings must specify version `3`. This requirement
-        # Any operation that affects conditional role bindings must specify version
+        # applies to the following operations: * Getting a policy that includes a
-        # `3`. This requirement applies to the following operations:
+        # conditional role binding * Adding a conditional role binding to a policy *
-        # * Getting a policy that includes a conditional role binding
+        # Changing a conditional role binding in a policy * Removing any role binding,
-        # * Adding a conditional role binding to a policy
+        # with or without a condition, from a policy that includes conditions **
-        # * Changing a conditional role binding in a policy
+        # Important:** If you use IAM Conditions, you must include the `etag` field
-        # * Removing any role binding, with or without a condition, from a policy
+        # whenever you call `setIamPolicy`. If you omit this field, then IAM allows you
-        # that includes conditions
+        # to overwrite a version `3` policy with a version `1` policy, and all of the
-        # **Important:** If you use IAM Conditions, you must include the `etag` field
+        # conditions in the version `3` policy are lost. If a policy does not include
-        # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
+        # any conditions, operations on that policy may specify any valid version or
-        # you to overwrite a version `3` policy with a version `1` policy, and all of
+        # leave the field unset. To learn which resources support conditions in their
-        # the conditions in the version `3` policy are lost.
+        # IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/
-        # If a policy does not include any conditions, operations on that policy may
+        # conditions/resource-policies).
-        # 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
@@ -646,74 +538,39 @@ module Google
         include Google::Apis::Core::Hashable
       
         # An Identity and Access Management (IAM) policy, which specifies access
-        # controls for Google Cloud resources.
+        # controls for Google Cloud resources. A `Policy` is a collection of `bindings`.
-        # A `Policy` is a collection of `bindings`. A `binding` binds one or more
+        # A `binding` binds one or more `members` to a single `role`. Members can be
-        # `members` to a single `role`. Members can be user accounts, service accounts,
+        # user accounts, service accounts, Google groups, and domains (such as G Suite).
-        # Google groups, and domains (such as G Suite). A `role` is a named list of
+        # A `role` is a named list of permissions; each `role` can be an IAM predefined
-        # permissions; each `role` can be an IAM predefined role or a user-created
+        # role or a user-created custom role. For some types of Google Cloud resources,
-        # custom role.
+        # a `binding` can also specify a `condition`, which is a logical expression that
-        # For some types of Google Cloud resources, a `binding` can also specify a
+        # allows access to a resource only if the expression evaluates to `true`. A
-        # `condition`, which is a logical expression that allows access to a resource
+        # condition can add constraints based on attributes of the request, the resource,
-        # only if the expression evaluates to `true`. A condition can add constraints
+        # or both. To learn which resources support conditions in their IAM policies,
-        # based on attributes of the request, the resource, or both. To learn which
+        # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
-        # resources support conditions in their IAM policies, see the
+        # resource-policies). **JSON example:** ` "bindings": [ ` "role": "roles/
-        # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
+        # resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "
-        # policies).
+        # group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@
-        # **JSON example:**
+        # appspot.gserviceaccount.com" ] `, ` "role": "roles/resourcemanager.
-        # `
+        # organizationViewer", "members": [ "user:eve@example.com" ], "condition": ` "
-        # "bindings": [
+        # title": "expirable access", "description": "Does not grant access after Sep
-        # `
+        # 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", `
-        # "role": "roles/resourcemanager.organizationAdmin",
+        # ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:** bindings: -
-        # "members": [
+        # members: - user:mike@example.com - group:admins@example.com - domain:google.
-        # "user:mike@example.com",
+        # com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/
-        # "group:admins@example.com",
+        # resourcemanager.organizationAdmin - members: - user:eve@example.com role:
-        # "domain:google.com",
+        # roles/resourcemanager.organizationViewer condition: title: expirable access
-        # "serviceAccount:my-project-id@appspot.gserviceaccount.com"
+        # 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/).
-        # "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::BigqueryconnectionV1beta1::Policy]
         attr_accessor :policy
       
         # OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only
-        # the fields in the mask will be modified. If no mask is provided, the
+        # the fields in the mask will be modified. If no mask is provided, the following
-        # following default mask is used:
+        # default mask is used: `paths: "bindings, etag"`
-        # `paths: "bindings, etag"`
         # Corresponds to the JSON property `updateMask`
         # @return [String]
         attr_accessor :update_mask
@@ -733,10 +590,9 @@ module Google
       class TestIamPermissionsRequest
         include Google::Apis::Core::Hashable
       
-        # The set of permissions to check for the `resource`. Permissions with
+        # The set of permissions to check for the `resource`. Permissions with wildcards
-        # wildcards (such as '*' or 'storage.*') are not allowed. For more
+        # (such as '*' or 'storage.*') are not allowed. For more information see [IAM
-        # information see
+        # Overview](https://cloud.google.com/iam/docs/overview#permissions).
-        # [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
         # Corresponds to the JSON property `permissions`
         # @return [Array<String>]
         attr_accessor :permissions
@@ -755,8 +611,7 @@ module Google
       class TestIamPermissionsResponse
         include Google::Apis::Core::Hashable
       
-        # A subset of `TestPermissionsRequest.permissions` that the caller is
+        # A subset of `TestPermissionsRequest.permissions` that the caller is allowed.
-        # allowed.
         # Corresponds to the JSON property `permissions`
         # @return [Array<String>]
         attr_accessor :permissions

generated/google/apis/bigqueryconnection_v1beta1/service.rb

@@ -49,8 +49,8 @@ module Google
         
         # Creates a new connection.
         # @param [String] parent
-        #   Required. Parent resource name.
+        #   Required. Parent resource name. Must be in the format `projects/`project_id`/
-        #   Must be in the format `projects/`project_id`/locations/`location_id``
+        #   locations/`location_id``
         # @param [Google::Apis::BigqueryconnectionV1beta1::Connection] connection_object
         # @param [String] connection_id
         #   Optional. Connection id that should be assigned to the created connection.
@@ -86,8 +86,8 @@ module Google
         
         # Deletes connection and associated credential.
         # @param [String] name
-        #   Required. Name of the deleted connection, for example:
+        #   Required. Name of the deleted connection, for example: `projects/`project_id`/
-        #   `projects/`project_id`/locations/`location_id`/connections/`connection_id``
+        #   locations/`location_id`/connections/`connection_id``
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -117,8 +117,8 @@ module Google
         
         # Returns specified connection.
         # @param [String] name
-        #   Required. Name of the requested connection, for example:
+        #   Required. Name of the requested connection, for example: `projects/`project_id`
-        #   `projects/`project_id`/locations/`location_id`/connections/`connection_id``
+        #   /locations/`location_id`/connections/`connection_id``
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -146,12 +146,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the access control policy for a resource.
+        # Gets the access control policy for a resource. Returns an empty policy if the
-        # Returns an empty policy if the resource exists and does not have a policy
+        # resource exists and does not have a policy set.
-        # set.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being requested.
+        #   REQUIRED: The resource for which the policy is being requested. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::BigqueryconnectionV1beta1::GetIamPolicyRequest] get_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -184,8 +183,8 @@ module Google
         
         # Returns a list of connections in the given project.
         # @param [String] parent
-        #   Required. Parent resource name.
+        #   Required. Parent resource name. Must be in the form: `projects/`project_id`/
-        #   Must be in the form: `projects/`project_id`/locations/`location_id``
+        #   locations/`location_id``
         # @param [Fixnum] max_results
         #   Required. Maximum number of results per page.
         # @param [String] page_token
@@ -219,11 +218,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates the specified connection. For security reasons, also resets
+        # Updates the specified connection. For security reasons, also resets credential
-        # credential if connection properties are in the update field mask.
+        # if connection properties are in the update field mask.
         # @param [String] name
-        #   Required. Name of the connection to update, for example:
+        #   Required. Name of the connection to update, for example: `projects/`project_id`
-        #   `projects/`project_id`/locations/`location_id`/connections/`connection_id``
+        #   /locations/`location_id`/connections/`connection_id``
         # @param [Google::Apis::BigqueryconnectionV1beta1::Connection] connection_object
         # @param [String] update_mask
         #   Required. Update mask for the connection fields to be updated.
@@ -258,11 +257,11 @@ module Google
         end
         
         # Sets the access control policy on the specified resource. Replaces any
-        # existing policy.
+        # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
-        # Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.
+        # PERMISSION_DENIED` errors.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being specified.
+        #   REQUIRED: The resource for which the policy is being specified. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::BigqueryconnectionV1beta1::SetIamPolicyRequest] set_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -293,15 +292,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns permissions that a caller has on the specified resource.
+        # Returns permissions that a caller has on the specified resource. If the
-        # If the resource does not exist, this will return an empty set of
+        # resource does not exist, this will return an empty set of permissions, not a `
-        # permissions, not a `NOT_FOUND` error.
+        # NOT_FOUND` error. Note: This operation is designed to be used for building
-        # Note: This operation is designed to be used for building permission-aware
+        # permission-aware UIs and command-line tools, not for authorization checking.
-        # UIs and command-line tools, not for authorization checking. This operation
+        # This operation may "fail open" without warning.
-        # may "fail open" without warning.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy detail is being requested.
+        #   REQUIRED: The resource for which the policy detail is being requested. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::BigqueryconnectionV1beta1::TestIamPermissionsRequest] test_iam_permissions_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -334,9 +332,8 @@ module Google
         
         # Sets the credential for the specified connection.
         # @param [String] name
-        #   Required. Name of the connection, for example:
+        #   Required. Name of the connection, for example: `projects/`project_id`/
-        #   `projects/`project_id`/locations/`location_id`/connections/`connection_id`/
+        #   locations/`location_id`/connections/`connection_id`/credential`
-        #   credential`
         # @param [Google::Apis::BigqueryconnectionV1beta1::ConnectionCredential] connection_credential_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.

generated/google/apis/binaryauthorization_v1.rb

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

generated/google/apis/binaryauthorization_v1/classes.rb

@@ -22,12 +22,11 @@ module Google
   module Apis
     module BinaryauthorizationV1
       
-      # An admission rule specifies either that all container images
+      # An admission rule specifies either that all container images used in a pod
-      # used in a pod creation request must be attested to by one or more
+      # creation request must be attested to by one or more attestors, that all pod
-      # attestors, that all pod creations will be allowed, or that all
+      # creations will be allowed, or that all pod creations will be denied. Images
-      # pod creations will be denied.
+      # matching an admission whitelist pattern are exempted from admission rules and
-      # Images matching an admission whitelist pattern
+      # will never block a pod creation.
-      # are exempted from admission rules and will never block a pod creation.
       class AdmissionRule
         include Google::Apis::Core::Hashable
       
@@ -41,11 +40,10 @@ module Google
         # @return [String]
         attr_accessor :evaluation_mode
       
-        # Optional. The resource names of the attestors that must attest to
+        # Optional. The resource names of the attestors that must attest to a container
-        # a container image, in the format `projects/*/attestors/*`. Each
+        # image, in the format `projects/*/attestors/*`. Each attestor must exist before
-        # attestor must exist before a policy can reference it.  To add an attestor
+        # a policy can reference it. To add an attestor to a policy the principal
-        # to a policy the principal issuing the policy change request must be able
+        # issuing the policy change request must be able to read the attestor resource.
-        # to read the attestor resource.
         # Note: this field must be non-empty when the evaluation_mode field specifies
         # REQUIRE_ATTESTATION, otherwise it must be empty.
         # Corresponds to the JSON property `requireAttestationsBy`
@@ -64,14 +62,13 @@ module Google
         end
       end
       
-      # An admission whitelist pattern exempts images
+      # An admission whitelist pattern exempts images from checks by admission rules.
-      # from checks by admission rules.
       class AdmissionWhitelistPattern
         include Google::Apis::Core::Hashable
       
-        # An image name pattern to whitelist, in the form `registry/path/to/image`.
+        # An image name pattern to whitelist, in the form `registry/path/to/image`. This
-        # This supports a trailing `*` as a wildcard, but this is allowed only in
+        # supports a trailing `*` as a wildcard, but this is allowed only in text after
-        # text after the `registry/` part.
+        # the `registry/` part.
         # Corresponds to the JSON property `namePattern`
         # @return [String]
         attr_accessor :name_pattern
@@ -86,20 +83,19 @@ module Google
         end
       end
       
-      # An attestor that attests to container image
+      # An attestor that attests to container image artifacts. An existing attestor
-      # artifacts. An existing attestor cannot be modified except where
+      # cannot be modified except where indicated.
-      # indicated.
       class Attestor
         include Google::Apis::Core::Hashable
       
-        # Optional. A descriptive comment.  This field may be updated.
+        # Optional. A descriptive comment. This field may be updated. The field may be
-        # The field may be displayed in chooser dialogs.
+        # displayed in chooser dialogs.
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
       
-        # Required. The resource name, in the format:
+        # Required. The resource name, in the format: `projects/*/attestors/*`. This
-        # `projects/*/attestors/*`. This field may not be updated.
+        # field may not be updated.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -109,8 +105,8 @@ module Google
         # @return [String]
         attr_accessor :update_time
       
-        # An user owned Grafeas note references a Grafeas
+        # An user owned Grafeas note references a Grafeas Attestation.Authority Note
-        # Attestation.Authority Note created by the user.
+        # created by the user.
         # Corresponds to the JSON property `userOwnedGrafeasNote`
         # @return [Google::Apis::BinaryauthorizationV1::UserOwnedGrafeasNote]
         attr_accessor :user_owned_grafeas_note
@@ -128,19 +124,17 @@ module Google
         end
       end
       
-      # An attestor public key that will be used to verify
+      # An attestor public key that will be used to verify attestations signed by this
-      # attestations signed by this attestor.
+      # attestor.
       class AttestorPublicKey
         include Google::Apis::Core::Hashable
       
-        # ASCII-armored representation of a PGP public key, as the entire output by
+        # ASCII-armored representation of a PGP public key, as the entire output by the
-        # the command `gpg --export --armor foo@example.com` (either LF or CRLF
+        # command `gpg --export --armor foo@example.com` (either LF or CRLF line endings)
-        # line endings).
+        # . When using this field, `id` should be left blank. The BinAuthz API handlers
-        # When using this field, `id` should be left blank.  The BinAuthz API
+        # will calculate the ID and fill it in automatically. BinAuthz computes this ID
-        # handlers will calculate the ID and fill it in automatically.  BinAuthz
+        # as the OpenPGP RFC4880 V4 fingerprint, represented as upper-case hex. If `id`
-        # computes this ID as the OpenPGP RFC4880 V4 fingerprint, represented as
+        # is provided by the caller, it will be overwritten by the API-calculated ID.
-        # upper-case hex.  If `id` is provided by the caller, it will be
-        # overwritten by the API-calculated ID.
         # Corresponds to the JSON property `asciiArmoredPgpPublicKey`
         # @return [String]
         attr_accessor :ascii_armored_pgp_public_key
@@ -150,21 +144,18 @@ module Google
         # @return [String]
         attr_accessor :comment
       
-        # The ID of this public key.
+        # The ID of this public key. Signatures verified by BinAuthz must include the ID
-        # Signatures verified by BinAuthz must include the ID of the public key that
+        # of the public key that can be used to verify them, and that ID must match the
-        # can be used to verify them, and that ID must match the contents of this
+        # contents of this field exactly. Additional restrictions on this field can be
-        # field exactly.
+        # imposed based on which public key type is encapsulated. See the documentation
-        # Additional restrictions on this field can be imposed based on which public
+        # on `public_key` cases below for details.
-        # key type is encapsulated. See the documentation on `public_key` cases below
-        # for details.
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
       
-        # A public key in the PkixPublicKey format (see
+        # A public key in the PkixPublicKey format (see https://tools.ietf.org/html/
-        # https://tools.ietf.org/html/rfc5280#section-4.1.2.7 for details).
+        # rfc5280#section-4.1.2.7 for details). Public keys of this type are typically
-        # Public keys of this type are typically textually encoded using the PEM
+        # textually encoded using the PEM format.
-        # format.
         # Corresponds to the JSON property `pkixPublicKey`
         # @return [Google::Apis::BinaryauthorizationV1::PkixPublicKey]
         attr_accessor :pkix_public_key
@@ -186,69 +177,57 @@ module Google
       class Binding
         include Google::Apis::Core::Hashable
       
-        # Represents a textual expression in the Common Expression Language (CEL)
+        # Represents a textual expression in the Common Expression Language (CEL) syntax.
-        # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
+        # CEL is a C-like expression language. The syntax and semantics of CEL are
-        # are documented at https://github.com/google/cel-spec.
+        # documented at https://github.com/google/cel-spec. Example (Comparison): title:
-        # Example (Comparison):
+        # "Summary size limit" description: "Determines if a summary is less than 100
-        # title: "Summary size limit"
+        # chars" expression: "document.summary.size() < 100" Example (Equality): title: "
-        # description: "Determines if a summary is less than 100 chars"
+        # Requestor is owner" description: "Determines if requestor is the document
-        # expression: "document.summary.size() < 100"
+        # owner" expression: "document.owner == request.auth.claims.email" Example (
-        # Example (Equality):
+        # Logic): title: "Public documents" description: "Determine whether the document
-        # title: "Requestor is owner"
+        # should be publicly visible" expression: "document.type != 'private' &&
-        # description: "Determines if requestor is the document owner"
+        # document.type != 'internal'" Example (Data Manipulation): title: "Notification
-        # expression: "document.owner == request.auth.claims.email"
+        # string" description: "Create a notification string with a timestamp."
-        # Example (Logic):
+        # expression: "'New message received at ' + string(document.create_time)" The
-        # title: "Public documents"
+        # exact variables and functions that may be referenced within an expression are
-        # description: "Determine whether the document should be publicly visible"
+        # determined by the service that evaluates it. See the service documentation for
-        # expression: "document.type != 'private' && document.type != 'internal'"
+        # additional information.
-        # 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::BinaryauthorizationV1::Expr]
         attr_accessor :condition
       
-        # Specifies the identities requesting access for a Cloud Platform resource.
+        # Specifies the identities requesting access for a Cloud Platform resource. `
-        # `members` can have the following values:
+        # members` can have the following values: * `allUsers`: A special identifier
-        # * `allUsers`: A special identifier that represents anyone who is
+        # that represents anyone who is on the internet; with or without a Google
-        # on the internet; with or without a Google account.
+        # account. * `allAuthenticatedUsers`: A special identifier that represents
-        # * `allAuthenticatedUsers`: A special identifier that represents anyone
+        # anyone who is authenticated with a Google account or a service account. * `
-        # who is authenticated with a Google account or a service account.
+        # user:`emailid``: An email address that represents a specific Google account.
-        # * `user:`emailid``: An email address that represents a specific Google
+        # For example, `alice@example.com` . * `serviceAccount:`emailid``: An email
-        # account. For example, `alice@example.com` .
+        # address that represents a service account. For example, `my-other-app@appspot.
-        # * `serviceAccount:`emailid``: An email address that represents a service
+        # gserviceaccount.com`. * `group:`emailid``: An email address that represents a
-        # account. For example, `my-other-app@appspot.gserviceaccount.com`.
+        # Google group. For example, `admins@example.com`. * `deleted:user:`emailid`?uid=
-        # * `group:`emailid``: An email address that represents a Google group.
+        # `uniqueid``: An email address (plus unique identifier) representing a user
-        # For example, `admins@example.com`.
+        # that has been recently deleted. For example, `alice@example.com?uid=
-        # * `deleted:user:`emailid`?uid=`uniqueid``: An email address (plus unique
+        # 123456789012345678901`. If the user is recovered, this value reverts to `user:`
-        # identifier) representing a user that has been recently deleted. For
+        # emailid`` and the recovered user retains the role in the binding. * `deleted:
-        # example, `alice@example.com?uid=123456789012345678901`. If the user is
+        # serviceAccount:`emailid`?uid=`uniqueid``: An email address (plus unique
-        # recovered, this value reverts to `user:`emailid`` and the recovered user
+        # identifier) representing a service account that has been recently deleted. For
-        # retains the role in the binding.
+        # example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`.
-        # * `deleted:serviceAccount:`emailid`?uid=`uniqueid``: An email address (plus
+        # If the service account is undeleted, this value reverts to `serviceAccount:`
-        # unique identifier) representing a service account that has been recently
+        # emailid`` and the undeleted service account retains the role in the binding. *
-        # deleted. For example,
+        # `deleted:group:`emailid`?uid=`uniqueid``: An email address (plus unique
-        # `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`.
+        # identifier) representing a Google group that has been recently deleted. For
-        # If the service account is undeleted, this value reverts to
+        # example, `admins@example.com?uid=123456789012345678901`. If the group is
-        # `serviceAccount:`emailid`` and the undeleted service account retains the
+        # recovered, this value reverts to `group:`emailid`` and the recovered group
-        # role in the binding.
+        # retains the role in the binding. * `domain:`domain``: The G Suite domain (
-        # * `deleted:group:`emailid`?uid=`uniqueid``: An email address (plus unique
+        # primary) that represents all the users of that domain. For example, `google.
-        # identifier) representing a Google group that has been recently
+        # com` or `example.com`.
-        # 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`.
+        # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`
-        # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+        # , or `roles/owner`.
         # Corresponds to the JSON property `role`
         # @return [String]
         attr_accessor :role
@@ -265,13 +244,11 @@ module Google
         end
       end
       
-      # A generic empty message that you can re-use to avoid defining duplicated
+      # A generic empty message that you can re-use to avoid defining duplicated empty
-      # empty messages in your APIs. A typical example is to use it as the request
+      # messages in your APIs. A typical example is to use it as the request or the
-      # or the response type of an API method. For instance:
+      # response type of an API method. For instance: service Foo ` rpc Bar(google.
-      # service Foo `
+      # protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for
-      # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      # `Empty` is empty JSON object ````.
-      # `
-      # The JSON representation for `Empty` is empty JSON object ````.
       class Empty
         include Google::Apis::Core::Hashable
       
@@ -284,52 +261,43 @@ module Google
         end
       end
       
-      # Represents a textual expression in the Common Expression Language (CEL)
+      # Represents a textual expression in the Common Expression Language (CEL) syntax.
-      # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
+      # CEL is a C-like expression language. The syntax and semantics of CEL are
-      # are documented at https://github.com/google/cel-spec.
+      # documented at https://github.com/google/cel-spec. Example (Comparison): title:
-      # Example (Comparison):
+      # "Summary size limit" description: "Determines if a summary is less than 100
-      # title: "Summary size limit"
+      # chars" expression: "document.summary.size() < 100" Example (Equality): title: "
-      # description: "Determines if a summary is less than 100 chars"
+      # Requestor is owner" description: "Determines if requestor is the document
-      # expression: "document.summary.size() < 100"
+      # owner" expression: "document.owner == request.auth.claims.email" Example (
-      # Example (Equality):
+      # Logic): title: "Public documents" description: "Determine whether the document
-      # title: "Requestor is owner"
+      # should be publicly visible" expression: "document.type != 'private' &&
-      # description: "Determines if requestor is the document owner"
+      # document.type != 'internal'" Example (Data Manipulation): title: "Notification
-      # expression: "document.owner == request.auth.claims.email"
+      # string" description: "Create a notification string with a timestamp."
-      # Example (Logic):
+      # expression: "'New message received at ' + string(document.create_time)" The
-      # title: "Public documents"
+      # exact variables and functions that may be referenced within an expression are
-      # description: "Determine whether the document should be publicly visible"
+      # determined by the service that evaluates it. See the service documentation for
-      # expression: "document.type != 'private' && document.type != 'internal'"
+      # additional information.
-      # 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
+        # Optional. Description of the expression. This is a longer text which describes
-        # describes the expression, e.g. when hovered over it in a UI.
+        # 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
+        # Textual representation of an expression in Common Expression Language syntax.
-        # syntax.
         # Corresponds to the JSON property `expression`
         # @return [String]
         attr_accessor :expression
       
-        # Optional. String indicating the location of the expression for error
+        # Optional. String indicating the location of the expression for error reporting,
-        # reporting, e.g. a file name and a position in the file.
+        # 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
+        # Optional. Title for the expression, i.e. a short string describing its purpose.
-        # its purpose. This can be used e.g. in UIs which allow to enter the
+        # This can be used e.g. in UIs which allow to enter the expression.
-        # expression.
         # Corresponds to the JSON property `title`
         # @return [String]
         attr_accessor :title
@@ -348,111 +316,73 @@ module Google
       end
       
       # An Identity and Access Management (IAM) policy, which specifies access
-      # controls for Google Cloud resources.
+      # controls for Google Cloud resources. A `Policy` is a collection of `bindings`.
-      # A `Policy` is a collection of `bindings`. A `binding` binds one or more
+      # A `binding` binds one or more `members` to a single `role`. Members can be
-      # `members` to a single `role`. Members can be user accounts, service accounts,
+      # user accounts, service accounts, Google groups, and domains (such as G Suite).
-      # Google groups, and domains (such as G Suite). A `role` is a named list of
+      # A `role` is a named list of permissions; each `role` can be an IAM predefined
-      # permissions; each `role` can be an IAM predefined role or a user-created
+      # role or a user-created custom role. For some types of Google Cloud resources,
-      # custom role.
+      # a `binding` can also specify a `condition`, which is a logical expression that
-      # For some types of Google Cloud resources, a `binding` can also specify a
+      # allows access to a resource only if the expression evaluates to `true`. A
-      # `condition`, which is a logical expression that allows access to a resource
+      # condition can add constraints based on attributes of the request, the resource,
-      # only if the expression evaluates to `true`. A condition can add constraints
+      # or both. To learn which resources support conditions in their IAM policies,
-      # based on attributes of the request, the resource, or both. To learn which
+      # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
-      # resources support conditions in their IAM policies, see the
+      # resource-policies). **JSON example:** ` "bindings": [ ` "role": "roles/
-      # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
+      # resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "
-      # policies).
+      # group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@
-      # **JSON example:**
+      # appspot.gserviceaccount.com" ] `, ` "role": "roles/resourcemanager.
-      # `
+      # organizationViewer", "members": [ "user:eve@example.com" ], "condition": ` "
-      # "bindings": [
+      # title": "expirable access", "description": "Does not grant access after Sep
-      # `
+      # 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", `
-      # "role": "roles/resourcemanager.organizationAdmin",
+      # ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:** bindings: -
-      # "members": [
+      # members: - user:mike@example.com - group:admins@example.com - domain:google.
-      # "user:mike@example.com",
+      # com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/
-      # "group:admins@example.com",
+      # resourcemanager.organizationAdmin - members: - user:eve@example.com role:
-      # "domain:google.com",
+      # roles/resourcemanager.organizationViewer condition: title: expirable access
-      # "serviceAccount:my-project-id@appspot.gserviceaccount.com"
+      # 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/).
-      # "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 IamPolicy
         include Google::Apis::Core::Hashable
       
-        # Associates a list of `members` to a `role`. Optionally, may specify a
+        # Associates a list of `members` to a `role`. Optionally, may specify a `
-        # `condition` that determines how and when the `bindings` are applied. Each
+        # condition` that determines how and when the `bindings` are applied. Each of
-        # of the `bindings` must contain at least one member.
+        # the `bindings` must contain at least one member.
         # Corresponds to the JSON property `bindings`
         # @return [Array<Google::Apis::BinaryauthorizationV1::Binding>]
         attr_accessor :bindings
       
-        # `etag` is used for optimistic concurrency control as a way to help
+        # `etag` is used for optimistic concurrency control as a way to help prevent
-        # prevent simultaneous updates of a policy from overwriting each other.
+        # simultaneous updates of a policy from overwriting each other. It is strongly
-        # It is strongly suggested that systems make use of the `etag` in the
+        # suggested that systems make use of the `etag` in the read-modify-write cycle
-        # read-modify-write cycle to perform policy updates in order to avoid race
+        # to perform policy updates in order to avoid race conditions: An `etag` is
-        # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+        # returned in the response to `getIamPolicy`, and systems are expected to put
-        # systems are expected to put that etag in the request to `setIamPolicy` to
+        # that etag in the request to `setIamPolicy` to ensure that their change will be
-        # ensure that their change will be applied to the same version of the policy.
+        # applied to the same version of the policy. **Important:** If you use IAM
-        # **Important:** If you use IAM Conditions, you must include the `etag` field
+        # Conditions, you must include the `etag` field whenever you call `setIamPolicy`.
-        # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
+        # If you omit this field, then IAM allows you to overwrite a version `3` policy
-        # you to overwrite a version `3` policy with a version `1` policy, and all of
+        # with a version `1` policy, and all of the conditions in the version `3` policy
-        # the conditions in the version `3` policy are lost.
+        # 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.
+        # Specifies the format of the policy. Valid values are `0`, `1`, and `3`.
-        # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
+        # Requests that specify an invalid value are rejected. Any operation that
-        # are rejected.
+        # affects conditional role bindings must specify version `3`. This requirement
-        # Any operation that affects conditional role bindings must specify version
+        # applies to the following operations: * Getting a policy that includes a
-        # `3`. This requirement applies to the following operations:
+        # conditional role binding * Adding a conditional role binding to a policy *
-        # * Getting a policy that includes a conditional role binding
+        # Changing a conditional role binding in a policy * Removing any role binding,
-        # * Adding a conditional role binding to a policy
+        # with or without a condition, from a policy that includes conditions **
-        # * Changing a conditional role binding in a policy
+        # Important:** If you use IAM Conditions, you must include the `etag` field
-        # * Removing any role binding, with or without a condition, from a policy
+        # whenever you call `setIamPolicy`. If you omit this field, then IAM allows you
-        # that includes conditions
+        # to overwrite a version `3` policy with a version `1` policy, and all of the
-        # **Important:** If you use IAM Conditions, you must include the `etag` field
+        # conditions in the version `3` policy are lost. If a policy does not include
-        # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
+        # any conditions, operations on that policy may specify any valid version or
-        # you to overwrite a version `3` policy with a version `1` policy, and all of
+        # leave the field unset. To learn which resources support conditions in their
-        # the conditions in the version `3` policy are lost.
+        # IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/
-        # If a policy does not include any conditions, operations on that policy may
+        # conditions/resource-policies).
-        # 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
@@ -479,8 +409,8 @@ module Google
         attr_accessor :attestors
       
         # A token to retrieve the next page of results. Pass this value in the
-        # ListAttestorsRequest.page_token field in the subsequent call to the
+        # ListAttestorsRequest.page_token field in the subsequent call to the `
-        # `ListAttestors` method to retrieve the next page of results.
+        # ListAttestors` method to retrieve the next page of results.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -496,24 +426,22 @@ module Google
         end
       end
       
-      # A public key in the PkixPublicKey format (see
+      # A public key in the PkixPublicKey format (see https://tools.ietf.org/html/
-      # https://tools.ietf.org/html/rfc5280#section-4.1.2.7 for details).
+      # rfc5280#section-4.1.2.7 for details). Public keys of this type are typically
-      # Public keys of this type are typically textually encoded using the PEM
+      # textually encoded using the PEM format.
-      # format.
       class PkixPublicKey
         include Google::Apis::Core::Hashable
       
-        # A PEM-encoded public key, as described in
+        # A PEM-encoded public key, as described in https://tools.ietf.org/html/rfc7468#
-        # https://tools.ietf.org/html/rfc7468#section-13
+        # section-13
         # Corresponds to the JSON property `publicKeyPem`
         # @return [String]
         attr_accessor :public_key_pem
       
         # The signature algorithm used to verify a message against a signature using
-        # this key.
+        # this key. These signature algorithm must match the structure and any object
-        # These signature algorithm must match the structure and any object
+        # identifiers encoded in `public_key_pem` (i.e. this algorithm must match that
-        # identifiers encoded in `public_key_pem` (i.e. this algorithm must match
+        # of the public key).
-        # that of the public key).
         # Corresponds to the JSON property `signatureAlgorithm`
         # @return [String]
         attr_accessor :signature_algorithm
@@ -534,30 +462,26 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Optional. Admission policy whitelisting. A matching admission request will
-        # always be permitted. This feature is typically used to exclude Google or
+        # always be permitted. This feature is typically used to exclude Google or third-
-        # third-party infrastructure images from Binary Authorization policies.
+        # party infrastructure images from Binary Authorization policies.
         # Corresponds to the JSON property `admissionWhitelistPatterns`
         # @return [Array<Google::Apis::BinaryauthorizationV1::AdmissionWhitelistPattern>]
         attr_accessor :admission_whitelist_patterns
       
-        # Optional. Per-cluster admission rules. Cluster spec format:
+        # Optional. Per-cluster admission rules. Cluster spec format: `location.
-        # `location.clusterId`. There can be at most one admission rule per cluster
+        # clusterId`. There can be at most one admission rule per cluster spec. A `
-        # spec.
+        # location` is either a compute zone (e.g. us-central1-a) or a region (e.g. us-
-        # A `location` is either a compute zone (e.g. us-central1-a) or a region
+        # central1). For `clusterId` syntax restrictions see https://cloud.google.com/
-        # (e.g. us-central1).
+        # container-engine/reference/rest/v1/projects.zones.clusters.
-        # For `clusterId` syntax restrictions see
-        # https://cloud.google.com/container-engine/reference/rest/v1/projects.zones.
-        # clusters.
         # Corresponds to the JSON property `clusterAdmissionRules`
         # @return [Hash<String,Google::Apis::BinaryauthorizationV1::AdmissionRule>]
         attr_accessor :cluster_admission_rules
       
-        # An admission rule specifies either that all container images
+        # An admission rule specifies either that all container images used in a pod
-        # used in a pod creation request must be attested to by one or more
+        # creation request must be attested to by one or more attestors, that all pod
-        # attestors, that all pod creations will be allowed, or that all
+        # creations will be allowed, or that all pod creations will be denied. Images
-        # pod creations will be denied.
+        # matching an admission whitelist pattern are exempted from admission rules and
-        # Images matching an admission whitelist pattern
+        # will never block a pod creation.
-        # are exempted from admission rules and will never block a pod creation.
         # Corresponds to the JSON property `defaultAdmissionRule`
         # @return [Google::Apis::BinaryauthorizationV1::AdmissionRule]
         attr_accessor :default_admission_rule
@@ -568,15 +492,15 @@ module Google
         attr_accessor :description
       
         # Optional. Controls the evaluation of a Google-maintained global admission
-        # policy for common system-level images. Images not covered by the global
+        # policy for common system-level images. Images not covered by the global policy
-        # policy will be subject to the project admission policy. This setting
+        # will be subject to the project admission policy. This setting has no effect
-        # has no effect when specified inside a global admission policy.
+        # when specified inside a global admission policy.
         # Corresponds to the JSON property `globalPolicyEvaluationMode`
         # @return [String]
         attr_accessor :global_policy_evaluation_mode
       
-        # Output only. The resource name, in the format `projects/*/policy`. There is
+        # Output only. The resource name, in the format `projects/*/policy`. There is at
-        # at most one policy per project.
+        # most one policy per project.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -607,66 +531,32 @@ module Google
         include Google::Apis::Core::Hashable
       
         # An Identity and Access Management (IAM) policy, which specifies access
-        # controls for Google Cloud resources.
+        # controls for Google Cloud resources. A `Policy` is a collection of `bindings`.
-        # A `Policy` is a collection of `bindings`. A `binding` binds one or more
+        # A `binding` binds one or more `members` to a single `role`. Members can be
-        # `members` to a single `role`. Members can be user accounts, service accounts,
+        # user accounts, service accounts, Google groups, and domains (such as G Suite).
-        # Google groups, and domains (such as G Suite). A `role` is a named list of
+        # A `role` is a named list of permissions; each `role` can be an IAM predefined
-        # permissions; each `role` can be an IAM predefined role or a user-created
+        # role or a user-created custom role. For some types of Google Cloud resources,
-        # custom role.
+        # a `binding` can also specify a `condition`, which is a logical expression that
-        # For some types of Google Cloud resources, a `binding` can also specify a
+        # allows access to a resource only if the expression evaluates to `true`. A
-        # `condition`, which is a logical expression that allows access to a resource
+        # condition can add constraints based on attributes of the request, the resource,
-        # only if the expression evaluates to `true`. A condition can add constraints
+        # or both. To learn which resources support conditions in their IAM policies,
-        # based on attributes of the request, the resource, or both. To learn which
+        # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
-        # resources support conditions in their IAM policies, see the
+        # resource-policies). **JSON example:** ` "bindings": [ ` "role": "roles/
-        # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
+        # resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "
-        # policies).
+        # group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@
-        # **JSON example:**
+        # appspot.gserviceaccount.com" ] `, ` "role": "roles/resourcemanager.
-        # `
+        # organizationViewer", "members": [ "user:eve@example.com" ], "condition": ` "
-        # "bindings": [
+        # title": "expirable access", "description": "Does not grant access after Sep
-        # `
+        # 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", `
-        # "role": "roles/resourcemanager.organizationAdmin",
+        # ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:** bindings: -
-        # "members": [
+        # members: - user:mike@example.com - group:admins@example.com - domain:google.
-        # "user:mike@example.com",
+        # com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/
-        # "group:admins@example.com",
+        # resourcemanager.organizationAdmin - members: - user:eve@example.com role:
-        # "domain:google.com",
+        # roles/resourcemanager.organizationViewer condition: title: expirable access
-        # "serviceAccount:my-project-id@appspot.gserviceaccount.com"
+        # 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/).
-        # "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::BinaryauthorizationV1::IamPolicy]
         attr_accessor :policy
@@ -685,10 +575,9 @@ module Google
       class TestIamPermissionsRequest
         include Google::Apis::Core::Hashable
       
-        # The set of permissions to check for the `resource`. Permissions with
+        # The set of permissions to check for the `resource`. Permissions with wildcards
-        # wildcards (such as '*' or 'storage.*') are not allowed. For more
+        # (such as '*' or 'storage.*') are not allowed. For more information see [IAM
-        # information see
+        # Overview](https://cloud.google.com/iam/docs/overview#permissions).
-        # [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
         # Corresponds to the JSON property `permissions`
         # @return [Array<String>]
         attr_accessor :permissions
@@ -707,8 +596,7 @@ module Google
       class TestIamPermissionsResponse
         include Google::Apis::Core::Hashable
       
-        # A subset of `TestPermissionsRequest.permissions` that the caller is
+        # A subset of `TestPermissionsRequest.permissions` that the caller is allowed.
-        # allowed.
         # Corresponds to the JSON property `permissions`
         # @return [Array<String>]
         attr_accessor :permissions
@@ -723,40 +611,37 @@ module Google
         end
       end
       
-      # An user owned Grafeas note references a Grafeas
+      # An user owned Grafeas note references a Grafeas Attestation.Authority Note
-      # Attestation.Authority Note created by the user.
+      # created by the user.
       class UserOwnedGrafeasNote
         include Google::Apis::Core::Hashable
       
-        # Output only. This field will contain the service account email address
+        # Output only. This field will contain the service account email address that
-        # that this Attestor will use as the principal when querying Container
+        # this Attestor will use as the principal when querying Container Analysis.
-        # Analysis. Attestor administrators must grant this service account the
+        # Attestor administrators must grant this service account the IAM role needed to
-        # IAM role needed to read attestations from the note_reference in
+        # read attestations from the note_reference in Container Analysis (`
-        # Container Analysis (`containeranalysis.notes.occurrences.viewer`).
+        # containeranalysis.notes.occurrences.viewer`). This email address is fixed for
-        # This email address is fixed for the lifetime of the Attestor, but callers
+        # the lifetime of the Attestor, but callers should not make any other
-        # should not make any other assumptions about the service account email;
+        # assumptions about the service account email; future versions may use an email
-        # future versions may use an email based on a different naming pattern.
+        # based on a different naming pattern.
         # Corresponds to the JSON property `delegationServiceAccountEmail`
         # @return [String]
         attr_accessor :delegation_service_account_email
       
-        # Required. The Grafeas resource name of a Attestation.Authority Note,
+        # Required. The Grafeas resource name of a Attestation.Authority Note, created
-        # created by the user, in the format: `projects/*/notes/*`. This field may
+        # by the user, in the format: `projects/*/notes/*`. This field may not be
-        # not be updated.
+        # updated. An attestation by this attestor is stored as a Grafeas Attestation.
-        # An attestation by this attestor is stored as a Grafeas
+        # Authority Occurrence that names a container image and that links to this Note.
-        # Attestation.Authority Occurrence that names a container image and that
+        # Grafeas is an external dependency.
-        # links to this Note. Grafeas is an external dependency.
         # Corresponds to the JSON property `noteReference`
         # @return [String]
         attr_accessor :note_reference
       
-        # Optional. Public keys that verify attestations signed by this
+        # Optional. Public keys that verify attestations signed by this attestor. This
-        # attestor.  This field may be updated.
+        # field may be updated. If this field is non-empty, one of the specified public
-        # If this field is non-empty, one of the specified public keys must
+        # keys must verify that an attestation was signed by this attestor for the image
-        # verify that an attestation was signed by this attestor for the
+        # specified in the admission request. If this field is empty, this attestor
-        # image specified in the admission request.
+        # always returns that no valid attestations exist.
-        # If this field is empty, this attestor always returns that no
-        # valid attestations exist.
         # Corresponds to the JSON property `publicKeys`
         # @return [Array<Google::Apis::BinaryauthorizationV1::AttestorPublicKey>]
         attr_accessor :public_keys

generated/google/apis/binaryauthorization_v1/service.rb

@@ -48,15 +48,14 @@ module Google
           @batch_path = 'batch'
         end
         
-        # A policy specifies the attestors that must attest to
+        # A policy specifies the attestors that must attest to a container image, before
-        # a container image, before the project is allowed to deploy that
+        # the project is allowed to deploy that image. There is at most one policy per
-        # image. There is at most one policy per project. All image admission
+        # project. All image admission requests are permitted if a project has no policy.
-        # requests are permitted if a project has no policy.
+        # Gets the policy for this project. Returns a default policy if the project
-        # Gets the policy for this project. Returns a default
+        # does not have one.
-        # policy if the project does not have one.
         # @param [String] name
-        #   Required. The resource name of the policy to retrieve,
+        #   Required. The resource name of the policy to retrieve, in the format `projects/
-        #   in the format `projects/*/policy`.
+        #   */policy`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -84,14 +83,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates or updates a project's policy, and returns a copy of the
+        # Creates or updates a project's policy, and returns a copy of the new policy. A
-        # new policy. A policy is always updated as a whole, to avoid race
+        # policy is always updated as a whole, to avoid race conditions with concurrent
-        # conditions with concurrent policy enforcement (or management!)
+        # policy enforcement (or management!) requests. Returns NOT_FOUND if the project
-        # requests. Returns NOT_FOUND if the project does not exist, INVALID_ARGUMENT
+        # does not exist, INVALID_ARGUMENT if the request is malformed.
-        # if the request is malformed.
         # @param [String] name
-        #   Output only. The resource name, in the format `projects/*/policy`. There is
+        #   Output only. The resource name, in the format `projects/*/policy`. There is at
-        #   at most one policy per project.
+        #   most one policy per project.
         # @param [Google::Apis::BinaryauthorizationV1::Policy] policy_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -122,10 +120,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates an attestor, and returns a copy of the new
+        # Creates an attestor, and returns a copy of the new attestor. Returns NOT_FOUND
-        # attestor. Returns NOT_FOUND if the project does not exist,
+        # if the project does not exist, INVALID_ARGUMENT if the request is malformed,
-        # INVALID_ARGUMENT if the request is malformed, ALREADY_EXISTS if the
+        # ALREADY_EXISTS if the attestor already exists.
-        # attestor already exists.
         # @param [String] parent
         #   Required. The parent of this attestor.
         # @param [Google::Apis::BinaryauthorizationV1::Attestor] attestor_object
@@ -161,11 +158,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes an attestor. Returns NOT_FOUND if the
+        # Deletes an attestor. Returns NOT_FOUND if the attestor does not exist.
-        # attestor does not exist.
         # @param [String] name
-        #   Required. The name of the attestors to delete, in the format
+        #   Required. The name of the attestors to delete, in the format `projects/*/
-        #   `projects/*/attestors/*`.
+        #   attestors/*`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -193,11 +189,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets an attestor.
+        # Gets an attestor. Returns NOT_FOUND if the attestor does not exist.
-        # Returns NOT_FOUND if the attestor does not exist.
         # @param [String] name
-        #   Required. The name of the attestor to retrieve, in the format
+        #   Required. The name of the attestor to retrieve, in the format `projects/*/
-        #   `projects/*/attestors/*`.
+        #   attestors/*`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -225,22 +220,19 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the access control policy for a resource.
+        # Gets the access control policy for a resource. Returns an empty policy if the
-        # Returns an empty policy if the resource exists and does not have a policy
+        # resource exists and does not have a policy set.
-        # set.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being requested.
+        #   REQUIRED: The resource for which the policy is being requested. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Fixnum] options_requested_policy_version
-        #   Optional. The policy format version to be returned.
+        #   Optional. The policy format version to be returned. Valid values are 0, 1, and
-        #   Valid values are 0, 1, and 3. Requests specifying an invalid value will be
+        #   3. Requests specifying an invalid value will be rejected. Requests for
-        #   rejected.
+        #   policies with any conditional bindings must specify version 3. Policies
-        #   Requests for policies with any conditional bindings must specify version 3.
+        #   without any conditional bindings may specify any valid value or leave the
-        #   Policies without any conditional bindings may specify any valid value or
+        #   field unset. To learn which resources support conditions in their IAM policies,
-        #   leave the field unset.
+        #   see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
-        #   To learn which resources support conditions in their IAM policies, see the
+        #   resource-policies).
-        #   [IAM
-        #   documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -269,18 +261,17 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists attestors.
+        # Lists attestors. Returns INVALID_ARGUMENT if the project does not exist.
-        # Returns INVALID_ARGUMENT if the project does not exist.
         # @param [String] parent
-        #   Required. The resource name of the project associated with the
+        #   Required. The resource name of the project associated with the attestors, in
-        #   attestors, in the format `projects/*`.
+        #   the format `projects/*`.
         # @param [Fixnum] page_size
         #   Requested page size. The server may return fewer results than requested. If
         #   unspecified, the server will pick an appropriate default.
         # @param [String] page_token
         #   A token identifying a page of results the server should return. Typically,
-        #   this is the value of ListAttestorsResponse.next_page_token returned
+        #   this is the value of ListAttestorsResponse.next_page_token returned from the
-        #   from the previous call to the `ListAttestors` method.
+        #   previous call to the `ListAttestors` method.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -311,11 +302,11 @@ module Google
         end
         
         # Sets the access control policy on the specified resource. Replaces any
-        # existing policy.
+        # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
-        # Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.
+        # PERMISSION_DENIED` errors.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being specified.
+        #   REQUIRED: The resource for which the policy is being specified. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::BinaryauthorizationV1::SetIamPolicyRequest] set_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -346,15 +337,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns permissions that a caller has on the specified resource.
+        # Returns permissions that a caller has on the specified resource. If the
-        # If the resource does not exist, this will return an empty set of
+        # resource does not exist, this will return an empty set of permissions, not a `
-        # permissions, not a `NOT_FOUND` error.
+        # NOT_FOUND` error. Note: This operation is designed to be used for building
-        # Note: This operation is designed to be used for building permission-aware
+        # permission-aware UIs and command-line tools, not for authorization checking.
-        # UIs and command-line tools, not for authorization checking. This operation
+        # This operation may "fail open" without warning.
-        # may "fail open" without warning.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy detail is being requested.
+        #   REQUIRED: The resource for which the policy detail is being requested. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::BinaryauthorizationV1::TestIamPermissionsRequest] test_iam_permissions_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -385,11 +375,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates an attestor.
+        # Updates an attestor. Returns NOT_FOUND if the attestor does not exist.
-        # Returns NOT_FOUND if the attestor does not exist.
         # @param [String] name
-        #   Required. The resource name, in the format:
+        #   Required. The resource name, in the format: `projects/*/attestors/*`. This
-        #   `projects/*/attestors/*`. This field may not be updated.
+        #   field may not be updated.
         # @param [Google::Apis::BinaryauthorizationV1::Attestor] attestor_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -420,22 +409,19 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the access control policy for a resource.
+        # Gets the access control policy for a resource. Returns an empty policy if the
-        # Returns an empty policy if the resource exists and does not have a policy
+        # resource exists and does not have a policy set.
-        # set.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being requested.
+        #   REQUIRED: The resource for which the policy is being requested. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Fixnum] options_requested_policy_version
-        #   Optional. The policy format version to be returned.
+        #   Optional. The policy format version to be returned. Valid values are 0, 1, and
-        #   Valid values are 0, 1, and 3. Requests specifying an invalid value will be
+        #   3. Requests specifying an invalid value will be rejected. Requests for
-        #   rejected.
+        #   policies with any conditional bindings must specify version 3. Policies
-        #   Requests for policies with any conditional bindings must specify version 3.
+        #   without any conditional bindings may specify any valid value or leave the
-        #   Policies without any conditional bindings may specify any valid value or
+        #   field unset. To learn which resources support conditions in their IAM policies,
-        #   leave the field unset.
+        #   see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
-        #   To learn which resources support conditions in their IAM policies, see the
+        #   resource-policies).
-        #   [IAM
-        #   documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -465,11 +451,11 @@ module Google
         end
         
         # Sets the access control policy on the specified resource. Replaces any
-        # existing policy.
+        # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
-        # Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.
+        # PERMISSION_DENIED` errors.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being specified.
+        #   REQUIRED: The resource for which the policy is being specified. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::BinaryauthorizationV1::SetIamPolicyRequest] set_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -500,15 +486,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns permissions that a caller has on the specified resource.
+        # Returns permissions that a caller has on the specified resource. If the
-        # If the resource does not exist, this will return an empty set of
+        # resource does not exist, this will return an empty set of permissions, not a `
-        # permissions, not a `NOT_FOUND` error.
+        # NOT_FOUND` error. Note: This operation is designed to be used for building
-        # Note: This operation is designed to be used for building permission-aware
+        # permission-aware UIs and command-line tools, not for authorization checking.
-        # UIs and command-line tools, not for authorization checking. This operation
+        # This operation may "fail open" without warning.
-        # may "fail open" without warning.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy detail is being requested.
+        #   REQUIRED: The resource for which the policy detail is being requested. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::BinaryauthorizationV1::TestIamPermissionsRequest] test_iam_permissions_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.

generated/google/apis/binaryauthorization_v1beta1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/binary-authorization/
     module BinaryauthorizationV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20200731'
+      REVISION = '20200807'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/binaryauthorization_v1beta1/classes.rb

@@ -22,12 +22,11 @@ module Google
   module Apis
     module BinaryauthorizationV1beta1
       
-      # An admission rule specifies either that all container images
+      # An admission rule specifies either that all container images used in a pod
-      # used in a pod creation request must be attested to by one or more
+      # creation request must be attested to by one or more attestors, that all pod
-      # attestors, that all pod creations will be allowed, or that all
+      # creations will be allowed, or that all pod creations will be denied. Images
-      # pod creations will be denied.
+      # matching an admission whitelist pattern are exempted from admission rules and
-      # Images matching an admission whitelist pattern
+      # will never block a pod creation.
-      # are exempted from admission rules and will never block a pod creation.
       class AdmissionRule
         include Google::Apis::Core::Hashable
       
@@ -41,11 +40,10 @@ module Google
         # @return [String]
         attr_accessor :evaluation_mode
       
-        # Optional. The resource names of the attestors that must attest to
+        # Optional. The resource names of the attestors that must attest to a container
-        # a container image, in the format `projects/*/attestors/*`. Each
+        # image, in the format `projects/*/attestors/*`. Each attestor must exist before
-        # attestor must exist before a policy can reference it.  To add an attestor
+        # a policy can reference it. To add an attestor to a policy the principal
-        # to a policy the principal issuing the policy change request must be able
+        # issuing the policy change request must be able to read the attestor resource.
-        # to read the attestor resource.
         # Note: this field must be non-empty when the evaluation_mode field specifies
         # REQUIRE_ATTESTATION, otherwise it must be empty.
         # Corresponds to the JSON property `requireAttestationsBy`
@@ -64,14 +62,13 @@ module Google
         end
       end
       
-      # An admission whitelist pattern exempts images
+      # An admission whitelist pattern exempts images from checks by admission rules.
-      # from checks by admission rules.
       class AdmissionWhitelistPattern
         include Google::Apis::Core::Hashable
       
-        # An image name pattern to whitelist, in the form `registry/path/to/image`.
+        # An image name pattern to whitelist, in the form `registry/path/to/image`. This
-        # This supports a trailing `*` as a wildcard, but this is allowed only in
+        # supports a trailing `*` as a wildcard, but this is allowed only in text after
-        # text after the `registry/` part.
+        # the `registry/` part.
         # Corresponds to the JSON property `namePattern`
         # @return [String]
         attr_accessor :name_pattern
@@ -86,20 +83,19 @@ module Google
         end
       end
       
-      # An attestor that attests to container image
+      # An attestor that attests to container image artifacts. An existing attestor
-      # artifacts. An existing attestor cannot be modified except where
+      # cannot be modified except where indicated.
-      # indicated.
       class Attestor
         include Google::Apis::Core::Hashable
       
-        # Optional. A descriptive comment.  This field may be updated.
+        # Optional. A descriptive comment. This field may be updated. The field may be
-        # The field may be displayed in chooser dialogs.
+        # displayed in chooser dialogs.
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
       
-        # Required. The resource name, in the format:
+        # Required. The resource name, in the format: `projects/*/attestors/*`. This
-        # `projects/*/attestors/*`. This field may not be updated.
+        # field may not be updated.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -109,8 +105,8 @@ module Google
         # @return [String]
         attr_accessor :update_time
       
-        # An user owned drydock note references a Drydock
+        # An user owned drydock note references a Drydock ATTESTATION_AUTHORITY Note
-        # ATTESTATION_AUTHORITY Note created by the user.
+        # created by the user.
         # Corresponds to the JSON property `userOwnedDrydockNote`
         # @return [Google::Apis::BinaryauthorizationV1beta1::UserOwnedDrydockNote]
         attr_accessor :user_owned_drydock_note
@@ -128,19 +124,17 @@ module Google
         end
       end
       
-      # An attestor public key that will be used to verify
+      # An attestor public key that will be used to verify attestations signed by this
-      # attestations signed by this attestor.
+      # attestor.
       class AttestorPublicKey
         include Google::Apis::Core::Hashable
       
-        # ASCII-armored representation of a PGP public key, as the entire output by
+        # ASCII-armored representation of a PGP public key, as the entire output by the
-        # the command `gpg --export --armor foo@example.com` (either LF or CRLF
+        # command `gpg --export --armor foo@example.com` (either LF or CRLF line endings)
-        # line endings).
+        # . When using this field, `id` should be left blank. The BinAuthz API handlers
-        # When using this field, `id` should be left blank.  The BinAuthz API
+        # will calculate the ID and fill it in automatically. BinAuthz computes this ID
-        # handlers will calculate the ID and fill it in automatically.  BinAuthz
+        # as the OpenPGP RFC4880 V4 fingerprint, represented as upper-case hex. If `id`
-        # computes this ID as the OpenPGP RFC4880 V4 fingerprint, represented as
+        # is provided by the caller, it will be overwritten by the API-calculated ID.
-        # upper-case hex.  If `id` is provided by the caller, it will be
-        # overwritten by the API-calculated ID.
         # Corresponds to the JSON property `asciiArmoredPgpPublicKey`
         # @return [String]
         attr_accessor :ascii_armored_pgp_public_key
@@ -150,21 +144,18 @@ module Google
         # @return [String]
         attr_accessor :comment
       
-        # The ID of this public key.
+        # The ID of this public key. Signatures verified by BinAuthz must include the ID
-        # Signatures verified by BinAuthz must include the ID of the public key that
+        # of the public key that can be used to verify them, and that ID must match the
-        # can be used to verify them, and that ID must match the contents of this
+        # contents of this field exactly. Additional restrictions on this field can be
-        # field exactly.
+        # imposed based on which public key type is encapsulated. See the documentation
-        # Additional restrictions on this field can be imposed based on which public
+        # on `public_key` cases below for details.
-        # key type is encapsulated. See the documentation on `public_key` cases below
-        # for details.
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
       
-        # A public key in the PkixPublicKey format (see
+        # A public key in the PkixPublicKey format (see https://tools.ietf.org/html/
-        # https://tools.ietf.org/html/rfc5280#section-4.1.2.7 for details).
+        # rfc5280#section-4.1.2.7 for details). Public keys of this type are typically
-        # Public keys of this type are typically textually encoded using the PEM
+        # textually encoded using the PEM format.
-        # format.
         # Corresponds to the JSON property `pkixPublicKey`
         # @return [Google::Apis::BinaryauthorizationV1beta1::PkixPublicKey]
         attr_accessor :pkix_public_key
@@ -186,69 +177,57 @@ module Google
       class Binding
         include Google::Apis::Core::Hashable
       
-        # Represents a textual expression in the Common Expression Language (CEL)
+        # Represents a textual expression in the Common Expression Language (CEL) syntax.
-        # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
+        # CEL is a C-like expression language. The syntax and semantics of CEL are
-        # are documented at https://github.com/google/cel-spec.
+        # documented at https://github.com/google/cel-spec. Example (Comparison): title:
-        # Example (Comparison):
+        # "Summary size limit" description: "Determines if a summary is less than 100
-        # title: "Summary size limit"
+        # chars" expression: "document.summary.size() < 100" Example (Equality): title: "
-        # description: "Determines if a summary is less than 100 chars"
+        # Requestor is owner" description: "Determines if requestor is the document
-        # expression: "document.summary.size() < 100"
+        # owner" expression: "document.owner == request.auth.claims.email" Example (
-        # Example (Equality):
+        # Logic): title: "Public documents" description: "Determine whether the document
-        # title: "Requestor is owner"
+        # should be publicly visible" expression: "document.type != 'private' &&
-        # description: "Determines if requestor is the document owner"
+        # document.type != 'internal'" Example (Data Manipulation): title: "Notification
-        # expression: "document.owner == request.auth.claims.email"
+        # string" description: "Create a notification string with a timestamp."
-        # Example (Logic):
+        # expression: "'New message received at ' + string(document.create_time)" The
-        # title: "Public documents"
+        # exact variables and functions that may be referenced within an expression are
-        # description: "Determine whether the document should be publicly visible"
+        # determined by the service that evaluates it. See the service documentation for
-        # expression: "document.type != 'private' && document.type != 'internal'"
+        # additional information.
-        # 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::BinaryauthorizationV1beta1::Expr]
         attr_accessor :condition
       
-        # Specifies the identities requesting access for a Cloud Platform resource.
+        # Specifies the identities requesting access for a Cloud Platform resource. `
-        # `members` can have the following values:
+        # members` can have the following values: * `allUsers`: A special identifier
-        # * `allUsers`: A special identifier that represents anyone who is
+        # that represents anyone who is on the internet; with or without a Google
-        # on the internet; with or without a Google account.
+        # account. * `allAuthenticatedUsers`: A special identifier that represents
-        # * `allAuthenticatedUsers`: A special identifier that represents anyone
+        # anyone who is authenticated with a Google account or a service account. * `
-        # who is authenticated with a Google account or a service account.
+        # user:`emailid``: An email address that represents a specific Google account.
-        # * `user:`emailid``: An email address that represents a specific Google
+        # For example, `alice@example.com` . * `serviceAccount:`emailid``: An email
-        # account. For example, `alice@example.com` .
+        # address that represents a service account. For example, `my-other-app@appspot.
-        # * `serviceAccount:`emailid``: An email address that represents a service
+        # gserviceaccount.com`. * `group:`emailid``: An email address that represents a
-        # account. For example, `my-other-app@appspot.gserviceaccount.com`.
+        # Google group. For example, `admins@example.com`. * `deleted:user:`emailid`?uid=
-        # * `group:`emailid``: An email address that represents a Google group.
+        # `uniqueid``: An email address (plus unique identifier) representing a user
-        # For example, `admins@example.com`.
+        # that has been recently deleted. For example, `alice@example.com?uid=
-        # * `deleted:user:`emailid`?uid=`uniqueid``: An email address (plus unique
+        # 123456789012345678901`. If the user is recovered, this value reverts to `user:`
-        # identifier) representing a user that has been recently deleted. For
+        # emailid`` and the recovered user retains the role in the binding. * `deleted:
-        # example, `alice@example.com?uid=123456789012345678901`. If the user is
+        # serviceAccount:`emailid`?uid=`uniqueid``: An email address (plus unique
-        # recovered, this value reverts to `user:`emailid`` and the recovered user
+        # identifier) representing a service account that has been recently deleted. For
-        # retains the role in the binding.
+        # example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`.
-        # * `deleted:serviceAccount:`emailid`?uid=`uniqueid``: An email address (plus
+        # If the service account is undeleted, this value reverts to `serviceAccount:`
-        # unique identifier) representing a service account that has been recently
+        # emailid`` and the undeleted service account retains the role in the binding. *
-        # deleted. For example,
+        # `deleted:group:`emailid`?uid=`uniqueid``: An email address (plus unique
-        # `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`.
+        # identifier) representing a Google group that has been recently deleted. For
-        # If the service account is undeleted, this value reverts to
+        # example, `admins@example.com?uid=123456789012345678901`. If the group is
-        # `serviceAccount:`emailid`` and the undeleted service account retains the
+        # recovered, this value reverts to `group:`emailid`` and the recovered group
-        # role in the binding.
+        # retains the role in the binding. * `domain:`domain``: The G Suite domain (
-        # * `deleted:group:`emailid`?uid=`uniqueid``: An email address (plus unique
+        # primary) that represents all the users of that domain. For example, `google.
-        # identifier) representing a Google group that has been recently
+        # com` or `example.com`.
-        # 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`.
+        # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`
-        # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+        # , or `roles/owner`.
         # Corresponds to the JSON property `role`
         # @return [String]
         attr_accessor :role
@@ -265,13 +244,11 @@ module Google
         end
       end
       
-      # A generic empty message that you can re-use to avoid defining duplicated
+      # A generic empty message that you can re-use to avoid defining duplicated empty
-      # empty messages in your APIs. A typical example is to use it as the request
+      # messages in your APIs. A typical example is to use it as the request or the
-      # or the response type of an API method. For instance:
+      # response type of an API method. For instance: service Foo ` rpc Bar(google.
-      # service Foo `
+      # protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for
-      # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      # `Empty` is empty JSON object ````.
-      # `
-      # The JSON representation for `Empty` is empty JSON object ````.
       class Empty
         include Google::Apis::Core::Hashable
       
@@ -284,52 +261,43 @@ module Google
         end
       end
       
-      # Represents a textual expression in the Common Expression Language (CEL)
+      # Represents a textual expression in the Common Expression Language (CEL) syntax.
-      # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
+      # CEL is a C-like expression language. The syntax and semantics of CEL are
-      # are documented at https://github.com/google/cel-spec.
+      # documented at https://github.com/google/cel-spec. Example (Comparison): title:
-      # Example (Comparison):
+      # "Summary size limit" description: "Determines if a summary is less than 100
-      # title: "Summary size limit"
+      # chars" expression: "document.summary.size() < 100" Example (Equality): title: "
-      # description: "Determines if a summary is less than 100 chars"
+      # Requestor is owner" description: "Determines if requestor is the document
-      # expression: "document.summary.size() < 100"
+      # owner" expression: "document.owner == request.auth.claims.email" Example (
-      # Example (Equality):
+      # Logic): title: "Public documents" description: "Determine whether the document
-      # title: "Requestor is owner"
+      # should be publicly visible" expression: "document.type != 'private' &&
-      # description: "Determines if requestor is the document owner"
+      # document.type != 'internal'" Example (Data Manipulation): title: "Notification
-      # expression: "document.owner == request.auth.claims.email"
+      # string" description: "Create a notification string with a timestamp."
-      # Example (Logic):
+      # expression: "'New message received at ' + string(document.create_time)" The
-      # title: "Public documents"
+      # exact variables and functions that may be referenced within an expression are
-      # description: "Determine whether the document should be publicly visible"
+      # determined by the service that evaluates it. See the service documentation for
-      # expression: "document.type != 'private' && document.type != 'internal'"
+      # additional information.
-      # 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
+        # Optional. Description of the expression. This is a longer text which describes
-        # describes the expression, e.g. when hovered over it in a UI.
+        # 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
+        # Textual representation of an expression in Common Expression Language syntax.
-        # syntax.
         # Corresponds to the JSON property `expression`
         # @return [String]
         attr_accessor :expression
       
-        # Optional. String indicating the location of the expression for error
+        # Optional. String indicating the location of the expression for error reporting,
-        # reporting, e.g. a file name and a position in the file.
+        # 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
+        # Optional. Title for the expression, i.e. a short string describing its purpose.
-        # its purpose. This can be used e.g. in UIs which allow to enter the
+        # This can be used e.g. in UIs which allow to enter the expression.
-        # expression.
         # Corresponds to the JSON property `title`
         # @return [String]
         attr_accessor :title
@@ -348,111 +316,73 @@ module Google
       end
       
       # An Identity and Access Management (IAM) policy, which specifies access
-      # controls for Google Cloud resources.
+      # controls for Google Cloud resources. A `Policy` is a collection of `bindings`.
-      # A `Policy` is a collection of `bindings`. A `binding` binds one or more
+      # A `binding` binds one or more `members` to a single `role`. Members can be
-      # `members` to a single `role`. Members can be user accounts, service accounts,
+      # user accounts, service accounts, Google groups, and domains (such as G Suite).
-      # Google groups, and domains (such as G Suite). A `role` is a named list of
+      # A `role` is a named list of permissions; each `role` can be an IAM predefined
-      # permissions; each `role` can be an IAM predefined role or a user-created
+      # role or a user-created custom role. For some types of Google Cloud resources,
-      # custom role.
+      # a `binding` can also specify a `condition`, which is a logical expression that
-      # For some types of Google Cloud resources, a `binding` can also specify a
+      # allows access to a resource only if the expression evaluates to `true`. A
-      # `condition`, which is a logical expression that allows access to a resource
+      # condition can add constraints based on attributes of the request, the resource,
-      # only if the expression evaluates to `true`. A condition can add constraints
+      # or both. To learn which resources support conditions in their IAM policies,
-      # based on attributes of the request, the resource, or both. To learn which
+      # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
-      # resources support conditions in their IAM policies, see the
+      # resource-policies). **JSON example:** ` "bindings": [ ` "role": "roles/
-      # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
+      # resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "
-      # policies).
+      # group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@
-      # **JSON example:**
+      # appspot.gserviceaccount.com" ] `, ` "role": "roles/resourcemanager.
-      # `
+      # organizationViewer", "members": [ "user:eve@example.com" ], "condition": ` "
-      # "bindings": [
+      # title": "expirable access", "description": "Does not grant access after Sep
-      # `
+      # 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", `
-      # "role": "roles/resourcemanager.organizationAdmin",
+      # ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:** bindings: -
-      # "members": [
+      # members: - user:mike@example.com - group:admins@example.com - domain:google.
-      # "user:mike@example.com",
+      # com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/
-      # "group:admins@example.com",
+      # resourcemanager.organizationAdmin - members: - user:eve@example.com role:
-      # "domain:google.com",
+      # roles/resourcemanager.organizationViewer condition: title: expirable access
-      # "serviceAccount:my-project-id@appspot.gserviceaccount.com"
+      # 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/).
-      # "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 IamPolicy
         include Google::Apis::Core::Hashable
       
-        # Associates a list of `members` to a `role`. Optionally, may specify a
+        # Associates a list of `members` to a `role`. Optionally, may specify a `
-        # `condition` that determines how and when the `bindings` are applied. Each
+        # condition` that determines how and when the `bindings` are applied. Each of
-        # of the `bindings` must contain at least one member.
+        # the `bindings` must contain at least one member.
         # Corresponds to the JSON property `bindings`
         # @return [Array<Google::Apis::BinaryauthorizationV1beta1::Binding>]
         attr_accessor :bindings
       
-        # `etag` is used for optimistic concurrency control as a way to help
+        # `etag` is used for optimistic concurrency control as a way to help prevent
-        # prevent simultaneous updates of a policy from overwriting each other.
+        # simultaneous updates of a policy from overwriting each other. It is strongly
-        # It is strongly suggested that systems make use of the `etag` in the
+        # suggested that systems make use of the `etag` in the read-modify-write cycle
-        # read-modify-write cycle to perform policy updates in order to avoid race
+        # to perform policy updates in order to avoid race conditions: An `etag` is
-        # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+        # returned in the response to `getIamPolicy`, and systems are expected to put
-        # systems are expected to put that etag in the request to `setIamPolicy` to
+        # that etag in the request to `setIamPolicy` to ensure that their change will be
-        # ensure that their change will be applied to the same version of the policy.
+        # applied to the same version of the policy. **Important:** If you use IAM
-        # **Important:** If you use IAM Conditions, you must include the `etag` field
+        # Conditions, you must include the `etag` field whenever you call `setIamPolicy`.
-        # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
+        # If you omit this field, then IAM allows you to overwrite a version `3` policy
-        # you to overwrite a version `3` policy with a version `1` policy, and all of
+        # with a version `1` policy, and all of the conditions in the version `3` policy
-        # the conditions in the version `3` policy are lost.
+        # 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.
+        # Specifies the format of the policy. Valid values are `0`, `1`, and `3`.
-        # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
+        # Requests that specify an invalid value are rejected. Any operation that
-        # are rejected.
+        # affects conditional role bindings must specify version `3`. This requirement
-        # Any operation that affects conditional role bindings must specify version
+        # applies to the following operations: * Getting a policy that includes a
-        # `3`. This requirement applies to the following operations:
+        # conditional role binding * Adding a conditional role binding to a policy *
-        # * Getting a policy that includes a conditional role binding
+        # Changing a conditional role binding in a policy * Removing any role binding,
-        # * Adding a conditional role binding to a policy
+        # with or without a condition, from a policy that includes conditions **
-        # * Changing a conditional role binding in a policy
+        # Important:** If you use IAM Conditions, you must include the `etag` field
-        # * Removing any role binding, with or without a condition, from a policy
+        # whenever you call `setIamPolicy`. If you omit this field, then IAM allows you
-        # that includes conditions
+        # to overwrite a version `3` policy with a version `1` policy, and all of the
-        # **Important:** If you use IAM Conditions, you must include the `etag` field
+        # conditions in the version `3` policy are lost. If a policy does not include
-        # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
+        # any conditions, operations on that policy may specify any valid version or
-        # you to overwrite a version `3` policy with a version `1` policy, and all of
+        # leave the field unset. To learn which resources support conditions in their
-        # the conditions in the version `3` policy are lost.
+        # IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/
-        # If a policy does not include any conditions, operations on that policy may
+        # conditions/resource-policies).
-        # 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
@@ -479,8 +409,8 @@ module Google
         attr_accessor :attestors
       
         # A token to retrieve the next page of results. Pass this value in the
-        # ListAttestorsRequest.page_token field in the subsequent call to the
+        # ListAttestorsRequest.page_token field in the subsequent call to the `
-        # `ListAttestors` method to retrieve the next page of results.
+        # ListAttestors` method to retrieve the next page of results.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -496,24 +426,22 @@ module Google
         end
       end
       
-      # A public key in the PkixPublicKey format (see
+      # A public key in the PkixPublicKey format (see https://tools.ietf.org/html/
-      # https://tools.ietf.org/html/rfc5280#section-4.1.2.7 for details).
+      # rfc5280#section-4.1.2.7 for details). Public keys of this type are typically
-      # Public keys of this type are typically textually encoded using the PEM
+      # textually encoded using the PEM format.
-      # format.
       class PkixPublicKey
         include Google::Apis::Core::Hashable
       
-        # A PEM-encoded public key, as described in
+        # A PEM-encoded public key, as described in https://tools.ietf.org/html/rfc7468#
-        # https://tools.ietf.org/html/rfc7468#section-13
+        # section-13
         # Corresponds to the JSON property `publicKeyPem`
         # @return [String]
         attr_accessor :public_key_pem
       
         # The signature algorithm used to verify a message against a signature using
-        # this key.
+        # this key. These signature algorithm must match the structure and any object
-        # These signature algorithm must match the structure and any object
+        # identifiers encoded in `public_key_pem` (i.e. this algorithm must match that
-        # identifiers encoded in `public_key_pem` (i.e. this algorithm must match
+        # of the public key).
-        # that of the public key).
         # Corresponds to the JSON property `signatureAlgorithm`
         # @return [String]
         attr_accessor :signature_algorithm
@@ -534,30 +462,26 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Optional. Admission policy whitelisting. A matching admission request will
-        # always be permitted. This feature is typically used to exclude Google or
+        # always be permitted. This feature is typically used to exclude Google or third-
-        # third-party infrastructure images from Binary Authorization policies.
+        # party infrastructure images from Binary Authorization policies.
         # Corresponds to the JSON property `admissionWhitelistPatterns`
         # @return [Array<Google::Apis::BinaryauthorizationV1beta1::AdmissionWhitelistPattern>]
         attr_accessor :admission_whitelist_patterns
       
-        # Optional. Per-cluster admission rules. Cluster spec format:
+        # Optional. Per-cluster admission rules. Cluster spec format: `location.
-        # `location.clusterId`. There can be at most one admission rule per cluster
+        # clusterId`. There can be at most one admission rule per cluster spec. A `
-        # spec.
+        # location` is either a compute zone (e.g. us-central1-a) or a region (e.g. us-
-        # A `location` is either a compute zone (e.g. us-central1-a) or a region
+        # central1). For `clusterId` syntax restrictions see https://cloud.google.com/
-        # (e.g. us-central1).
+        # container-engine/reference/rest/v1/projects.zones.clusters.
-        # For `clusterId` syntax restrictions see
-        # https://cloud.google.com/container-engine/reference/rest/v1/projects.zones.
-        # clusters.
         # Corresponds to the JSON property `clusterAdmissionRules`
         # @return [Hash<String,Google::Apis::BinaryauthorizationV1beta1::AdmissionRule>]
         attr_accessor :cluster_admission_rules
       
-        # An admission rule specifies either that all container images
+        # An admission rule specifies either that all container images used in a pod
-        # used in a pod creation request must be attested to by one or more
+        # creation request must be attested to by one or more attestors, that all pod
-        # attestors, that all pod creations will be allowed, or that all
+        # creations will be allowed, or that all pod creations will be denied. Images
-        # pod creations will be denied.
+        # matching an admission whitelist pattern are exempted from admission rules and
-        # Images matching an admission whitelist pattern
+        # will never block a pod creation.
-        # are exempted from admission rules and will never block a pod creation.
         # Corresponds to the JSON property `defaultAdmissionRule`
         # @return [Google::Apis::BinaryauthorizationV1beta1::AdmissionRule]
         attr_accessor :default_admission_rule
@@ -568,15 +492,15 @@ module Google
         attr_accessor :description
       
         # Optional. Controls the evaluation of a Google-maintained global admission
-        # policy for common system-level images. Images not covered by the global
+        # policy for common system-level images. Images not covered by the global policy
-        # policy will be subject to the project admission policy. This setting
+        # will be subject to the project admission policy. This setting has no effect
-        # has no effect when specified inside a global admission policy.
+        # when specified inside a global admission policy.
         # Corresponds to the JSON property `globalPolicyEvaluationMode`
         # @return [String]
         attr_accessor :global_policy_evaluation_mode
       
-        # Output only. The resource name, in the format `projects/*/policy`. There is
+        # Output only. The resource name, in the format `projects/*/policy`. There is at
-        # at most one policy per project.
+        # most one policy per project.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -607,66 +531,32 @@ module Google
         include Google::Apis::Core::Hashable
       
         # An Identity and Access Management (IAM) policy, which specifies access
-        # controls for Google Cloud resources.
+        # controls for Google Cloud resources. A `Policy` is a collection of `bindings`.
-        # A `Policy` is a collection of `bindings`. A `binding` binds one or more
+        # A `binding` binds one or more `members` to a single `role`. Members can be
-        # `members` to a single `role`. Members can be user accounts, service accounts,
+        # user accounts, service accounts, Google groups, and domains (such as G Suite).
-        # Google groups, and domains (such as G Suite). A `role` is a named list of
+        # A `role` is a named list of permissions; each `role` can be an IAM predefined
-        # permissions; each `role` can be an IAM predefined role or a user-created
+        # role or a user-created custom role. For some types of Google Cloud resources,
-        # custom role.
+        # a `binding` can also specify a `condition`, which is a logical expression that
-        # For some types of Google Cloud resources, a `binding` can also specify a
+        # allows access to a resource only if the expression evaluates to `true`. A
-        # `condition`, which is a logical expression that allows access to a resource
+        # condition can add constraints based on attributes of the request, the resource,
-        # only if the expression evaluates to `true`. A condition can add constraints
+        # or both. To learn which resources support conditions in their IAM policies,
-        # based on attributes of the request, the resource, or both. To learn which
+        # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
-        # resources support conditions in their IAM policies, see the
+        # resource-policies). **JSON example:** ` "bindings": [ ` "role": "roles/
-        # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
+        # resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "
-        # policies).
+        # group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@
-        # **JSON example:**
+        # appspot.gserviceaccount.com" ] `, ` "role": "roles/resourcemanager.
-        # `
+        # organizationViewer", "members": [ "user:eve@example.com" ], "condition": ` "
-        # "bindings": [
+        # title": "expirable access", "description": "Does not grant access after Sep
-        # `
+        # 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", `
-        # "role": "roles/resourcemanager.organizationAdmin",
+        # ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:** bindings: -
-        # "members": [
+        # members: - user:mike@example.com - group:admins@example.com - domain:google.
-        # "user:mike@example.com",
+        # com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/
-        # "group:admins@example.com",
+        # resourcemanager.organizationAdmin - members: - user:eve@example.com role:
-        # "domain:google.com",
+        # roles/resourcemanager.organizationViewer condition: title: expirable access
-        # "serviceAccount:my-project-id@appspot.gserviceaccount.com"
+        # 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/).
-        # "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::BinaryauthorizationV1beta1::IamPolicy]
         attr_accessor :policy
@@ -685,10 +575,9 @@ module Google
       class TestIamPermissionsRequest
         include Google::Apis::Core::Hashable
       
-        # The set of permissions to check for the `resource`. Permissions with
+        # The set of permissions to check for the `resource`. Permissions with wildcards
-        # wildcards (such as '*' or 'storage.*') are not allowed. For more
+        # (such as '*' or 'storage.*') are not allowed. For more information see [IAM
-        # information see
+        # Overview](https://cloud.google.com/iam/docs/overview#permissions).
-        # [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
         # Corresponds to the JSON property `permissions`
         # @return [Array<String>]
         attr_accessor :permissions
@@ -707,8 +596,7 @@ module Google
       class TestIamPermissionsResponse
         include Google::Apis::Core::Hashable
       
-        # A subset of `TestPermissionsRequest.permissions` that the caller is
+        # A subset of `TestPermissionsRequest.permissions` that the caller is allowed.
-        # allowed.
         # Corresponds to the JSON property `permissions`
         # @return [Array<String>]
         attr_accessor :permissions
@@ -723,40 +611,37 @@ module Google
         end
       end
       
-      # An user owned drydock note references a Drydock
+      # An user owned drydock note references a Drydock ATTESTATION_AUTHORITY Note
-      # ATTESTATION_AUTHORITY Note created by the user.
+      # created by the user.
       class UserOwnedDrydockNote
         include Google::Apis::Core::Hashable
       
-        # Output only. This field will contain the service account email address
+        # Output only. This field will contain the service account email address that
-        # that this Attestor will use as the principal when querying Container
+        # this Attestor will use as the principal when querying Container Analysis.
-        # Analysis. Attestor administrators must grant this service account the
+        # Attestor administrators must grant this service account the IAM role needed to
-        # IAM role needed to read attestations from the note_reference in
+        # read attestations from the note_reference in Container Analysis (`
-        # Container Analysis (`containeranalysis.notes.occurrences.viewer`).
+        # containeranalysis.notes.occurrences.viewer`). This email address is fixed for
-        # This email address is fixed for the lifetime of the Attestor, but callers
+        # the lifetime of the Attestor, but callers should not make any other
-        # should not make any other assumptions about the service account email;
+        # assumptions about the service account email; future versions may use an email
-        # future versions may use an email based on a different naming pattern.
+        # based on a different naming pattern.
         # Corresponds to the JSON property `delegationServiceAccountEmail`
         # @return [String]
         attr_accessor :delegation_service_account_email
       
-        # Required. The Drydock resource name of a ATTESTATION_AUTHORITY Note,
+        # Required. The Drydock resource name of a ATTESTATION_AUTHORITY Note, created
-        # created by the user, in the format: `projects/*/notes/*` (or the legacy
+        # by the user, in the format: `projects/*/notes/*` (or the legacy `providers/*/
-        # `providers/*/notes/*`). This field may not be updated.
+        # notes/*`). This field may not be updated. An attestation by this attestor is
-        # An attestation by this attestor is stored as a Drydock
+        # stored as a Drydock ATTESTATION_AUTHORITY Occurrence that names a container
-        # ATTESTATION_AUTHORITY Occurrence that names a container image and that
+        # image and that links to this Note. Drydock is an external dependency.
-        # links to this Note. Drydock is an external dependency.
         # Corresponds to the JSON property `noteReference`
         # @return [String]
         attr_accessor :note_reference
       
-        # Optional. Public keys that verify attestations signed by this
+        # Optional. Public keys that verify attestations signed by this attestor. This
-        # attestor.  This field may be updated.
+        # field may be updated. If this field is non-empty, one of the specified public
-        # If this field is non-empty, one of the specified public keys must
+        # keys must verify that an attestation was signed by this attestor for the image
-        # verify that an attestation was signed by this attestor for the
+        # specified in the admission request. If this field is empty, this attestor
-        # image specified in the admission request.
+        # always returns that no valid attestations exist.
-        # If this field is empty, this attestor always returns that no
-        # valid attestations exist.
         # Corresponds to the JSON property `publicKeys`
         # @return [Array<Google::Apis::BinaryauthorizationV1beta1::AttestorPublicKey>]
         attr_accessor :public_keys

generated/google/apis/binaryauthorization_v1beta1/service.rb

@@ -48,15 +48,14 @@ module Google
           @batch_path = 'batch'
         end
         
-        # A policy specifies the attestors that must attest to
+        # A policy specifies the attestors that must attest to a container image, before
-        # a container image, before the project is allowed to deploy that
+        # the project is allowed to deploy that image. There is at most one policy per
-        # image. There is at most one policy per project. All image admission
+        # project. All image admission requests are permitted if a project has no policy.
-        # requests are permitted if a project has no policy.
+        # Gets the policy for this project. Returns a default policy if the project
-        # Gets the policy for this project. Returns a default
+        # does not have one.
-        # policy if the project does not have one.
         # @param [String] name
-        #   Required. The resource name of the policy to retrieve,
+        #   Required. The resource name of the policy to retrieve, in the format `projects/
-        #   in the format `projects/*/policy`.
+        #   */policy`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -84,14 +83,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates or updates a project's policy, and returns a copy of the
+        # Creates or updates a project's policy, and returns a copy of the new policy. A
-        # new policy. A policy is always updated as a whole, to avoid race
+        # policy is always updated as a whole, to avoid race conditions with concurrent
-        # conditions with concurrent policy enforcement (or management!)
+        # policy enforcement (or management!) requests. Returns NOT_FOUND if the project
-        # requests. Returns NOT_FOUND if the project does not exist, INVALID_ARGUMENT
+        # does not exist, INVALID_ARGUMENT if the request is malformed.
-        # if the request is malformed.
         # @param [String] name
-        #   Output only. The resource name, in the format `projects/*/policy`. There is
+        #   Output only. The resource name, in the format `projects/*/policy`. There is at
-        #   at most one policy per project.
+        #   most one policy per project.
         # @param [Google::Apis::BinaryauthorizationV1beta1::Policy] policy_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -122,10 +120,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates an attestor, and returns a copy of the new
+        # Creates an attestor, and returns a copy of the new attestor. Returns NOT_FOUND
-        # attestor. Returns NOT_FOUND if the project does not exist,
+        # if the project does not exist, INVALID_ARGUMENT if the request is malformed,
-        # INVALID_ARGUMENT if the request is malformed, ALREADY_EXISTS if the
+        # ALREADY_EXISTS if the attestor already exists.
-        # attestor already exists.
         # @param [String] parent
         #   Required. The parent of this attestor.
         # @param [Google::Apis::BinaryauthorizationV1beta1::Attestor] attestor_object
@@ -161,11 +158,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes an attestor. Returns NOT_FOUND if the
+        # Deletes an attestor. Returns NOT_FOUND if the attestor does not exist.
-        # attestor does not exist.
         # @param [String] name
-        #   Required. The name of the attestors to delete, in the format
+        #   Required. The name of the attestors to delete, in the format `projects/*/
-        #   `projects/*/attestors/*`.
+        #   attestors/*`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -193,11 +189,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets an attestor.
+        # Gets an attestor. Returns NOT_FOUND if the attestor does not exist.
-        # Returns NOT_FOUND if the attestor does not exist.
         # @param [String] name
-        #   Required. The name of the attestor to retrieve, in the format
+        #   Required. The name of the attestor to retrieve, in the format `projects/*/
-        #   `projects/*/attestors/*`.
+        #   attestors/*`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -225,22 +220,19 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the access control policy for a resource.
+        # Gets the access control policy for a resource. Returns an empty policy if the
-        # Returns an empty policy if the resource exists and does not have a policy
+        # resource exists and does not have a policy set.
-        # set.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being requested.
+        #   REQUIRED: The resource for which the policy is being requested. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Fixnum] options_requested_policy_version
-        #   Optional. The policy format version to be returned.
+        #   Optional. The policy format version to be returned. Valid values are 0, 1, and
-        #   Valid values are 0, 1, and 3. Requests specifying an invalid value will be
+        #   3. Requests specifying an invalid value will be rejected. Requests for
-        #   rejected.
+        #   policies with any conditional bindings must specify version 3. Policies
-        #   Requests for policies with any conditional bindings must specify version 3.
+        #   without any conditional bindings may specify any valid value or leave the
-        #   Policies without any conditional bindings may specify any valid value or
+        #   field unset. To learn which resources support conditions in their IAM policies,
-        #   leave the field unset.
+        #   see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
-        #   To learn which resources support conditions in their IAM policies, see the
+        #   resource-policies).
-        #   [IAM
-        #   documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -269,18 +261,17 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists attestors.
+        # Lists attestors. Returns INVALID_ARGUMENT if the project does not exist.
-        # Returns INVALID_ARGUMENT if the project does not exist.
         # @param [String] parent
-        #   Required. The resource name of the project associated with the
+        #   Required. The resource name of the project associated with the attestors, in
-        #   attestors, in the format `projects/*`.
+        #   the format `projects/*`.
         # @param [Fixnum] page_size
         #   Requested page size. The server may return fewer results than requested. If
         #   unspecified, the server will pick an appropriate default.
         # @param [String] page_token
         #   A token identifying a page of results the server should return. Typically,
-        #   this is the value of ListAttestorsResponse.next_page_token returned
+        #   this is the value of ListAttestorsResponse.next_page_token returned from the
-        #   from the previous call to the `ListAttestors` method.
+        #   previous call to the `ListAttestors` method.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -311,11 +302,11 @@ module Google
         end
         
         # Sets the access control policy on the specified resource. Replaces any
-        # existing policy.
+        # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
-        # Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.
+        # PERMISSION_DENIED` errors.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being specified.
+        #   REQUIRED: The resource for which the policy is being specified. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::BinaryauthorizationV1beta1::SetIamPolicyRequest] set_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -346,15 +337,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns permissions that a caller has on the specified resource.
+        # Returns permissions that a caller has on the specified resource. If the
-        # If the resource does not exist, this will return an empty set of
+        # resource does not exist, this will return an empty set of permissions, not a `
-        # permissions, not a `NOT_FOUND` error.
+        # NOT_FOUND` error. Note: This operation is designed to be used for building
-        # Note: This operation is designed to be used for building permission-aware
+        # permission-aware UIs and command-line tools, not for authorization checking.
-        # UIs and command-line tools, not for authorization checking. This operation
+        # This operation may "fail open" without warning.
-        # may "fail open" without warning.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy detail is being requested.
+        #   REQUIRED: The resource for which the policy detail is being requested. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::BinaryauthorizationV1beta1::TestIamPermissionsRequest] test_iam_permissions_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -385,11 +375,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates an attestor.
+        # Updates an attestor. Returns NOT_FOUND if the attestor does not exist.
-        # Returns NOT_FOUND if the attestor does not exist.
         # @param [String] name
-        #   Required. The resource name, in the format:
+        #   Required. The resource name, in the format: `projects/*/attestors/*`. This
-        #   `projects/*/attestors/*`. This field may not be updated.
+        #   field may not be updated.
         # @param [Google::Apis::BinaryauthorizationV1beta1::Attestor] attestor_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -420,22 +409,19 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the access control policy for a resource.
+        # Gets the access control policy for a resource. Returns an empty policy if the
-        # Returns an empty policy if the resource exists and does not have a policy
+        # resource exists and does not have a policy set.
-        # set.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being requested.
+        #   REQUIRED: The resource for which the policy is being requested. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Fixnum] options_requested_policy_version
-        #   Optional. The policy format version to be returned.
+        #   Optional. The policy format version to be returned. Valid values are 0, 1, and
-        #   Valid values are 0, 1, and 3. Requests specifying an invalid value will be
+        #   3. Requests specifying an invalid value will be rejected. Requests for
-        #   rejected.
+        #   policies with any conditional bindings must specify version 3. Policies
-        #   Requests for policies with any conditional bindings must specify version 3.
+        #   without any conditional bindings may specify any valid value or leave the
-        #   Policies without any conditional bindings may specify any valid value or
+        #   field unset. To learn which resources support conditions in their IAM policies,
-        #   leave the field unset.
+        #   see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
-        #   To learn which resources support conditions in their IAM policies, see the
+        #   resource-policies).
-        #   [IAM
-        #   documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -465,11 +451,11 @@ module Google
         end
         
         # Sets the access control policy on the specified resource. Replaces any
-        # existing policy.
+        # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
-        # Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.
+        # PERMISSION_DENIED` errors.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being specified.
+        #   REQUIRED: The resource for which the policy is being specified. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::BinaryauthorizationV1beta1::SetIamPolicyRequest] set_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -500,15 +486,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns permissions that a caller has on the specified resource.
+        # Returns permissions that a caller has on the specified resource. If the
-        # If the resource does not exist, this will return an empty set of
+        # resource does not exist, this will return an empty set of permissions, not a `
-        # permissions, not a `NOT_FOUND` error.
+        # NOT_FOUND` error. Note: This operation is designed to be used for building
-        # Note: This operation is designed to be used for building permission-aware
+        # permission-aware UIs and command-line tools, not for authorization checking.
-        # UIs and command-line tools, not for authorization checking. This operation
+        # This operation may "fail open" without warning.
-        # may "fail open" without warning.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy detail is being requested.
+        #   REQUIRED: The resource for which the policy detail is being requested. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::BinaryauthorizationV1beta1::TestIamPermissionsRequest] test_iam_permissions_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.

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 = '20200804'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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
+        # 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
+        # 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,57 @@ module Google
       class Binding
         include Google::Apis::Core::Hashable
       
-        # Represents a textual expression in the Common Expression Language (CEL)
+        # Represents a textual expression in the Common Expression Language (CEL) syntax.
-        # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
+        # CEL is a C-like expression language. The syntax and semantics of CEL are
-        # are documented at https://github.com/google/cel-spec.
+        # documented at https://github.com/google/cel-spec. Example (Comparison): title:
-        # Example (Comparison):
+        # "Summary size limit" description: "Determines if a summary is less than 100
-        # title: "Summary size limit"
+        # chars" expression: "document.summary.size() < 100" Example (Equality): title: "
-        # description: "Determines if a summary is less than 100 chars"
+        # Requestor is owner" description: "Determines if requestor is the document
-        # expression: "document.summary.size() < 100"
+        # owner" expression: "document.owner == request.auth.claims.email" Example (
-        # Example (Equality):
+        # Logic): title: "Public documents" description: "Determine whether the document
-        # title: "Requestor is owner"
+        # should be publicly visible" expression: "document.type != 'private' &&
-        # description: "Determines if requestor is the document owner"
+        # document.type != 'internal'" Example (Data Manipulation): title: "Notification
-        # expression: "document.owner == request.auth.claims.email"
+        # string" description: "Create a notification string with a timestamp."
-        # Example (Logic):
+        # expression: "'New message received at ' + string(document.create_time)" The
-        # title: "Public documents"
+        # exact variables and functions that may be referenced within an expression are
-        # description: "Determine whether the document should be publicly visible"
+        # determined by the service that evaluates it. See the service documentation for
-        # expression: "document.type != 'private' && document.type != 'internal'"
+        # additional information.
-        # 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.
+        # Specifies the identities requesting access for a Cloud Platform resource. `
-        # `members` can have the following values:
+        # members` can have the following values: * `allUsers`: A special identifier
-        # * `allUsers`: A special identifier that represents anyone who is
+        # that represents anyone who is on the internet; with or without a Google
-        # on the internet; with or without a Google account.
+        # account. * `allAuthenticatedUsers`: A special identifier that represents
-        # * `allAuthenticatedUsers`: A special identifier that represents anyone
+        # anyone who is authenticated with a Google account or a service account. * `
-        # who is authenticated with a Google account or a service account.
+        # user:`emailid``: An email address that represents a specific Google account.
-        # * `user:`emailid``: An email address that represents a specific Google
+        # For example, `alice@example.com` . * `serviceAccount:`emailid``: An email
-        # account. For example, `alice@example.com` .
+        # address that represents a service account. For example, `my-other-app@appspot.
-        # * `serviceAccount:`emailid``: An email address that represents a service
+        # gserviceaccount.com`. * `group:`emailid``: An email address that represents a
-        # account. For example, `my-other-app@appspot.gserviceaccount.com`.
+        # Google group. For example, `admins@example.com`. * `deleted:user:`emailid`?uid=
-        # * `group:`emailid``: An email address that represents a Google group.
+        # `uniqueid``: An email address (plus unique identifier) representing a user
-        # For example, `admins@example.com`.
+        # that has been recently deleted. For example, `alice@example.com?uid=
-        # * `deleted:user:`emailid`?uid=`uniqueid``: An email address (plus unique
+        # 123456789012345678901`. If the user is recovered, this value reverts to `user:`
-        # identifier) representing a user that has been recently deleted. For
+        # emailid`` and the recovered user retains the role in the binding. * `deleted:
-        # example, `alice@example.com?uid=123456789012345678901`. If the user is
+        # serviceAccount:`emailid`?uid=`uniqueid``: An email address (plus unique
-        # recovered, this value reverts to `user:`emailid`` and the recovered user
+        # identifier) representing a service account that has been recently deleted. For
-        # retains the role in the binding.
+        # example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`.
-        # * `deleted:serviceAccount:`emailid`?uid=`uniqueid``: An email address (plus
+        # If the service account is undeleted, this value reverts to `serviceAccount:`
-        # unique identifier) representing a service account that has been recently
+        # emailid`` and the undeleted service account retains the role in the binding. *
-        # deleted. For example,
+        # `deleted:group:`emailid`?uid=`uniqueid``: An email address (plus unique
-        # `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`.
+        # identifier) representing a Google group that has been recently deleted. For
-        # If the service account is undeleted, this value reverts to
+        # example, `admins@example.com?uid=123456789012345678901`. If the group is
-        # `serviceAccount:`emailid`` and the undeleted service account retains the
+        # recovered, this value reverts to `group:`emailid`` and the recovered group
-        # role in the binding.
+        # retains the role in the binding. * `domain:`domain``: The G Suite domain (
-        # * `deleted:group:`emailid`?uid=`uniqueid``: An email address (plus unique
+        # primary) that represents all the users of that domain. For example, `google.
-        # identifier) representing a Google group that has been recently
+        # com` or `example.com`.
-        # 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`.
+        # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`
-        # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+        # , or `roles/owner`.
         # Corresponds to the JSON property `role`
         # @return [String]
         attr_accessor :role
@@ -151,8 +139,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
+        # Can be used to temporarily prevent the device from connecting if, for example,
-        # example, the sensor is generating bad data and needs maintenance.
+        # the sensor is generating bad data and needs maintenance.
         # Corresponds to the JSON property `blocked`
         # @return [Boolean]
         attr_accessor :blocked
@@ -163,12 +151,12 @@ module Google
         # @return [Google::Apis::CloudiotV1::DeviceConfig]
         attr_accessor :config
       
-        # The credentials used to authenticate this device. To allow credential
+        # The credentials used to authenticate this device. To allow credential rotation
-        # rotation without interruption, multiple device credentials can be bound to
+        # without interruption, multiple device credentials can be bound to this device.
-        # this device. No more than 3 credentials can be bound to a single device at
+        # No more than 3 credentials can be bound to a single device at a time. When new
-        # a time. When new credentials are added to a device, they are verified
+        # credentials are added to a device, they are verified against the registry
-        # against the registry credentials. For details, see the description of the
+        # credentials. For details, see the description of the `DeviceRegistry.
-        # `DeviceRegistry.credentials` field.
+        # credentials` field.
         # Corresponds to the JSON property `credentials`
         # @return [Array<Google::Apis::CloudiotV1::DeviceCredential>]
         attr_accessor :credentials
@@ -178,38 +166,37 @@ module Google
         # @return [Google::Apis::CloudiotV1::GatewayConfig]
         attr_accessor :gateway_config
       
-        # The user-defined device identifier. The device ID must be unique
+        # The user-defined device identifier. The device ID must be unique within a
-        # within a device registry.
+        # 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
+        # was received from the device. This field is only for configurations sent
-        # sent through MQTT.
+        # 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
+        # [Output only] The last time a cloud-to-device config version was sent to the
-        # the device.
+        # 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
+        # The `Status` type defines a logical error model that is suitable for different
-        # different programming environments, including REST APIs and RPC APIs. It is
+        # programming environments, including REST APIs and RPC APIs. It is used by [
-        # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+        # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
-        # three pieces of data: error code, error message, and error details.
+        # data: error code, error message, and error details. You can find out more
-        # You can find out more about this error model and how to work with it in the
+        # about this error model and how to work with it in the [API Design Guide](https:
-        # [API Design Guide](https://cloud.google.com/apis/design/errors).
+        # //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
+        # publish to Cloud Pub/Sub. This field is the timestamp of 'last_error_status'.
-        # 'last_error_status'.
         # Corresponds to the JSON property `lastErrorTime`
         # @return [String]
         attr_accessor :last_error_time
@@ -221,11 +208,11 @@ module Google
         # @return [String]
         attr_accessor :last_event_time
       
-        # [Output only] The last time an MQTT `PINGREQ` was received. This field
+        # [Output only] The last time an MQTT `PINGREQ` was received. This field applies
-        # applies only to devices connecting through MQTT. MQTT clients usually only
+        # only to devices connecting through MQTT. MQTT clients usually only send `
-        # send `PINGREQ` messages if the connection is idle, and no other messages
+        # PINGREQ` messages if the connection is idle, and no other messages have been
-        # have been sent. Timestamps are periodically collected and written to
+        # sent. Timestamps are periodically collected and written to storage; they may
-        # storage; they may be stale by a few minutes.
+        # be stale by a few minutes.
         # Corresponds to the JSON property `lastHeartbeatTime`
         # @return [String]
         attr_accessor :last_heartbeat_time
@@ -237,8 +224,7 @@ module Google
         # @return [String]
         attr_accessor :last_state_time
       
-        # **Beta Feature**
+        # **Beta Feature** The logging verbosity for device activity. If unspecified,
-        # The logging verbosity for device activity. If unspecified,
         # DeviceRegistry.log_level will be used.
         # Corresponds to the JSON property `logLevel`
         # @return [String]
@@ -246,22 +232,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.
+        # information for the device. Keys must conform to the regular expression a-zA-Z+
-        # Keys must conform to the regular expression a-zA-Z+ and
+        # and be less than 128 bytes in length. Values are free-form strings. Each
-        # be less than 128 bytes in length.
+        # value must be less than or equal to 32 KB in size. The total size of all keys
-        # Values are free-form strings. Each value must be less than or equal to 32
+        # and values must be less than 256 KB, and the maximum number of key-value pairs
-        # KB in size.
+        # is 500.
-        # 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,
+        # The resource path name. For example, `projects/p1/locations/us-central1/
-        # `projects/p1/locations/us-central1/registries/registry0/devices/dev0` or
+        # registries/registry0/devices/dev0` or `projects/p1/locations/us-central1/
-        # `projects/p1/locations/us-central1/registries/registry0/devices/`num_id``.
+        # registries/registry0/devices/`num_id``. When `name` is populated as a response
-        # When `name` is populated as a response from the service, it always ends
+        # from the service, it always ends in the device numeric ID.
-        # in the device numeric ID.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -319,23 +302,22 @@ module Google
         # @return [String]
         attr_accessor :cloud_update_time
       
-        # [Output only] The time at which Cloud IoT Core received the
+        # [Output only] The time at which Cloud IoT Core received the acknowledgment
-        # acknowledgment from the device, indicating that the device has received
+        # from the device, indicating that the device has received this configuration
-        # this configuration version. If this field is not present, the device has
+        # version. If this field is not present, the device has not yet acknowledged
-        # not yet acknowledged that it received this version. Note that when
+        # that it received this version. Note that when the config was sent to the
-        # the config was sent to the device, many config versions may have been
+        # device, many config versions may have been available in Cloud IoT Core while
-        # available in Cloud IoT Core while the device was disconnected, and on
+        # the device was disconnected, and on connection, only the latest version is
-        # connection, only the latest version is sent to the device. Some
+        # sent to the device. Some versions may never be sent to the device, and
-        # versions may never be sent to the device, and therefore are never
+        # therefore are never acknowledged. This timestamp is set by Cloud IoT Core.
-        # 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
+        # the server, and is always greater than 0 after device creation. The version
-        # version must be 0 on the `CreateDevice` request if a `config` is
+        # must be 0 on the `CreateDevice` request if a `config` is specified; the
-        # specified; the response of `CreateDevice` will always have a value of 1.
+        # response of `CreateDevice` will always have a value of 1.
         # Corresponds to the JSON property `version`
         # @return [Fixnum]
         attr_accessor :version
@@ -357,9 +339,9 @@ module Google
       class DeviceCredential
         include Google::Apis::Core::Hashable
       
-        # [Optional] The time at which this credential becomes invalid. This
+        # [Optional] The time at which this credential becomes invalid. This credential
-        # credential will be ignored for new client authentication requests after
+        # will be ignored for new client authentication requests after this timestamp;
-        # this timestamp; however, it will not be automatically deleted.
+        # however, it will not be automatically deleted.
         # Corresponds to the JSON property `expirationTime`
         # @return [String]
         attr_accessor :expiration_time
@@ -388,25 +370,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
+        # created device or added credentials of an updated device should be signed with
-        # with one of these registry credentials.
+        # one of these registry credentials. Note, however, that existing devices will
-        # Note, however, that existing devices will never be affected by
+        # never be affected by modifications to this list of credentials: after a device
-        # modifications to this list of credentials: after a device has been
+        # has been successfully created in a registry, it should be able to connect even
-        # successfully created in a registry, it should be able to connect even if
+        # if its registry credentials are revoked, deleted, or modified.
-        # 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. All telemetry events that were successfully published by the device
-        # device and acknowledged by Cloud IoT Core are guaranteed to be
+        # and acknowledged by Cloud IoT Core are guaranteed to be delivered to Cloud Pub/
-        # delivered to Cloud Pub/Sub. If multiple configurations match a message,
+        # Sub. If multiple configurations match a message, only the first matching
-        # only the first matching configuration is used. If you try to publish a
+        # configuration is used. If you try to publish a device telemetry event using
-        # device telemetry event using MQTT without specifying a Cloud Pub/Sub topic
+        # MQTT without specifying a Cloud Pub/Sub topic for the device's registry, the
-        # for the device's registry, the connection closes automatically. If you try
+        # connection closes automatically. If you try to do so using an HTTP connection,
-        # to do so using an HTTP connection, an error is returned. Up to 10
+        # an error is returned. Up to 10 configurations may be provided.
-        # configurations may be provided.
         # Corresponds to the JSON property `eventNotificationConfigs`
         # @return [Array<Google::Apis::CloudiotV1::EventNotificationConfig>]
         attr_accessor :event_notification_configs
@@ -421,9 +401,8 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # **Beta Feature**
+        # **Beta Feature** The default logging verbosity for activity from devices in
-        # The default logging verbosity for activity from devices in this registry.
+        # this registry. The verbosity level can be overridden by Device.log_level.
-        # The verbosity level can be overridden by Device.log_level.
         # Corresponds to the JSON property `logLevel`
         # @return [String]
         attr_accessor :log_level
@@ -433,8 +412,8 @@ module Google
         # @return [Google::Apis::CloudiotV1::MqttConfig]
         attr_accessor :mqtt_config
       
-        # The resource path name. For example,
+        # The resource path name. For example, `projects/example-project/locations/us-
-        # `projects/example-project/locations/us-central1/registries/my-registry`.
+        # central1/registries/my-registry`.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -471,8 +450,8 @@ module Google
         # @return [String]
         attr_accessor :binary_data
       
-        # [Output only] The time at which this state version was updated in Cloud
+        # [Output only] The time at which this state version was updated in Cloud IoT
-        # IoT Core.
+        # Core.
         # Corresponds to the JSON property `updateTime`
         # @return [String]
         attr_accessor :update_time
@@ -488,13 +467,11 @@ module Google
         end
       end
       
-      # A generic empty message that you can re-use to avoid defining duplicated
+      # A generic empty message that you can re-use to avoid defining duplicated empty
-      # empty messages in your APIs. A typical example is to use it as the request
+      # messages in your APIs. A typical example is to use it as the request or the
-      # or the response type of an API method. For instance:
+      # response type of an API method. For instance: service Foo ` rpc Bar(google.
-      # service Foo `
+      # protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for
-      # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      # `Empty` is empty JSON object ````.
-      # `
-      # The JSON representation for `Empty` is empty JSON object ````.
       class Empty
         include Google::Apis::Core::Hashable
       
@@ -511,16 +488,16 @@ module Google
       class EventNotificationConfig
         include Google::Apis::Core::Hashable
       
-        # A Cloud Pub/Sub topic name. For example,
+        # A Cloud Pub/Sub topic name. For example, `projects/myProject/topics/
-        # `projects/myProject/topics/deviceEvents`.
+        # 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
+        # If the subfolder name matches this string exactly, this configuration will be
-        # be used. The string must not include the leading '/' character. If empty,
+        # used. The string must not include the leading '/' character. If empty, all
-        # all strings are matched. This field is used only for telemetry events;
+        # strings are matched. This field is used only for telemetry events; subfolders
-        # subfolders are not supported for state changes.
+        # are not supported for state changes.
         # Corresponds to the JSON property `subfolderMatches`
         # @return [String]
         attr_accessor :subfolder_matches
@@ -536,52 +513,43 @@ module Google
         end
       end
       
-      # Represents a textual expression in the Common Expression Language (CEL)
+      # Represents a textual expression in the Common Expression Language (CEL) syntax.
-      # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
+      # CEL is a C-like expression language. The syntax and semantics of CEL are
-      # are documented at https://github.com/google/cel-spec.
+      # documented at https://github.com/google/cel-spec. Example (Comparison): title:
-      # Example (Comparison):
+      # "Summary size limit" description: "Determines if a summary is less than 100
-      # title: "Summary size limit"
+      # chars" expression: "document.summary.size() < 100" Example (Equality): title: "
-      # description: "Determines if a summary is less than 100 chars"
+      # Requestor is owner" description: "Determines if requestor is the document
-      # expression: "document.summary.size() < 100"
+      # owner" expression: "document.owner == request.auth.claims.email" Example (
-      # Example (Equality):
+      # Logic): title: "Public documents" description: "Determine whether the document
-      # title: "Requestor is owner"
+      # should be publicly visible" expression: "document.type != 'private' &&
-      # description: "Determines if requestor is the document owner"
+      # document.type != 'internal'" Example (Data Manipulation): title: "Notification
-      # expression: "document.owner == request.auth.claims.email"
+      # string" description: "Create a notification string with a timestamp."
-      # Example (Logic):
+      # expression: "'New message received at ' + string(document.create_time)" The
-      # title: "Public documents"
+      # exact variables and functions that may be referenced within an expression are
-      # description: "Determine whether the document should be publicly visible"
+      # determined by the service that evaluates it. See the service documentation for
-      # expression: "document.type != 'private' && document.type != 'internal'"
+      # additional information.
-      # 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
+        # Optional. Description of the expression. This is a longer text which describes
-        # describes the expression, e.g. when hovered over it in a UI.
+        # 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
+        # Textual representation of an expression in Common Expression Language syntax.
-        # syntax.
         # Corresponds to the JSON property `expression`
         # @return [String]
         attr_accessor :expression
       
-        # Optional. String indicating the location of the expression for error
+        # Optional. String indicating the location of the expression for error reporting,
-        # reporting, e.g. a file name and a position in the file.
+        # 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
+        # Optional. Title for the expression, i.e. a short string describing its purpose.
-        # its purpose. This can be used e.g. in UIs which allow to enter the
+        # This can be used e.g. in UIs which allow to enter the expression.
-        # expression.
         # Corresponds to the JSON property `title`
         # @return [String]
         attr_accessor :title
@@ -603,8 +571,7 @@ module Google
       class GatewayConfig
         include Google::Apis::Core::Hashable
       
-        # Indicates how to authorize and/or authenticate devices to access the
+        # Indicates how to authorize and/or authenticate devices to access the gateway.
-        # gateway.
         # Corresponds to the JSON property `gatewayAuthMethod`
         # @return [String]
         attr_accessor :gateway_auth_method
@@ -661,15 +628,13 @@ module Google
       class GetPolicyOptions
         include Google::Apis::Core::Hashable
       
-        # Optional. The policy format version to be returned.
+        # Optional. The policy format version to be returned. Valid values are 0, 1, and
-        # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
+        # 3. Requests specifying an invalid value will be rejected. Requests for
-        # rejected.
+        # policies with any conditional bindings must specify version 3. Policies
-        # Requests for policies with any conditional bindings must specify version 3.
+        # without any conditional bindings may specify any valid value or leave the
-        # Policies without any conditional bindings may specify any valid value or
+        # field unset. To learn which resources support conditions in their IAM policies,
-        # leave the field unset.
+        # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
-        # To learn which resources support conditions in their IAM policies, see the
+        # resource-policies).
-        # [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 +673,8 @@ module Google
       class ListDeviceConfigVersionsResponse
         include Google::Apis::Core::Hashable
       
-        # The device configuration for the last few versions. Versions are listed
+        # The device configuration for the last few versions. Versions are listed in
-        # in decreasing order, starting from the most recent one.
+        # 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 +699,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
+        # request; this value should be passed in a new `ListDeviceRegistriesRequest`.
-        # `ListDeviceRegistriesRequest`.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -780,8 +744,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
+        # If not empty, indicates that there may be more devices that match the request;
-        # request; this value should be passed in a new `ListDevicesRequest`.
+        # this value should be passed in a new `ListDevicesRequest`.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -848,111 +812,73 @@ module Google
       end
       
       # An Identity and Access Management (IAM) policy, which specifies access
-      # controls for Google Cloud resources.
+      # controls for Google Cloud resources. A `Policy` is a collection of `bindings`.
-      # A `Policy` is a collection of `bindings`. A `binding` binds one or more
+      # A `binding` binds one or more `members` to a single `role`. Members can be
-      # `members` to a single `role`. Members can be user accounts, service accounts,
+      # user accounts, service accounts, Google groups, and domains (such as G Suite).
-      # Google groups, and domains (such as G Suite). A `role` is a named list of
+      # A `role` is a named list of permissions; each `role` can be an IAM predefined
-      # permissions; each `role` can be an IAM predefined role or a user-created
+      # role or a user-created custom role. For some types of Google Cloud resources,
-      # custom role.
+      # a `binding` can also specify a `condition`, which is a logical expression that
-      # For some types of Google Cloud resources, a `binding` can also specify a
+      # allows access to a resource only if the expression evaluates to `true`. A
-      # `condition`, which is a logical expression that allows access to a resource
+      # condition can add constraints based on attributes of the request, the resource,
-      # only if the expression evaluates to `true`. A condition can add constraints
+      # or both. To learn which resources support conditions in their IAM policies,
-      # based on attributes of the request, the resource, or both. To learn which
+      # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
-      # resources support conditions in their IAM policies, see the
+      # resource-policies). **JSON example:** ` "bindings": [ ` "role": "roles/
-      # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
+      # resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "
-      # policies).
+      # group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@
-      # **JSON example:**
+      # appspot.gserviceaccount.com" ] `, ` "role": "roles/resourcemanager.
-      # `
+      # organizationViewer", "members": [ "user:eve@example.com" ], "condition": ` "
-      # "bindings": [
+      # title": "expirable access", "description": "Does not grant access after Sep
-      # `
+      # 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", `
-      # "role": "roles/resourcemanager.organizationAdmin",
+      # ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:** bindings: -
-      # "members": [
+      # members: - user:mike@example.com - group:admins@example.com - domain:google.
-      # "user:mike@example.com",
+      # com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/
-      # "group:admins@example.com",
+      # resourcemanager.organizationAdmin - members: - user:eve@example.com role:
-      # "domain:google.com",
+      # roles/resourcemanager.organizationViewer condition: title: expirable access
-      # "serviceAccount:my-project-id@appspot.gserviceaccount.com"
+      # 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/).
-      # "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
+        # Associates a list of `members` to a `role`. Optionally, may specify a `
-        # `condition` that determines how and when the `bindings` are applied. Each
+        # condition` that determines how and when the `bindings` are applied. Each of
-        # of the `bindings` must contain at least one member.
+        # 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
+        # `etag` is used for optimistic concurrency control as a way to help prevent
-        # prevent simultaneous updates of a policy from overwriting each other.
+        # simultaneous updates of a policy from overwriting each other. It is strongly
-        # It is strongly suggested that systems make use of the `etag` in the
+        # suggested that systems make use of the `etag` in the read-modify-write cycle
-        # read-modify-write cycle to perform policy updates in order to avoid race
+        # to perform policy updates in order to avoid race conditions: An `etag` is
-        # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+        # returned in the response to `getIamPolicy`, and systems are expected to put
-        # systems are expected to put that etag in the request to `setIamPolicy` to
+        # that etag in the request to `setIamPolicy` to ensure that their change will be
-        # ensure that their change will be applied to the same version of the policy.
+        # applied to the same version of the policy. **Important:** If you use IAM
-        # **Important:** If you use IAM Conditions, you must include the `etag` field
+        # Conditions, you must include the `etag` field whenever you call `setIamPolicy`.
-        # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
+        # If you omit this field, then IAM allows you to overwrite a version `3` policy
-        # you to overwrite a version `3` policy with a version `1` policy, and all of
+        # with a version `1` policy, and all of the conditions in the version `3` policy
-        # the conditions in the version `3` policy are lost.
+        # 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.
+        # Specifies the format of the policy. Valid values are `0`, `1`, and `3`.
-        # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
+        # Requests that specify an invalid value are rejected. Any operation that
-        # are rejected.
+        # affects conditional role bindings must specify version `3`. This requirement
-        # Any operation that affects conditional role bindings must specify version
+        # applies to the following operations: * Getting a policy that includes a
-        # `3`. This requirement applies to the following operations:
+        # conditional role binding * Adding a conditional role binding to a policy *
-        # * Getting a policy that includes a conditional role binding
+        # Changing a conditional role binding in a policy * Removing any role binding,
-        # * Adding a conditional role binding to a policy
+        # with or without a condition, from a policy that includes conditions **
-        # * Changing a conditional role binding in a policy
+        # Important:** If you use IAM Conditions, you must include the `etag` field
-        # * Removing any role binding, with or without a condition, from a policy
+        # whenever you call `setIamPolicy`. If you omit this field, then IAM allows you
-        # that includes conditions
+        # to overwrite a version `3` policy with a version `1` policy, and all of the
-        # **Important:** If you use IAM Conditions, you must include the `etag` field
+        # conditions in the version `3` policy are lost. If a policy does not include
-        # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
+        # any conditions, operations on that policy may specify any valid version or
-        # you to overwrite a version `3` policy with a version `1` policy, and all of
+        # leave the field unset. To learn which resources support conditions in their
-        # the conditions in the version `3` policy are lost.
+        # IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/
-        # If a policy does not include any conditions, operations on that policy may
+        # conditions/resource-policies).
-        # 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 +980,11 @@ module Google
         # @return [String]
         attr_accessor :binary_data
       
-        # Optional subfolder for the command. If empty, the command will be delivered
+        # Optional subfolder for the command. If empty, the command will be delivered to
-        # to the /devices/`device-id`/commands topic, otherwise it will be delivered
+        # the /devices/`device-id`/commands topic, otherwise it will be delivered to the
-        # to the /devices/`device-id`/commands/`subfolder` topic. Multi-level
+        # /devices/`device-id`/commands/`subfolder` topic. Multi-level subfolders are
-        # subfolders are allowed. This field must not have more than 256 characters,
+        # allowed. This field must not have more than 256 characters, and must not
-        # and must not contain any MQTT wildcards ("+" or "#") or null characters.
+        # contain any MQTT wildcards ("+" or "#") or null characters.
         # Corresponds to the JSON property `subfolder`
         # @return [String]
         attr_accessor :subfolder
@@ -1092,66 +1018,32 @@ module Google
         include Google::Apis::Core::Hashable
       
         # An Identity and Access Management (IAM) policy, which specifies access
-        # controls for Google Cloud resources.
+        # controls for Google Cloud resources. A `Policy` is a collection of `bindings`.
-        # A `Policy` is a collection of `bindings`. A `binding` binds one or more
+        # A `binding` binds one or more `members` to a single `role`. Members can be
-        # `members` to a single `role`. Members can be user accounts, service accounts,
+        # user accounts, service accounts, Google groups, and domains (such as G Suite).
-        # Google groups, and domains (such as G Suite). A `role` is a named list of
+        # A `role` is a named list of permissions; each `role` can be an IAM predefined
-        # permissions; each `role` can be an IAM predefined role or a user-created
+        # role or a user-created custom role. For some types of Google Cloud resources,
-        # custom role.
+        # a `binding` can also specify a `condition`, which is a logical expression that
-        # For some types of Google Cloud resources, a `binding` can also specify a
+        # allows access to a resource only if the expression evaluates to `true`. A
-        # `condition`, which is a logical expression that allows access to a resource
+        # condition can add constraints based on attributes of the request, the resource,
-        # only if the expression evaluates to `true`. A condition can add constraints
+        # or both. To learn which resources support conditions in their IAM policies,
-        # based on attributes of the request, the resource, or both. To learn which
+        # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
-        # resources support conditions in their IAM policies, see the
+        # resource-policies). **JSON example:** ` "bindings": [ ` "role": "roles/
-        # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
+        # resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "
-        # policies).
+        # group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@
-        # **JSON example:**
+        # appspot.gserviceaccount.com" ] `, ` "role": "roles/resourcemanager.
-        # `
+        # organizationViewer", "members": [ "user:eve@example.com" ], "condition": ` "
-        # "bindings": [
+        # title": "expirable access", "description": "Does not grant access after Sep
-        # `
+        # 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", `
-        # "role": "roles/resourcemanager.organizationAdmin",
+        # ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:** bindings: -
-        # "members": [
+        # members: - user:mike@example.com - group:admins@example.com - domain:google.
-        # "user:mike@example.com",
+        # com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/
-        # "group:admins@example.com",
+        # resourcemanager.organizationAdmin - members: - user:eve@example.com role:
-        # "domain:google.com",
+        # roles/resourcemanager.organizationViewer condition: title: expirable access
-        # "serviceAccount:my-project-id@appspot.gserviceaccount.com"
+        # 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/).
-        # "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 +1062,8 @@ module Google
       class StateNotificationConfig
         include Google::Apis::Core::Hashable
       
-        # A Cloud Pub/Sub topic name. For example,
+        # A Cloud Pub/Sub topic name. For example, `projects/myProject/topics/
-        # `projects/myProject/topics/deviceEvents`.
+        # deviceEvents`.
         # Corresponds to the JSON property `pubsubTopicName`
         # @return [String]
         attr_accessor :pubsub_topic_name
@@ -1186,12 +1078,12 @@ module Google
         end
       end
       
-      # The `Status` type defines a logical error model that is suitable for
+      # The `Status` type defines a logical error model that is suitable for different
-      # different programming environments, including REST APIs and RPC APIs. It is
+      # programming environments, including REST APIs and RPC APIs. It is used by [
-      # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+      # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
-      # three pieces of data: error code, error message, and error details.
+      # data: error code, error message, and error details. You can find out more
-      # You can find out more about this error model and how to work with it in the
+      # about this error model and how to work with it in the [API Design Guide](https:
-      # [API Design Guide](https://cloud.google.com/apis/design/errors).
+      # //cloud.google.com/apis/design/errors).
       class Status
         include Google::Apis::Core::Hashable
       
@@ -1200,15 +1092,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
+        # A developer-facing error message, which should be in English. Any user-facing
-        # user-facing error message should be localized and sent in the
+        # error message should be localized and sent in the google.rpc.Status.details
-        # google.rpc.Status.details field, or localized by the client.
+        # field, or localized by the client.
         # Corresponds to the JSON property `message`
         # @return [String]
         attr_accessor :message
@@ -1229,10 +1121,9 @@ module Google
       class TestIamPermissionsRequest
         include Google::Apis::Core::Hashable
       
-        # The set of permissions to check for the `resource`. Permissions with
+        # The set of permissions to check for the `resource`. Permissions with wildcards
-        # wildcards (such as '*' or 'storage.*') are not allowed. For more
+        # (such as '*' or 'storage.*') are not allowed. For more information see [IAM
-        # information see
+        # Overview](https://cloud.google.com/iam/docs/overview#permissions).
-        # [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
         # Corresponds to the JSON property `permissions`
         # @return [Array<String>]
         attr_accessor :permissions
@@ -1251,8 +1142,7 @@ module Google
       class TestIamPermissionsResponse
         include Google::Apis::Core::Hashable
       
-        # A subset of `TestPermissionsRequest.permissions` that the caller is
+        # A subset of `TestPermissionsRequest.permissions` that the caller is allowed.
-        # allowed.
         # Corresponds to the JSON property `permissions`
         # @return [Array<String>]
         attr_accessor :permissions
@@ -1271,8 +1161,8 @@ module Google
       class UnbindDeviceFromGatewayRequest
         include Google::Apis::Core::Hashable
       
-        # Required. 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
+        # device_id` can be either the device numeric ID or the user-defined device
         # identifier.
         # Corresponds to the JSON property `deviceId`
         # @return [String]

generated/google/apis/cloudiot_v1/service.rb

@@ -50,8 +50,8 @@ module Google
         
         # Associates the device with the gateway.
         # @param [String] parent
-        #   Required. The name of the registry. For example,
+        #   Required. The name of the registry. For example, `projects/example-project/
-        #   `projects/example-project/locations/us-central1/registries/my-registry`.
+        #   locations/us-central1/registries/my-registry`.
         # @param [Google::Apis::CloudiotV1::BindDeviceToGatewayRequest] bind_device_to_gateway_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -85,8 +85,7 @@ module Google
         # Creates a device registry that contains devices.
         # @param [String] parent
         #   Required. The project and cloud region where this device registry must be
-        #   created.
+        #   created. For example, `projects/example-project/locations/us-central1`.
-        #   For example, `projects/example-project/locations/us-central1`.
         # @param [Google::Apis::CloudiotV1::DeviceRegistry] device_registry_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -119,8 +118,8 @@ module Google
         
         # Deletes a device registry configuration.
         # @param [String] name
-        #   Required. The name of the device registry. For example,
+        #   Required. The name of the device registry. For example, `projects/example-
-        #   `projects/example-project/locations/us-central1/registries/my-registry`.
+        #   project/locations/us-central1/registries/my-registry`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -150,8 +149,8 @@ module Google
         
         # Gets a device registry configuration.
         # @param [String] name
-        #   Required. The name of the device registry. For example,
+        #   Required. The name of the device registry. For example, `projects/example-
-        #   `projects/example-project/locations/us-central1/registries/my-registry`.
+        #   project/locations/us-central1/registries/my-registry`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -179,12 +178,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the access control policy for a resource.
+        # Gets the access control policy for a resource. Returns an empty policy if the
-        # Returns an empty policy if the resource exists and does not have a policy
+        # resource exists and does not have a policy set.
-        # set.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being requested.
+        #   REQUIRED: The resource for which the policy is being requested. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::CloudiotV1::GetIamPolicyRequest] get_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -217,17 +215,17 @@ module Google
         
         # Lists device registries.
         # @param [String] parent
-        #   Required. The project and cloud region path. For example,
+        #   Required. The project and cloud region path. For example, `projects/example-
-        #   `projects/example-project/locations/us-central1`.
+        #   project/locations/us-central1`.
         # @param [Fixnum] page_size
-        #   The maximum number of registries to return in the response. If this value
+        #   The maximum number of registries to return in the response. If this value is
-        #   is zero, the service will select a default size. A call may return fewer
+        #   zero, the service will select a default size. A call may return fewer objects
-        #   objects than requested. A non-empty `next_page_token` in the response
+        #   than requested. A non-empty `next_page_token` in the response indicates that
-        #   indicates that more data is available.
+        #   more data is available.
         # @param [String] page_token
-        #   The value returned by the last `ListDeviceRegistriesResponse`; indicates
+        #   The value returned by the last `ListDeviceRegistriesResponse`; indicates that
-        #   that this is a continuation of a prior `ListDeviceRegistries` call and
+        #   this is a continuation of a prior `ListDeviceRegistries` call and the system
-        #   the system should return the next page of data.
+        #   should return the next page of data.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -259,15 +257,15 @@ module Google
         
         # Updates a device registry configuration.
         # @param [String] name
-        #   The resource path name. For example,
+        #   The resource path name. For example, `projects/example-project/locations/us-
-        #   `projects/example-project/locations/us-central1/registries/my-registry`.
+        #   central1/registries/my-registry`.
         # @param [Google::Apis::CloudiotV1::DeviceRegistry] device_registry_object
         # @param [String] update_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
+        #   The field mask must not be empty, and it must not contain fields that are
-        #   are immutable or only set by the server.
+        #   immutable or only set by the server. Mutable top-level fields: `
-        #   Mutable top-level fields: `event_notification_config`, `http_config`,
+        #   event_notification_config`, `http_config`, `mqtt_config`, and `
-        #   `mqtt_config`, and `state_notification_config`.
+        #   state_notification_config`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -301,8 +299,8 @@ module Google
         # Sets the access control policy on the specified resource. Replaces any
         # existing policy.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being specified.
+        #   REQUIRED: The resource for which the policy is being specified. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::CloudiotV1::SetIamPolicyRequest] set_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -333,12 +331,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns permissions that a caller has on the specified resource.
+        # Returns permissions that a caller has on the specified resource. If the
-        # If the resource does not exist, this will return an empty set of
+        # resource does not exist, this will return an empty set of permissions, not a
-        # permissions, not a NOT_FOUND error.
+        # NOT_FOUND error.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy detail is being requested.
+        #   REQUIRED: The resource for which the policy detail is being requested. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::CloudiotV1::TestIamPermissionsRequest] test_iam_permissions_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -371,8 +369,8 @@ module Google
         
         # Deletes the association between the device and the gateway.
         # @param [String] parent
-        #   Required. The name of the registry. For example,
+        #   Required. The name of the registry. For example, `projects/example-project/
-        #   `projects/example-project/locations/us-central1/registries/my-registry`.
+        #   locations/us-central1/registries/my-registry`.
         # @param [Google::Apis::CloudiotV1::UnbindDeviceFromGatewayRequest] unbind_device_from_gateway_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -406,8 +404,8 @@ module Google
         # Creates a device in a device registry.
         # @param [String] parent
         #   Required. The name of the device registry where this device should be created.
-        #   For example,
+        #   For example, `projects/example-project/locations/us-central1/registries/my-
-        #   `projects/example-project/locations/us-central1/registries/my-registry`.
+        #   registry`.
         # @param [Google::Apis::CloudiotV1::Device] device_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -440,9 +438,9 @@ module Google
         
         # Deletes a device.
         # @param [String] name
-        #   Required. The name of the device. For example,
+        #   Required. The name of the device. For example, `projects/p0/locations/us-
-        #   `projects/p0/locations/us-central1/registries/registry0/devices/device0` or
+        #   central1/registries/registry0/devices/device0` or `projects/p0/locations/us-
-        #   `projects/p0/locations/us-central1/registries/registry0/devices/`num_id``.
+        #   central1/registries/registry0/devices/`num_id``.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -472,9 +470,9 @@ module Google
         
         # Gets details about a device.
         # @param [String] name
-        #   Required. The name of the device. For example,
+        #   Required. The name of the device. For example, `projects/p0/locations/us-
-        #   `projects/p0/locations/us-central1/registries/registry0/devices/device0` or
+        #   central1/registries/registry0/devices/device0` or `projects/p0/locations/us-
-        #   `projects/p0/locations/us-central1/registries/registry0/devices/`num_id``.
+        #   central1/registries/registry0/devices/`num_id``.
         # @param [String] field_mask
         #   The fields of the `Device` resource to be returned in the response. If the
         #   field mask is unset or empty, all fields are returned.
@@ -508,41 +506,40 @@ module Google
         
         # List devices in a device registry.
         # @param [String] parent
-        #   Required. The device registry path. Required. For example,
+        #   Required. The device registry path. Required. For example, `projects/my-
-        #   `projects/my-project/locations/us-central1/registries/my-registry`.
+        #   project/locations/us-central1/registries/my-registry`.
         # @param [Array<String>, String] device_ids
-        #   A list of device string IDs. For example, `['device0', 'device12']`.
+        #   A list of device string IDs. For example, `['device0', 'device12']`. If empty,
-        #   If empty, this field is ignored. Maximum IDs: 10,000
+        #   this field is ignored. Maximum IDs: 10,000
         # @param [Array<Fixnum>, Fixnum] device_num_ids
-        #   A list of device numeric IDs. If empty, this field is ignored. Maximum
+        #   A list of device numeric IDs. If empty, this field is ignored. Maximum IDs: 10,
-        #   IDs: 10,000.
+        #   000.
         # @param [String] field_mask
-        #   The fields of the `Device` resource to be returned in the response. The
+        #   The fields of the `Device` resource to be returned in the response. The fields
-        #   fields `id` and `num_id` are always returned, along with any
+        #   `id` and `num_id` are always returned, along with any other fields specified.
-        #   other fields specified.
         # @param [String] gateway_list_options_associations_device_id
         #   If set, returns only the gateways with which the specified device is
-        #   associated. The device ID can be numeric (`num_id`) or the user-defined
+        #   associated. The device ID can be numeric (`num_id`) or the user-defined string
-        #   string (`id`). For example, if `456` is specified, returns only the
+        #   (`id`). For example, if `456` is specified, returns only the gateways to which
-        #   gateways to which the device with `num_id` 456 is bound.
+        #   the device with `num_id` 456 is bound.
         # @param [String] gateway_list_options_associations_gateway_id
-        #   If set, only devices associated with the specified gateway are returned.
+        #   If set, only devices associated with the specified gateway are returned. The
-        #   The gateway ID can be numeric (`num_id`) or the user-defined string
+        #   gateway ID can be numeric (`num_id`) or the user-defined string (`id`). For
-        #   (`id`). For example, if `123` is specified, only devices bound to the
+        #   example, if `123` is specified, only devices bound to the gateway with `num_id`
-        #   gateway with `num_id` 123 are returned.
+        #   123 are returned.
         # @param [String] gateway_list_options_gateway_type
-        #   If `GATEWAY` is specified, only gateways are returned. If `NON_GATEWAY`
+        #   If `GATEWAY` is specified, only gateways are returned. If `NON_GATEWAY` is
-        #   is specified, only non-gateway devices are returned. If
+        #   specified, only non-gateway devices are returned. If `GATEWAY_TYPE_UNSPECIFIED`
-        #   `GATEWAY_TYPE_UNSPECIFIED` is specified, all devices are returned.
+        #   is specified, all devices are returned.
         # @param [Fixnum] page_size
-        #   The maximum number of devices to return in the response. If this value
+        #   The maximum number of devices to return in the response. If this value is zero,
-        #   is zero, the service will select a default size. A call may return fewer
+        #   the service will select a default size. A call may return fewer objects than
-        #   objects than requested. A non-empty `next_page_token` in the response
+        #   requested. A non-empty `next_page_token` in the response indicates that more
-        #   indicates that more data is available.
+        #   data is available.
         # @param [String] page_token
-        #   The value returned by the last `ListDevicesResponse`; indicates
+        #   The value returned by the last `ListDevicesResponse`; indicates that this is a
-        #   that this is a continuation of a prior `ListDevices` call and
+        #   continuation of a prior `ListDevices` call and the system should return the
-        #   the system should return the next page of data.
+        #   next page of data.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -578,13 +575,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Modifies the configuration for the device, which is eventually sent from
+        # Modifies the configuration for the device, which is eventually sent from the
-        # the Cloud IoT Core servers. Returns the modified configuration version and
+        # Cloud IoT Core servers. Returns the modified configuration version and its
-        # its metadata.
+        # metadata.
         # @param [String] name
-        #   Required. The name of the device. For example,
+        #   Required. The name of the device. For example, `projects/p0/locations/us-
-        #   `projects/p0/locations/us-central1/registries/registry0/devices/device0` or
+        #   central1/registries/registry0/devices/device0` or `projects/p0/locations/us-
-        #   `projects/p0/locations/us-central1/registries/registry0/devices/`num_id``.
+        #   central1/registries/registry0/devices/`num_id``.
         # @param [Google::Apis::CloudiotV1::ModifyCloudToDeviceConfigRequest] modify_cloud_to_device_config_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -617,17 +614,16 @@ module Google
         
         # Updates a device.
         # @param [String] name
-        #   The resource path name. For example,
+        #   The resource path name. For example, `projects/p1/locations/us-central1/
-        #   `projects/p1/locations/us-central1/registries/registry0/devices/dev0` or
+        #   registries/registry0/devices/dev0` or `projects/p1/locations/us-central1/
-        #   `projects/p1/locations/us-central1/registries/registry0/devices/`num_id``.
+        #   registries/registry0/devices/`num_id``. When `name` is populated as a response
-        #   When `name` is populated as a response from the service, it always ends
+        #   from the service, it always ends in the device numeric ID.
-        #   in the device numeric ID.
         # @param [Google::Apis::CloudiotV1::Device] device_object
         # @param [String] update_mask
-        #   Required. Only updates the `device` fields indicated by this mask.
+        #   Required. Only updates the `device` fields indicated by this mask. The field
-        #   The field mask must not be empty, and it must not contain fields that
+        #   mask must not be empty, and it must not contain fields that are immutable or
-        #   are immutable or only set by the server.
+        #   only set by the server. Mutable top-level fields: `credentials`, `blocked`,
-        #   Mutable top-level fields: `credentials`, `blocked`, and `metadata`
+        #   and `metadata`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -658,23 +654,22 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Sends a command to the specified device. In order for a device to be able
+        # Sends a command to the specified device. In order for a device to be able to
-        # to receive commands, it must:
+        # receive commands, it must: 1) be connected to Cloud IoT Core using the MQTT
-        # 1) be connected to Cloud IoT Core using the MQTT protocol, and
+        # protocol, and 2) be subscribed to the group of MQTT topics specified by /
-        # 2) be subscribed to the group of MQTT topics specified by
+        # devices/`device-id`/commands/#. This subscription will receive commands at the
-        # /devices/`device-id`/commands/#. This subscription will receive commands
+        # top-level topic /devices/`device-id`/commands as well as commands for
-        # at the top-level topic /devices/`device-id`/commands as well as commands
+        # subfolders, like /devices/`device-id`/commands/subfolder. Note that
-        # for subfolders, like /devices/`device-id`/commands/subfolder.
+        # subscribing to specific subfolders is not supported. If the command could not
-        # Note that subscribing to specific subfolders is not supported.
+        # be delivered to the device, this method will return an error; in particular,
-        # If the command could not be delivered to the device, this method will
+        # if the device is not subscribed, this method will return FAILED_PRECONDITION.
-        # return an error; in particular, if the device is not subscribed, this
+        # Otherwise, this method will return OK. If the subscription is QoS 1, at least
-        # method will return FAILED_PRECONDITION. Otherwise, this method will
+        # once delivery will be guaranteed; for QoS 0, no acknowledgment will be
-        # return OK. If the subscription is QoS 1, at least once delivery will be
+        # expected from the device.
-        # guaranteed; for QoS 0, no acknowledgment will be expected from the device.
         # @param [String] name
-        #   Required. The name of the device. For example,
+        #   Required. The name of the device. For example, `projects/p0/locations/us-
-        #   `projects/p0/locations/us-central1/registries/registry0/devices/device0` or
+        #   central1/registries/registry0/devices/device0` or `projects/p0/locations/us-
-        #   `projects/p0/locations/us-central1/registries/registry0/devices/`num_id``.
+        #   central1/registries/registry0/devices/`num_id``.
         # @param [Google::Apis::CloudiotV1::SendCommandToDeviceRequest] send_command_to_device_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -705,16 +700,16 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists the last few versions of the device configuration in descending
+        # Lists the last few versions of the device configuration in descending order (i.
-        # order (i.e.: newest first).
+        # e.: newest first).
         # @param [String] name
-        #   Required. The name of the device. For example,
+        #   Required. The name of the device. For example, `projects/p0/locations/us-
-        #   `projects/p0/locations/us-central1/registries/registry0/devices/device0` or
+        #   central1/registries/registry0/devices/device0` or `projects/p0/locations/us-
-        #   `projects/p0/locations/us-central1/registries/registry0/devices/`num_id``.
+        #   central1/registries/registry0/devices/`num_id``.
         # @param [Fixnum] num_versions
-        #   The number of versions to list. Versions are listed in decreasing order of
+        #   The number of versions to list. Versions are listed in decreasing order of the
-        #   the version number. The maximum number of versions retained is 10. If this
+        #   version number. The maximum number of versions retained is 10. If this value
-        #   value is zero, it will return all the versions available.
+        #   is zero, it will return all the versions available.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -746,13 +741,13 @@ module Google
         # Lists the last few versions of the device state in descending order (i.e.:
         # newest first).
         # @param [String] name
-        #   Required. The name of the device. For example,
+        #   Required. The name of the device. For example, `projects/p0/locations/us-
-        #   `projects/p0/locations/us-central1/registries/registry0/devices/device0` or
+        #   central1/registries/registry0/devices/device0` or `projects/p0/locations/us-
-        #   `projects/p0/locations/us-central1/registries/registry0/devices/`num_id``.
+        #   central1/registries/registry0/devices/`num_id``.
         # @param [Fixnum] num_states
-        #   The number of states to list. States are listed in descending order of
+        #   The number of states to list. States are listed in descending order of update
-        #   update time. The maximum number of states retained is 10. If this
+        #   time. The maximum number of states retained is 10. If this value is zero, it
-        #   value is zero, it will return all the states available.
+        #   will return all the states available.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -781,12 +776,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the access control policy for a resource.
+        # Gets the access control policy for a resource. Returns an empty policy if the
-        # Returns an empty policy if the resource exists and does not have a policy
+        # resource exists and does not have a policy set.
-        # set.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being requested.
+        #   REQUIRED: The resource for which the policy is being requested. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::CloudiotV1::GetIamPolicyRequest] get_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -820,8 +814,8 @@ module Google
         # Sets the access control policy on the specified resource. Replaces any
         # existing policy.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being specified.
+        #   REQUIRED: The resource for which the policy is being specified. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::CloudiotV1::SetIamPolicyRequest] set_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -852,12 +846,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns permissions that a caller has on the specified resource.
+        # Returns permissions that a caller has on the specified resource. If the
-        # If the resource does not exist, this will return an empty set of
+        # resource does not exist, this will return an empty set of permissions, not a
-        # permissions, not a NOT_FOUND error.
+        # NOT_FOUND error.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy detail is being requested.
+        #   REQUIRED: The resource for which the policy detail is being requested. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::CloudiotV1::TestIamPermissionsRequest] test_iam_permissions_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -890,41 +884,40 @@ module Google
         
         # List devices in a device registry.
         # @param [String] parent
-        #   Required. The device registry path. Required. For example,
+        #   Required. The device registry path. Required. For example, `projects/my-
-        #   `projects/my-project/locations/us-central1/registries/my-registry`.
+        #   project/locations/us-central1/registries/my-registry`.
         # @param [Array<String>, String] device_ids
-        #   A list of device string IDs. For example, `['device0', 'device12']`.
+        #   A list of device string IDs. For example, `['device0', 'device12']`. If empty,
-        #   If empty, this field is ignored. Maximum IDs: 10,000
+        #   this field is ignored. Maximum IDs: 10,000
         # @param [Array<Fixnum>, Fixnum] device_num_ids
-        #   A list of device numeric IDs. If empty, this field is ignored. Maximum
+        #   A list of device numeric IDs. If empty, this field is ignored. Maximum IDs: 10,
-        #   IDs: 10,000.
+        #   000.
         # @param [String] field_mask
-        #   The fields of the `Device` resource to be returned in the response. The
+        #   The fields of the `Device` resource to be returned in the response. The fields
-        #   fields `id` and `num_id` are always returned, along with any
+        #   `id` and `num_id` are always returned, along with any other fields specified.
-        #   other fields specified.
         # @param [String] gateway_list_options_associations_device_id
         #   If set, returns only the gateways with which the specified device is
-        #   associated. The device ID can be numeric (`num_id`) or the user-defined
+        #   associated. The device ID can be numeric (`num_id`) or the user-defined string
-        #   string (`id`). For example, if `456` is specified, returns only the
+        #   (`id`). For example, if `456` is specified, returns only the gateways to which
-        #   gateways to which the device with `num_id` 456 is bound.
+        #   the device with `num_id` 456 is bound.
         # @param [String] gateway_list_options_associations_gateway_id
-        #   If set, only devices associated with the specified gateway are returned.
+        #   If set, only devices associated with the specified gateway are returned. The
-        #   The gateway ID can be numeric (`num_id`) or the user-defined string
+        #   gateway ID can be numeric (`num_id`) or the user-defined string (`id`). For
-        #   (`id`). For example, if `123` is specified, only devices bound to the
+        #   example, if `123` is specified, only devices bound to the gateway with `num_id`
-        #   gateway with `num_id` 123 are returned.
+        #   123 are returned.
         # @param [String] gateway_list_options_gateway_type
-        #   If `GATEWAY` is specified, only gateways are returned. If `NON_GATEWAY`
+        #   If `GATEWAY` is specified, only gateways are returned. If `NON_GATEWAY` is
-        #   is specified, only non-gateway devices are returned. If
+        #   specified, only non-gateway devices are returned. If `GATEWAY_TYPE_UNSPECIFIED`
-        #   `GATEWAY_TYPE_UNSPECIFIED` is specified, all devices are returned.
+        #   is specified, all devices are returned.
         # @param [Fixnum] page_size
-        #   The maximum number of devices to return in the response. If this value
+        #   The maximum number of devices to return in the response. If this value is zero,
-        #   is zero, the service will select a default size. A call may return fewer
+        #   the service will select a default size. A call may return fewer objects than
-        #   objects than requested. A non-empty `next_page_token` in the response
+        #   requested. A non-empty `next_page_token` in the response indicates that more
-        #   indicates that more data is available.
+        #   data is available.
         # @param [String] page_token
-        #   The value returned by the last `ListDevicesResponse`; indicates
+        #   The value returned by the last `ListDevicesResponse`; indicates that this is a
-        #   that this is a continuation of a prior `ListDevices` call and
+        #   continuation of a prior `ListDevices` call and the system should return the
-        #   the system should return the next page of data.
+        #   next page of data.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user

generated/google/apis/cloudtasks_v2beta2.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/tasks/
     module CloudtasksV2beta2
       VERSION = 'V2beta2'
-      REVISION = '20200505'
+      REVISION = '20200804'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/cloudtasks_v2beta2/service.rb

@@ -116,23 +116,17 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a queue.
+        # Creates a queue. Queues created with this method allow tasks to live for a
-        # Queues created with this method allow tasks to live for a maximum of 31
+        # maximum of 31 days. After a task is 31 days old, the task will be deleted
-        # days. After a task is 31 days old, the task will be deleted regardless of
+        # regardless of whether it was dispatched or not. WARNING: Using this method may
-        # whether
+        # have unintended side effects if you are using an App Engine `queue.yaml` or `
-        # it was dispatched or not.
+        # queue.xml` file to manage your queues. Read [Overview of Queue Management and
-        # WARNING: Using this method may have unintended side effects if you are
+        # queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using this
-        # using an App Engine `queue.yaml` or `queue.xml` file to manage your queues.
+        # method.
-        # Read
-        # [Overview of Queue Management and
-        # queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using
-        # this method.
         # @param [String] parent
-        #   Required. The location name in which the queue will be created.
+        #   Required. The location name in which the queue will be created. For example: `
-        #   For example: `projects/PROJECT_ID/locations/LOCATION_ID`
+        #   projects/PROJECT_ID/locations/LOCATION_ID` The list of allowed locations can
-        #   The list of allowed locations can be obtained by calling Cloud
+        #   be obtained by calling Cloud Tasks' implementation of ListLocations.
-        #   Tasks' implementation of
-        #   ListLocations.
         # @param [Google::Apis::CloudtasksV2beta2::Queue] queue_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -163,19 +157,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a queue.
+        # Deletes a queue. This command will delete the queue even if it has tasks in it.
-        # This command will delete the queue even if it has tasks in it.
+        # Note: If you delete a queue, a queue with the same name can't be created for
-        # Note: If you delete a queue, a queue with the same name can't be created
+        # 7 days. WARNING: Using this method may have unintended side effects if you are
-        # for 7 days.
-        # WARNING: Using this method may have unintended side effects if you are
         # using an App Engine `queue.yaml` or `queue.xml` file to manage your queues.
-        # Read
+        # Read [Overview of Queue Management and queue.yaml](https://cloud.google.com/
-        # [Overview of Queue Management and
+        # tasks/docs/queue-yaml) before using this method.
-        # queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using
-        # this method.
         # @param [String] name
-        #   Required. The queue name. For example:
+        #   Required. The queue name. For example: `projects/PROJECT_ID/locations/
-        #   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
+        #   LOCATION_ID/queues/QUEUE_ID`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -205,12 +195,11 @@ module Google
         
         # Gets a queue.
         # @param [String] name
-        #   Required. The resource name of the queue. For example:
+        #   Required. The resource name of the queue. For example: `projects/PROJECT_ID/
-        #   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
+        #   locations/LOCATION_ID/queues/QUEUE_ID`
         # @param [String] read_mask
         #   Optional. Read mask is used for a more granular control over what the API
-        #   returns. By
+        #   returns. By it includes all fields in Queue except for stats.
-        #   it includes all fields in Queue except for stats.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -239,16 +228,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the access control policy for a Queue.
+        # Gets the access control policy for a Queue. Returns an empty policy if the
-        # Returns an empty policy if the resource exists and does not have a policy
+        # resource exists and does not have a policy set. Authorization requires the
-        # set.
+        # following [Google IAM](https://cloud.google.com/iam) permission on the
-        # Authorization requires the following
+        # specified resource parent: * `cloudtasks.queues.getIamPolicy`
-        # [Google IAM](https://cloud.google.com/iam) permission on the specified
-        # resource parent:
-        # * `cloudtasks.queues.getIamPolicy`
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being requested.
+        #   REQUIRED: The resource for which the policy is being requested. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::CloudtasksV2beta2::GetIamPolicyRequest] get_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -279,36 +265,28 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists queues.
+        # Lists queues. Queues are returned in lexicographical order.
-        # Queues are returned in lexicographical order.
         # @param [String] parent
-        #   Required. The location name.
+        #   Required. The location name. For example: `projects/PROJECT_ID/locations/
-        #   For example: `projects/PROJECT_ID/locations/LOCATION_ID`
+        #   LOCATION_ID`
         # @param [String] filter
-        #   `filter` can be used to specify a subset of queues. Any Queue
+        #   `filter` can be used to specify a subset of queues. Any Queue field can be
-        #   field can be used as a filter and several operators as supported.
+        #   used as a filter and several operators as supported. For example: `<=, <, >=, >
-        #   For example: `<=, <, >=, >, !=, =, :`. The filter syntax is the same as
+        #   , !=, =, :`. The filter syntax is the same as described in [Stackdriver's
-        #   described in
+        #   Advanced Logs Filters](https://cloud.google.com/logging/docs/view/
-        #   [Stackdriver's Advanced Logs
+        #   advanced_filters). Sample filter "app_engine_http_target: *". Note that using
-        #   Filters](https://cloud.google.com/logging/docs/view/advanced_filters).
+        #   filters might cause fewer queues than the requested_page size to be returned.
-        #   Sample filter "app_engine_http_target: *".
-        #   Note that using filters might cause fewer queues than the
-        #   requested_page size to be returned.
         # @param [Fixnum] page_size
-        #   Requested page size.
+        #   Requested page size. The maximum page size is 9800. If unspecified, the page
-        #   The maximum page size is 9800. If unspecified, the page size will
+        #   size will be the maximum. Fewer queues than requested might be returned, even
-        #   be the maximum. Fewer queues than requested might be returned,
+        #   if more queues exist; use the next_page_token in the response to determine if
-        #   even if more queues exist; use the
+        #   more queues exist.
-        #   next_page_token in the
-        #   response to determine if more queues exist.
         # @param [String] page_token
-        #   A token identifying the page of results to return.
+        #   A token identifying the page of results to return. To request the first page
-        #   To request the first page results, page_token must be empty. To
+        #   results, page_token must be empty. To request the next page of results,
-        #   request the next page of results, page_token must be the value of
+        #   page_token must be the value of next_page_token returned from the previous
-        #   next_page_token returned
+        #   call to ListQueues method. It is an error to switch the value of the filter
-        #   from the previous call to ListQueues
+        #   while iterating through pages.
-        #   method. It is an error to switch the value of the
-        #   filter while iterating through pages.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -339,41 +317,30 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates a queue.
+        # Updates a queue. This method creates the queue if it does not exist and
-        # This method creates the queue if it does not exist and updates
+        # updates the queue if it does exist. Queues created with this method allow
-        # the queue if it does exist.
+        # tasks to live for a maximum of 31 days. After a task is 31 days old, the task
-        # Queues created with this method allow tasks to live for a maximum of 31
+        # will be deleted regardless of whether it was dispatched or not. WARNING: Using
-        # days. After a task is 31 days old, the task will be deleted regardless of
+        # this method may have unintended side effects if you are using an App Engine `
-        # whether
+        # queue.yaml` or `queue.xml` file to manage your queues. Read [Overview of Queue
-        # it was dispatched or not.
+        # Management and queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml)
-        # WARNING: Using this method may have unintended side effects if you are
+        # before using this method.
-        # using an App Engine `queue.yaml` or `queue.xml` file to manage your queues.
-        # Read
-        # [Overview of Queue Management and
-        # queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using
-        # this method.
         # @param [String] name
-        #   Caller-specified and required in CreateQueue,
+        #   Caller-specified and required in CreateQueue, after which it becomes output
-        #   after which it becomes output only.
+        #   only. The queue name. The queue name must have the following format: `projects/
-        #   The queue name.
+        #   PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID` * `PROJECT_ID` can contain
-        #   The queue name must have the following format:
+        #   letters ([A-Za-z]), numbers ([0-9]), hyphens (-), colons (:), or periods (.).
-        #   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
+        #   For more information, see [Identifying projects](https://cloud.google.com/
-        #   * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]),
+        #   resource-manager/docs/creating-managing-projects#identifying_projects) * `
-        #   hyphens (-), colons (:), or periods (.).
+        #   LOCATION_ID` is the canonical ID for the queue's location. The list of
-        #   For more information, see
+        #   available locations can be obtained by calling ListLocations. For more
-        #   [Identifying
+        #   information, see https://cloud.google.com/about/locations/. * `QUEUE_ID` can
-        #   projects](https://cloud.google.com/resource-manager/docs/creating-managing-
+        #   contain letters ([A-Za-z]), numbers ([0-9]), or hyphens (-). The maximum
-        #   projects#identifying_projects)
+        #   length is 100 characters.
-        #   * `LOCATION_ID` is the canonical ID for the queue's location.
-        #   The list of available locations can be obtained by calling
-        #   ListLocations.
-        #   For more information, see https://cloud.google.com/about/locations/.
-        #   * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or
-        #   hyphens (-). The maximum length is 100 characters.
         # @param [Google::Apis::CloudtasksV2beta2::Queue] queue_object
         # @param [String] update_mask
-        #   A mask used to specify which fields of the queue are being updated.
+        #   A mask used to specify which fields of the queue are being updated. If empty,
-        #   If empty, then all fields will be updated.
+        #   then all fields will be updated.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -404,15 +371,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Pauses the queue.
+        # Pauses the queue. If a queue is paused then the system will stop dispatching
-        # If a queue is paused then the system will stop dispatching tasks
+        # tasks until the queue is resumed via ResumeQueue. Tasks can still be added
-        # until the queue is resumed via
+        # when the queue is paused. A queue is paused if its state is PAUSED.
-        # ResumeQueue. Tasks can still be added
-        # when the queue is paused. A queue is paused if its
-        # state is PAUSED.
         # @param [String] name
-        #   Required. The queue name. For example:
+        #   Required. The queue name. For example: `projects/PROJECT_ID/location/
-        #   `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`
+        #   LOCATION_ID/queues/QUEUE_ID`
         # @param [Google::Apis::CloudtasksV2beta2::PauseQueueRequest] pause_queue_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -443,13 +407,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Purges a queue by deleting all of its tasks.
+        # Purges a queue by deleting all of its tasks. All tasks created before this
-        # All tasks created before this method is called are permanently deleted.
+        # method is called are permanently deleted. Purge operations can take up to one
-        # Purge operations can take up to one minute to take effect. Tasks
+        # minute to take effect. Tasks might be dispatched before the purge takes effect.
-        # might be dispatched before the purge takes effect. A purge is irreversible.
+        # A purge is irreversible.
         # @param [String] name
-        #   Required. The queue name. For example:
+        #   Required. The queue name. For example: `projects/PROJECT_ID/location/
-        #   `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`
+        #   LOCATION_ID/queues/QUEUE_ID`
         # @param [Google::Apis::CloudtasksV2beta2::PurgeQueueRequest] purge_queue_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -480,20 +444,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Resume a queue.
+        # Resume a queue. This method resumes a queue after it has been PAUSED or
-        # This method resumes a queue after it has been
+        # DISABLED. The state of a queue is stored in the queue's state; after calling
-        # PAUSED or
+        # this method it will be set to RUNNING. WARNING: Resuming many high-QPS queues
-        # DISABLED. The state of a queue is stored
+        # at the same time can lead to target overloading. If you are resuming high-QPS
-        # in the queue's state; after calling this method it
+        # queues, follow the 500/50/5 pattern described in [Managing Cloud Tasks Scaling
-        # will be set to RUNNING.
-        # WARNING: Resuming many high-QPS queues at the same time can
-        # lead to target overloading. If you are resuming high-QPS
-        # queues, follow the 500/50/5 pattern described in
-        # [Managing Cloud Tasks Scaling
         # Risks](https://cloud.google.com/tasks/docs/manage-cloud-task-scaling).
         # @param [String] name
-        #   Required. The queue name. For example:
+        #   Required. The queue name. For example: `projects/PROJECT_ID/location/
-        #   `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`
+        #   LOCATION_ID/queues/QUEUE_ID`
         # @param [Google::Apis::CloudtasksV2beta2::ResumeQueueRequest] resume_queue_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -524,17 +483,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Sets the access control policy for a Queue. Replaces any existing
+        # Sets the access control policy for a Queue. Replaces any existing policy. Note:
-        # policy.
+        # The Cloud Console does not check queue-level IAM permissions yet. Project-
-        # Note: The Cloud Console does not check queue-level IAM permissions yet.
+        # level permissions are required to use the Cloud Console. Authorization
-        # Project-level permissions are required to use the Cloud Console.
+        # requires the following [Google IAM](https://cloud.google.com/iam) permission
-        # Authorization requires the following
+        # on the specified resource parent: * `cloudtasks.queues.setIamPolicy`
-        # [Google IAM](https://cloud.google.com/iam) permission on the specified
-        # resource parent:
-        # * `cloudtasks.queues.setIamPolicy`
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being specified.
+        #   REQUIRED: The resource for which the policy is being specified. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::CloudtasksV2beta2::SetIamPolicyRequest] set_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -565,15 +521,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns permissions that a caller has on a Queue.
+        # Returns permissions that a caller has on a Queue. If the resource does not
-        # If the resource does not exist, this will return an empty set of
+        # exist, this will return an empty set of permissions, not a NOT_FOUND error.
-        # permissions, not a NOT_FOUND error.
+        # Note: This operation is designed to be used for building permission-aware UIs
-        # Note: This operation is designed to be used for building permission-aware
+        # and command-line tools, not for authorization checking. This operation may "
-        # UIs and command-line tools, not for authorization checking. This operation
+        # fail open" without warning.
-        # may "fail open" without warning.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy detail is being requested.
+        #   REQUIRED: The resource for which the policy detail is being requested. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::CloudtasksV2beta2::TestIamPermissionsRequest] test_iam_permissions_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -604,20 +559,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Acknowledges a pull task.
+        # Acknowledges a pull task. The worker, that is, the entity that leased this
-        # The worker, that is, the entity that
+        # task must call this method to indicate that the work associated with the task
-        # leased this task must call this method
+        # has finished. The worker must acknowledge a task within the lease_duration or
-        # to indicate that the work associated with the task has finished.
+        # the lease will expire and the task will become available to be leased again.
-        # The worker must acknowledge a task within the
+        # After the task is acknowledged, it will not be returned by a later LeaseTasks,
-        # lease_duration or the lease
+        # GetTask, or ListTasks.
-        # will expire and the task will become available to be leased
-        # again. After the task is acknowledged, it will not be returned
-        # by a later LeaseTasks,
-        # GetTask, or
-        # ListTasks.
         # @param [String] name
-        #   Required. The task name. For example:
+        #   Required. The task name. For example: `projects/PROJECT_ID/locations/
-        #   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
+        #   LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
         # @param [Google::Apis::CloudtasksV2beta2::AcknowledgeTaskRequest] acknowledge_task_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -648,14 +598,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Cancel a pull task's lease.
+        # Cancel a pull task's lease. The worker can use this method to cancel a task's
-        # The worker can use this method to cancel a task's lease by
+        # lease by setting its schedule_time to now. This will make the task available
-        # setting its schedule_time to now. This will
+        # to be leased to the next caller of LeaseTasks.
-        # make the task available to be leased to the next caller of
-        # LeaseTasks.
         # @param [String] name
-        #   Required. The task name. For example:
+        #   Required. The task name. For example: `projects/PROJECT_ID/locations/
-        #   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
+        #   LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
         # @param [Google::Apis::CloudtasksV2beta2::CancelLeaseRequest] cancel_lease_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -686,15 +634,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a task and adds it to a queue.
+        # Creates a task and adds it to a queue. Tasks cannot be updated after creation;
-        # Tasks cannot be updated after creation; there is no UpdateTask command.
+        # there is no UpdateTask command. * For App Engine queues, the maximum task size
-        # * For App Engine queues, the maximum task size is
+        # is 100KB. * For pull queues, the maximum task size is 1MB.
-        # 100KB.
-        # * For pull queues, the maximum task size is 1MB.
         # @param [String] parent
-        #   Required. The queue name. For example:
+        #   Required. The queue name. For example: `projects/PROJECT_ID/locations/
-        #   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
+        #   LOCATION_ID/queues/QUEUE_ID` The queue must already exist.
-        #   The queue must already exist.
         # @param [Google::Apis::CloudtasksV2beta2::CreateTaskRequest] create_task_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -725,13 +670,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a task.
+        # Deletes a task. A task can be deleted if it is scheduled or dispatched. A task
-        # A task can be deleted if it is scheduled or dispatched. A task
+        # cannot be deleted if it has completed successfully or permanently failed.
-        # cannot be deleted if it has completed successfully or permanently
-        # failed.
         # @param [String] name
-        #   Required. The task name. For example:
+        #   Required. The task name. For example: `projects/PROJECT_ID/locations/
-        #   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
+        #   LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -761,19 +704,15 @@ module Google
         
         # Gets a task.
         # @param [String] name
-        #   Required. The task name. For example:
+        #   Required. The task name. For example: `projects/PROJECT_ID/locations/
-        #   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
+        #   LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
         # @param [String] response_view
-        #   The response_view specifies which subset of the Task will be
+        #   The response_view specifies which subset of the Task will be returned. By
-        #   returned.
+        #   default response_view is BASIC; not all information is retrieved by default
-        #   By default response_view is BASIC; not all
+        #   because some data, such as payloads, might be desirable to return only when
-        #   information is retrieved by default because some data, such as
+        #   needed because of its large size or because of the sensitivity of data that it
-        #   payloads, might be desirable to return only when needed because
+        #   contains. Authorization for FULL requires `cloudtasks.tasks.fullView` [Google
-        #   of its large size or because of the sensitivity of data that it
+        #   IAM](https://cloud.google.com/iam/) permission on the Task resource.
-        #   contains.
-        #   Authorization for FULL requires
-        #   `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
-        #   permission on the Task resource.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -802,28 +741,18 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Leases tasks from a pull queue for
+        # Leases tasks from a pull queue for lease_duration. This method is invoked by
-        # lease_duration.
+        # the worker to obtain a lease. The worker must acknowledge the task via
-        # This method is invoked by the worker to obtain a lease. The
+        # AcknowledgeTask after they have performed the work associated with the task.
-        # worker must acknowledge the task via
+        # The payload is intended to store data that the worker needs to perform the
-        # AcknowledgeTask after they have
+        # work associated with the task. To return the payloads in the response, set
-        # performed the work associated with the task.
+        # response_view to FULL. A maximum of 10 qps of LeaseTasks requests are allowed
-        # The payload is intended to store data that
+        # per queue. RESOURCE_EXHAUSTED is returned when this limit is exceeded.
-        # the worker needs to perform the work associated with the task. To
+        # RESOURCE_EXHAUSTED is also returned when max_tasks_dispatched_per_second is
-        # return the payloads in the response, set
+        # exceeded.
-        # response_view to
-        # FULL.
-        # A maximum of 10 qps of LeaseTasks
-        # requests are allowed per
-        # queue. RESOURCE_EXHAUSTED
-        # is returned when this limit is
-        # exceeded. RESOURCE_EXHAUSTED
-        # is also returned when
-        # max_tasks_dispatched_per_second
-        # is exceeded.
         # @param [String] parent
-        #   Required. The queue name. For example:
+        #   Required. The queue name. For example: `projects/PROJECT_ID/locations/
-        #   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
+        #   LOCATION_ID/queues/QUEUE_ID`
         # @param [Google::Apis::CloudtasksV2beta2::LeaseTasksRequest] lease_tasks_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -854,42 +783,30 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists the tasks in a queue.
+        # Lists the tasks in a queue. By default, only the BASIC view is retrieved due
-        # By default, only the BASIC view is retrieved
+        # to performance considerations; response_view controls the subset of
-        # due to performance considerations;
+        # information which is returned. The tasks may be returned in any order. The
-        # response_view controls the
+        # ordering may change at any time.
-        # subset of information which is returned.
-        # The tasks may be returned in any order. The ordering may change at any
-        # time.
         # @param [String] parent
-        #   Required. The queue name. For example:
+        #   Required. The queue name. For example: `projects/PROJECT_ID/locations/
-        #   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
+        #   LOCATION_ID/queues/QUEUE_ID`
         # @param [Fixnum] page_size
-        #   Maximum page size.
+        #   Maximum page size. Fewer tasks than requested might be returned, even if more
-        #   Fewer tasks than requested might be returned, even if more tasks exist; use
+        #   tasks exist; use next_page_token in the response to determine if more tasks
-        #   next_page_token in the response to
+        #   exist. The maximum page size is 1000. If unspecified, the page size will be
-        #   determine if more tasks exist.
+        #   the maximum.
-        #   The maximum page size is 1000. If unspecified, the page size will be the
-        #   maximum.
         # @param [String] page_token
-        #   A token identifying the page of results to return.
+        #   A token identifying the page of results to return. To request the first page
-        #   To request the first page results, page_token must be empty. To
+        #   results, page_token must be empty. To request the next page of results,
-        #   request the next page of results, page_token must be the value of
+        #   page_token must be the value of next_page_token returned from the previous
-        #   next_page_token returned
+        #   call to ListTasks method. The page token is valid for only 2 hours.
-        #   from the previous call to ListTasks
-        #   method.
-        #   The page token is valid for only 2 hours.
         # @param [String] response_view
-        #   The response_view specifies which subset of the Task will be
+        #   The response_view specifies which subset of the Task will be returned. By
-        #   returned.
+        #   default response_view is BASIC; not all information is retrieved by default
-        #   By default response_view is BASIC; not all
+        #   because some data, such as payloads, might be desirable to return only when
-        #   information is retrieved by default because some data, such as
+        #   needed because of its large size or because of the sensitivity of data that it
-        #   payloads, might be desirable to return only when needed because
+        #   contains. Authorization for FULL requires `cloudtasks.tasks.fullView` [Google
-        #   of its large size or because of the sensitivity of data that it
+        #   IAM](https://cloud.google.com/iam/) permission on the Task resource.
-        #   contains.
-        #   Authorization for FULL requires
-        #   `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
-        #   permission on the Task resource.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -920,13 +837,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Renew the current lease of a pull task.
+        # Renew the current lease of a pull task. The worker can use this method to
-        # The worker can use this method to extend the lease by a new
+        # extend the lease by a new duration, starting from now. The new task lease will
-        # duration, starting from now. The new task lease will be
+        # be returned in the task's schedule_time.
-        # returned in the task's schedule_time.
         # @param [String] name
-        #   Required. The task name. For example:
+        #   Required. The task name. For example: `projects/PROJECT_ID/locations/
-        #   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
+        #   LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
         # @param [Google::Apis::CloudtasksV2beta2::RenewLeaseRequest] renew_lease_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -957,30 +873,22 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Forces a task to run now.
+        # Forces a task to run now. When this method is called, Cloud Tasks will
-        # When this method is called, Cloud Tasks will dispatch the task, even if
+        # dispatch the task, even if the task is already running, the queue has reached
-        # the task is already running, the queue has reached its RateLimits or
+        # its RateLimits or is PAUSED. This command is meant to be used for manual
-        # is PAUSED.
+        # debugging. For example, RunTask can be used to retry a failed task after a fix
-        # This command is meant to be used for manual debugging. For
+        # has been made or to manually force a task to be dispatched now. The dispatched
-        # example, RunTask can be used to retry a failed
+        # task is returned. That is, the task that is returned contains the status after
-        # task after a fix has been made or to manually force a task to be
+        # the task is dispatched but before the task is received by its target. If Cloud
-        # dispatched now.
+        # Tasks receives a successful response from the task's target, then the task
-        # The dispatched task is returned. That is, the task that is returned
+        # will be deleted; otherwise the task's schedule_time will be reset to the time
-        # contains the status after the task is dispatched but
+        # that RunTask was called plus the retry delay specified in the queue's
-        # before the task is received by its target.
+        # RetryConfig. RunTask returns NOT_FOUND when it is called on a task that has
-        # If Cloud Tasks receives a successful response from the task's
+        # already succeeded or permanently failed. RunTask cannot be called on a pull
-        # target, then the task will be deleted; otherwise the task's
+        # task.
-        # schedule_time will be reset to the time that
-        # RunTask was called plus the retry delay specified
-        # in the queue's RetryConfig.
-        # RunTask returns
-        # NOT_FOUND when it is called on a
-        # task that has already succeeded or permanently failed.
-        # RunTask cannot be called on a
-        # pull task.
         # @param [String] name
-        #   Required. The task name. For example:
+        #   Required. The task name. For example: `projects/PROJECT_ID/locations/
-        #   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
+        #   LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
         # @param [Google::Apis::CloudtasksV2beta2::RunTaskRequest] run_task_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.

generated/google/apis/cloudtasks_v2beta3.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/tasks/
     module CloudtasksV2beta3
       VERSION = 'V2beta3'
-      REVISION = '20200529'
+      REVISION = '20200804'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/cloudtasks_v2beta3/service.rb

@@ -116,23 +116,17 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a queue.
+        # Creates a queue. Queues created with this method allow tasks to live for a
-        # Queues created with this method allow tasks to live for a maximum of 31
+        # maximum of 31 days. After a task is 31 days old, the task will be deleted
-        # days. After a task is 31 days old, the task will be deleted regardless of
+        # regardless of whether it was dispatched or not. WARNING: Using this method may
-        # whether
+        # have unintended side effects if you are using an App Engine `queue.yaml` or `
-        # it was dispatched or not.
+        # queue.xml` file to manage your queues. Read [Overview of Queue Management and
-        # WARNING: Using this method may have unintended side effects if you are
+        # queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using this
-        # using an App Engine `queue.yaml` or `queue.xml` file to manage your queues.
+        # method.
-        # Read
-        # [Overview of Queue Management and
-        # queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using
-        # this method.
         # @param [String] parent
-        #   Required. The location name in which the queue will be created.
+        #   Required. The location name in which the queue will be created. For example: `
-        #   For example: `projects/PROJECT_ID/locations/LOCATION_ID`
+        #   projects/PROJECT_ID/locations/LOCATION_ID` The list of allowed locations can
-        #   The list of allowed locations can be obtained by calling Cloud
+        #   be obtained by calling Cloud Tasks' implementation of ListLocations.
-        #   Tasks' implementation of
-        #   ListLocations.
         # @param [Google::Apis::CloudtasksV2beta3::Queue] queue_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -163,19 +157,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a queue.
+        # Deletes a queue. This command will delete the queue even if it has tasks in it.
-        # This command will delete the queue even if it has tasks in it.
+        # Note: If you delete a queue, a queue with the same name can't be created for
-        # Note: If you delete a queue, a queue with the same name can't be created
+        # 7 days. WARNING: Using this method may have unintended side effects if you are
-        # for 7 days.
-        # WARNING: Using this method may have unintended side effects if you are
         # using an App Engine `queue.yaml` or `queue.xml` file to manage your queues.
-        # Read
+        # Read [Overview of Queue Management and queue.yaml](https://cloud.google.com/
-        # [Overview of Queue Management and
+        # tasks/docs/queue-yaml) before using this method.
-        # queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using
-        # this method.
         # @param [String] name
-        #   Required. The queue name. For example:
+        #   Required. The queue name. For example: `projects/PROJECT_ID/locations/
-        #   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
+        #   LOCATION_ID/queues/QUEUE_ID`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -205,8 +195,8 @@ module Google
         
         # Gets a queue.
         # @param [String] name
-        #   Required. The resource name of the queue. For example:
+        #   Required. The resource name of the queue. For example: `projects/PROJECT_ID/
-        #   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
+        #   locations/LOCATION_ID/queues/QUEUE_ID`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -234,16 +224,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the access control policy for a Queue.
+        # Gets the access control policy for a Queue. Returns an empty policy if the
-        # Returns an empty policy if the resource exists and does not have a policy
+        # resource exists and does not have a policy set. Authorization requires the
-        # set.
+        # following [Google IAM](https://cloud.google.com/iam) permission on the
-        # Authorization requires the following
+        # specified resource parent: * `cloudtasks.queues.getIamPolicy`
-        # [Google IAM](https://cloud.google.com/iam) permission on the specified
-        # resource parent:
-        # * `cloudtasks.queues.getIamPolicy`
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being requested.
+        #   REQUIRED: The resource for which the policy is being requested. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::CloudtasksV2beta3::GetIamPolicyRequest] get_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -274,36 +261,28 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists queues.
+        # Lists queues. Queues are returned in lexicographical order.
-        # Queues are returned in lexicographical order.
         # @param [String] parent
-        #   Required. The location name.
+        #   Required. The location name. For example: `projects/PROJECT_ID/locations/
-        #   For example: `projects/PROJECT_ID/locations/LOCATION_ID`
+        #   LOCATION_ID`
         # @param [String] filter
-        #   `filter` can be used to specify a subset of queues. Any Queue
+        #   `filter` can be used to specify a subset of queues. Any Queue field can be
-        #   field can be used as a filter and several operators as supported.
+        #   used as a filter and several operators as supported. For example: `<=, <, >=, >
-        #   For example: `<=, <, >=, >, !=, =, :`. The filter syntax is the same as
+        #   , !=, =, :`. The filter syntax is the same as described in [Stackdriver's
-        #   described in
+        #   Advanced Logs Filters](https://cloud.google.com/logging/docs/view/
-        #   [Stackdriver's Advanced Logs
+        #   advanced_filters). Sample filter "state: PAUSED". Note that using filters
-        #   Filters](https://cloud.google.com/logging/docs/view/advanced_filters).
+        #   might cause fewer queues than the requested page_size to be returned.
-        #   Sample filter "state: PAUSED".
-        #   Note that using filters might cause fewer queues than the
-        #   requested page_size to be returned.
         # @param [Fixnum] page_size
-        #   Requested page size.
+        #   Requested page size. The maximum page size is 9800. If unspecified, the page
-        #   The maximum page size is 9800. If unspecified, the page size will
+        #   size will be the maximum. Fewer queues than requested might be returned, even
-        #   be the maximum. Fewer queues than requested might be returned,
+        #   if more queues exist; use the next_page_token in the response to determine if
-        #   even if more queues exist; use the
+        #   more queues exist.
-        #   next_page_token in the
-        #   response to determine if more queues exist.
         # @param [String] page_token
-        #   A token identifying the page of results to return.
+        #   A token identifying the page of results to return. To request the first page
-        #   To request the first page results, page_token must be empty. To
+        #   results, page_token must be empty. To request the next page of results,
-        #   request the next page of results, page_token must be the value of
+        #   page_token must be the value of next_page_token returned from the previous
-        #   next_page_token returned
+        #   call to ListQueues method. It is an error to switch the value of the filter
-        #   from the previous call to ListQueues
+        #   while iterating through pages.
-        #   method. It is an error to switch the value of the
-        #   filter while iterating through pages.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -334,41 +313,30 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates a queue.
+        # Updates a queue. This method creates the queue if it does not exist and
-        # This method creates the queue if it does not exist and updates
+        # updates the queue if it does exist. Queues created with this method allow
-        # the queue if it does exist.
+        # tasks to live for a maximum of 31 days. After a task is 31 days old, the task
-        # Queues created with this method allow tasks to live for a maximum of 31
+        # will be deleted regardless of whether it was dispatched or not. WARNING: Using
-        # days. After a task is 31 days old, the task will be deleted regardless of
+        # this method may have unintended side effects if you are using an App Engine `
-        # whether
+        # queue.yaml` or `queue.xml` file to manage your queues. Read [Overview of Queue
-        # it was dispatched or not.
+        # Management and queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml)
-        # WARNING: Using this method may have unintended side effects if you are
+        # before using this method.
-        # using an App Engine `queue.yaml` or `queue.xml` file to manage your queues.
-        # Read
-        # [Overview of Queue Management and
-        # queue.yaml](https://cloud.google.com/tasks/docs/queue-yaml) before using
-        # this method.
         # @param [String] name
-        #   Caller-specified and required in CreateQueue,
+        #   Caller-specified and required in CreateQueue, after which it becomes output
-        #   after which it becomes output only.
+        #   only. The queue name. The queue name must have the following format: `projects/
-        #   The queue name.
+        #   PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID` * `PROJECT_ID` can contain
-        #   The queue name must have the following format:
+        #   letters ([A-Za-z]), numbers ([0-9]), hyphens (-), colons (:), or periods (.).
-        #   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
+        #   For more information, see [Identifying projects](https://cloud.google.com/
-        #   * `PROJECT_ID` can contain letters ([A-Za-z]), numbers ([0-9]),
+        #   resource-manager/docs/creating-managing-projects#identifying_projects) * `
-        #   hyphens (-), colons (:), or periods (.).
+        #   LOCATION_ID` is the canonical ID for the queue's location. The list of
-        #   For more information, see
+        #   available locations can be obtained by calling ListLocations. For more
-        #   [Identifying
+        #   information, see https://cloud.google.com/about/locations/. * `QUEUE_ID` can
-        #   projects](https://cloud.google.com/resource-manager/docs/creating-managing-
+        #   contain letters ([A-Za-z]), numbers ([0-9]), or hyphens (-). The maximum
-        #   projects#identifying_projects)
+        #   length is 100 characters.
-        #   * `LOCATION_ID` is the canonical ID for the queue's location.
-        #   The list of available locations can be obtained by calling
-        #   ListLocations.
-        #   For more information, see https://cloud.google.com/about/locations/.
-        #   * `QUEUE_ID` can contain letters ([A-Za-z]), numbers ([0-9]), or
-        #   hyphens (-). The maximum length is 100 characters.
         # @param [Google::Apis::CloudtasksV2beta3::Queue] queue_object
         # @param [String] update_mask
-        #   A mask used to specify which fields of the queue are being updated.
+        #   A mask used to specify which fields of the queue are being updated. If empty,
-        #   If empty, then all fields will be updated.
+        #   then all fields will be updated.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -399,15 +367,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Pauses the queue.
+        # Pauses the queue. If a queue is paused then the system will stop dispatching
-        # If a queue is paused then the system will stop dispatching tasks
+        # tasks until the queue is resumed via ResumeQueue. Tasks can still be added
-        # until the queue is resumed via
+        # when the queue is paused. A queue is paused if its state is PAUSED.
-        # ResumeQueue. Tasks can still be added
-        # when the queue is paused. A queue is paused if its
-        # state is PAUSED.
         # @param [String] name
-        #   Required. The queue name. For example:
+        #   Required. The queue name. For example: `projects/PROJECT_ID/location/
-        #   `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`
+        #   LOCATION_ID/queues/QUEUE_ID`
         # @param [Google::Apis::CloudtasksV2beta3::PauseQueueRequest] pause_queue_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -438,13 +403,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Purges a queue by deleting all of its tasks.
+        # Purges a queue by deleting all of its tasks. All tasks created before this
-        # All tasks created before this method is called are permanently deleted.
+        # method is called are permanently deleted. Purge operations can take up to one
-        # Purge operations can take up to one minute to take effect. Tasks
+        # minute to take effect. Tasks might be dispatched before the purge takes effect.
-        # might be dispatched before the purge takes effect. A purge is irreversible.
+        # A purge is irreversible.
         # @param [String] name
-        #   Required. The queue name. For example:
+        #   Required. The queue name. For example: `projects/PROJECT_ID/location/
-        #   `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`
+        #   LOCATION_ID/queues/QUEUE_ID`
         # @param [Google::Apis::CloudtasksV2beta3::PurgeQueueRequest] purge_queue_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -475,20 +440,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Resume a queue.
+        # Resume a queue. This method resumes a queue after it has been PAUSED or
-        # This method resumes a queue after it has been
+        # DISABLED. The state of a queue is stored in the queue's state; after calling
-        # PAUSED or
+        # this method it will be set to RUNNING. WARNING: Resuming many high-QPS queues
-        # DISABLED. The state of a queue is stored
+        # at the same time can lead to target overloading. If you are resuming high-QPS
-        # in the queue's state; after calling this method it
+        # queues, follow the 500/50/5 pattern described in [Managing Cloud Tasks Scaling
-        # will be set to RUNNING.
-        # WARNING: Resuming many high-QPS queues at the same time can
-        # lead to target overloading. If you are resuming high-QPS
-        # queues, follow the 500/50/5 pattern described in
-        # [Managing Cloud Tasks Scaling
         # Risks](https://cloud.google.com/tasks/docs/manage-cloud-task-scaling).
         # @param [String] name
-        #   Required. The queue name. For example:
+        #   Required. The queue name. For example: `projects/PROJECT_ID/location/
-        #   `projects/PROJECT_ID/location/LOCATION_ID/queues/QUEUE_ID`
+        #   LOCATION_ID/queues/QUEUE_ID`
         # @param [Google::Apis::CloudtasksV2beta3::ResumeQueueRequest] resume_queue_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -519,17 +479,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Sets the access control policy for a Queue. Replaces any existing
+        # Sets the access control policy for a Queue. Replaces any existing policy. Note:
-        # policy.
+        # The Cloud Console does not check queue-level IAM permissions yet. Project-
-        # Note: The Cloud Console does not check queue-level IAM permissions yet.
+        # level permissions are required to use the Cloud Console. Authorization
-        # Project-level permissions are required to use the Cloud Console.
+        # requires the following [Google IAM](https://cloud.google.com/iam) permission
-        # Authorization requires the following
+        # on the specified resource parent: * `cloudtasks.queues.setIamPolicy`
-        # [Google IAM](https://cloud.google.com/iam) permission on the specified
-        # resource parent:
-        # * `cloudtasks.queues.setIamPolicy`
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being specified.
+        #   REQUIRED: The resource for which the policy is being specified. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::CloudtasksV2beta3::SetIamPolicyRequest] set_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -560,15 +517,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns permissions that a caller has on a Queue.
+        # Returns permissions that a caller has on a Queue. If the resource does not
-        # If the resource does not exist, this will return an empty set of
+        # exist, this will return an empty set of permissions, not a NOT_FOUND error.
-        # permissions, not a NOT_FOUND error.
+        # Note: This operation is designed to be used for building permission-aware UIs
-        # Note: This operation is designed to be used for building permission-aware
+        # and command-line tools, not for authorization checking. This operation may "
-        # UIs and command-line tools, not for authorization checking. This operation
+        # fail open" without warning.
-        # may "fail open" without warning.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy detail is being requested.
+        #   REQUIRED: The resource for which the policy detail is being requested. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::CloudtasksV2beta3::TestIamPermissionsRequest] test_iam_permissions_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -599,13 +555,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a task and adds it to a queue.
+        # Creates a task and adds it to a queue. Tasks cannot be updated after creation;
-        # Tasks cannot be updated after creation; there is no UpdateTask command.
+        # there is no UpdateTask command. * The maximum task size is 100KB.
-        # * The maximum task size is 100KB.
         # @param [String] parent
-        #   Required. The queue name. For example:
+        #   Required. The queue name. For example: `projects/PROJECT_ID/locations/
-        #   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
+        #   LOCATION_ID/queues/QUEUE_ID` The queue must already exist.
-        #   The queue must already exist.
         # @param [Google::Apis::CloudtasksV2beta3::CreateTaskRequest] create_task_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -636,13 +590,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a task.
+        # Deletes a task. A task can be deleted if it is scheduled or dispatched. A task
-        # A task can be deleted if it is scheduled or dispatched. A task
+        # cannot be deleted if it has executed successfully or permanently failed.
-        # cannot be deleted if it has executed successfully or permanently
-        # failed.
         # @param [String] name
-        #   Required. The task name. For example:
+        #   Required. The task name. For example: `projects/PROJECT_ID/locations/
-        #   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
+        #   LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -672,19 +624,15 @@ module Google
         
         # Gets a task.
         # @param [String] name
-        #   Required. The task name. For example:
+        #   Required. The task name. For example: `projects/PROJECT_ID/locations/
-        #   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
+        #   LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
         # @param [String] response_view
-        #   The response_view specifies which subset of the Task will be
+        #   The response_view specifies which subset of the Task will be returned. By
-        #   returned.
+        #   default response_view is BASIC; not all information is retrieved by default
-        #   By default response_view is BASIC; not all
+        #   because some data, such as payloads, might be desirable to return only when
-        #   information is retrieved by default because some data, such as
+        #   needed because of its large size or because of the sensitivity of data that it
-        #   payloads, might be desirable to return only when needed because
+        #   contains. Authorization for FULL requires `cloudtasks.tasks.fullView` [Google
-        #   of its large size or because of the sensitivity of data that it
+        #   IAM](https://cloud.google.com/iam/) permission on the Task resource.
-        #   contains.
-        #   Authorization for FULL requires
-        #   `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
-        #   permission on the Task resource.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -713,42 +661,30 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists the tasks in a queue.
+        # Lists the tasks in a queue. By default, only the BASIC view is retrieved due
-        # By default, only the BASIC view is retrieved
+        # to performance considerations; response_view controls the subset of
-        # due to performance considerations;
+        # information which is returned. The tasks may be returned in any order. The
-        # response_view controls the
+        # ordering may change at any time.
-        # subset of information which is returned.
-        # The tasks may be returned in any order. The ordering may change at any
-        # time.
         # @param [String] parent
-        #   Required. The queue name. For example:
+        #   Required. The queue name. For example: `projects/PROJECT_ID/locations/
-        #   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID`
+        #   LOCATION_ID/queues/QUEUE_ID`
         # @param [Fixnum] page_size
-        #   Maximum page size.
+        #   Maximum page size. Fewer tasks than requested might be returned, even if more
-        #   Fewer tasks than requested might be returned, even if more tasks exist; use
+        #   tasks exist; use next_page_token in the response to determine if more tasks
-        #   next_page_token in the response to
+        #   exist. The maximum page size is 1000. If unspecified, the page size will be
-        #   determine if more tasks exist.
+        #   the maximum.
-        #   The maximum page size is 1000. If unspecified, the page size will be the
-        #   maximum.
         # @param [String] page_token
-        #   A token identifying the page of results to return.
+        #   A token identifying the page of results to return. To request the first page
-        #   To request the first page results, page_token must be empty. To
+        #   results, page_token must be empty. To request the next page of results,
-        #   request the next page of results, page_token must be the value of
+        #   page_token must be the value of next_page_token returned from the previous
-        #   next_page_token returned
+        #   call to ListTasks method. The page token is valid for only 2 hours.
-        #   from the previous call to ListTasks
-        #   method.
-        #   The page token is valid for only 2 hours.
         # @param [String] response_view
-        #   The response_view specifies which subset of the Task will be
+        #   The response_view specifies which subset of the Task will be returned. By
-        #   returned.
+        #   default response_view is BASIC; not all information is retrieved by default
-        #   By default response_view is BASIC; not all
+        #   because some data, such as payloads, might be desirable to return only when
-        #   information is retrieved by default because some data, such as
+        #   needed because of its large size or because of the sensitivity of data that it
-        #   payloads, might be desirable to return only when needed because
+        #   contains. Authorization for FULL requires `cloudtasks.tasks.fullView` [Google
-        #   of its large size or because of the sensitivity of data that it
+        #   IAM](https://cloud.google.com/iam/) permission on the Task resource.
-        #   contains.
-        #   Authorization for FULL requires
-        #   `cloudtasks.tasks.fullView` [Google IAM](https://cloud.google.com/iam/)
-        #   permission on the Task resource.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -779,28 +715,21 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Forces a task to run now.
+        # Forces a task to run now. When this method is called, Cloud Tasks will
-        # When this method is called, Cloud Tasks will dispatch the task, even if
+        # dispatch the task, even if the task is already running, the queue has reached
-        # the task is already running, the queue has reached its RateLimits or
+        # its RateLimits or is PAUSED. This command is meant to be used for manual
-        # is PAUSED.
+        # debugging. For example, RunTask can be used to retry a failed task after a fix
-        # This command is meant to be used for manual debugging. For
+        # has been made or to manually force a task to be dispatched now. The dispatched
-        # example, RunTask can be used to retry a failed
+        # task is returned. That is, the task that is returned contains the status after
-        # task after a fix has been made or to manually force a task to be
+        # the task is dispatched but before the task is received by its target. If Cloud
-        # dispatched now.
+        # Tasks receives a successful response from the task's target, then the task
-        # The dispatched task is returned. That is, the task that is returned
+        # will be deleted; otherwise the task's schedule_time will be reset to the time
-        # contains the status after the task is dispatched but
+        # that RunTask was called plus the retry delay specified in the queue's
-        # before the task is received by its target.
+        # RetryConfig. RunTask returns NOT_FOUND when it is called on a task that has
-        # If Cloud Tasks receives a successful response from the task's
+        # already succeeded or permanently failed.
-        # target, then the task will be deleted; otherwise the task's
-        # schedule_time will be reset to the time that
-        # RunTask was called plus the retry delay specified
-        # in the queue's RetryConfig.
-        # RunTask returns
-        # NOT_FOUND when it is called on a
-        # task that has already succeeded or permanently failed.
         # @param [String] name
-        #   Required. The task name. For example:
+        #   Required. The task name. For example: `projects/PROJECT_ID/locations/
-        #   `projects/PROJECT_ID/locations/LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
+        #   LOCATION_ID/queues/QUEUE_ID/tasks/TASK_ID`
         # @param [Google::Apis::CloudtasksV2beta3::RunTaskRequest] run_task_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.

generated/google/apis/compute_alpha.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/compute/docs/reference/latest/
     module ComputeAlpha
       VERSION = 'Alpha'
-      REVISION = '20200704'
+      REVISION = '20200719'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/compute_alpha/classes.rb

@@ -1174,18 +1174,6 @@ module Google
         # @return [String]
         attr_accessor :location_hint
       
-        # DEPRECATED, please use maintenance_freeze_duration_hours. TODO(b/154158138):
-        # Remove this field. Compute Engine Long Term Release. When specified, VMs that
-        # have this policy become long term release (internal: stable fleet) VMs.
-        # For all VM shapes, this should result in fewer disruptions due to software
-        # updates and greater predictability via 1 week extended notifications.
-        # For GPU VMs, this should also result in an 2 week uptime guarantee. See go/
-        # stable-fleet-gpus-design for more details.
-        # Corresponds to the JSON property `longTermRelease`
-        # @return [Boolean]
-        attr_accessor :long_term_release
-        alias_method :long_term_release?, :long_term_release
-      
         # Specifies type of machine (name only) which has fixed number of vCPUs and
         # fixed amount of memory. This also includes specifying custom machine type
         # following custom-NUMBER_OF_CPUS-AMOUNT_OF_MEMORY pattern.
@@ -1220,7 +1208,6 @@ module Google
           @guest_accelerators = args[:guest_accelerators] if args.key?(:guest_accelerators)
           @local_ssds = args[:local_ssds] if args.key?(:local_ssds)
           @location_hint = args[:location_hint] if args.key?(:location_hint)
-          @long_term_release = args[:long_term_release] if args.key?(:long_term_release)
           @machine_type = args[:machine_type] if args.key?(:machine_type)
           @maintenance_freeze_duration_hours = args[:maintenance_freeze_duration_hours] if args.key?(:maintenance_freeze_duration_hours)
           @maintenance_interval = args[:maintenance_interval] if args.key?(:maintenance_interval)
@@ -2837,6 +2824,11 @@ module Google
         # @return [String]
         attr_accessor :creation_timestamp
       
+        # Headers that the HTTP/S load balancer should add to proxied responses.
+        # Corresponds to the JSON property `customResponseHeaders`
+        # @return [Array<String>]
+        attr_accessor :custom_response_headers
+      
         # An optional textual description of the resource; provided by the client when
         # the resource is created.
         # Corresponds to the JSON property `description`
@@ -2888,6 +2880,7 @@ module Google
           @bucket_name = args[:bucket_name] if args.key?(:bucket_name)
           @cdn_policy = args[:cdn_policy] if args.key?(:cdn_policy)
           @creation_timestamp = args[:creation_timestamp] if args.key?(:creation_timestamp)
+          @custom_response_headers = args[:custom_response_headers] if args.key?(:custom_response_headers)
           @description = args[:description] if args.key?(:description)
           @enable_cdn = args[:enable_cdn] if args.key?(:enable_cdn)
           @id = args[:id] if args.key?(:id)
@@ -2902,6 +2895,66 @@ module Google
       class BackendBucketCdnPolicy
         include Google::Apis::Core::Hashable
       
+        # 
+        # Corresponds to the JSON property `cacheMode`
+        # @return [String]
+        attr_accessor :cache_mode
+      
+        # Specifies a separate client (e.g. browser client) TTL, separate from the TTL
+        # for Cloud CDN?s edge caches. Leaving this empty will use the same cache TTL
+        # for both Cloud CDN and the client-facing response. The maximum allowed value
+        # is 86400s (1 day).
+        # Corresponds to the JSON property `clientTtl`
+        # @return [Fixnum]
+        attr_accessor :client_ttl
+      
+        # Specifies the default TTL for cached content served by this origin for
+        # responses that do not have an existing valid TTL (max-age or s-max-age).
+        # Setting a TTL of ?0? means ?always revalidate? and a value of ?-1? disables
+        # caching for that status code. The value of defaultTTL cannot be set to a value
+        # greater than that of maxTTL, but can be equal. When the cacheMode is set to
+        # FORCE_CACHE_ALL, the defaultTTL will overwrite the TTL set in all responses.
+        # The maximum allowed value is 31,622,400s (1 year), noting that infrequently
+        # accessed objects may be evicted from the cache before the defined TTL.
+        # Corresponds to the JSON property `defaultTtl`
+        # @return [Fixnum]
+        attr_accessor :default_ttl
+      
+        # Specifies the maximum allowed TTL for cached content served by this origin.
+        # Cache directives that attempt to set a max-age or s-maxage higher than this,
+        # or an Expires header more than maxTTL seconds in the future will be capped at
+        # the value of maxTTL, as if it were the value of an s-maxage Cache-Control
+        # directive. Setting a TTL of ?0? means ?always revalidate? and a value of ?-1?
+        # disables caching for that status code. The maximum allowed value is 31,622,
+        # 400s (1 year), noting that infrequently accessed objects may be evicted from
+        # the cache before the defined TTL.
+        # Corresponds to the JSON property `maxTtl`
+        # @return [Fixnum]
+        attr_accessor :max_ttl
+      
+        # Negative caching allows per-status code TTLs to be set, in order to apply fine-
+        # grained caching for common errors or redirects. This can reduce the load on
+        # your origin and improve end-user experience by reducing response latency. By
+        # default, Cloud CDN will apply the following default TTLs to these status codes:
+        # HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m HTTP 404 (Not
+        # Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s HTTP 405 (Method
+        # Not Found), 414 (URI Too Long), 501 (Not Implemented): 60s These defaults can
+        # be overridden in negative_caching_policy
+        # Corresponds to the JSON property `negativeCaching`
+        # @return [Boolean]
+        attr_accessor :negative_caching
+        alias_method :negative_caching?, :negative_caching
+      
+        # Sets a cache TTL for the specified HTTP status code. negative_caching must be
+        # enabled to configure negative_caching_policy. Omitting the policy and leaving
+        # negative_caching enabled will use Cloud CDN?s default cache TTLs. Note that
+        # when specifying an explicit negative_caching_policy, you should take care to
+        # specify a cache TTL for all response codes that you wish to cache. Cloud CDN
+        # will not apply any default negative caching when a policy exists.
+        # Corresponds to the JSON property `negativeCachingPolicys`
+        # @return [Array<Google::Apis::ComputeAlpha::BackendBucketCdnPolicyNegativeCachingPolicy>]
+        attr_accessor :negative_caching_policys
+      
         # If true then Cloud CDN will combine multiple concurrent cache fill requests
         # into a small number of requests to the origin.
         # Corresponds to the JSON property `requestCoalescing`
@@ -2931,12 +2984,49 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @cache_mode = args[:cache_mode] if args.key?(:cache_mode)
+          @client_ttl = args[:client_ttl] if args.key?(:client_ttl)
+          @default_ttl = args[:default_ttl] if args.key?(:default_ttl)
+          @max_ttl = args[:max_ttl] if args.key?(:max_ttl)
+          @negative_caching = args[:negative_caching] if args.key?(:negative_caching)
+          @negative_caching_policys = args[:negative_caching_policys] if args.key?(:negative_caching_policys)
           @request_coalescing = args[:request_coalescing] if args.key?(:request_coalescing)
           @signed_url_cache_max_age_sec = args[:signed_url_cache_max_age_sec] if args.key?(:signed_url_cache_max_age_sec)
           @signed_url_key_names = args[:signed_url_key_names] if args.key?(:signed_url_key_names)
         end
       end
       
+      # Specify CDN TTLs for response error codes.
+      class BackendBucketCdnPolicyNegativeCachingPolicy
+        include Google::Apis::Core::Hashable
+      
+        # The HTTP status code to define a TTL against. Only HTTP status codes 300, 301,
+        # 308, 404, 405, 410, 414, 451 and 501 are can be specified as values, and you
+        # cannot specify a status code more than once.
+        # Corresponds to the JSON property `code`
+        # @return [Fixnum]
+        attr_accessor :code
+      
+        # The TTL (in seconds) to cache responses with the corresponding status code for.
+        # A TTL of ?0? means ?always revalidate? and a value of ?-1? disables caching
+        # for that status code. The maximum allowed value is 1800s (30 minutes), noting
+        # that infrequently accessed objects may be evicted from the cache before the
+        # defined TTL.
+        # Corresponds to the JSON property `ttl`
+        # @return [Fixnum]
+        attr_accessor :ttl
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @code = args[:code] if args.key?(:code)
+          @ttl = args[:ttl] if args.key?(:ttl)
+        end
+      end
+      
       # Contains a list of BackendBucket resources.
       class BackendBucketList
         include Google::Apis::Core::Hashable
@@ -3111,6 +3201,11 @@ module Google
         # @return [Array<String>]
         attr_accessor :custom_request_headers
       
+        # Headers that the HTTP/S load balancer should add to proxied responses.
+        # Corresponds to the JSON property `customResponseHeaders`
+        # @return [Array<String>]
+        attr_accessor :custom_response_headers
+      
         # An optional description of this resource. Provide this property when you
         # create the resource.
         # Corresponds to the JSON property `description`
@@ -3150,10 +3245,10 @@ module Google
         # The list of URLs to the healthChecks, httpHealthChecks (legacy), or
         # httpsHealthChecks (legacy) resource for health checking this backend service.
         # Not all backend services support legacy health checks. See  Load balancer
-        # guide. Currently at most one health check can be specified. Backend services
+        # guide. Currently, at most one health check can be specified for each backend
-        # with instance group or zonal NEG backends must have a health check. Backend
+        # service. Backend services with instance group or zonal NEG backends must have
-        # services with internet NEG backends must not have a health check. A health
+        # a health check. Backend services with internet or serverless NEG backends must
-        # check must
+        # not have a health check.
         # Corresponds to the JSON property `healthChecks`
         # @return [Array<String>]
         attr_accessor :health_checks
@@ -3262,8 +3357,8 @@ module Google
         attr_accessor :port_name
       
         # The protocol this BackendService uses to communicate with backends.
-        # Possible values are HTTP, HTTPS, HTTP2, TCP, SSL, or UDP. depending on the
+        # Possible values are HTTP, HTTPS, HTTP2, TCP, SSL, UDP or GRPC. depending on
-        # chosen load balancer or Traffic Director configuration. Refer to the
+        # the chosen load balancer or Traffic Director configuration. Refer to the
         # documentation for the load balancer or for Traffic Director for more
         # information.
         # Corresponds to the JSON property `protocol`
@@ -3334,6 +3429,7 @@ module Google
           @consistent_hash = args[:consistent_hash] if args.key?(:consistent_hash)
           @creation_timestamp = args[:creation_timestamp] if args.key?(:creation_timestamp)
           @custom_request_headers = args[:custom_request_headers] if args.key?(:custom_request_headers)
+          @custom_response_headers = args[:custom_response_headers] if args.key?(:custom_response_headers)
           @description = args[:description] if args.key?(:description)
           @enable_cdn = args[:enable_cdn] if args.key?(:enable_cdn)
           @failover_policy = args[:failover_policy] if args.key?(:failover_policy)
@@ -3494,6 +3590,66 @@ module Google
         # @return [Google::Apis::ComputeAlpha::CacheKeyPolicy]
         attr_accessor :cache_key_policy
       
+        # 
+        # Corresponds to the JSON property `cacheMode`
+        # @return [String]
+        attr_accessor :cache_mode
+      
+        # Specifies a separate client (e.g. browser client) TTL, separate from the TTL
+        # for Cloud CDN?s edge caches. Leaving this empty will use the same cache TTL
+        # for both Cloud CDN and the client-facing response. The maximum allowed value
+        # is 86400s (1 day).
+        # Corresponds to the JSON property `clientTtl`
+        # @return [Fixnum]
+        attr_accessor :client_ttl
+      
+        # Specifies the default TTL for cached content served by this origin for
+        # responses that do not have an existing valid TTL (max-age or s-max-age).
+        # Setting a TTL of ?0? means ?always revalidate? and a value of ?-1? disables
+        # caching for that status code. The value of defaultTTL cannot be set to a value
+        # greater than that of maxTTL, but can be equal. When the cacheMode is set to
+        # FORCE_CACHE_ALL, the defaultTTL will overwrite the TTL set in all responses.
+        # The maximum allowed value is 31,622,400s (1 year), noting that infrequently
+        # accessed objects may be evicted from the cache before the defined TTL.
+        # Corresponds to the JSON property `defaultTtl`
+        # @return [Fixnum]
+        attr_accessor :default_ttl
+      
+        # Specifies the maximum allowed TTL for cached content served by this origin.
+        # Cache directives that attempt to set a max-age or s-maxage higher than this,
+        # or an Expires header more than maxTTL seconds in the future will be capped at
+        # the value of maxTTL, as if it were the value of an s-maxage Cache-Control
+        # directive. Setting a TTL of ?0? means ?always revalidate? and a value of ?-1?
+        # disables caching for that status code. The maximum allowed value is 31,622,
+        # 400s (1 year), noting that infrequently accessed objects may be evicted from
+        # the cache before the defined TTL.
+        # Corresponds to the JSON property `maxTtl`
+        # @return [Fixnum]
+        attr_accessor :max_ttl
+      
+        # Negative caching allows per-status code TTLs to be set, in order to apply fine-
+        # grained caching for common errors or redirects. This can reduce the load on
+        # your origin and improve end-user experience by reducing response latency. By
+        # default, Cloud CDN will apply the following default TTLs to these status codes:
+        # HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m HTTP 404 (Not
+        # Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s HTTP 405 (Method
+        # Not Found), 414 (URI Too Long), 501 (Not Implemented): 60s These defaults can
+        # be overridden in negative_caching_policy
+        # Corresponds to the JSON property `negativeCaching`
+        # @return [Boolean]
+        attr_accessor :negative_caching
+        alias_method :negative_caching?, :negative_caching
+      
+        # Sets a cache TTL for the specified HTTP status code. negative_caching must be
+        # enabled to configure negative_caching_policy. Omitting the policy and leaving
+        # negative_caching enabled will use Cloud CDN?s default cache TTLs. Note that
+        # when specifying an explicit negative_caching_policy, you should take care to
+        # specify a cache TTL for all response codes that you wish to cache. Cloud CDN
+        # will not apply any default negative caching when a policy exists.
+        # Corresponds to the JSON property `negativeCachingPolicys`
+        # @return [Array<Google::Apis::ComputeAlpha::BackendServiceCdnPolicyNegativeCachingPolicy>]
+        attr_accessor :negative_caching_policys
+      
         # If true then Cloud CDN will combine multiple concurrent cache fill requests
         # into a small number of requests to the origin.
         # Corresponds to the JSON property `requestCoalescing`
@@ -3524,12 +3680,49 @@ module Google
         # Update properties of this object
         def update!(**args)
           @cache_key_policy = args[:cache_key_policy] if args.key?(:cache_key_policy)
+          @cache_mode = args[:cache_mode] if args.key?(:cache_mode)
+          @client_ttl = args[:client_ttl] if args.key?(:client_ttl)
+          @default_ttl = args[:default_ttl] if args.key?(:default_ttl)
+          @max_ttl = args[:max_ttl] if args.key?(:max_ttl)
+          @negative_caching = args[:negative_caching] if args.key?(:negative_caching)
+          @negative_caching_policys = args[:negative_caching_policys] if args.key?(:negative_caching_policys)
           @request_coalescing = args[:request_coalescing] if args.key?(:request_coalescing)
           @signed_url_cache_max_age_sec = args[:signed_url_cache_max_age_sec] if args.key?(:signed_url_cache_max_age_sec)
           @signed_url_key_names = args[:signed_url_key_names] if args.key?(:signed_url_key_names)
         end
       end
       
+      # Specify CDN TTLs for response error codes.
+      class BackendServiceCdnPolicyNegativeCachingPolicy
+        include Google::Apis::Core::Hashable
+      
+        # The HTTP status code to define a TTL against. Only HTTP status codes 300, 301,
+        # 308, 404, 405, 410, 414, 451 and 501 are can be specified as values, and you
+        # cannot specify a status code more than once.
+        # Corresponds to the JSON property `code`
+        # @return [Fixnum]
+        attr_accessor :code
+      
+        # The TTL (in seconds) to cache responses with the corresponding status code for.
+        # A TTL of ?0? means ?always revalidate? and a value of ?-1? disables caching
+        # for that status code. The maximum allowed value is 1800s (30 minutes), noting
+        # that infrequently accessed objects may be evicted from the cache before the
+        # defined TTL.
+        # Corresponds to the JSON property `ttl`
+        # @return [Fixnum]
+        attr_accessor :ttl
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @code = args[:code] if args.key?(:code)
+          @ttl = args[:ttl] if args.key?(:ttl)
+        end
+      end
+      
       # Applicable only to Failover for Internal TCP/UDP Load Balancing. On failover
       # or failback, this field indicates whether connection draining will be honored.
       # GCP has a fixed connection draining timeout of 10 minutes. A setting of true
@@ -5628,12 +5821,11 @@ module Google
         # @return [String]
         attr_accessor :self_link_with_id
       
-        # Size of the persistent disk, specified in GB. You can specify this field when
+        # Size, in GB, of the persistent disk. You can specify this field when creating
-        # creating a persistent disk using the sourceImage or sourceSnapshot parameter,
+        # a persistent disk using the sourceImage, sourceSnapshot, or sourceDisk
-        # or specify it alone to create an empty persistent disk.
+        # parameter, or specify it alone to create an empty persistent disk.
-        # If you specify this field along with sourceImage or sourceSnapshot, the value
+        # If you specify this field along with a source, the value of sizeGb must not be
-        # of sizeGb must not be less than the size of the sourceImage or the size of the
+        # less than the size of the source. Acceptable values are 1 to 65536, inclusive.
-        # snapshot. Acceptable values are 1 to 65536, inclusive.
         # Corresponds to the JSON property `sizeGb`
         # @return [Fixnum]
         attr_accessor :size_gb
@@ -5689,9 +5881,9 @@ module Google
         # @return [String]
         attr_accessor :source_image_id
       
-        # The source in-place snapshot used to create this disk. You can provide this as
+        # [Deprecated] The source in-place snapshot used to create this disk. You can
-        # a partial or full URL to the resource. For example, the following are valid
+        # provide this as a partial or full URL to the resource. For example, the
-        # values:
+        # following are valid values:
         # - https://www.googleapis.com/compute/v1/projects/project/global/
         # inPlaceSnapshots/inPlaceSnapshots
         # - projects/project/global/inPlaceSnapshots/inPlaceSnapshots
@@ -5700,12 +5892,12 @@ module Google
         # @return [String]
         attr_accessor :source_in_place_snapshot
       
-        # [Output Only] The unique ID of the in-place snapshot used to create this disk.
+        # [Deprecated] [Output Only] The unique ID of the in-place snapshot used to
-        # This value identifies the exact in-place snapshot that was used to create this
+        # create this disk. This value identifies the exact in-place snapshot that was
-        # persistent disk. For example, if you created the persistent disk from an in-
+        # used to create this persistent disk. For example, if you created the
-        # place snapshot that was later deleted and recreated under the same name, the
+        # persistent disk from an in-place snapshot that was later deleted and recreated
-        # source in-place snapshot ID would identify the exact version of the in-place
+        # under the same name, the source in-place snapshot ID would identify the exact
-        # snapshot that was used.
+        # version of the in-place snapshot that was used.
         # Corresponds to the JSON property `sourceInPlaceSnapshotId`
         # @return [String]
         attr_accessor :source_in_place_snapshot_id
@@ -8439,13 +8631,14 @@ module Google
         # that points to a target proxy or a target pool. Do not use with a forwarding
         # rule that points to a backend service. This field is used along with the
         # target field for TargetHttpProxy, TargetHttpsProxy, TargetSslProxy,
-        # TargetTcpProxy, TargetVpnGateway, TargetPool, TargetInstance.
+        # TargetTcpProxy, TargetGrpcProxy, TargetVpnGateway, TargetPool, TargetInstance.
         # Applicable only when IPProtocol is TCP, UDP, or SCTP, only packets addressed
         # to ports in the specified range will be forwarded to target. Forwarding rules
         # with the same [IPAddress, IPProtocol] pair must have disjoint port ranges.
         # Some types of forwarding target have constraints on the acceptable ports:
         # - TargetHttpProxy: 80, 8080
         # - TargetHttpsProxy: 443
+        # - TargetGrpcProxy: Any ports
         # - TargetTcpProxy: 25, 43, 110, 143, 195, 443, 465, 587, 700, 993, 995, 1688,
         # 1883, 5222
         # - TargetSslProxy: 25, 43, 110, 143, 195, 443, 465, 587, 700, 993, 995, 1688,
@@ -8520,8 +8713,8 @@ module Google
         # forwarding rules, this target must live in the same region as the forwarding
         # rule. For global forwarding rules, this target must be a global load balancing
         # resource. The forwarded traffic must be of a type appropriate to the target
-        # object. For INTERNAL_SELF_MANAGED load balancing, only targetHttpProxy is
+        # object. For INTERNAL_SELF_MANAGED load balancing, only targetHttpProxy and
-        # valid, not targetHttpsProxy.
+        # targetGrpcProxy are valid, not targetHttpsProxy.
         # Corresponds to the JSON property `target`
         # @return [String]
         attr_accessor :target
@@ -11269,7 +11462,11 @@ module Google
         # @return [Array<Google::Apis::ComputeAlpha::HttpFilterConfig>]
         attr_accessor :http_filter_metadata
       
-        # 
+        # The list of criteria for matching attributes of a request to this routeRule.
+        # This list has OR semantics: the request matches this routeRule when any of the
+        # matchRules are satisfied. However predicates within a given matchRule have AND
+        # semantics. All predicates within a matchRule must match for the request to
+        # match the rule.
         # Corresponds to the JSON property `matchRules`
         # @return [Array<Google::Apis::ComputeAlpha::HttpRouteRuleMatch>]
         attr_accessor :match_rules
@@ -11297,6 +11494,8 @@ module Google
         # routeAction cannot contain any  weightedBackendServices.
         # Only one of urlRedirect, service or routeAction.weightedBackendService must be
         # set.
+        # UrlMaps for external HTTP(S) load balancers support only the urlRewrite action
+        # within a routeRule's routeAction.
         # Corresponds to the JSON property `routeAction`
         # @return [Google::Apis::ComputeAlpha::HttpRouteAction]
         attr_accessor :route_action
@@ -20057,10 +20256,11 @@ module Google
       # Represents a collection of network endpoints.
       # A network endpoint group (NEG) defines how a set of endpoints should be
       # reached, whether they are reachable, and where they are located. For more
-      # information about using NEGs, see  Setting up internet NEGs or  Setting up
+      # information about using NEGs, see  Setting up internet NEGs,  Setting up zonal
-      # zonal NEGs. (== resource_for `$api_version`.networkEndpointGroups ==) (==
+      # NEGs, or  Setting up serverless NEGs. (== resource_for `$api_version`.
-      # resource_for `$api_version`.globalNetworkEndpointGroups ==) (== resource_for `$
+      # networkEndpointGroups ==) (== resource_for `$api_version`.
-      # api_version`.regionNetworkEndpointGroups ==)
+      # globalNetworkEndpointGroups ==) (== resource_for `$api_version`.
+      # regionNetworkEndpointGroups ==)
       class NetworkEndpointGroup
         include Google::Apis::Core::Hashable
       
@@ -20146,7 +20346,9 @@ module Google
         # @return [String]
         attr_accessor :network
       
-        # Type of network endpoints in this network endpoint group.
+        # Type of network endpoints in this network endpoint group. Can be one of
+        # GCE_VM_IP_PORT, NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT, INTERNET_IP_PORT,
+        # or SERVERLESS.
         # Corresponds to the JSON property `networkEndpointType`
         # @return [String]
         attr_accessor :network_endpoint_type
@@ -25953,9 +26155,9 @@ module Google
         # @return [String]
         attr_accessor :region
       
-        # The status of the public delegated prefix. Possible values are: ACTIVE: The
+        # The status of the public delegated prefix. Possible values are: INITIALIZING:
-        # public delegated prefix is active DRAINED: The public delegated prefix is
+        # The public delegated prefix is being initialized and addresses cannot be
-        # drained.
+        # created yet. ANNOUNCED: The public delegated prefix is active.
         # Corresponds to the JSON property `status`
         # @return [String]
         attr_accessor :status
@@ -31553,18 +31755,6 @@ module Google
         # @return [String]
         attr_accessor :location_hint
       
-        # DEPRECATED, please use maintenance_freeze_duration_hours. TODO(b/154158138):
-        # Remove this field. Compute Engine Long Term Release. When specified, VMs that
-        # have this policy become long term release (internal: stable fleet) VMs.
-        # For all VM shapes, this should result in fewer disruptions due to software
-        # updates and greater predictability via 1 week extended notifications.
-        # For GPU VMs, this should also result in an 2 week uptime guarantee. See go/
-        # stable-fleet-gpus-design for more details.
-        # Corresponds to the JSON property `longTermRelease`
-        # @return [Boolean]
-        attr_accessor :long_term_release
-        alias_method :long_term_release?, :long_term_release
-      
         # Specifies the number of hours after instance creation where the instance won't
         # be scheduled for maintenance.
         # Corresponds to the JSON property `maintenanceFreezeDurationHours`
@@ -31609,7 +31799,6 @@ module Google
           @automatic_restart = args[:automatic_restart] if args.key?(:automatic_restart)
           @latency_tolerant = args[:latency_tolerant] if args.key?(:latency_tolerant)
           @location_hint = args[:location_hint] if args.key?(:location_hint)
-          @long_term_release = args[:long_term_release] if args.key?(:long_term_release)
           @maintenance_freeze_duration_hours = args[:maintenance_freeze_duration_hours] if args.key?(:maintenance_freeze_duration_hours)
           @min_node_cpus = args[:min_node_cpus] if args.key?(:min_node_cpus)
           @node_affinities = args[:node_affinities] if args.key?(:node_affinities)
@@ -37032,7 +37221,7 @@ module Google
       
         # The URL of the HttpHealthCheck resource. A member instance in this pool is
         # considered healthy if and only if the health checks pass. An empty list means
-        # all member instances will be considered healthy at all times. Only
+        # all member instances will be considered healthy at all times. Only legacy
         # HttpHealthChecks are supported. Only one health check may be specified.
         # Corresponds to the JSON property `healthChecks`
         # @return [Array<String>]

generated/google/apis/compute_alpha/representations.rb

@@ -352,6 +352,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class BackendBucketCdnPolicyNegativeCachingPolicy
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class BackendBucketList
         class Representation < Google::Apis::Core::JsonRepresentation; end
         
@@ -400,6 +406,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class BackendServiceCdnPolicyNegativeCachingPolicy
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class BackendServiceFailoverPolicy
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -5801,7 +5813,6 @@ module Google
           collection :local_ssds, as: 'localSsds', class: Google::Apis::ComputeAlpha::AllocationSpecificSkuAllocationAllocatedInstancePropertiesReservedDisk, decorator: Google::Apis::ComputeAlpha::AllocationSpecificSkuAllocationAllocatedInstancePropertiesReservedDisk::Representation
       
           property :location_hint, as: 'locationHint'
-          property :long_term_release, as: 'longTermRelease'
           property :machine_type, as: 'machineType'
           property :maintenance_freeze_duration_hours, as: 'maintenanceFreezeDurationHours'
           property :maintenance_interval, as: 'maintenanceInterval'
@@ -6144,6 +6155,7 @@ module Google
           property :cdn_policy, as: 'cdnPolicy', class: Google::Apis::ComputeAlpha::BackendBucketCdnPolicy, decorator: Google::Apis::ComputeAlpha::BackendBucketCdnPolicy::Representation
       
           property :creation_timestamp, as: 'creationTimestamp'
+          collection :custom_response_headers, as: 'customResponseHeaders'
           property :description, as: 'description'
           property :enable_cdn, as: 'enableCdn'
           property :id, :numeric_string => true, as: 'id'
@@ -6157,12 +6169,27 @@ module Google
       class BackendBucketCdnPolicy
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :cache_mode, as: 'cacheMode'
+          property :client_ttl, as: 'clientTtl'
+          property :default_ttl, as: 'defaultTtl'
+          property :max_ttl, as: 'maxTtl'
+          property :negative_caching, as: 'negativeCaching'
+          collection :negative_caching_policys, as: 'negativeCachingPolicys', class: Google::Apis::ComputeAlpha::BackendBucketCdnPolicyNegativeCachingPolicy, decorator: Google::Apis::ComputeAlpha::BackendBucketCdnPolicyNegativeCachingPolicy::Representation
+      
           property :request_coalescing, as: 'requestCoalescing'
           property :signed_url_cache_max_age_sec, :numeric_string => true, as: 'signedUrlCacheMaxAgeSec'
           collection :signed_url_key_names, as: 'signedUrlKeyNames'
         end
       end
       
+      class BackendBucketCdnPolicyNegativeCachingPolicy
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :code, as: 'code'
+          property :ttl, as: 'ttl'
+        end
+      end
+      
       class BackendBucketList
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -6211,6 +6238,7 @@ module Google
       
           property :creation_timestamp, as: 'creationTimestamp'
           collection :custom_request_headers, as: 'customRequestHeaders'
+          collection :custom_response_headers, as: 'customResponseHeaders'
           property :description, as: 'description'
           property :enable_cdn, as: 'enableCDN'
           property :failover_policy, as: 'failoverPolicy', class: Google::Apis::ComputeAlpha::BackendServiceFailoverPolicy, decorator: Google::Apis::ComputeAlpha::BackendServiceFailoverPolicy::Representation
@@ -6281,12 +6309,27 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           property :cache_key_policy, as: 'cacheKeyPolicy', class: Google::Apis::ComputeAlpha::CacheKeyPolicy, decorator: Google::Apis::ComputeAlpha::CacheKeyPolicy::Representation
       
+          property :cache_mode, as: 'cacheMode'
+          property :client_ttl, as: 'clientTtl'
+          property :default_ttl, as: 'defaultTtl'
+          property :max_ttl, as: 'maxTtl'
+          property :negative_caching, as: 'negativeCaching'
+          collection :negative_caching_policys, as: 'negativeCachingPolicys', class: Google::Apis::ComputeAlpha::BackendServiceCdnPolicyNegativeCachingPolicy, decorator: Google::Apis::ComputeAlpha::BackendServiceCdnPolicyNegativeCachingPolicy::Representation
+      
           property :request_coalescing, as: 'requestCoalescing'
           property :signed_url_cache_max_age_sec, :numeric_string => true, as: 'signedUrlCacheMaxAgeSec'
           collection :signed_url_key_names, as: 'signedUrlKeyNames'
         end
       end
       
+      class BackendServiceCdnPolicyNegativeCachingPolicy
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :code, as: 'code'
+          property :ttl, as: 'ttl'
+        end
+      end
+      
       class BackendServiceFailoverPolicy
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -13203,7 +13246,6 @@ module Google
           property :automatic_restart, as: 'automaticRestart'
           property :latency_tolerant, as: 'latencyTolerant'
           property :location_hint, as: 'locationHint'
-          property :long_term_release, as: 'longTermRelease'
           property :maintenance_freeze_duration_hours, as: 'maintenanceFreezeDurationHours'
           property :min_node_cpus, as: 'minNodeCpus'
           collection :node_affinities, as: 'nodeAffinities', class: Google::Apis::ComputeAlpha::SchedulingNodeAffinity, decorator: Google::Apis::ComputeAlpha::SchedulingNodeAffinity::Representation

generated/google/apis/compute_beta.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/compute/docs/reference/latest/
     module ComputeBeta
       VERSION = 'Beta'
-      REVISION = '20200704'
+      REVISION = '20200719'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/compute_beta/classes.rb

@@ -2549,6 +2549,11 @@ module Google
         # @return [String]
         attr_accessor :creation_timestamp
       
+        # Headers that the HTTP/S load balancer should add to proxied responses.
+        # Corresponds to the JSON property `customResponseHeaders`
+        # @return [Array<String>]
+        attr_accessor :custom_response_headers
+      
         # An optional textual description of the resource; provided by the client when
         # the resource is created.
         # Corresponds to the JSON property `description`
@@ -2595,6 +2600,7 @@ module Google
           @bucket_name = args[:bucket_name] if args.key?(:bucket_name)
           @cdn_policy = args[:cdn_policy] if args.key?(:cdn_policy)
           @creation_timestamp = args[:creation_timestamp] if args.key?(:creation_timestamp)
+          @custom_response_headers = args[:custom_response_headers] if args.key?(:custom_response_headers)
           @description = args[:description] if args.key?(:description)
           @enable_cdn = args[:enable_cdn] if args.key?(:enable_cdn)
           @id = args[:id] if args.key?(:id)
@@ -2608,6 +2614,66 @@ module Google
       class BackendBucketCdnPolicy
         include Google::Apis::Core::Hashable
       
+        # 
+        # Corresponds to the JSON property `cacheMode`
+        # @return [String]
+        attr_accessor :cache_mode
+      
+        # Specifies a separate client (e.g. browser client) TTL, separate from the TTL
+        # for Cloud CDN?s edge caches. Leaving this empty will use the same cache TTL
+        # for both Cloud CDN and the client-facing response. The maximum allowed value
+        # is 86400s (1 day).
+        # Corresponds to the JSON property `clientTtl`
+        # @return [Fixnum]
+        attr_accessor :client_ttl
+      
+        # Specifies the default TTL for cached content served by this origin for
+        # responses that do not have an existing valid TTL (max-age or s-max-age).
+        # Setting a TTL of ?0? means ?always revalidate? and a value of ?-1? disables
+        # caching for that status code. The value of defaultTTL cannot be set to a value
+        # greater than that of maxTTL, but can be equal. When the cacheMode is set to
+        # FORCE_CACHE_ALL, the defaultTTL will overwrite the TTL set in all responses.
+        # The maximum allowed value is 31,622,400s (1 year), noting that infrequently
+        # accessed objects may be evicted from the cache before the defined TTL.
+        # Corresponds to the JSON property `defaultTtl`
+        # @return [Fixnum]
+        attr_accessor :default_ttl
+      
+        # Specifies the maximum allowed TTL for cached content served by this origin.
+        # Cache directives that attempt to set a max-age or s-maxage higher than this,
+        # or an Expires header more than maxTTL seconds in the future will be capped at
+        # the value of maxTTL, as if it were the value of an s-maxage Cache-Control
+        # directive. Setting a TTL of ?0? means ?always revalidate? and a value of ?-1?
+        # disables caching for that status code. The maximum allowed value is 31,622,
+        # 400s (1 year), noting that infrequently accessed objects may be evicted from
+        # the cache before the defined TTL.
+        # Corresponds to the JSON property `maxTtl`
+        # @return [Fixnum]
+        attr_accessor :max_ttl
+      
+        # Negative caching allows per-status code TTLs to be set, in order to apply fine-
+        # grained caching for common errors or redirects. This can reduce the load on
+        # your origin and improve end-user experience by reducing response latency. By
+        # default, Cloud CDN will apply the following default TTLs to these status codes:
+        # HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m HTTP 404 (Not
+        # Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s HTTP 405 (Method
+        # Not Found), 414 (URI Too Long), 501 (Not Implemented): 60s These defaults can
+        # be overridden in negative_caching_policy
+        # Corresponds to the JSON property `negativeCaching`
+        # @return [Boolean]
+        attr_accessor :negative_caching
+        alias_method :negative_caching?, :negative_caching
+      
+        # Sets a cache TTL for the specified HTTP status code. negative_caching must be
+        # enabled to configure negative_caching_policy. Omitting the policy and leaving
+        # negative_caching enabled will use Cloud CDN?s default cache TTLs. Note that
+        # when specifying an explicit negative_caching_policy, you should take care to
+        # specify a cache TTL for all response codes that you wish to cache. Cloud CDN
+        # will not apply any default negative caching when a policy exists.
+        # Corresponds to the JSON property `negativeCachingPolicys`
+        # @return [Array<Google::Apis::ComputeBeta::BackendBucketCdnPolicyNegativeCachingPolicy>]
+        attr_accessor :negative_caching_policys
+      
         # Maximum number of seconds the response to a signed URL request will be
         # considered fresh. After this time period, the response will be revalidated
         # before being served. Defaults to 1hr (3600s). When serving responses to signed
@@ -2630,11 +2696,48 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @cache_mode = args[:cache_mode] if args.key?(:cache_mode)
+          @client_ttl = args[:client_ttl] if args.key?(:client_ttl)
+          @default_ttl = args[:default_ttl] if args.key?(:default_ttl)
+          @max_ttl = args[:max_ttl] if args.key?(:max_ttl)
+          @negative_caching = args[:negative_caching] if args.key?(:negative_caching)
+          @negative_caching_policys = args[:negative_caching_policys] if args.key?(:negative_caching_policys)
           @signed_url_cache_max_age_sec = args[:signed_url_cache_max_age_sec] if args.key?(:signed_url_cache_max_age_sec)
           @signed_url_key_names = args[:signed_url_key_names] if args.key?(:signed_url_key_names)
         end
       end
       
+      # Specify CDN TTLs for response error codes.
+      class BackendBucketCdnPolicyNegativeCachingPolicy
+        include Google::Apis::Core::Hashable
+      
+        # The HTTP status code to define a TTL against. Only HTTP status codes 300, 301,
+        # 308, 404, 405, 410, 414, 451 and 501 are can be specified as values, and you
+        # cannot specify a status code more than once.
+        # Corresponds to the JSON property `code`
+        # @return [Fixnum]
+        attr_accessor :code
+      
+        # The TTL (in seconds) to cache responses with the corresponding status code for.
+        # A TTL of ?0? means ?always revalidate? and a value of ?-1? disables caching
+        # for that status code. The maximum allowed value is 1800s (30 minutes), noting
+        # that infrequently accessed objects may be evicted from the cache before the
+        # defined TTL.
+        # Corresponds to the JSON property `ttl`
+        # @return [Fixnum]
+        attr_accessor :ttl
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @code = args[:code] if args.key?(:code)
+          @ttl = args[:ttl] if args.key?(:ttl)
+        end
+      end
+      
       # Contains a list of BackendBucket resources.
       class BackendBucketList
         include Google::Apis::Core::Hashable
@@ -2809,6 +2912,11 @@ module Google
         # @return [Array<String>]
         attr_accessor :custom_request_headers
       
+        # Headers that the HTTP/S load balancer should add to proxied responses.
+        # Corresponds to the JSON property `customResponseHeaders`
+        # @return [Array<String>]
+        attr_accessor :custom_response_headers
+      
         # An optional description of this resource. Provide this property when you
         # create the resource.
         # Corresponds to the JSON property `description`
@@ -2848,10 +2956,10 @@ module Google
         # The list of URLs to the healthChecks, httpHealthChecks (legacy), or
         # httpsHealthChecks (legacy) resource for health checking this backend service.
         # Not all backend services support legacy health checks. See  Load balancer
-        # guide. Currently at most one health check can be specified. Backend services
+        # guide. Currently, at most one health check can be specified for each backend
-        # with instance group or zonal NEG backends must have a health check. Backend
+        # service. Backend services with instance group or zonal NEG backends must have
-        # services with internet NEG backends must not have a health check. A health
+        # a health check. Backend services with internet or serverless NEG backends must
-        # check must
+        # not have a health check.
         # Corresponds to the JSON property `healthChecks`
         # @return [Array<String>]
         attr_accessor :health_checks
@@ -2960,8 +3068,8 @@ module Google
         attr_accessor :port_name
       
         # The protocol this BackendService uses to communicate with backends.
-        # Possible values are HTTP, HTTPS, HTTP2, TCP, SSL, or UDP. depending on the
+        # Possible values are HTTP, HTTPS, HTTP2, TCP, SSL, UDP or GRPC. depending on
-        # chosen load balancer or Traffic Director configuration. Refer to the
+        # the chosen load balancer or Traffic Director configuration. Refer to the
         # documentation for the load balancer or for Traffic Director for more
         # information.
         # Corresponds to the JSON property `protocol`
@@ -3027,6 +3135,7 @@ module Google
           @consistent_hash = args[:consistent_hash] if args.key?(:consistent_hash)
           @creation_timestamp = args[:creation_timestamp] if args.key?(:creation_timestamp)
           @custom_request_headers = args[:custom_request_headers] if args.key?(:custom_request_headers)
+          @custom_response_headers = args[:custom_response_headers] if args.key?(:custom_response_headers)
           @description = args[:description] if args.key?(:description)
           @enable_cdn = args[:enable_cdn] if args.key?(:enable_cdn)
           @failover_policy = args[:failover_policy] if args.key?(:failover_policy)
@@ -3180,6 +3289,66 @@ module Google
         # @return [Google::Apis::ComputeBeta::CacheKeyPolicy]
         attr_accessor :cache_key_policy
       
+        # 
+        # Corresponds to the JSON property `cacheMode`
+        # @return [String]
+        attr_accessor :cache_mode
+      
+        # Specifies a separate client (e.g. browser client) TTL, separate from the TTL
+        # for Cloud CDN?s edge caches. Leaving this empty will use the same cache TTL
+        # for both Cloud CDN and the client-facing response. The maximum allowed value
+        # is 86400s (1 day).
+        # Corresponds to the JSON property `clientTtl`
+        # @return [Fixnum]
+        attr_accessor :client_ttl
+      
+        # Specifies the default TTL for cached content served by this origin for
+        # responses that do not have an existing valid TTL (max-age or s-max-age).
+        # Setting a TTL of ?0? means ?always revalidate? and a value of ?-1? disables
+        # caching for that status code. The value of defaultTTL cannot be set to a value
+        # greater than that of maxTTL, but can be equal. When the cacheMode is set to
+        # FORCE_CACHE_ALL, the defaultTTL will overwrite the TTL set in all responses.
+        # The maximum allowed value is 31,622,400s (1 year), noting that infrequently
+        # accessed objects may be evicted from the cache before the defined TTL.
+        # Corresponds to the JSON property `defaultTtl`
+        # @return [Fixnum]
+        attr_accessor :default_ttl
+      
+        # Specifies the maximum allowed TTL for cached content served by this origin.
+        # Cache directives that attempt to set a max-age or s-maxage higher than this,
+        # or an Expires header more than maxTTL seconds in the future will be capped at
+        # the value of maxTTL, as if it were the value of an s-maxage Cache-Control
+        # directive. Setting a TTL of ?0? means ?always revalidate? and a value of ?-1?
+        # disables caching for that status code. The maximum allowed value is 31,622,
+        # 400s (1 year), noting that infrequently accessed objects may be evicted from
+        # the cache before the defined TTL.
+        # Corresponds to the JSON property `maxTtl`
+        # @return [Fixnum]
+        attr_accessor :max_ttl
+      
+        # Negative caching allows per-status code TTLs to be set, in order to apply fine-
+        # grained caching for common errors or redirects. This can reduce the load on
+        # your origin and improve end-user experience by reducing response latency. By
+        # default, Cloud CDN will apply the following default TTLs to these status codes:
+        # HTTP 300 (Multiple Choice), 301, 308 (Permanent Redirects): 10m HTTP 404 (Not
+        # Found), 410 (Gone), 451 (Unavailable For Legal Reasons): 120s HTTP 405 (Method
+        # Not Found), 414 (URI Too Long), 501 (Not Implemented): 60s These defaults can
+        # be overridden in negative_caching_policy
+        # Corresponds to the JSON property `negativeCaching`
+        # @return [Boolean]
+        attr_accessor :negative_caching
+        alias_method :negative_caching?, :negative_caching
+      
+        # Sets a cache TTL for the specified HTTP status code. negative_caching must be
+        # enabled to configure negative_caching_policy. Omitting the policy and leaving
+        # negative_caching enabled will use Cloud CDN?s default cache TTLs. Note that
+        # when specifying an explicit negative_caching_policy, you should take care to
+        # specify a cache TTL for all response codes that you wish to cache. Cloud CDN
+        # will not apply any default negative caching when a policy exists.
+        # Corresponds to the JSON property `negativeCachingPolicys`
+        # @return [Array<Google::Apis::ComputeBeta::BackendServiceCdnPolicyNegativeCachingPolicy>]
+        attr_accessor :negative_caching_policys
+      
         # Maximum number of seconds the response to a signed URL request will be
         # considered fresh. After this time period, the response will be revalidated
         # before being served. Defaults to 1hr (3600s). When serving responses to signed
@@ -3203,11 +3372,48 @@ module Google
         # Update properties of this object
         def update!(**args)
           @cache_key_policy = args[:cache_key_policy] if args.key?(:cache_key_policy)
+          @cache_mode = args[:cache_mode] if args.key?(:cache_mode)
+          @client_ttl = args[:client_ttl] if args.key?(:client_ttl)
+          @default_ttl = args[:default_ttl] if args.key?(:default_ttl)
+          @max_ttl = args[:max_ttl] if args.key?(:max_ttl)
+          @negative_caching = args[:negative_caching] if args.key?(:negative_caching)
+          @negative_caching_policys = args[:negative_caching_policys] if args.key?(:negative_caching_policys)
           @signed_url_cache_max_age_sec = args[:signed_url_cache_max_age_sec] if args.key?(:signed_url_cache_max_age_sec)
           @signed_url_key_names = args[:signed_url_key_names] if args.key?(:signed_url_key_names)
         end
       end
       
+      # Specify CDN TTLs for response error codes.
+      class BackendServiceCdnPolicyNegativeCachingPolicy
+        include Google::Apis::Core::Hashable
+      
+        # The HTTP status code to define a TTL against. Only HTTP status codes 300, 301,
+        # 308, 404, 405, 410, 414, 451 and 501 are can be specified as values, and you
+        # cannot specify a status code more than once.
+        # Corresponds to the JSON property `code`
+        # @return [Fixnum]
+        attr_accessor :code
+      
+        # The TTL (in seconds) to cache responses with the corresponding status code for.
+        # A TTL of ?0? means ?always revalidate? and a value of ?-1? disables caching
+        # for that status code. The maximum allowed value is 1800s (30 minutes), noting
+        # that infrequently accessed objects may be evicted from the cache before the
+        # defined TTL.
+        # Corresponds to the JSON property `ttl`
+        # @return [Fixnum]
+        attr_accessor :ttl
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @code = args[:code] if args.key?(:code)
+          @ttl = args[:ttl] if args.key?(:ttl)
+        end
+      end
+      
       # Applicable only to Failover for Internal TCP/UDP Load Balancing. On failover
       # or failback, this field indicates whether connection draining will be honored.
       # GCP has a fixed connection draining timeout of 10 minutes. A setting of true
@@ -4071,6 +4277,15 @@ module Google
       class Commitment
         include Google::Apis::Core::Hashable
       
+        # The category of the commitment. Category MACHINE specifies commitments
+        # composed of machine resources such as VCPU or MEMORY, listed in resources.
+        # Category LICENSE specifies commitments composed of software licenses, listed
+        # in licenseResources. Note that only MACHINE commitments should have a Type
+        # specified.
+        # Corresponds to the JSON property `category`
+        # @return [String]
+        attr_accessor :category
+      
         # [Output Only] Creation timestamp in RFC3339 text format.
         # Corresponds to the JSON property `creationTimestamp`
         # @return [String]
@@ -4098,6 +4313,11 @@ module Google
         # @return [String]
         attr_accessor :kind
       
+        # Commitment for a particular license resource.
+        # Corresponds to the JSON property `licenseResource`
+        # @return [Google::Apis::ComputeBeta::LicenseResourceCommitment]
+        attr_accessor :license_resource
+      
         # Name of the resource. Provided by the client when the resource is created. The
         # name must be 1-63 characters long, and comply with RFC1035. Specifically, the
         # name must be 1-63 characters long and match the regular expression `[a-z]([-a-
@@ -4167,11 +4387,13 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @category = args[:category] if args.key?(:category)
           @creation_timestamp = args[:creation_timestamp] if args.key?(:creation_timestamp)
           @description = args[:description] if args.key?(:description)
           @end_timestamp = args[:end_timestamp] if args.key?(:end_timestamp)
           @id = args[:id] if args.key?(:id)
           @kind = args[:kind] if args.key?(:kind)
+          @license_resource = args[:license_resource] if args.key?(:license_resource)
           @name = args[:name] if args.key?(:name)
           @plan = args[:plan] if args.key?(:plan)
           @region = args[:region] if args.key?(:region)
@@ -5031,12 +5253,11 @@ module Google
         # @return [String]
         attr_accessor :self_link
       
-        # Size of the persistent disk, specified in GB. You can specify this field when
+        # Size, in GB, of the persistent disk. You can specify this field when creating
-        # creating a persistent disk using the sourceImage or sourceSnapshot parameter,
+        # a persistent disk using the sourceImage, sourceSnapshot, or sourceDisk
-        # or specify it alone to create an empty persistent disk.
+        # parameter, or specify it alone to create an empty persistent disk.
-        # If you specify this field along with sourceImage or sourceSnapshot, the value
+        # If you specify this field along with a source, the value of sizeGb must not be
-        # of sizeGb must not be less than the size of the sourceImage or the size of the
+        # less than the size of the source. Acceptable values are 1 to 65536, inclusive.
-        # snapshot. Acceptable values are 1 to 65536, inclusive.
         # Corresponds to the JSON property `sizeGb`
         # @return [Fixnum]
         attr_accessor :size_gb
@@ -7350,13 +7571,14 @@ module Google
         # that points to a target proxy or a target pool. Do not use with a forwarding
         # rule that points to a backend service. This field is used along with the
         # target field for TargetHttpProxy, TargetHttpsProxy, TargetSslProxy,
-        # TargetTcpProxy, TargetVpnGateway, TargetPool, TargetInstance.
+        # TargetTcpProxy, TargetGrpcProxy, TargetVpnGateway, TargetPool, TargetInstance.
         # Applicable only when IPProtocol is TCP, UDP, or SCTP, only packets addressed
         # to ports in the specified range will be forwarded to target. Forwarding rules
         # with the same [IPAddress, IPProtocol] pair must have disjoint port ranges.
         # Some types of forwarding target have constraints on the acceptable ports:
         # - TargetHttpProxy: 80, 8080
         # - TargetHttpsProxy: 443
+        # - TargetGrpcProxy: Any ports
         # - TargetTcpProxy: 25, 43, 110, 143, 195, 443, 465, 587, 700, 993, 995, 1688,
         # 1883, 5222
         # - TargetSslProxy: 25, 43, 110, 143, 195, 443, 465, 587, 700, 993, 995, 1688,
@@ -7426,8 +7648,8 @@ module Google
         # forwarding rules, this target must live in the same region as the forwarding
         # rule. For global forwarding rules, this target must be a global load balancing
         # resource. The forwarded traffic must be of a type appropriate to the target
-        # object. For INTERNAL_SELF_MANAGED load balancing, only targetHttpProxy is
+        # object. For INTERNAL_SELF_MANAGED load balancing, only targetHttpProxy and
-        # valid, not targetHttpsProxy.
+        # targetGrpcProxy are valid, not targetHttpsProxy.
         # Corresponds to the JSON property `target`
         # @return [String]
         attr_accessor :target
@@ -10031,7 +10253,11 @@ module Google
         # @return [Google::Apis::ComputeBeta::HttpHeaderAction]
         attr_accessor :header_action
       
-        # 
+        # The list of criteria for matching attributes of a request to this routeRule.
+        # This list has OR semantics: the request matches this routeRule when any of the
+        # matchRules are satisfied. However predicates within a given matchRule have AND
+        # semantics. All predicates within a matchRule must match for the request to
+        # match the rule.
         # Corresponds to the JSON property `matchRules`
         # @return [Array<Google::Apis::ComputeBeta::HttpRouteRuleMatch>]
         attr_accessor :match_rules
@@ -10059,6 +10285,8 @@ module Google
         # routeAction cannot contain any  weightedBackendServices.
         # Only one of urlRedirect, service or routeAction.weightedBackendService must be
         # set.
+        # UrlMaps for external HTTP(S) load balancers support only the urlRewrite action
+        # within a routeRule's routeAction.
         # Corresponds to the JSON property `routeAction`
         # @return [Google::Apis::ComputeBeta::HttpRouteAction]
         attr_accessor :route_action
@@ -16227,6 +16455,37 @@ module Google
         end
       end
       
+      # Commitment for a particular license resource.
+      class LicenseResourceCommitment
+        include Google::Apis::Core::Hashable
+      
+        # The number of licenses purchased.
+        # Corresponds to the JSON property `amount`
+        # @return [Fixnum]
+        attr_accessor :amount
+      
+        # Specifies the core range of the instance for which this license applies.
+        # Corresponds to the JSON property `coresPerLicense`
+        # @return [String]
+        attr_accessor :cores_per_license
+      
+        # Any applicable license URI.
+        # Corresponds to the JSON property `license`
+        # @return [String]
+        attr_accessor :license
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @amount = args[:amount] if args.key?(:amount)
+          @cores_per_license = args[:cores_per_license] if args.key?(:cores_per_license)
+          @license = args[:license] if args.key?(:license)
+        end
+      end
+      
       # 
       class LicenseResourceRequirements
         include Google::Apis::Core::Hashable
@@ -17774,10 +18033,11 @@ module Google
       # Represents a collection of network endpoints.
       # A network endpoint group (NEG) defines how a set of endpoints should be
       # reached, whether they are reachable, and where they are located. For more
-      # information about using NEGs, see  Setting up internet NEGs or  Setting up
+      # information about using NEGs, see  Setting up internet NEGs,  Setting up zonal
-      # zonal NEGs. (== resource_for `$api_version`.networkEndpointGroups ==) (==
+      # NEGs, or  Setting up serverless NEGs. (== resource_for `$api_version`.
-      # resource_for `$api_version`.globalNetworkEndpointGroups ==) (== resource_for `$
+      # networkEndpointGroups ==) (== resource_for `$api_version`.
-      # api_version`.regionNetworkEndpointGroups ==)
+      # globalNetworkEndpointGroups ==) (== resource_for `$api_version`.
+      # regionNetworkEndpointGroups ==)
       class NetworkEndpointGroup
         include Google::Apis::Core::Hashable
       
@@ -17863,7 +18123,9 @@ module Google
         # @return [String]
         attr_accessor :network
       
-        # Type of network endpoints in this network endpoint group.
+        # Type of network endpoints in this network endpoint group. Can be one of
+        # GCE_VM_IP_PORT, NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT, INTERNET_IP_PORT,
+        # or SERVERLESS.
         # Corresponds to the JSON property `networkEndpointType`
         # @return [String]
         attr_accessor :network_endpoint_type
@@ -32440,7 +32702,7 @@ module Google
       
         # The URL of the HttpHealthCheck resource. A member instance in this pool is
         # considered healthy if and only if the health checks pass. An empty list means
-        # all member instances will be considered healthy at all times. Only
+        # all member instances will be considered healthy at all times. Only legacy
         # HttpHealthChecks are supported. Only one health check may be specified.
         # Corresponds to the JSON property `healthChecks`
         # @return [Array<String>]

generated/google/apis/compute_beta/representations.rb

@@ -328,6 +328,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class BackendBucketCdnPolicyNegativeCachingPolicy
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class BackendBucketList
         class Representation < Google::Apis::Core::JsonRepresentation; end
         
@@ -376,6 +382,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class BackendServiceCdnPolicyNegativeCachingPolicy
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class BackendServiceFailoverPolicy
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -2026,6 +2038,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class LicenseResourceCommitment
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class LicenseResourceRequirements
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -5539,6 +5557,7 @@ module Google
           property :cdn_policy, as: 'cdnPolicy', class: Google::Apis::ComputeBeta::BackendBucketCdnPolicy, decorator: Google::Apis::ComputeBeta::BackendBucketCdnPolicy::Representation
       
           property :creation_timestamp, as: 'creationTimestamp'
+          collection :custom_response_headers, as: 'customResponseHeaders'
           property :description, as: 'description'
           property :enable_cdn, as: 'enableCdn'
           property :id, :numeric_string => true, as: 'id'
@@ -5551,11 +5570,26 @@ module Google
       class BackendBucketCdnPolicy
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :cache_mode, as: 'cacheMode'
+          property :client_ttl, as: 'clientTtl'
+          property :default_ttl, as: 'defaultTtl'
+          property :max_ttl, as: 'maxTtl'
+          property :negative_caching, as: 'negativeCaching'
+          collection :negative_caching_policys, as: 'negativeCachingPolicys', class: Google::Apis::ComputeBeta::BackendBucketCdnPolicyNegativeCachingPolicy, decorator: Google::Apis::ComputeBeta::BackendBucketCdnPolicyNegativeCachingPolicy::Representation
+      
           property :signed_url_cache_max_age_sec, :numeric_string => true, as: 'signedUrlCacheMaxAgeSec'
           collection :signed_url_key_names, as: 'signedUrlKeyNames'
         end
       end
       
+      class BackendBucketCdnPolicyNegativeCachingPolicy
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :code, as: 'code'
+          property :ttl, as: 'ttl'
+        end
+      end
+      
       class BackendBucketList
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -5604,6 +5638,7 @@ module Google
       
           property :creation_timestamp, as: 'creationTimestamp'
           collection :custom_request_headers, as: 'customRequestHeaders'
+          collection :custom_response_headers, as: 'customResponseHeaders'
           property :description, as: 'description'
           property :enable_cdn, as: 'enableCDN'
           property :failover_policy, as: 'failoverPolicy', class: Google::Apis::ComputeBeta::BackendServiceFailoverPolicy, decorator: Google::Apis::ComputeBeta::BackendServiceFailoverPolicy::Representation
@@ -5672,11 +5707,26 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           property :cache_key_policy, as: 'cacheKeyPolicy', class: Google::Apis::ComputeBeta::CacheKeyPolicy, decorator: Google::Apis::ComputeBeta::CacheKeyPolicy::Representation
       
+          property :cache_mode, as: 'cacheMode'
+          property :client_ttl, as: 'clientTtl'
+          property :default_ttl, as: 'defaultTtl'
+          property :max_ttl, as: 'maxTtl'
+          property :negative_caching, as: 'negativeCaching'
+          collection :negative_caching_policys, as: 'negativeCachingPolicys', class: Google::Apis::ComputeBeta::BackendServiceCdnPolicyNegativeCachingPolicy, decorator: Google::Apis::ComputeBeta::BackendServiceCdnPolicyNegativeCachingPolicy::Representation
+      
           property :signed_url_cache_max_age_sec, :numeric_string => true, as: 'signedUrlCacheMaxAgeSec'
           collection :signed_url_key_names, as: 'signedUrlKeyNames'
         end
       end
       
+      class BackendServiceCdnPolicyNegativeCachingPolicy
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :code, as: 'code'
+          property :ttl, as: 'ttl'
+        end
+      end
+      
       class BackendServiceFailoverPolicy
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -5878,11 +5928,14 @@ module Google
       class Commitment
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :category, as: 'category'
           property :creation_timestamp, as: 'creationTimestamp'
           property :description, as: 'description'
           property :end_timestamp, as: 'endTimestamp'
           property :id, :numeric_string => true, as: 'id'
           property :kind, as: 'kind'
+          property :license_resource, as: 'licenseResource', class: Google::Apis::ComputeBeta::LicenseResourceCommitment, decorator: Google::Apis::ComputeBeta::LicenseResourceCommitment::Representation
+      
           property :name, as: 'name'
           property :plan, as: 'plan'
           property :region, as: 'region'
@@ -8799,6 +8852,15 @@ module Google
         end
       end
       
+      class LicenseResourceCommitment
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :amount, :numeric_string => true, as: 'amount'
+          property :cores_per_license, as: 'coresPerLicense'
+          property :license, as: 'license'
+        end
+      end
+      
       class LicenseResourceRequirements
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

generated/google/apis/compute_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/compute/docs/reference/latest/
     module ComputeV1
       VERSION = 'V1'
-      REVISION = '20200704'
+      REVISION = '20200719'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/compute_v1/representations.rb

@@ -1390,6 +1390,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class InstanceGroupManagerStatusStateful
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class InstanceGroupManagerStatusStatefulPerInstanceConfigs
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class InstanceGroupManagerStatusVersionTarget
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1432,6 +1444,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class InstanceGroupManagersDeletePerInstanceConfigsReq
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class InstanceGroupManagersListErrorsResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1444,6 +1462,30 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class InstanceGroupManagersListPerInstanceConfigsResp
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+        
+        class Warning
+          class Representation < Google::Apis::Core::JsonRepresentation; end
+          
+          class Datum
+            class Representation < Google::Apis::Core::JsonRepresentation; end
+          
+            include Google::Apis::Core::JsonObjectSupport
+          end
+        
+          include Google::Apis::Core::JsonObjectSupport
+        end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class InstanceGroupManagersPatchPerInstanceConfigsReq
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class InstanceGroupManagersRecreateInstancesRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1480,6 +1522,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class InstanceGroupManagersUpdatePerInstanceConfigsReq
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class InstanceGroupsAddInstancesRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1906,6 +1954,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class LicenseResourceCommitment
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class LicenseResourceRequirements
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -2134,6 +2188,24 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class NetworkEndpointGroupAppEngine
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class NetworkEndpointGroupCloudFunction
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class NetworkEndpointGroupCloudRun
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class NetworkEndpointGroupList
         class Representation < Google::Apis::Core::JsonRepresentation; end
         
@@ -2746,6 +2818,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class PreservedState
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class PreservedStatePreservedDisk
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Project
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -2872,6 +2956,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class RegionInstanceGroupManagerDeleteInstanceConfigReq
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class RegionInstanceGroupManagerList
         class Representation < Google::Apis::Core::JsonRepresentation; end
         
@@ -2890,6 +2980,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class RegionInstanceGroupManagerPatchInstanceConfigReq
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class RegionInstanceGroupManagerUpdateInstanceConfigReq
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class RegionInstanceGroupManagersAbandonInstancesRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -2920,6 +3022,24 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class RegionInstanceGroupManagersListInstanceConfigsResp
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+        
+        class Warning
+          class Representation < Google::Apis::Core::JsonRepresentation; end
+          
+          class Datum
+            class Representation < Google::Apis::Core::JsonRepresentation; end
+          
+            include Google::Apis::Core::JsonObjectSupport
+          end
+        
+          include Google::Apis::Core::JsonObjectSupport
+        end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class RegionInstanceGroupManagersListInstancesResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -3670,6 +3790,24 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class StatefulPolicy
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class StatefulPolicyPreservedState
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class StatefulPolicyPreservedStateDiskDevice
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Subnetwork
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -5450,11 +5588,14 @@ module Google
       class Commitment
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :category, as: 'category'
           property :creation_timestamp, as: 'creationTimestamp'
           property :description, as: 'description'
           property :end_timestamp, as: 'endTimestamp'
           property :id, :numeric_string => true, as: 'id'
           property :kind, as: 'kind'
+          property :license_resource, as: 'licenseResource', class: Google::Apis::ComputeV1::LicenseResourceCommitment, decorator: Google::Apis::ComputeV1::LicenseResourceCommitment::Representation
+      
           property :name, as: 'name'
           property :plan, as: 'plan'
           property :region, as: 'region'
@@ -7177,6 +7318,8 @@ module Google
       
           property :region, as: 'region'
           property :self_link, as: 'selfLink'
+          property :stateful_policy, as: 'statefulPolicy', class: Google::Apis::ComputeV1::StatefulPolicy, decorator: Google::Apis::ComputeV1::StatefulPolicy::Representation
+      
           property :status, as: 'status', class: Google::Apis::ComputeV1::InstanceGroupManagerStatus, decorator: Google::Apis::ComputeV1::InstanceGroupManagerStatus::Representation
       
           collection :target_pools, as: 'targetPools'
@@ -7281,11 +7424,29 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           property :autoscaler, as: 'autoscaler'
           property :is_stable, as: 'isStable'
+          property :stateful, as: 'stateful', class: Google::Apis::ComputeV1::InstanceGroupManagerStatusStateful, decorator: Google::Apis::ComputeV1::InstanceGroupManagerStatusStateful::Representation
+      
           property :version_target, as: 'versionTarget', class: Google::Apis::ComputeV1::InstanceGroupManagerStatusVersionTarget, decorator: Google::Apis::ComputeV1::InstanceGroupManagerStatusVersionTarget::Representation
       
         end
       end
       
+      class InstanceGroupManagerStatusStateful
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :has_stateful_config, as: 'hasStatefulConfig'
+          property :per_instance_configs, as: 'perInstanceConfigs', class: Google::Apis::ComputeV1::InstanceGroupManagerStatusStatefulPerInstanceConfigs, decorator: Google::Apis::ComputeV1::InstanceGroupManagerStatusStatefulPerInstanceConfigs::Representation
+      
+        end
+      end
+      
+      class InstanceGroupManagerStatusStatefulPerInstanceConfigs
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :all_effective, as: 'allEffective'
+        end
+      end
+      
       class InstanceGroupManagerStatusVersionTarget
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -7348,6 +7509,13 @@ module Google
         end
       end
       
+      class InstanceGroupManagersDeletePerInstanceConfigsReq
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :names, as: 'names'
+        end
+      end
+      
       class InstanceGroupManagersListErrorsResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -7366,6 +7534,43 @@ module Google
         end
       end
       
+      class InstanceGroupManagersListPerInstanceConfigsResp
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :items, as: 'items', class: Google::Apis::ComputeV1::PerInstanceConfig, decorator: Google::Apis::ComputeV1::PerInstanceConfig::Representation
+      
+          property :next_page_token, as: 'nextPageToken'
+          property :warning, as: 'warning', class: Google::Apis::ComputeV1::InstanceGroupManagersListPerInstanceConfigsResp::Warning, decorator: Google::Apis::ComputeV1::InstanceGroupManagersListPerInstanceConfigsResp::Warning::Representation
+      
+        end
+        
+        class Warning
+          # @private
+          class Representation < Google::Apis::Core::JsonRepresentation
+            property :code, as: 'code'
+            collection :data, as: 'data', class: Google::Apis::ComputeV1::InstanceGroupManagersListPerInstanceConfigsResp::Warning::Datum, decorator: Google::Apis::ComputeV1::InstanceGroupManagersListPerInstanceConfigsResp::Warning::Datum::Representation
+        
+            property :message, as: 'message'
+          end
+          
+          class Datum
+            # @private
+            class Representation < Google::Apis::Core::JsonRepresentation
+              property :key, as: 'key'
+              property :value, as: 'value'
+            end
+          end
+        end
+      end
+      
+      class InstanceGroupManagersPatchPerInstanceConfigsReq
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :per_instance_configs, as: 'perInstanceConfigs', class: Google::Apis::ComputeV1::PerInstanceConfig, decorator: Google::Apis::ComputeV1::PerInstanceConfig::Representation
+      
+        end
+      end
+      
       class InstanceGroupManagersRecreateInstancesRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -7416,6 +7621,14 @@ module Google
         end
       end
       
+      class InstanceGroupManagersUpdatePerInstanceConfigsReq
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :per_instance_configs, as: 'perInstanceConfigs', class: Google::Apis::ComputeV1::PerInstanceConfig, decorator: Google::Apis::ComputeV1::PerInstanceConfig::Representation
+      
+        end
+      end
+      
       class InstanceGroupsAddInstancesRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -8191,6 +8404,15 @@ module Google
         end
       end
       
+      class LicenseResourceCommitment
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :amount, :numeric_string => true, as: 'amount'
+          property :cores_per_license, as: 'coresPerLicense'
+          property :license, as: 'license'
+        end
+      end
+      
       class LicenseResourceRequirements
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -8419,6 +8641,10 @@ module Google
           property :instance_status, as: 'instanceStatus'
           property :last_attempt, as: 'lastAttempt', class: Google::Apis::ComputeV1::ManagedInstanceLastAttempt, decorator: Google::Apis::ComputeV1::ManagedInstanceLastAttempt::Representation
       
+          property :preserved_state_from_config, as: 'preservedStateFromConfig', class: Google::Apis::ComputeV1::PreservedState, decorator: Google::Apis::ComputeV1::PreservedState::Representation
+      
+          property :preserved_state_from_policy, as: 'preservedStateFromPolicy', class: Google::Apis::ComputeV1::PreservedState, decorator: Google::Apis::ComputeV1::PreservedState::Representation
+      
           property :version, as: 'version', class: Google::Apis::ComputeV1::ManagedInstanceVersion, decorator: Google::Apis::ComputeV1::ManagedInstanceVersion::Representation
       
         end
@@ -8543,6 +8769,12 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           hash :annotations, as: 'annotations'
+          property :app_engine, as: 'appEngine', class: Google::Apis::ComputeV1::NetworkEndpointGroupAppEngine, decorator: Google::Apis::ComputeV1::NetworkEndpointGroupAppEngine::Representation
+      
+          property :cloud_function, as: 'cloudFunction', class: Google::Apis::ComputeV1::NetworkEndpointGroupCloudFunction, decorator: Google::Apis::ComputeV1::NetworkEndpointGroupCloudFunction::Representation
+      
+          property :cloud_run, as: 'cloudRun', class: Google::Apis::ComputeV1::NetworkEndpointGroupCloudRun, decorator: Google::Apis::ComputeV1::NetworkEndpointGroupCloudRun::Representation
+      
           property :creation_timestamp, as: 'creationTimestamp'
           property :default_port, as: 'defaultPort'
           property :description, as: 'description'
@@ -8551,6 +8783,7 @@ module Google
           property :name, as: 'name'
           property :network, as: 'network'
           property :network_endpoint_type, as: 'networkEndpointType'
+          property :region, as: 'region'
           property :self_link, as: 'selfLink'
           property :size, as: 'size'
           property :subnetwork, as: 'subnetwork'
@@ -8590,6 +8823,32 @@ module Google
         end
       end
       
+      class NetworkEndpointGroupAppEngine
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :service, as: 'service'
+          property :url_mask, as: 'urlMask'
+          property :version, as: 'version'
+        end
+      end
+      
+      class NetworkEndpointGroupCloudFunction
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :function, as: 'function'
+          property :url_mask, as: 'urlMask'
+        end
+      end
+      
+      class NetworkEndpointGroupCloudRun
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :service, as: 'service'
+          property :tag, as: 'tag'
+          property :url_mask, as: 'urlMask'
+        end
+      end
+      
       class NetworkEndpointGroupList
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -8908,6 +9167,7 @@ module Google
       class NodeGroupNode
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :cpu_overcommit_type, as: 'cpuOvercommitType'
           collection :instances, as: 'instances'
           property :name, as: 'name'
           property :node_type, as: 'nodeType'
@@ -9002,6 +9262,7 @@ module Google
       class NodeTemplate
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :cpu_overcommit_type, as: 'cpuOvercommitType'
           property :creation_timestamp, as: 'creationTimestamp'
           property :description, as: 'description'
           property :id, :numeric_string => true, as: 'id'
@@ -9670,6 +9931,9 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           property :fingerprint, :base64 => true, as: 'fingerprint'
           property :name, as: 'name'
+          property :preserved_state, as: 'preservedState', class: Google::Apis::ComputeV1::PreservedState, decorator: Google::Apis::ComputeV1::PreservedState::Representation
+      
+          property :status, as: 'status'
         end
       end
       
@@ -9696,6 +9960,24 @@ module Google
         end
       end
       
+      class PreservedState
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          hash :disks, as: 'disks', class: Google::Apis::ComputeV1::PreservedStatePreservedDisk, decorator: Google::Apis::ComputeV1::PreservedStatePreservedDisk::Representation
+      
+          hash :metadata, as: 'metadata'
+        end
+      end
+      
+      class PreservedStatePreservedDisk
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :auto_delete, as: 'autoDelete'
+          property :mode, as: 'mode'
+          property :source, as: 'source'
+        end
+      end
+      
       class Project
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -9913,6 +10195,13 @@ module Google
         end
       end
       
+      class RegionInstanceGroupManagerDeleteInstanceConfigReq
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :names, as: 'names'
+        end
+      end
+      
       class RegionInstanceGroupManagerList
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -9945,6 +10234,22 @@ module Google
         end
       end
       
+      class RegionInstanceGroupManagerPatchInstanceConfigReq
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :per_instance_configs, as: 'perInstanceConfigs', class: Google::Apis::ComputeV1::PerInstanceConfig, decorator: Google::Apis::ComputeV1::PerInstanceConfig::Representation
+      
+        end
+      end
+      
+      class RegionInstanceGroupManagerUpdateInstanceConfigReq
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :per_instance_configs, as: 'perInstanceConfigs', class: Google::Apis::ComputeV1::PerInstanceConfig, decorator: Google::Apis::ComputeV1::PerInstanceConfig::Representation
+      
+        end
+      end
+      
       class RegionInstanceGroupManagersAbandonInstancesRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -9985,6 +10290,35 @@ module Google
         end
       end
       
+      class RegionInstanceGroupManagersListInstanceConfigsResp
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :items, as: 'items', class: Google::Apis::ComputeV1::PerInstanceConfig, decorator: Google::Apis::ComputeV1::PerInstanceConfig::Representation
+      
+          property :next_page_token, as: 'nextPageToken'
+          property :warning, as: 'warning', class: Google::Apis::ComputeV1::RegionInstanceGroupManagersListInstanceConfigsResp::Warning, decorator: Google::Apis::ComputeV1::RegionInstanceGroupManagersListInstanceConfigsResp::Warning::Representation
+      
+        end
+        
+        class Warning
+          # @private
+          class Representation < Google::Apis::Core::JsonRepresentation
+            property :code, as: 'code'
+            collection :data, as: 'data', class: Google::Apis::ComputeV1::RegionInstanceGroupManagersListInstanceConfigsResp::Warning::Datum, decorator: Google::Apis::ComputeV1::RegionInstanceGroupManagersListInstanceConfigsResp::Warning::Datum::Representation
+        
+            property :message, as: 'message'
+          end
+          
+          class Datum
+            # @private
+            class Representation < Google::Apis::Core::JsonRepresentation
+              property :key, as: 'key'
+              property :value, as: 'value'
+            end
+          end
+        end
+      end
+      
       class RegionInstanceGroupManagersListInstancesResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -10844,6 +11178,7 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :automatic_restart, as: 'automaticRestart'
+          property :min_node_cpus, as: 'minNodeCpus'
           collection :node_affinities, as: 'nodeAffinities', class: Google::Apis::ComputeV1::SchedulingNodeAffinity, decorator: Google::Apis::ComputeV1::SchedulingNodeAffinity::Representation
       
           property :on_host_maintenance, as: 'onHostMaintenance'
@@ -11312,6 +11647,29 @@ module Google
         end
       end
       
+      class StatefulPolicy
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :preserved_state, as: 'preservedState', class: Google::Apis::ComputeV1::StatefulPolicyPreservedState, decorator: Google::Apis::ComputeV1::StatefulPolicyPreservedState::Representation
+      
+        end
+      end
+      
+      class StatefulPolicyPreservedState
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          hash :disks, as: 'disks', class: Google::Apis::ComputeV1::StatefulPolicyPreservedStateDiskDevice, decorator: Google::Apis::ComputeV1::StatefulPolicyPreservedStateDiskDevice::Representation
+      
+        end
+      end
+      
+      class StatefulPolicyPreservedStateDiskDevice
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :auto_delete, as: 'autoDelete'
+        end
+      end
+      
       class Subnetwork
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

generated/google/apis/compute_v1/service.rb

@@ -2473,9 +2473,10 @@ module Google
         end
         
         # Creates a persistent disk in the specified project using the data in the
-        # request. You can create a disk with a sourceImage, a sourceSnapshot, or create
+        # request. You can create a disk from a source (sourceImage, sourceSnapshot, or
-        # an empty 500 GB data disk by omitting all properties. You can also create a
+        # sourceDisk) or create an empty 500 GB data disk by omitting all properties.
-        # disk that is larger than the default size by specifying the sizeGb property.
+        # You can also create a disk that is larger than the default size by specifying
+        # the sizeGb property.
         # @param [String] project
         #   Project ID for this request.
         # @param [String] zone
@@ -6859,6 +6860,49 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Deletes selected per-instance configs for the managed instance group.
+        # @param [String] project
+        #   Project ID for this request.
+        # @param [String] zone
+        #   The name of the zone where the managed instance group is located. It should
+        #   conform to RFC1035.
+        # @param [String] instance_group_manager
+        #   The name of the managed instance group. It should conform to RFC1035.
+        # @param [Google::Apis::ComputeV1::InstanceGroupManagersDeletePerInstanceConfigsReq] instance_group_managers_delete_per_instance_configs_req_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
+        # @param [String] user_ip
+        #   Deprecated. Please use quotaUser instead.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ComputeV1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ComputeV1::Operation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def delete_instance_group_manager_per_instance_configs(project, zone, instance_group_manager, instance_group_managers_delete_per_instance_configs_req_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command = make_simple_command(:post, '{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/deletePerInstanceConfigs', options)
+          command.request_representation = Google::Apis::ComputeV1::InstanceGroupManagersDeletePerInstanceConfigsReq::Representation
+          command.request_object = instance_group_managers_delete_per_instance_configs_req_object
+          command.response_representation = Google::Apis::ComputeV1::Operation::Representation
+          command.response_class = Google::Apis::ComputeV1::Operation
+          command.params['project'] = project unless project.nil?
+          command.params['zone'] = zone unless zone.nil?
+          command.params['instanceGroupManager'] = instance_group_manager unless instance_group_manager.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          command.query['userIp'] = user_ip unless user_ip.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Returns all of the details about the specified managed instance group. Gets a
         # list of available managed instance groups by making a list() request.
         # @param [String] project
@@ -7195,6 +7239,85 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Lists all of the per-instance configs defined for the managed instance group.
+        # The orderBy query parameter is not supported.
+        # @param [String] project
+        #   Project ID for this request.
+        # @param [String] zone
+        #   The name of the zone where the managed instance group is located. It should
+        #   conform to RFC1035.
+        # @param [String] instance_group_manager
+        #   The name of the managed instance group. It should conform to RFC1035.
+        # @param [String] filter
+        #   A filter expression that filters resources listed in the response. The
+        #   expression must specify the field name, a comparison operator, and the value
+        #   that you want to use for filtering. The value must be a string, a number, or a
+        #   boolean. The comparison operator must be either `=`, `!=`, `>`, or `<`.
+        #   For example, if you are filtering Compute Engine instances, you can exclude
+        #   instances named `example-instance` by specifying `name != example-instance`.
+        #   You can also filter nested fields. For example, you could specify `scheduling.
+        #   automaticRestart = false` to include instances only if they are not scheduled
+        #   for automatic restarts. You can use filtering on nested fields to filter based
+        #   on resource labels.
+        #   To filter on multiple expressions, provide each separate expression within
+        #   parentheses. For example: ``` (scheduling.automaticRestart = true) (
+        #   cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND`
+        #   expression. However, you can include `AND` and `OR` expressions explicitly.
+        #   For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel
+        #   Broadwell") AND (scheduling.automaticRestart = true) ```
+        # @param [Fixnum] max_results
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than `maxResults`, Compute Engine returns a `
+        #   nextPageToken` that can be used to get the next page of results in subsequent
+        #   list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)
+        # @param [String] order_by
+        #   Sorts list results by a certain order. By default, results are returned in
+        #   alphanumerical order based on the resource name.
+        #   You can also sort results in descending order based on the creation timestamp
+        #   using `orderBy="creationTimestamp desc"`. This sorts results based on the `
+        #   creationTimestamp` field in reverse chronological order (newest result first).
+        #   Use this to sort resources like operations so that the newest operation is
+        #   returned first.
+        #   Currently, only sorting by `name` or `creationTimestamp desc` is supported.
+        # @param [String] page_token
+        #   Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned
+        #   by a previous list request to get the next page of results.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
+        # @param [String] user_ip
+        #   Deprecated. Please use quotaUser instead.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ComputeV1::InstanceGroupManagersListPerInstanceConfigsResp] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ComputeV1::InstanceGroupManagersListPerInstanceConfigsResp]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_instance_group_manager_per_instance_configs(project, zone, instance_group_manager, filter: nil, max_results: nil, order_by: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command = make_simple_command(:post, '{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/listPerInstanceConfigs', options)
+          command.response_representation = Google::Apis::ComputeV1::InstanceGroupManagersListPerInstanceConfigsResp::Representation
+          command.response_class = Google::Apis::ComputeV1::InstanceGroupManagersListPerInstanceConfigsResp
+          command.params['project'] = project unless project.nil?
+          command.params['zone'] = zone unless zone.nil?
+          command.params['instanceGroupManager'] = instance_group_manager unless instance_group_manager.nil?
+          command.query['filter'] = filter unless filter.nil?
+          command.query['maxResults'] = max_results unless max_results.nil?
+          command.query['orderBy'] = order_by unless order_by.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          command.query['userIp'] = user_ip unless user_ip.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Updates a managed instance group using the information that you specify in the
         # request. This operation is marked as DONE when the group is patched even if
         # the instances in the group are still in the process of being patched. You must
@@ -7254,6 +7377,63 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Inserts or patches per-instance configs for the managed instance group.
+        # perInstanceConfig.name serves as a key used to distinguish whether to perform
+        # insert or patch.
+        # @param [String] project
+        #   Project ID for this request.
+        # @param [String] zone
+        #   The name of the zone where the managed instance group is located. It should
+        #   conform to RFC1035.
+        # @param [String] instance_group_manager
+        #   The name of the managed instance group. It should conform to RFC1035.
+        # @param [Google::Apis::ComputeV1::InstanceGroupManagersPatchPerInstanceConfigsReq] instance_group_managers_patch_per_instance_configs_req_object
+        # @param [String] request_id
+        #   An optional request ID to identify requests. Specify a unique request ID so
+        #   that if you must retry your request, the server will know to ignore the
+        #   request if it has already been completed.
+        #   For example, consider a situation where you make an initial request and the
+        #   request times out. If you make the request again with the same request ID, the
+        #   server can check if original operation with the same request ID was received,
+        #   and if so, will ignore the second request. This prevents clients from
+        #   accidentally creating duplicate commitments.
+        #   The request ID must be a valid UUID with the exception that zero UUID is not
+        #   supported (00000000-0000-0000-0000-000000000000).
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
+        # @param [String] user_ip
+        #   Deprecated. Please use quotaUser instead.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ComputeV1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ComputeV1::Operation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def patch_instance_group_manager_per_instance_configs(project, zone, instance_group_manager, instance_group_managers_patch_per_instance_configs_req_object = nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command = make_simple_command(:post, '{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/patchPerInstanceConfigs', options)
+          command.request_representation = Google::Apis::ComputeV1::InstanceGroupManagersPatchPerInstanceConfigsReq::Representation
+          command.request_object = instance_group_managers_patch_per_instance_configs_req_object
+          command.response_representation = Google::Apis::ComputeV1::Operation::Representation
+          command.response_class = Google::Apis::ComputeV1::Operation
+          command.params['project'] = project unless project.nil?
+          command.params['zone'] = zone unless zone.nil?
+          command.params['instanceGroupManager'] = instance_group_manager unless instance_group_manager.nil?
+          command.query['requestId'] = request_id unless request_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          command.query['userIp'] = user_ip unless user_ip.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Flags the specified instances in the managed instance group to be immediately
         # recreated. The instances are deleted and recreated using the current instance
         # template for the managed instance group. This operation is marked as DONE when
@@ -7503,6 +7683,63 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Inserts or updates per-instance configs for the managed instance group.
+        # perInstanceConfig.name serves as a key used to distinguish whether to perform
+        # insert or patch.
+        # @param [String] project
+        #   Project ID for this request.
+        # @param [String] zone
+        #   The name of the zone where the managed instance group is located. It should
+        #   conform to RFC1035.
+        # @param [String] instance_group_manager
+        #   The name of the managed instance group. It should conform to RFC1035.
+        # @param [Google::Apis::ComputeV1::InstanceGroupManagersUpdatePerInstanceConfigsReq] instance_group_managers_update_per_instance_configs_req_object
+        # @param [String] request_id
+        #   An optional request ID to identify requests. Specify a unique request ID so
+        #   that if you must retry your request, the server will know to ignore the
+        #   request if it has already been completed.
+        #   For example, consider a situation where you make an initial request and the
+        #   request times out. If you make the request again with the same request ID, the
+        #   server can check if original operation with the same request ID was received,
+        #   and if so, will ignore the second request. This prevents clients from
+        #   accidentally creating duplicate commitments.
+        #   The request ID must be a valid UUID with the exception that zero UUID is not
+        #   supported (00000000-0000-0000-0000-000000000000).
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
+        # @param [String] user_ip
+        #   Deprecated. Please use quotaUser instead.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ComputeV1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ComputeV1::Operation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def update_instance_group_manager_per_instance_configs(project, zone, instance_group_manager, instance_group_managers_update_per_instance_configs_req_object = nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command = make_simple_command(:post, '{project}/zones/{zone}/instanceGroupManagers/{instanceGroupManager}/updatePerInstanceConfigs', options)
+          command.request_representation = Google::Apis::ComputeV1::InstanceGroupManagersUpdatePerInstanceConfigsReq::Representation
+          command.request_object = instance_group_managers_update_per_instance_configs_req_object
+          command.response_representation = Google::Apis::ComputeV1::Operation::Representation
+          command.response_class = Google::Apis::ComputeV1::Operation
+          command.params['project'] = project unless project.nil?
+          command.params['zone'] = zone unless zone.nil?
+          command.params['instanceGroupManager'] = instance_group_manager unless instance_group_manager.nil?
+          command.query['requestId'] = request_id unless request_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          command.query['userIp'] = user_ip unless user_ip.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Adds a list of instances to the specified instance group. All of the instances
         # in the instance group must be in the same network/subnetwork. Read  Adding
         # instances for more information.
@@ -17930,6 +18167,48 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Deletes selected per-instance configs for the managed instance group.
+        # @param [String] project
+        #   Project ID for this request.
+        # @param [String] region
+        #   Name of the region scoping this request, should conform to RFC1035.
+        # @param [String] instance_group_manager
+        #   The name of the managed instance group. It should conform to RFC1035.
+        # @param [Google::Apis::ComputeV1::RegionInstanceGroupManagerDeleteInstanceConfigReq] region_instance_group_manager_delete_instance_config_req_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
+        # @param [String] user_ip
+        #   Deprecated. Please use quotaUser instead.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ComputeV1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ComputeV1::Operation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def delete_region_instance_group_manager_per_instance_configs(project, region, instance_group_manager, region_instance_group_manager_delete_instance_config_req_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command = make_simple_command(:post, '{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/deletePerInstanceConfigs', options)
+          command.request_representation = Google::Apis::ComputeV1::RegionInstanceGroupManagerDeleteInstanceConfigReq::Representation
+          command.request_object = region_instance_group_manager_delete_instance_config_req_object
+          command.response_representation = Google::Apis::ComputeV1::Operation::Representation
+          command.response_class = Google::Apis::ComputeV1::Operation
+          command.params['project'] = project unless project.nil?
+          command.params['region'] = region unless region.nil?
+          command.params['instanceGroupManager'] = instance_group_manager unless instance_group_manager.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          command.query['userIp'] = user_ip unless user_ip.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Returns all of the details about the specified managed instance group.
         # @param [String] project
         #   Project ID for this request.
@@ -18260,6 +18539,84 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Lists all of the per-instance configs defined for the managed instance group.
+        # The orderBy query parameter is not supported.
+        # @param [String] project
+        #   Project ID for this request.
+        # @param [String] region
+        #   Name of the region scoping this request, should conform to RFC1035.
+        # @param [String] instance_group_manager
+        #   The name of the managed instance group. It should conform to RFC1035.
+        # @param [String] filter
+        #   A filter expression that filters resources listed in the response. The
+        #   expression must specify the field name, a comparison operator, and the value
+        #   that you want to use for filtering. The value must be a string, a number, or a
+        #   boolean. The comparison operator must be either `=`, `!=`, `>`, or `<`.
+        #   For example, if you are filtering Compute Engine instances, you can exclude
+        #   instances named `example-instance` by specifying `name != example-instance`.
+        #   You can also filter nested fields. For example, you could specify `scheduling.
+        #   automaticRestart = false` to include instances only if they are not scheduled
+        #   for automatic restarts. You can use filtering on nested fields to filter based
+        #   on resource labels.
+        #   To filter on multiple expressions, provide each separate expression within
+        #   parentheses. For example: ``` (scheduling.automaticRestart = true) (
+        #   cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND`
+        #   expression. However, you can include `AND` and `OR` expressions explicitly.
+        #   For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel
+        #   Broadwell") AND (scheduling.automaticRestart = true) ```
+        # @param [Fixnum] max_results
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than `maxResults`, Compute Engine returns a `
+        #   nextPageToken` that can be used to get the next page of results in subsequent
+        #   list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)
+        # @param [String] order_by
+        #   Sorts list results by a certain order. By default, results are returned in
+        #   alphanumerical order based on the resource name.
+        #   You can also sort results in descending order based on the creation timestamp
+        #   using `orderBy="creationTimestamp desc"`. This sorts results based on the `
+        #   creationTimestamp` field in reverse chronological order (newest result first).
+        #   Use this to sort resources like operations so that the newest operation is
+        #   returned first.
+        #   Currently, only sorting by `name` or `creationTimestamp desc` is supported.
+        # @param [String] page_token
+        #   Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned
+        #   by a previous list request to get the next page of results.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
+        # @param [String] user_ip
+        #   Deprecated. Please use quotaUser instead.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ComputeV1::RegionInstanceGroupManagersListInstanceConfigsResp] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ComputeV1::RegionInstanceGroupManagersListInstanceConfigsResp]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_region_instance_group_manager_per_instance_configs(project, region, instance_group_manager, filter: nil, max_results: nil, order_by: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command = make_simple_command(:post, '{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/listPerInstanceConfigs', options)
+          command.response_representation = Google::Apis::ComputeV1::RegionInstanceGroupManagersListInstanceConfigsResp::Representation
+          command.response_class = Google::Apis::ComputeV1::RegionInstanceGroupManagersListInstanceConfigsResp
+          command.params['project'] = project unless project.nil?
+          command.params['region'] = region unless region.nil?
+          command.params['instanceGroupManager'] = instance_group_manager unless instance_group_manager.nil?
+          command.query['filter'] = filter unless filter.nil?
+          command.query['maxResults'] = max_results unless max_results.nil?
+          command.query['orderBy'] = order_by unless order_by.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          command.query['userIp'] = user_ip unless user_ip.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Updates a managed instance group using the information that you specify in the
         # request. This operation is marked as DONE when the group is patched even if
         # the instances in the group are still in the process of being patched. You must
@@ -18319,6 +18676,62 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Insert or patch (for the ones that already exist) per-instance configs for the
+        # managed instance group. perInstanceConfig.instance serves as a key used to
+        # distinguish whether to perform insert or patch.
+        # @param [String] project
+        #   Project ID for this request.
+        # @param [String] region
+        #   Name of the region scoping this request, should conform to RFC1035.
+        # @param [String] instance_group_manager
+        #   The name of the managed instance group. It should conform to RFC1035.
+        # @param [Google::Apis::ComputeV1::RegionInstanceGroupManagerPatchInstanceConfigReq] region_instance_group_manager_patch_instance_config_req_object
+        # @param [String] request_id
+        #   An optional request ID to identify requests. Specify a unique request ID so
+        #   that if you must retry your request, the server will know to ignore the
+        #   request if it has already been completed.
+        #   For example, consider a situation where you make an initial request and the
+        #   request times out. If you make the request again with the same request ID, the
+        #   server can check if original operation with the same request ID was received,
+        #   and if so, will ignore the second request. This prevents clients from
+        #   accidentally creating duplicate commitments.
+        #   The request ID must be a valid UUID with the exception that zero UUID is not
+        #   supported (00000000-0000-0000-0000-000000000000).
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
+        # @param [String] user_ip
+        #   Deprecated. Please use quotaUser instead.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ComputeV1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ComputeV1::Operation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def patch_region_instance_group_manager_per_instance_configs(project, region, instance_group_manager, region_instance_group_manager_patch_instance_config_req_object = nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command = make_simple_command(:post, '{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/patchPerInstanceConfigs', options)
+          command.request_representation = Google::Apis::ComputeV1::RegionInstanceGroupManagerPatchInstanceConfigReq::Representation
+          command.request_object = region_instance_group_manager_patch_instance_config_req_object
+          command.response_representation = Google::Apis::ComputeV1::Operation::Representation
+          command.response_class = Google::Apis::ComputeV1::Operation
+          command.params['project'] = project unless project.nil?
+          command.params['region'] = region unless region.nil?
+          command.params['instanceGroupManager'] = instance_group_manager unless instance_group_manager.nil?
+          command.query['requestId'] = request_id unless request_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          command.query['userIp'] = user_ip unless user_ip.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Flags the specified instances in the managed instance group to be immediately
         # recreated. The instances are deleted and recreated using the current instance
         # template for the managed instance group. This operation is marked as DONE when
@@ -18554,6 +18967,62 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Insert or update (for the ones that already exist) per-instance configs for
+        # the managed instance group. perInstanceConfig.instance serves as a key used to
+        # distinguish whether to perform insert or patch.
+        # @param [String] project
+        #   Project ID for this request.
+        # @param [String] region
+        #   Name of the region scoping this request, should conform to RFC1035.
+        # @param [String] instance_group_manager
+        #   The name of the managed instance group. It should conform to RFC1035.
+        # @param [Google::Apis::ComputeV1::RegionInstanceGroupManagerUpdateInstanceConfigReq] region_instance_group_manager_update_instance_config_req_object
+        # @param [String] request_id
+        #   An optional request ID to identify requests. Specify a unique request ID so
+        #   that if you must retry your request, the server will know to ignore the
+        #   request if it has already been completed.
+        #   For example, consider a situation where you make an initial request and the
+        #   request times out. If you make the request again with the same request ID, the
+        #   server can check if original operation with the same request ID was received,
+        #   and if so, will ignore the second request. This prevents clients from
+        #   accidentally creating duplicate commitments.
+        #   The request ID must be a valid UUID with the exception that zero UUID is not
+        #   supported (00000000-0000-0000-0000-000000000000).
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
+        # @param [String] user_ip
+        #   Deprecated. Please use quotaUser instead.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ComputeV1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ComputeV1::Operation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def update_region_instance_group_manager_per_instance_configs(project, region, instance_group_manager, region_instance_group_manager_update_instance_config_req_object = nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command = make_simple_command(:post, '{project}/regions/{region}/instanceGroupManagers/{instanceGroupManager}/updatePerInstanceConfigs', options)
+          command.request_representation = Google::Apis::ComputeV1::RegionInstanceGroupManagerUpdateInstanceConfigReq::Representation
+          command.request_object = region_instance_group_manager_update_instance_config_req_object
+          command.response_representation = Google::Apis::ComputeV1::Operation::Representation
+          command.response_class = Google::Apis::ComputeV1::Operation
+          command.params['project'] = project unless project.nil?
+          command.params['region'] = region unless region.nil?
+          command.params['instanceGroupManager'] = instance_group_manager unless instance_group_manager.nil?
+          command.query['requestId'] = request_id unless request_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          command.query['userIp'] = user_ip unless user_ip.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Returns the specified instance group resource.
         # @param [String] project
         #   Project ID for this request.
@@ -18805,6 +19274,230 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Deletes the specified network endpoint group. Note that the NEG cannot be
+        # deleted if it is configured as a backend of a backend service.
+        # @param [String] project
+        #   Project ID for this request.
+        # @param [String] region
+        #   The name of the region where the network endpoint group is located. It should
+        #   comply with RFC1035.
+        # @param [String] network_endpoint_group
+        #   The name of the network endpoint group to delete. It should comply with
+        #   RFC1035.
+        # @param [String] request_id
+        #   An optional request ID to identify requests. Specify a unique request ID so
+        #   that if you must retry your request, the server will know to ignore the
+        #   request if it has already been completed.
+        #   For example, consider a situation where you make an initial request and the
+        #   request times out. If you make the request again with the same request ID, the
+        #   server can check if original operation with the same request ID was received,
+        #   and if so, will ignore the second request. This prevents clients from
+        #   accidentally creating duplicate commitments.
+        #   The request ID must be a valid UUID with the exception that zero UUID is not
+        #   supported (00000000-0000-0000-0000-000000000000).
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
+        # @param [String] user_ip
+        #   Deprecated. Please use quotaUser instead.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ComputeV1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ComputeV1::Operation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def delete_region_network_endpoint_group(project, region, network_endpoint_group, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command = make_simple_command(:delete, '{project}/regions/{region}/networkEndpointGroups/{networkEndpointGroup}', options)
+          command.response_representation = Google::Apis::ComputeV1::Operation::Representation
+          command.response_class = Google::Apis::ComputeV1::Operation
+          command.params['project'] = project unless project.nil?
+          command.params['region'] = region unless region.nil?
+          command.params['networkEndpointGroup'] = network_endpoint_group unless network_endpoint_group.nil?
+          command.query['requestId'] = request_id unless request_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          command.query['userIp'] = user_ip unless user_ip.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Returns the specified network endpoint group. Gets a list of available network
+        # endpoint groups by making a list() request.
+        # @param [String] project
+        #   Project ID for this request.
+        # @param [String] region
+        #   The name of the region where the network endpoint group is located. It should
+        #   comply with RFC1035.
+        # @param [String] network_endpoint_group
+        #   The name of the network endpoint group. It should comply with RFC1035.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
+        # @param [String] user_ip
+        #   Deprecated. Please use quotaUser instead.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ComputeV1::NetworkEndpointGroup] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ComputeV1::NetworkEndpointGroup]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_region_network_endpoint_group(project, region, network_endpoint_group, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command = make_simple_command(:get, '{project}/regions/{region}/networkEndpointGroups/{networkEndpointGroup}', options)
+          command.response_representation = Google::Apis::ComputeV1::NetworkEndpointGroup::Representation
+          command.response_class = Google::Apis::ComputeV1::NetworkEndpointGroup
+          command.params['project'] = project unless project.nil?
+          command.params['region'] = region unless region.nil?
+          command.params['networkEndpointGroup'] = network_endpoint_group unless network_endpoint_group.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          command.query['userIp'] = user_ip unless user_ip.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Creates a network endpoint group in the specified project using the parameters
+        # that are included in the request.
+        # @param [String] project
+        #   Project ID for this request.
+        # @param [String] region
+        #   The name of the region where you want to create the network endpoint group. It
+        #   should comply with RFC1035.
+        # @param [Google::Apis::ComputeV1::NetworkEndpointGroup] network_endpoint_group_object
+        # @param [String] request_id
+        #   An optional request ID to identify requests. Specify a unique request ID so
+        #   that if you must retry your request, the server will know to ignore the
+        #   request if it has already been completed.
+        #   For example, consider a situation where you make an initial request and the
+        #   request times out. If you make the request again with the same request ID, the
+        #   server can check if original operation with the same request ID was received,
+        #   and if so, will ignore the second request. This prevents clients from
+        #   accidentally creating duplicate commitments.
+        #   The request ID must be a valid UUID with the exception that zero UUID is not
+        #   supported (00000000-0000-0000-0000-000000000000).
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
+        # @param [String] user_ip
+        #   Deprecated. Please use quotaUser instead.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ComputeV1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ComputeV1::Operation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def insert_region_network_endpoint_group(project, region, network_endpoint_group_object = nil, request_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command = make_simple_command(:post, '{project}/regions/{region}/networkEndpointGroups', options)
+          command.request_representation = Google::Apis::ComputeV1::NetworkEndpointGroup::Representation
+          command.request_object = network_endpoint_group_object
+          command.response_representation = Google::Apis::ComputeV1::Operation::Representation
+          command.response_class = Google::Apis::ComputeV1::Operation
+          command.params['project'] = project unless project.nil?
+          command.params['region'] = region unless region.nil?
+          command.query['requestId'] = request_id unless request_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          command.query['userIp'] = user_ip unless user_ip.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Retrieves the list of regional network endpoint groups available to the
+        # specified project in the given region.
+        # @param [String] project
+        #   Project ID for this request.
+        # @param [String] region
+        #   The name of the region where the network endpoint group is located. It should
+        #   comply with RFC1035.
+        # @param [String] filter
+        #   A filter expression that filters resources listed in the response. The
+        #   expression must specify the field name, a comparison operator, and the value
+        #   that you want to use for filtering. The value must be a string, a number, or a
+        #   boolean. The comparison operator must be either `=`, `!=`, `>`, or `<`.
+        #   For example, if you are filtering Compute Engine instances, you can exclude
+        #   instances named `example-instance` by specifying `name != example-instance`.
+        #   You can also filter nested fields. For example, you could specify `scheduling.
+        #   automaticRestart = false` to include instances only if they are not scheduled
+        #   for automatic restarts. You can use filtering on nested fields to filter based
+        #   on resource labels.
+        #   To filter on multiple expressions, provide each separate expression within
+        #   parentheses. For example: ``` (scheduling.automaticRestart = true) (
+        #   cpuPlatform = "Intel Skylake") ``` By default, each expression is an `AND`
+        #   expression. However, you can include `AND` and `OR` expressions explicitly.
+        #   For example: ``` (cpuPlatform = "Intel Skylake") OR (cpuPlatform = "Intel
+        #   Broadwell") AND (scheduling.automaticRestart = true) ```
+        # @param [Fixnum] max_results
+        #   The maximum number of results per page that should be returned. If the number
+        #   of available results is larger than `maxResults`, Compute Engine returns a `
+        #   nextPageToken` that can be used to get the next page of results in subsequent
+        #   list requests. Acceptable values are `0` to `500`, inclusive. (Default: `500`)
+        # @param [String] order_by
+        #   Sorts list results by a certain order. By default, results are returned in
+        #   alphanumerical order based on the resource name.
+        #   You can also sort results in descending order based on the creation timestamp
+        #   using `orderBy="creationTimestamp desc"`. This sorts results based on the `
+        #   creationTimestamp` field in reverse chronological order (newest result first).
+        #   Use this to sort resources like operations so that the newest operation is
+        #   returned first.
+        #   Currently, only sorting by `name` or `creationTimestamp desc` is supported.
+        # @param [String] page_token
+        #   Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned
+        #   by a previous list request to get the next page of results.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
+        # @param [String] user_ip
+        #   Deprecated. Please use quotaUser instead.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ComputeV1::NetworkEndpointGroupList] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ComputeV1::NetworkEndpointGroupList]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_region_network_endpoint_groups(project, region, filter: nil, max_results: nil, order_by: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command = make_simple_command(:get, '{project}/regions/{region}/networkEndpointGroups', options)
+          command.response_representation = Google::Apis::ComputeV1::NetworkEndpointGroupList::Representation
+          command.response_class = Google::Apis::ComputeV1::NetworkEndpointGroupList
+          command.params['project'] = project unless project.nil?
+          command.params['region'] = region unless region.nil?
+          command.query['filter'] = filter unless filter.nil?
+          command.query['maxResults'] = max_results unless max_results.nil?
+          command.query['orderBy'] = order_by unless order_by.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          command.query['userIp'] = user_ip unless user_ip.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Deletes the specified NotificationEndpoint in the given region
         # @param [String] project
         #   Project ID for this request.

generated/google/apis/containeranalysis_v1alpha1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/container-analysis/api/reference/rest/
     module ContaineranalysisV1alpha1
       VERSION = 'V1alpha1'
-      REVISION = '20200501'
+      REVISION = '20200807'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/containeranalysis_v1alpha1/service.rb

@@ -50,13 +50,11 @@ module Google
         
         # Creates a new `Note`.
         # @param [String] parent
-        #   This field contains the project Id for example:
+        #   This field contains the project Id for example: "projects/`project_id`
-        #   "projects/`project_id`
         # @param [Google::Apis::ContaineranalysisV1alpha1::Note] note_object
         # @param [String] name
-        #   The name of the project.
+        #   The name of the project. Should be of the form "providers/`provider_id`". @
-        #   Should be of the form "providers/`provider_id`".
+        #   Deprecated
-        #   @Deprecated
         # @param [String] note_id
         #   The ID to use for this note.
         # @param [String] fields
@@ -92,8 +90,7 @@ module Google
         
         # Deletes the given `Note` from the system.
         # @param [String] name
-        #   The name of the note in the form of
+        #   The name of the note in the form of "providers/`provider_id`/notes/`NOTE_ID`"
-        #   "providers/`provider_id`/notes/`NOTE_ID`"
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -123,8 +120,7 @@ module Google
         
         # Returns the requested `Note`.
         # @param [String] name
-        #   The name of the note in the form of
+        #   The name of the note in the form of "providers/`provider_id`/notes/`NOTE_ID`"
-        #   "providers/`provider_id`/notes/`NOTE_ID`"
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -153,19 +149,18 @@ module Google
         end
         
         # Gets the access control policy for a note or an `Occurrence` resource.
-        # Requires `containeranalysis.notes.setIamPolicy` or
+        # Requires `containeranalysis.notes.setIamPolicy` or `containeranalysis.
-        # `containeranalysis.occurrences.setIamPolicy` permission if the resource is
+        # occurrences.setIamPolicy` permission if the resource is a note or occurrence,
-        # a note or occurrence, respectively.
+        # respectively. Attempting to call this method on a resource without the
-        # Attempting to call this method on a resource without the required
+        # required permission will result in a `PERMISSION_DENIED` error. Attempting to
-        # permission will result in a `PERMISSION_DENIED` error. Attempting to call
+        # call this method on a non-existent resource will result in a `NOT_FOUND` error
-        # this method on a non-existent resource will result in a `NOT_FOUND` error
+        # if the user has list permission on the project, or a `PERMISSION_DENIED` error
-        # if the user has list permission on the project, or a `PERMISSION_DENIED`
+        # otherwise. The resource takes the following formats: `projects/`PROJECT_ID`/
-        # error otherwise. The resource takes the following formats:
+        # occurrences/`OCCURRENCE_ID`` for occurrences and projects/`PROJECT_ID`/notes/`
-        # `projects/`PROJECT_ID`/occurrences/`OCCURRENCE_ID`` for occurrences and
+        # NOTE_ID` for notes
-        # projects/`PROJECT_ID`/notes/`NOTE_ID` for notes
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being requested.
+        #   REQUIRED: The resource for which the policy is being requested. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::ContaineranalysisV1alpha1::GetIamPolicyRequest] get_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -202,9 +197,8 @@ module Google
         # @param [String] filter
         #   The filter expression.
         # @param [String] name
-        #   The name field will contain the project Id for example:
+        #   The name field will contain the project Id for example: "providers/`
-        #   "providers/`provider_id`
+        #   provider_id` @Deprecated
-        #   @Deprecated
         # @param [Fixnum] page_size
         #   Number of notes to return in the list.
         # @param [String] page_token
@@ -242,8 +236,8 @@ module Google
         
         # Updates an existing `Note`.
         # @param [String] name
-        #   The name of the note.
+        #   The name of the note. Should be of the form "projects/`provider_id`/notes/`
-        #   Should be of the form "projects/`provider_id`/notes/`note_id`".
+        #   note_id`".
         # @param [Google::Apis::ContaineranalysisV1alpha1::Note] note_object
         # @param [String] update_mask
         #   The fields to update.
@@ -278,20 +272,19 @@ module Google
         end
         
         # Sets the access control policy on the specified `Note` or `Occurrence`.
-        # Requires `containeranalysis.notes.setIamPolicy` or
+        # Requires `containeranalysis.notes.setIamPolicy` or `containeranalysis.
-        # `containeranalysis.occurrences.setIamPolicy` permission if the resource is
+        # occurrences.setIamPolicy` permission if the resource is a `Note` or an `
-        # a `Note` or an `Occurrence`, respectively.
+        # Occurrence`, respectively. Attempting to call this method without these
-        # Attempting to call this method without these permissions will result in a `
+        # permissions will result in a ` `PERMISSION_DENIED` error. Attempting to call
-        # `PERMISSION_DENIED` error.
+        # this method on a non-existent resource will result in a `NOT_FOUND` error if
-        # Attempting to call this method on a non-existent resource will result in a
+        # the user has `containeranalysis.notes.list` permission on a `Note` or `
-        # `NOT_FOUND` error if the user has `containeranalysis.notes.list` permission
+        # containeranalysis.occurrences.list` on an `Occurrence`, or a `
-        # on a `Note` or `containeranalysis.occurrences.list` on an `Occurrence`, or
+        # PERMISSION_DENIED` error otherwise. The resource takes the following formats: `
-        # a `PERMISSION_DENIED` error otherwise. The resource takes the following
+        # projects/`projectid`/occurrences/`occurrenceid`` for occurrences and projects/`
-        # formats: `projects/`projectid`/occurrences/`occurrenceid`` for occurrences
+        # projectid`/notes/`noteid` for notes
-        # and projects/`projectid`/notes/`noteid` for notes
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being specified.
+        #   REQUIRED: The resource for which the policy is being specified. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::ContaineranalysisV1alpha1::SetIamPolicyRequest] set_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -322,17 +315,17 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns the permissions that a caller has on the specified note or
+        # Returns the permissions that a caller has on the specified note or occurrence
-        # occurrence resource. Requires list permission on the project (for example,
+        # resource. Requires list permission on the project (for example, "storage.
-        # "storage.objects.list" on the containing bucket for testing permission of
+        # objects.list" on the containing bucket for testing permission of an object).
-        # an object). Attempting to call this method on a non-existent resource will
+        # Attempting to call this method on a non-existent resource will result in a `
-        # result in a `NOT_FOUND` error if the user has list permission on the
+        # NOT_FOUND` error if the user has list permission on the project, or a `
-        # project, or a `PERMISSION_DENIED` error otherwise. The resource takes the
+        # PERMISSION_DENIED` error otherwise. The resource takes the following formats: `
-        # following formats: `projects/`PROJECT_ID`/occurrences/`OCCURRENCE_ID`` for
+        # projects/`PROJECT_ID`/occurrences/`OCCURRENCE_ID`` for `Occurrences` and `
-        # `Occurrences` and `projects/`PROJECT_ID`/notes/`NOTE_ID`` for `Notes`
+        # projects/`PROJECT_ID`/notes/`NOTE_ID`` for `Notes`
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy detail is being requested.
+        #   REQUIRED: The resource for which the policy detail is being requested. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::ContaineranalysisV1alpha1::TestIamPermissionsRequest] test_iam_permissions_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -363,12 +356,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists `Occurrences` referencing the specified `Note`. Use this method to
+        # Lists `Occurrences` referencing the specified `Note`. Use this method to get
-        # get all occurrences referencing your `Note` across all your customer
+        # all occurrences referencing your `Note` across all your customer projects.
-        # projects.
         # @param [String] name
-        #   The name field will contain the note name for example:
+        #   The name field will contain the note name for example: "provider/`provider_id`/
-        #   "provider/`provider_id`/notes/`note_id`"
+        #   notes/`note_id`"
         # @param [String] filter
         #   The filter expression.
         # @param [Fixnum] page_size
@@ -405,14 +397,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new `Occurrence`. Use this method to create `Occurrences`
+        # Creates a new `Occurrence`. Use this method to create `Occurrences` for a
-        # for a resource.
+        # resource.
         # @param [String] parent
         #   This field contains the project Id for example: "projects/`project_id`"
         # @param [Google::Apis::ContaineranalysisV1alpha1::Occurrence] occurrence_object
         # @param [String] name
-        #   The name of the project.  Should be of the form "projects/`project_id`".
+        #   The name of the project. Should be of the form "projects/`project_id`". @
-        #   @Deprecated
+        #   Deprecated
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -443,11 +435,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes the given `Occurrence` from the system. Use this when
+        # Deletes the given `Occurrence` from the system. Use this when an `Occurrence`
-        # an `Occurrence` is no longer applicable for the given resource.
+        # is no longer applicable for the given resource.
         # @param [String] name
-        #   The name of the occurrence in the form of
+        #   The name of the occurrence in the form of "projects/`project_id`/occurrences/`
-        #   "projects/`project_id`/occurrences/`OCCURRENCE_ID`"
+        #   OCCURRENCE_ID`"
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -477,8 +469,8 @@ module Google
         
         # Returns the requested `Occurrence`.
         # @param [String] name
-        #   The name of the occurrence of the form
+        #   The name of the occurrence of the form "projects/`project_id`/occurrences/`
-        #   "projects/`project_id`/occurrences/`OCCURRENCE_ID`"
+        #   OCCURRENCE_ID`"
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -507,19 +499,18 @@ module Google
         end
         
         # Gets the access control policy for a note or an `Occurrence` resource.
-        # Requires `containeranalysis.notes.setIamPolicy` or
+        # Requires `containeranalysis.notes.setIamPolicy` or `containeranalysis.
-        # `containeranalysis.occurrences.setIamPolicy` permission if the resource is
+        # occurrences.setIamPolicy` permission if the resource is a note or occurrence,
-        # a note or occurrence, respectively.
+        # respectively. Attempting to call this method on a resource without the
-        # Attempting to call this method on a resource without the required
+        # required permission will result in a `PERMISSION_DENIED` error. Attempting to
-        # permission will result in a `PERMISSION_DENIED` error. Attempting to call
+        # call this method on a non-existent resource will result in a `NOT_FOUND` error
-        # this method on a non-existent resource will result in a `NOT_FOUND` error
+        # if the user has list permission on the project, or a `PERMISSION_DENIED` error
-        # if the user has list permission on the project, or a `PERMISSION_DENIED`
+        # otherwise. The resource takes the following formats: `projects/`PROJECT_ID`/
-        # error otherwise. The resource takes the following formats:
+        # occurrences/`OCCURRENCE_ID`` for occurrences and projects/`PROJECT_ID`/notes/`
-        # `projects/`PROJECT_ID`/occurrences/`OCCURRENCE_ID`` for occurrences and
+        # NOTE_ID` for notes
-        # projects/`PROJECT_ID`/notes/`NOTE_ID` for notes
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being requested.
+        #   REQUIRED: The resource for which the policy is being requested. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::ContaineranalysisV1alpha1::GetIamPolicyRequest] get_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -552,8 +543,8 @@ module Google
         
         # Gets the `Note` attached to the given `Occurrence`.
         # @param [String] name
-        #   The name of the occurrence in the form
+        #   The name of the occurrence in the form "projects/`project_id`/occurrences/`
-        #   "projects/`project_id`/occurrences/`OCCURRENCE_ID`"
+        #   OCCURRENCE_ID`"
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -622,9 +613,8 @@ module Google
         # @param [String] kind
         #   The kind of occurrences to filter on.
         # @param [String] name
-        #   The name field contains the project Id. For example:
+        #   The name field contains the project Id. For example: "projects/`project_id` @
-        #   "projects/`project_id`
+        #   Deprecated
-        #   @Deprecated
         # @param [Fixnum] page_size
         #   Number of occurrences to return in the list.
         # @param [String] page_token
@@ -663,8 +653,8 @@ module Google
         
         # Updates an existing occurrence.
         # @param [String] name
-        #   The name of the occurrence.
+        #   The name of the occurrence. Should be of the form "projects/`project_id`/
-        #   Should be of the form "projects/`project_id`/occurrences/`OCCURRENCE_ID`".
+        #   occurrences/`OCCURRENCE_ID`".
         # @param [Google::Apis::ContaineranalysisV1alpha1::Occurrence] occurrence_object
         # @param [String] update_mask
         #   The fields to update.
@@ -699,20 +689,19 @@ module Google
         end
         
         # Sets the access control policy on the specified `Note` or `Occurrence`.
-        # Requires `containeranalysis.notes.setIamPolicy` or
+        # Requires `containeranalysis.notes.setIamPolicy` or `containeranalysis.
-        # `containeranalysis.occurrences.setIamPolicy` permission if the resource is
+        # occurrences.setIamPolicy` permission if the resource is a `Note` or an `
-        # a `Note` or an `Occurrence`, respectively.
+        # Occurrence`, respectively. Attempting to call this method without these
-        # Attempting to call this method without these permissions will result in a `
+        # permissions will result in a ` `PERMISSION_DENIED` error. Attempting to call
-        # `PERMISSION_DENIED` error.
+        # this method on a non-existent resource will result in a `NOT_FOUND` error if
-        # Attempting to call this method on a non-existent resource will result in a
+        # the user has `containeranalysis.notes.list` permission on a `Note` or `
-        # `NOT_FOUND` error if the user has `containeranalysis.notes.list` permission
+        # containeranalysis.occurrences.list` on an `Occurrence`, or a `
-        # on a `Note` or `containeranalysis.occurrences.list` on an `Occurrence`, or
+        # PERMISSION_DENIED` error otherwise. The resource takes the following formats: `
-        # a `PERMISSION_DENIED` error otherwise. The resource takes the following
+        # projects/`projectid`/occurrences/`occurrenceid`` for occurrences and projects/`
-        # formats: `projects/`projectid`/occurrences/`occurrenceid`` for occurrences
+        # projectid`/notes/`noteid` for notes
-        # and projects/`projectid`/notes/`noteid` for notes
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being specified.
+        #   REQUIRED: The resource for which the policy is being specified. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::ContaineranalysisV1alpha1::SetIamPolicyRequest] set_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -743,17 +732,17 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns the permissions that a caller has on the specified note or
+        # Returns the permissions that a caller has on the specified note or occurrence
-        # occurrence resource. Requires list permission on the project (for example,
+        # resource. Requires list permission on the project (for example, "storage.
-        # "storage.objects.list" on the containing bucket for testing permission of
+        # objects.list" on the containing bucket for testing permission of an object).
-        # an object). Attempting to call this method on a non-existent resource will
+        # Attempting to call this method on a non-existent resource will result in a `
-        # result in a `NOT_FOUND` error if the user has list permission on the
+        # NOT_FOUND` error if the user has list permission on the project, or a `
-        # project, or a `PERMISSION_DENIED` error otherwise. The resource takes the
+        # PERMISSION_DENIED` error otherwise. The resource takes the following formats: `
-        # following formats: `projects/`PROJECT_ID`/occurrences/`OCCURRENCE_ID`` for
+        # projects/`PROJECT_ID`/occurrences/`OCCURRENCE_ID`` for `Occurrences` and `
-        # `Occurrences` and `projects/`PROJECT_ID`/notes/`NOTE_ID`` for `Notes`
+        # projects/`PROJECT_ID`/notes/`NOTE_ID`` for `Notes`
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy detail is being requested.
+        #   REQUIRED: The resource for which the policy detail is being requested. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::ContaineranalysisV1alpha1::TestIamPermissionsRequest] test_iam_permissions_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -817,12 +806,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates an existing operation returns an error if operation
+        # Updates an existing operation returns an error if operation does not exist.
-        # does not exist. The only valid operations are to update mark the done bit
+        # The only valid operations are to update mark the done bit change the result.
-        # change the result.
         # @param [String] name
-        #   The name of the Operation.
+        #   The name of the Operation. Should be of the form "projects/`provider_id`/
-        #   Should be of the form "projects/`provider_id`/operations/`operation_id`".
+        #   operations/`operation_id`".
         # @param [Google::Apis::ContaineranalysisV1alpha1::UpdateOperationRequest] update_operation_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -855,8 +843,8 @@ module Google
         
         # Gets a specific scan configuration for a project.
         # @param [String] name
-        #   The name of the ScanConfig in the form
+        #   The name of the ScanConfig in the form projects/`project_id`/scanConfigs/`
-        #   projects/`project_id`/scanConfigs/`scan_config_id`
+        #   scan_config_id`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -925,8 +913,8 @@ module Google
         
         # Updates the scan configuration to a new value.
         # @param [String] name
-        #   The scan config to update of the form
+        #   The scan config to update of the form projects/`project_id`/scanConfigs/`
-        #   projects/`project_id`/scanConfigs/`scan_config_id`.
+        #   scan_config_id`.
         # @param [Google::Apis::ContaineranalysisV1alpha1::ScanConfig] scan_config_object
         # @param [String] update_mask
         #   The fields to update.
@@ -962,15 +950,13 @@ module Google
         
         # Creates a new `Note`.
         # @param [String] name
-        #   The name of the project.
+        #   The name of the project. Should be of the form "providers/`provider_id`". @
-        #   Should be of the form "providers/`provider_id`".
+        #   Deprecated
-        #   @Deprecated
         # @param [Google::Apis::ContaineranalysisV1alpha1::Note] note_object
         # @param [String] note_id
         #   The ID to use for this note.
         # @param [String] parent
-        #   This field contains the project Id for example:
+        #   This field contains the project Id for example: "projects/`project_id`
-        #   "projects/`project_id`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1004,8 +990,7 @@ module Google
         
         # Deletes the given `Note` from the system.
         # @param [String] name
-        #   The name of the note in the form of
+        #   The name of the note in the form of "providers/`provider_id`/notes/`NOTE_ID`"
-        #   "providers/`provider_id`/notes/`NOTE_ID`"
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1035,8 +1020,7 @@ module Google
         
         # Returns the requested `Note`.
         # @param [String] name
-        #   The name of the note in the form of
+        #   The name of the note in the form of "providers/`provider_id`/notes/`NOTE_ID`"
-        #   "providers/`provider_id`/notes/`NOTE_ID`"
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1065,19 +1049,18 @@ module Google
         end
         
         # Gets the access control policy for a note or an `Occurrence` resource.
-        # Requires `containeranalysis.notes.setIamPolicy` or
+        # Requires `containeranalysis.notes.setIamPolicy` or `containeranalysis.
-        # `containeranalysis.occurrences.setIamPolicy` permission if the resource is
+        # occurrences.setIamPolicy` permission if the resource is a note or occurrence,
-        # a note or occurrence, respectively.
+        # respectively. Attempting to call this method on a resource without the
-        # Attempting to call this method on a resource without the required
+        # required permission will result in a `PERMISSION_DENIED` error. Attempting to
-        # permission will result in a `PERMISSION_DENIED` error. Attempting to call
+        # call this method on a non-existent resource will result in a `NOT_FOUND` error
-        # this method on a non-existent resource will result in a `NOT_FOUND` error
+        # if the user has list permission on the project, or a `PERMISSION_DENIED` error
-        # if the user has list permission on the project, or a `PERMISSION_DENIED`
+        # otherwise. The resource takes the following formats: `projects/`PROJECT_ID`/
-        # error otherwise. The resource takes the following formats:
+        # occurrences/`OCCURRENCE_ID`` for occurrences and projects/`PROJECT_ID`/notes/`
-        # `projects/`PROJECT_ID`/occurrences/`OCCURRENCE_ID`` for occurrences and
+        # NOTE_ID` for notes
-        # projects/`PROJECT_ID`/notes/`NOTE_ID` for notes
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being requested.
+        #   REQUIRED: The resource for which the policy is being requested. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::ContaineranalysisV1alpha1::GetIamPolicyRequest] get_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1110,9 +1093,8 @@ module Google
         
         # Lists all `Notes` for a given project.
         # @param [String] name
-        #   The name field will contain the project Id for example:
+        #   The name field will contain the project Id for example: "providers/`
-        #   "providers/`provider_id`
+        #   provider_id` @Deprecated
-        #   @Deprecated
         # @param [String] filter
         #   The filter expression.
         # @param [Fixnum] page_size
@@ -1154,8 +1136,8 @@ module Google
         
         # Updates an existing `Note`.
         # @param [String] name
-        #   The name of the note.
+        #   The name of the note. Should be of the form "projects/`provider_id`/notes/`
-        #   Should be of the form "projects/`provider_id`/notes/`note_id`".
+        #   note_id`".
         # @param [Google::Apis::ContaineranalysisV1alpha1::Note] note_object
         # @param [String] update_mask
         #   The fields to update.
@@ -1190,20 +1172,19 @@ module Google
         end
         
         # Sets the access control policy on the specified `Note` or `Occurrence`.
-        # Requires `containeranalysis.notes.setIamPolicy` or
+        # Requires `containeranalysis.notes.setIamPolicy` or `containeranalysis.
-        # `containeranalysis.occurrences.setIamPolicy` permission if the resource is
+        # occurrences.setIamPolicy` permission if the resource is a `Note` or an `
-        # a `Note` or an `Occurrence`, respectively.
+        # Occurrence`, respectively. Attempting to call this method without these
-        # Attempting to call this method without these permissions will result in a `
+        # permissions will result in a ` `PERMISSION_DENIED` error. Attempting to call
-        # `PERMISSION_DENIED` error.
+        # this method on a non-existent resource will result in a `NOT_FOUND` error if
-        # Attempting to call this method on a non-existent resource will result in a
+        # the user has `containeranalysis.notes.list` permission on a `Note` or `
-        # `NOT_FOUND` error if the user has `containeranalysis.notes.list` permission
+        # containeranalysis.occurrences.list` on an `Occurrence`, or a `
-        # on a `Note` or `containeranalysis.occurrences.list` on an `Occurrence`, or
+        # PERMISSION_DENIED` error otherwise. The resource takes the following formats: `
-        # a `PERMISSION_DENIED` error otherwise. The resource takes the following
+        # projects/`projectid`/occurrences/`occurrenceid`` for occurrences and projects/`
-        # formats: `projects/`projectid`/occurrences/`occurrenceid`` for occurrences
+        # projectid`/notes/`noteid` for notes
-        # and projects/`projectid`/notes/`noteid` for notes
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being specified.
+        #   REQUIRED: The resource for which the policy is being specified. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::ContaineranalysisV1alpha1::SetIamPolicyRequest] set_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1234,17 +1215,17 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns the permissions that a caller has on the specified note or
+        # Returns the permissions that a caller has on the specified note or occurrence
-        # occurrence resource. Requires list permission on the project (for example,
+        # resource. Requires list permission on the project (for example, "storage.
-        # "storage.objects.list" on the containing bucket for testing permission of
+        # objects.list" on the containing bucket for testing permission of an object).
-        # an object). Attempting to call this method on a non-existent resource will
+        # Attempting to call this method on a non-existent resource will result in a `
-        # result in a `NOT_FOUND` error if the user has list permission on the
+        # NOT_FOUND` error if the user has list permission on the project, or a `
-        # project, or a `PERMISSION_DENIED` error otherwise. The resource takes the
+        # PERMISSION_DENIED` error otherwise. The resource takes the following formats: `
-        # following formats: `projects/`PROJECT_ID`/occurrences/`OCCURRENCE_ID`` for
+        # projects/`PROJECT_ID`/occurrences/`OCCURRENCE_ID`` for `Occurrences` and `
-        # `Occurrences` and `projects/`PROJECT_ID`/notes/`NOTE_ID`` for `Notes`
+        # projects/`PROJECT_ID`/notes/`NOTE_ID`` for `Notes`
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy detail is being requested.
+        #   REQUIRED: The resource for which the policy detail is being requested. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::ContaineranalysisV1alpha1::TestIamPermissionsRequest] test_iam_permissions_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1275,12 +1256,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists `Occurrences` referencing the specified `Note`. Use this method to
+        # Lists `Occurrences` referencing the specified `Note`. Use this method to get
-        # get all occurrences referencing your `Note` across all your customer
+        # all occurrences referencing your `Note` across all your customer projects.
-        # projects.
         # @param [String] name
-        #   The name field will contain the note name for example:
+        #   The name field will contain the note name for example: "provider/`provider_id`/
-        #   "provider/`provider_id`/notes/`note_id`"
+        #   notes/`note_id`"
         # @param [String] filter
         #   The filter expression.
         # @param [Fixnum] page_size

generated/google/apis/containeranalysis_v1beta1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/container-analysis/api/reference/rest/
     module ContaineranalysisV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20200619'
+      REVISION = '20200807'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/containeranalysis_v1beta1/service.rb

@@ -51,8 +51,7 @@ module Google
         # Creates new notes in batch.
         # @param [String] parent
         #   Required. The name of the project in the form of `projects/[PROJECT_ID]`,
-        #   under which
+        #   under which the notes are to be created.
-        #   the notes are to be created.
         # @param [Google::Apis::ContaineranalysisV1beta1::BatchCreateNotesRequest] batch_create_notes_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -86,8 +85,7 @@ module Google
         # Creates a new note.
         # @param [String] parent
         #   Required. The name of the project in the form of `projects/[PROJECT_ID]`,
-        #   under which
+        #   under which the note is to be created.
-        #   the note is to be created.
         # @param [Google::Apis::ContaineranalysisV1beta1::Note] note_object
         # @param [String] note_id
         #   Required. The ID to use for this note.
@@ -123,8 +121,8 @@ module Google
         
         # Deletes the specified note.
         # @param [String] name
-        #   Required. The name of the note in the form of
+        #   Required. The name of the note in the form of `projects/[PROVIDER_ID]/notes/[
-        #   `projects/[PROVIDER_ID]/notes/[NOTE_ID]`.
+        #   NOTE_ID]`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -154,8 +152,8 @@ module Google
         
         # Gets the specified note.
         # @param [String] name
-        #   Required. The name of the note in the form of
+        #   Required. The name of the note in the form of `projects/[PROVIDER_ID]/notes/[
-        #   `projects/[PROVIDER_ID]/notes/[NOTE_ID]`.
+        #   NOTE_ID]`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -183,16 +181,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the access control policy for a note or an occurrence resource.
+        # Gets the access control policy for a note or an occurrence resource. Requires `
-        # Requires `containeranalysis.notes.setIamPolicy` or
+        # containeranalysis.notes.setIamPolicy` or `containeranalysis.occurrences.
-        # `containeranalysis.occurrences.setIamPolicy` permission if the resource is
+        # setIamPolicy` permission if the resource is a note or occurrence, respectively.
-        # a note or occurrence, respectively.
         # The resource takes the format `projects/[PROJECT_ID]/notes/[NOTE_ID]` for
-        # notes and `projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]` for
+        # notes and `projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]` for occurrences.
-        # occurrences.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being requested.
+        #   REQUIRED: The resource for which the policy is being requested. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::ContaineranalysisV1beta1::GetIamPolicyRequest] get_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -225,13 +221,13 @@ module Google
         
         # Lists notes for the specified project.
         # @param [String] parent
-        #   Required. The name of the project to list notes for in the form of
+        #   Required. The name of the project to list notes for in the form of `projects/[
-        #   `projects/[PROJECT_ID]`.
+        #   PROJECT_ID]`.
         # @param [String] filter
         #   The filter expression.
         # @param [Fixnum] page_size
-        #   Number of notes to return in the list. Must be positive. Max allowed page
+        #   Number of notes to return in the list. Must be positive. Max allowed page size
-        #   size is 1000. If not specified, page size defaults to 20.
+        #   is 1000. If not specified, page size defaults to 20.
         # @param [String] page_token
         #   Token to provide to skip to a particular spot in the list.
         # @param [String] fields
@@ -266,8 +262,8 @@ module Google
         
         # Updates the specified note.
         # @param [String] name
-        #   Required. The name of the note in the form of
+        #   Required. The name of the note in the form of `projects/[PROVIDER_ID]/notes/[
-        #   `projects/[PROVIDER_ID]/notes/[NOTE_ID]`.
+        #   NOTE_ID]`.
         # @param [Google::Apis::ContaineranalysisV1beta1::Note] note_object
         # @param [String] update_mask
         #   The fields to update.
@@ -301,16 +297,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Sets the access control policy on the specified note or occurrence.
+        # Sets the access control policy on the specified note or occurrence. Requires `
-        # Requires `containeranalysis.notes.setIamPolicy` or
+        # containeranalysis.notes.setIamPolicy` or `containeranalysis.occurrences.
-        # `containeranalysis.occurrences.setIamPolicy` permission if the resource is
+        # setIamPolicy` permission if the resource is a note or an occurrence,
-        # a note or an occurrence, respectively.
+        # respectively. The resource takes the format `projects/[PROJECT_ID]/notes/[
-        # The resource takes the format `projects/[PROJECT_ID]/notes/[NOTE_ID]` for
+        # NOTE_ID]` for notes and `projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]`
-        # notes and `projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]` for
+        # for occurrences.
-        # occurrences.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being specified.
+        #   REQUIRED: The resource for which the policy is being specified. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::ContaineranalysisV1beta1::SetIamPolicyRequest] set_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -341,15 +336,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns the permissions that a caller has on the specified note or
+        # Returns the permissions that a caller has on the specified note or occurrence.
-        # occurrence. Requires list permission on the project (for example,
+        # Requires list permission on the project (for example, `containeranalysis.notes.
-        # `containeranalysis.notes.list`).
+        # list`). The resource takes the format `projects/[PROJECT_ID]/notes/[NOTE_ID]`
-        # The resource takes the format `projects/[PROJECT_ID]/notes/[NOTE_ID]` for
+        # for notes and `projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]` for
-        # notes and `projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]` for
         # occurrences.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy detail is being requested.
+        #   REQUIRED: The resource for which the policy detail is being requested. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::ContaineranalysisV1beta1::TestIamPermissionsRequest] test_iam_permissions_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -384,8 +378,8 @@ module Google
         # this method to get all occurrences across consumer projects referencing the
         # specified note.
         # @param [String] name
-        #   Required. The name of the note to list occurrences for in the form of
+        #   Required. The name of the note to list occurrences for in the form of `
-        #   `projects/[PROVIDER_ID]/notes/[NOTE_ID]`.
+        #   projects/[PROVIDER_ID]/notes/[NOTE_ID]`.
         # @param [String] filter
         #   The filter expression.
         # @param [Fixnum] page_size
@@ -425,8 +419,7 @@ module Google
         # Creates new occurrences in batch.
         # @param [String] parent
         #   Required. The name of the project in the form of `projects/[PROJECT_ID]`,
-        #   under which
+        #   under which the occurrences are to be created.
-        #   the occurrences are to be created.
         # @param [Google::Apis::ContaineranalysisV1beta1::BatchCreateOccurrencesRequest] batch_create_occurrences_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -460,8 +453,7 @@ module Google
         # Creates a new occurrence.
         # @param [String] parent
         #   Required. The name of the project in the form of `projects/[PROJECT_ID]`,
-        #   under which
+        #   under which the occurrence is to be created.
-        #   the occurrence is to be created.
         # @param [Google::Apis::ContaineranalysisV1beta1::Occurrence] occurrence_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -493,11 +485,10 @@ module Google
         end
         
         # Deletes the specified occurrence. For example, use this method to delete an
-        # occurrence when the occurrence is no longer applicable for the given
+        # occurrence when the occurrence is no longer applicable for the given resource.
-        # resource.
         # @param [String] name
-        #   Required. The name of the occurrence in the form of
+        #   Required. The name of the occurrence in the form of `projects/[PROJECT_ID]/
-        #   `projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]`.
+        #   occurrences/[OCCURRENCE_ID]`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -527,8 +518,8 @@ module Google
         
         # Gets the specified occurrence.
         # @param [String] name
-        #   Required. The name of the occurrence in the form of
+        #   Required. The name of the occurrence in the form of `projects/[PROJECT_ID]/
-        #   `projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]`.
+        #   occurrences/[OCCURRENCE_ID]`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -556,16 +547,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the access control policy for a note or an occurrence resource.
+        # Gets the access control policy for a note or an occurrence resource. Requires `
-        # Requires `containeranalysis.notes.setIamPolicy` or
+        # containeranalysis.notes.setIamPolicy` or `containeranalysis.occurrences.
-        # `containeranalysis.occurrences.setIamPolicy` permission if the resource is
+        # setIamPolicy` permission if the resource is a note or occurrence, respectively.
-        # a note or occurrence, respectively.
         # The resource takes the format `projects/[PROJECT_ID]/notes/[NOTE_ID]` for
-        # notes and `projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]` for
+        # notes and `projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]` for occurrences.
-        # occurrences.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being requested.
+        #   REQUIRED: The resource for which the policy is being requested. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::ContaineranalysisV1beta1::GetIamPolicyRequest] get_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -596,11 +585,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the note attached to the specified occurrence. Consumer projects can
+        # Gets the note attached to the specified occurrence. Consumer projects can use
-        # use this method to get a note that belongs to a provider project.
+        # this method to get a note that belongs to a provider project.
         # @param [String] name
-        #   Required. The name of the occurrence in the form of
+        #   Required. The name of the occurrence in the form of `projects/[PROJECT_ID]/
-        #   `projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]`.
+        #   occurrences/[OCCURRENCE_ID]`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -631,8 +620,7 @@ module Google
         # Gets a summary of the number and severity of occurrences.
         # @param [String] parent
         #   Required. The name of the project to get a vulnerability summary for in the
-        #   form of
+        #   form of `projects/[PROJECT_ID]`.
-        #   `projects/[PROJECT_ID]`.
         # @param [String] filter
         #   The filter expression.
         # @param [String] fields
@@ -665,8 +653,8 @@ module Google
         
         # Lists occurrences for the specified project.
         # @param [String] parent
-        #   Required. The name of the project to list occurrences for in the form of
+        #   Required. The name of the project to list occurrences for in the form of `
-        #   `projects/[PROJECT_ID]`.
+        #   projects/[PROJECT_ID]`.
         # @param [String] filter
         #   The filter expression.
         # @param [Fixnum] page_size
@@ -706,8 +694,8 @@ module Google
         
         # Updates the specified occurrence.
         # @param [String] name
-        #   Required. The name of the occurrence in the form of
+        #   Required. The name of the occurrence in the form of `projects/[PROJECT_ID]/
-        #   `projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]`.
+        #   occurrences/[OCCURRENCE_ID]`.
         # @param [Google::Apis::ContaineranalysisV1beta1::Occurrence] occurrence_object
         # @param [String] update_mask
         #   The fields to update.
@@ -741,16 +729,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Sets the access control policy on the specified note or occurrence.
+        # Sets the access control policy on the specified note or occurrence. Requires `
-        # Requires `containeranalysis.notes.setIamPolicy` or
+        # containeranalysis.notes.setIamPolicy` or `containeranalysis.occurrences.
-        # `containeranalysis.occurrences.setIamPolicy` permission if the resource is
+        # setIamPolicy` permission if the resource is a note or an occurrence,
-        # a note or an occurrence, respectively.
+        # respectively. The resource takes the format `projects/[PROJECT_ID]/notes/[
-        # The resource takes the format `projects/[PROJECT_ID]/notes/[NOTE_ID]` for
+        # NOTE_ID]` for notes and `projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]`
-        # notes and `projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]` for
+        # for occurrences.
-        # occurrences.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being specified.
+        #   REQUIRED: The resource for which the policy is being specified. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::ContaineranalysisV1beta1::SetIamPolicyRequest] set_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -781,15 +768,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns the permissions that a caller has on the specified note or
+        # Returns the permissions that a caller has on the specified note or occurrence.
-        # occurrence. Requires list permission on the project (for example,
+        # Requires list permission on the project (for example, `containeranalysis.notes.
-        # `containeranalysis.notes.list`).
+        # list`). The resource takes the format `projects/[PROJECT_ID]/notes/[NOTE_ID]`
-        # The resource takes the format `projects/[PROJECT_ID]/notes/[NOTE_ID]` for
+        # for notes and `projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]` for
-        # notes and `projects/[PROJECT_ID]/occurrences/[OCCURRENCE_ID]` for
         # occurrences.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy detail is being requested.
+        #   REQUIRED: The resource for which the policy detail is being requested. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::ContaineranalysisV1beta1::TestIamPermissionsRequest] test_iam_permissions_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -822,8 +808,8 @@ module Google
         
         # Gets the specified scan configuration.
         # @param [String] name
-        #   Required. The name of the scan configuration in the form of
+        #   Required. The name of the scan configuration in the form of `projects/[
-        #   `projects/[PROJECT_ID]/scanConfigs/[SCAN_CONFIG_ID]`.
+        #   PROJECT_ID]/scanConfigs/[SCAN_CONFIG_ID]`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -854,8 +840,7 @@ module Google
         # Lists scan configurations for the specified project.
         # @param [String] parent
         #   Required. The name of the project to list scan configurations for in the form
-        #   of
+        #   of `projects/[PROJECT_ID]`.
-        #   `projects/[PROJECT_ID]`.
         # @param [String] filter
         #   Required. The filter expression.
         # @param [Fixnum] page_size
@@ -894,8 +879,8 @@ module Google
         
         # Updates the specified scan configuration.
         # @param [String] name
-        #   Required. The name of the scan configuration in the form of
+        #   Required. The name of the scan configuration in the form of `projects/[
-        #   `projects/[PROJECT_ID]/scanConfigs/[SCAN_CONFIG_ID]`.
+        #   PROJECT_ID]/scanConfigs/[SCAN_CONFIG_ID]`.
         # @param [Google::Apis::ContaineranalysisV1beta1::ScanConfig] scan_config_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.

generated/google/apis/content_v2.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://developers.google.com/shopping-content
     module ContentV2
       VERSION = 'V2'
-      REVISION = '20200721'
+      REVISION = '20200805'
 
       # Manage your product listings and accounts for Google Shopping
       AUTH_CONTENT = 'https://www.googleapis.com/auth/content'

generated/google/apis/content_v2/classes.rb

@@ -5829,7 +5829,9 @@ module Google
       class OrderShipmentScheduledDeliveryDetails
         include Google::Apis::Core::Hashable
       
-        # The phone number of the carrier fulfilling the delivery.
+        # The phone number of the carrier fulfilling the delivery. The phone number is
+        # formatted as the international notation in ITU-T Recommendation E.123 (e.g., "+
+        # 41 44 668 1800").
         # Corresponds to the JSON property `carrierPhoneNumber`
         # @return [String]
         attr_accessor :carrier_phone_number

generated/google/apis/content_v2_1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://developers.google.com/shopping-content
     module ContentV2_1
       VERSION = 'V2_1'
-      REVISION = '20200721'
+      REVISION = '20200805'
 
       # Manage your product listings and accounts for Google Shopping
       AUTH_CONTENT = 'https://www.googleapis.com/auth/content'

generated/google/apis/content_v2_1/classes.rb

@@ -48,6 +48,11 @@ module Google
         # @return [Google::Apis::ContentV2_1::AccountBusinessInformation]
         attr_accessor :business_information
       
+        # ID of CSS the account belongs to.
+        # Corresponds to the JSON property `cssId`
+        # @return [Fixnum]
+        attr_accessor :css_id
+      
         # The GMB account which is linked or in the process of being linked with the
         # Merchant Center account.
         # Corresponds to the JSON property `googleMyBusinessLink`
@@ -65,6 +70,11 @@ module Google
         # @return [String]
         attr_accessor :kind
       
+        # List of label IDs that are assigned to the account by CSS.
+        # Corresponds to the JSON property `labelIds`
+        # @return [Array<Fixnum>]
+        attr_accessor :label_ids
+      
         # Required. Display name for the account.
         # Corresponds to the JSON property `name`
         # @return [String]
@@ -104,9 +114,11 @@ module Google
           @ads_links = args[:ads_links] if args.key?(:ads_links)
           @adult_content = args[:adult_content] if args.key?(:adult_content)
           @business_information = args[:business_information] if args.key?(:business_information)
+          @css_id = args[:css_id] if args.key?(:css_id)
           @google_my_business_link = args[:google_my_business_link] if args.key?(:google_my_business_link)
           @id = args[:id] if args.key?(:id)
           @kind = args[:kind] if args.key?(:kind)
+          @label_ids = args[:label_ids] if args.key?(:label_ids)
           @name = args[:name] if args.key?(:name)
           @seller_id = args[:seller_id] if args.key?(:seller_id)
           @users = args[:users] if args.key?(:users)
@@ -862,6 +874,11 @@ module Google
         attr_accessor :overwrite
         alias_method :overwrite?, :overwrite
       
+        # Controls which fields are visible. Only applicable if the method is 'get'.
+        # Corresponds to the JSON property `view`
+        # @return [String]
+        attr_accessor :view
+      
         def initialize(**args)
            update!(**args)
         end
@@ -877,6 +894,7 @@ module Google
           @merchant_id = args[:merchant_id] if args.key?(:merchant_id)
           @method_prop = args[:method_prop] if args.key?(:method_prop)
           @overwrite = args[:overwrite] if args.key?(:overwrite)
+          @view = args[:view] if args.key?(:view)
         end
       end
       
@@ -1120,6 +1138,45 @@ module Google
         end
       end
       
+      # 
+      class AccountsUpdateLabelsRequest
+        include Google::Apis::Core::Hashable
+      
+        # The IDs of labels that should be assigned to the account.
+        # Corresponds to the JSON property `labelIds`
+        # @return [Array<Fixnum>]
+        attr_accessor :label_ids
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @label_ids = args[:label_ids] if args.key?(:label_ids)
+        end
+      end
+      
+      # 
+      class AccountsUpdateLabelsResponse
+        include Google::Apis::Core::Hashable
+      
+        # Identifies what kind of resource this is. Value: the fixed string "content#
+        # accountsUpdateLabelsResponse".
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @kind = args[:kind] if args.key?(:kind)
+        end
+      end
+      
       # 
       class AccountstatusesCustomBatchRequest
         include Google::Apis::Core::Hashable
@@ -5625,7 +5682,9 @@ module Google
       class OrderShipmentScheduledDeliveryDetails
         include Google::Apis::Core::Hashable
       
-        # The phone number of the carrier fulfilling the delivery.
+        # The phone number of the carrier fulfilling the delivery. The phone number is
+        # formatted as the international notation in ITU-T Recommendation E.123 (e.g., "+
+        # 41 44 668 1800").
         # Corresponds to the JSON property `carrierPhoneNumber`
         # @return [String]
         attr_accessor :carrier_phone_number
@@ -9312,11 +9371,26 @@ module Google
       class ProductStatusDestinationStatus
         include Google::Apis::Core::Hashable
       
+        # List of country codes (ISO 3166-1 alpha-2) where the offer is approved.
+        # Corresponds to the JSON property `approvedCountrys`
+        # @return [Array<String>]
+        attr_accessor :approved_countrys
+      
         # The name of the destination
         # Corresponds to the JSON property `destination`
         # @return [String]
         attr_accessor :destination
       
+        # List of country codes (ISO 3166-1 alpha-2) where the offer is disapproved.
+        # Corresponds to the JSON property `disapprovedCountrys`
+        # @return [Array<String>]
+        attr_accessor :disapproved_countrys
+      
+        # List of country codes (ISO 3166-1 alpha-2) where the offer is pending approval.
+        # Corresponds to the JSON property `pendingCountrys`
+        # @return [Array<String>]
+        attr_accessor :pending_countrys
+      
         # Destination approval status in `targetCountry` of the offer.
         # Corresponds to the JSON property `status`
         # @return [String]
@@ -9328,7 +9402,10 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @approved_countrys = args[:approved_countrys] if args.key?(:approved_countrys)
           @destination = args[:destination] if args.key?(:destination)
+          @disapproved_countrys = args[:disapproved_countrys] if args.key?(:disapproved_countrys)
+          @pending_countrys = args[:pending_countrys] if args.key?(:pending_countrys)
           @status = args[:status] if args.key?(:status)
         end
       end
@@ -9337,6 +9414,11 @@ module Google
       class ProductStatusItemLevelIssue
         include Google::Apis::Core::Hashable
       
+        # List of country codes (ISO 3166-1 alpha-2) where issue applies to the offer.
+        # Corresponds to the JSON property `applicableCountrys`
+        # @return [Array<String>]
+        attr_accessor :applicable_countrys
+      
         # The attribute's name, if the issue is caused by a single attribute.
         # Corresponds to the JSON property `attributeName`
         # @return [String]
@@ -9383,6 +9465,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @applicable_countrys = args[:applicable_countrys] if args.key?(:applicable_countrys)
           @attribute_name = args[:attribute_name] if args.key?(:attribute_name)
           @code = args[:code] if args.key?(:code)
           @description = args[:description] if args.key?(:description)
@@ -10069,7 +10152,7 @@ module Google
         # @return [Google::Apis::ContentV2_1::Price]
         attr_accessor :price
       
-        # The ID (name) of the region.
+        # The ID uniquely identifying each region.
         # Corresponds to the JSON property `regionId`
         # @return [String]
         attr_accessor :region_id

generated/google/apis/content_v2_1/representations.rb

@@ -184,6 +184,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class AccountsUpdateLabelsRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class AccountsUpdateLabelsResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class AccountstatusesCustomBatchRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1800,10 +1812,12 @@ module Google
           property :adult_content, as: 'adultContent'
           property :business_information, as: 'businessInformation', class: Google::Apis::ContentV2_1::AccountBusinessInformation, decorator: Google::Apis::ContentV2_1::AccountBusinessInformation::Representation
       
+          property :css_id, :numeric_string => true, as: 'cssId'
           property :google_my_business_link, as: 'googleMyBusinessLink', class: Google::Apis::ContentV2_1::AccountGoogleMyBusinessLink, decorator: Google::Apis::ContentV2_1::AccountGoogleMyBusinessLink::Representation
       
           property :id, :numeric_string => true, as: 'id'
           property :kind, as: 'kind'
+          collection :label_ids, as: 'labelIds'
           property :name, as: 'name'
           property :seller_id, as: 'sellerId'
           collection :users, as: 'users', class: Google::Apis::ContentV2_1::AccountUser, decorator: Google::Apis::ContentV2_1::AccountUser::Representation
@@ -2011,6 +2025,7 @@ module Google
           property :merchant_id, :numeric_string => true, as: 'merchantId'
           property :method_prop, as: 'method'
           property :overwrite, as: 'overwrite'
+          property :view, as: 'view'
         end
       end
       
@@ -2082,6 +2097,20 @@ module Google
         end
       end
       
+      class AccountsUpdateLabelsRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :label_ids, as: 'labelIds'
+        end
+      end
+      
+      class AccountsUpdateLabelsResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :kind, as: 'kind'
+        end
+      end
+      
       class AccountstatusesCustomBatchRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -4215,7 +4244,10 @@ module Google
       class ProductStatusDestinationStatus
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          collection :approved_countrys, as: 'approvedCountrys'
           property :destination, as: 'destination'
+          collection :disapproved_countrys, as: 'disapprovedCountrys'
+          collection :pending_countrys, as: 'pendingCountrys'
           property :status, as: 'status'
         end
       end
@@ -4223,6 +4255,7 @@ module Google
       class ProductStatusItemLevelIssue
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          collection :applicable_countrys, as: 'applicableCountrys'
           property :attribute_name, as: 'attributeName'
           property :code, as: 'code'
           property :description, as: 'description'

generated/google/apis/content_v2_1/service.rb

@@ -204,6 +204,9 @@ module Google
         #   ID of a sub-account of this account.
         # @param [Fixnum] account_id
         #   The ID of the account.
+        # @param [String] view
+        #   Controls which fields will be populated. Acceptable values are: "merchant" and
+        #   "css". The default value is "merchant".
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -223,12 +226,13 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def get_account(merchant_id, account_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def get_account(merchant_id, account_id, view: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           command = make_simple_command(:get, '{merchantId}/accounts/{accountId}', options)
           command.response_representation = Google::Apis::ContentV2_1::Account::Representation
           command.response_class = Google::Apis::ContentV2_1::Account
           command.params['merchantId'] = merchant_id unless merchant_id.nil?
           command.params['accountId'] = account_id unless account_id.nil?
+          command.query['view'] = view unless view.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           command.query['userIp'] = user_ip unless user_ip.nil?
@@ -316,10 +320,16 @@ module Google
         # Lists the sub-accounts in your Merchant Center account.
         # @param [Fixnum] merchant_id
         #   The ID of the managing account. This must be a multi-client account.
+        # @param [Fixnum] label
+        #   If view is set to "css", only return accounts that are assigned label with
+        #   given ID.
         # @param [Fixnum] max_results
         #   The maximum number of accounts to return in the response, used for paging.
         # @param [String] page_token
         #   The token returned by the previous request.
+        # @param [String] view
+        #   Controls which fields will be populated. Acceptable values are: "merchant" and
+        #   "css". The default value is "merchant".
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -339,13 +349,15 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def list_accounts(merchant_id, max_results: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def list_accounts(merchant_id, label: nil, max_results: nil, page_token: nil, view: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           command = make_simple_command(:get, '{merchantId}/accounts', options)
           command.response_representation = Google::Apis::ContentV2_1::AccountsListResponse::Representation
           command.response_class = Google::Apis::ContentV2_1::AccountsListResponse
           command.params['merchantId'] = merchant_id unless merchant_id.nil?
+          command.query['label'] = label unless label.nil?
           command.query['maxResults'] = max_results unless max_results.nil?
           command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['view'] = view unless view.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           command.query['userIp'] = user_ip unless user_ip.nil?
@@ -438,6 +450,45 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Updates labels that are assigned to the Merchant Center account by CSS user.
+        # @param [Fixnum] merchant_id
+        #   The ID of the managing account.
+        # @param [Fixnum] account_id
+        #   The ID of the account whose labels are updated.
+        # @param [Google::Apis::ContentV2_1::AccountsUpdateLabelsRequest] accounts_update_labels_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
+        # @param [String] user_ip
+        #   Deprecated. Please use quotaUser instead.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ContentV2_1::AccountsUpdateLabelsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ContentV2_1::AccountsUpdateLabelsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def updatelabels_account(merchant_id, account_id, accounts_update_labels_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command = make_simple_command(:post, '{merchantId}/accounts/{accountId}/updatelabels', options)
+          command.request_representation = Google::Apis::ContentV2_1::AccountsUpdateLabelsRequest::Representation
+          command.request_object = accounts_update_labels_request_object
+          command.response_representation = Google::Apis::ContentV2_1::AccountsUpdateLabelsResponse::Representation
+          command.response_class = Google::Apis::ContentV2_1::AccountsUpdateLabelsResponse
+          command.params['merchantId'] = merchant_id unless merchant_id.nil?
+          command.params['accountId'] = account_id unless account_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          command.query['userIp'] = user_ip unless user_ip.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Retrieves multiple Merchant Center account statuses in a single request.
         # @param [Google::Apis::ContentV2_1::AccountstatusesCustomBatchRequest] accountstatuses_custom_batch_request_object
         # @param [String] fields

generated/google/apis/documentai_v1beta2.rb

@@ -27,7 +27,7 @@ module Google
     # @see https://cloud.google.com/document-ai/docs/
     module DocumentaiV1beta2
       VERSION = 'V1beta2'
-      REVISION = '20200619'
+      REVISION = '20200807'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/documentai_v1beta2/representations.rb

@@ -22,6 +22,60 @@ module Google
   module Apis
     module DocumentaiV1beta2
       
+      class GoogleCloudDocumentaiUiv1beta3CreateLabelerPoolOperationMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudDocumentaiUiv1beta3CreateProcessorVersionMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudDocumentaiUiv1beta3DeleteLabelerPoolOperationMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudDocumentaiUiv1beta3DeleteProcessorMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudDocumentaiUiv1beta3DisableProcessorMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudDocumentaiUiv1beta3DisableProcessorResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudDocumentaiUiv1beta3EnableProcessorMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudDocumentaiUiv1beta3EnableProcessorResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudDocumentaiUiv1beta3UpdateLabelerPoolOperationMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudDocumentaiV1beta1BatchProcessDocumentsResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -46,6 +100,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudDocumentaiV1beta1DocumentEntityNormalizedValue
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudDocumentaiV1beta1DocumentEntityRelation
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -256,6 +316,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudDocumentaiV1beta2DocumentEntityNormalizedValue
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudDocumentaiV1beta2DocumentEntityRelation
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -478,12 +544,36 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudDocumentaiV1beta3BatchProcessMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudDocumentaiV1beta3BatchProcessMetadataIndividualProcessStatus
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudDocumentaiV1beta3BatchProcessResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleLongrunningOperation
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleProtobufEmpty
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleRpcStatus
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -496,6 +586,111 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleTypeDate
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleTypeDateTime
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleTypeMoney
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleTypeTimeZone
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudDocumentaiUiv1beta3CreateLabelerPoolOperationMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :create_time, as: 'createTime'
+          property :state, as: 'state'
+          property :state_message, as: 'stateMessage'
+          property :update_time, as: 'updateTime'
+        end
+      end
+      
+      class GoogleCloudDocumentaiUiv1beta3CreateProcessorVersionMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :create_time, as: 'createTime'
+          property :state, as: 'state'
+          property :update_time, as: 'updateTime'
+        end
+      end
+      
+      class GoogleCloudDocumentaiUiv1beta3DeleteLabelerPoolOperationMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :create_time, as: 'createTime'
+          property :state, as: 'state'
+          property :state_message, as: 'stateMessage'
+          property :update_time, as: 'updateTime'
+        end
+      end
+      
+      class GoogleCloudDocumentaiUiv1beta3DeleteProcessorMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :create_time, as: 'createTime'
+          property :state, as: 'state'
+          property :state_message, as: 'stateMessage'
+          property :update_time, as: 'updateTime'
+        end
+      end
+      
+      class GoogleCloudDocumentaiUiv1beta3DisableProcessorMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :create_time, as: 'createTime'
+          property :state, as: 'state'
+          property :state_message, as: 'stateMessage'
+          property :update_time, as: 'updateTime'
+        end
+      end
+      
+      class GoogleCloudDocumentaiUiv1beta3DisableProcessorResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
+      class GoogleCloudDocumentaiUiv1beta3EnableProcessorMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :create_time, as: 'createTime'
+          property :state, as: 'state'
+          property :state_message, as: 'stateMessage'
+          property :update_time, as: 'updateTime'
+        end
+      end
+      
+      class GoogleCloudDocumentaiUiv1beta3EnableProcessorResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
+      class GoogleCloudDocumentaiUiv1beta3UpdateLabelerPoolOperationMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :create_time, as: 'createTime'
+          property :state, as: 'state'
+          property :state_message, as: 'stateMessage'
+          property :update_time, as: 'updateTime'
+        end
+      end
+      
       class GoogleCloudDocumentaiV1beta1BatchProcessDocumentsResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -544,12 +739,28 @@ module Google
           property :confidence, as: 'confidence'
           property :mention_id, as: 'mentionId'
           property :mention_text, as: 'mentionText'
+          property :normalized_value, as: 'normalizedValue', class: Google::Apis::DocumentaiV1beta2::GoogleCloudDocumentaiV1beta1DocumentEntityNormalizedValue, decorator: Google::Apis::DocumentaiV1beta2::GoogleCloudDocumentaiV1beta1DocumentEntityNormalizedValue::Representation
+      
+          property :redacted, as: 'redacted'
           property :text_anchor, as: 'textAnchor', class: Google::Apis::DocumentaiV1beta2::GoogleCloudDocumentaiV1beta1DocumentTextAnchor, decorator: Google::Apis::DocumentaiV1beta2::GoogleCloudDocumentaiV1beta1DocumentTextAnchor::Representation
       
           property :type, as: 'type'
         end
       end
       
+      class GoogleCloudDocumentaiV1beta1DocumentEntityNormalizedValue
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :date_value, as: 'dateValue', class: Google::Apis::DocumentaiV1beta2::GoogleTypeDate, decorator: Google::Apis::DocumentaiV1beta2::GoogleTypeDate::Representation
+      
+          property :datetime_value, as: 'datetimeValue', class: Google::Apis::DocumentaiV1beta2::GoogleTypeDateTime, decorator: Google::Apis::DocumentaiV1beta2::GoogleTypeDateTime::Representation
+      
+          property :money_value, as: 'moneyValue', class: Google::Apis::DocumentaiV1beta2::GoogleTypeMoney, decorator: Google::Apis::DocumentaiV1beta2::GoogleTypeMoney::Representation
+      
+          property :text, as: 'text'
+        end
+      end
+      
       class GoogleCloudDocumentaiV1beta1DocumentEntityRelation
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -916,12 +1127,28 @@ module Google
           property :confidence, as: 'confidence'
           property :mention_id, as: 'mentionId'
           property :mention_text, as: 'mentionText'
+          property :normalized_value, as: 'normalizedValue', class: Google::Apis::DocumentaiV1beta2::GoogleCloudDocumentaiV1beta2DocumentEntityNormalizedValue, decorator: Google::Apis::DocumentaiV1beta2::GoogleCloudDocumentaiV1beta2DocumentEntityNormalizedValue::Representation
+      
+          property :redacted, as: 'redacted'
           property :text_anchor, as: 'textAnchor', class: Google::Apis::DocumentaiV1beta2::GoogleCloudDocumentaiV1beta2DocumentTextAnchor, decorator: Google::Apis::DocumentaiV1beta2::GoogleCloudDocumentaiV1beta2DocumentTextAnchor::Representation
       
           property :type, as: 'type'
         end
       end
       
+      class GoogleCloudDocumentaiV1beta2DocumentEntityNormalizedValue
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :date_value, as: 'dateValue', class: Google::Apis::DocumentaiV1beta2::GoogleTypeDate, decorator: Google::Apis::DocumentaiV1beta2::GoogleTypeDate::Representation
+      
+          property :datetime_value, as: 'datetimeValue', class: Google::Apis::DocumentaiV1beta2::GoogleTypeDateTime, decorator: Google::Apis::DocumentaiV1beta2::GoogleTypeDateTime::Representation
+      
+          property :money_value, as: 'moneyValue', class: Google::Apis::DocumentaiV1beta2::GoogleTypeMoney, decorator: Google::Apis::DocumentaiV1beta2::GoogleTypeMoney::Representation
+      
+          property :text, as: 'text'
+        end
+      end
+      
       class GoogleCloudDocumentaiV1beta2DocumentEntityRelation
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1309,6 +1536,34 @@ module Google
         end
       end
       
+      class GoogleCloudDocumentaiV1beta3BatchProcessMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :create_time, as: 'createTime'
+          collection :individual_process_statuses, as: 'individualProcessStatuses', class: Google::Apis::DocumentaiV1beta2::GoogleCloudDocumentaiV1beta3BatchProcessMetadataIndividualProcessStatus, decorator: Google::Apis::DocumentaiV1beta2::GoogleCloudDocumentaiV1beta3BatchProcessMetadataIndividualProcessStatus::Representation
+      
+          property :state, as: 'state'
+          property :state_message, as: 'stateMessage'
+          property :update_time, as: 'updateTime'
+        end
+      end
+      
+      class GoogleCloudDocumentaiV1beta3BatchProcessMetadataIndividualProcessStatus
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :input_gcs_source, as: 'inputGcsSource'
+          property :output_gcs_destination, as: 'outputGcsDestination'
+          property :status, as: 'status', class: Google::Apis::DocumentaiV1beta2::GoogleRpcStatus, decorator: Google::Apis::DocumentaiV1beta2::GoogleRpcStatus::Representation
+      
+        end
+      end
+      
+      class GoogleCloudDocumentaiV1beta3BatchProcessResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
       class GoogleLongrunningOperation
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1321,6 +1576,12 @@ module Google
         end
       end
       
+      class GoogleProtobufEmpty
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
       class GoogleRpcStatus
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -1339,6 +1600,48 @@ module Google
           property :red, as: 'red'
         end
       end
+      
+      class GoogleTypeDate
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :day, as: 'day'
+          property :month, as: 'month'
+          property :year, as: 'year'
+        end
+      end
+      
+      class GoogleTypeDateTime
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :day, as: 'day'
+          property :hours, as: 'hours'
+          property :minutes, as: 'minutes'
+          property :month, as: 'month'
+          property :nanos, as: 'nanos'
+          property :seconds, as: 'seconds'
+          property :time_zone, as: 'timeZone', class: Google::Apis::DocumentaiV1beta2::GoogleTypeTimeZone, decorator: Google::Apis::DocumentaiV1beta2::GoogleTypeTimeZone::Representation
+      
+          property :utc_offset, as: 'utcOffset'
+          property :year, as: 'year'
+        end
+      end
+      
+      class GoogleTypeMoney
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :currency_code, as: 'currencyCode'
+          property :nanos, as: 'nanos'
+          property :units, :numeric_string => true, as: 'units'
+        end
+      end
+      
+      class GoogleTypeTimeZone
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :id, as: 'id'
+          property :version, as: 'version'
+        end
+      end
     end
   end
 end

generated/google/apis/documentai_v1beta2/service.rb

@@ -49,12 +49,12 @@ module Google
           @batch_path = 'batch'
         end
         
-        # LRO endpoint to batch process many documents. The output is written
+        # LRO endpoint to batch process many documents. The output is written to Cloud
-        # to Cloud Storage as JSON in the [Document] format.
+        # Storage as JSON in the [Document] format.
         # @param [String] parent
-        #   Target project and location to make a call.
+        #   Target project and location to make a call. Format: `projects/`project-id`/
-        #   Format: `projects/`project-id`/locations/`location-id``.
+        #   locations/`location-id``. If no location is specified, a region will be chosen
-        #   If no location is specified, a region will be chosen automatically.
+        #   automatically.
         # @param [Google::Apis::DocumentaiV1beta2::GoogleCloudDocumentaiV1beta2BatchProcessDocumentsRequest] google_cloud_documentai_v1beta2_batch_process_documents_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -87,10 +87,10 @@ module Google
         
         # Processes a single document.
         # @param [String] parent
-        #   Target project and location to make a call.
+        #   Target project and location to make a call. Format: `projects/`project-id`/
-        #   Format: `projects/`project-id`/locations/`location-id``.
+        #   locations/`location-id``. If no location is specified, a region will be chosen
-        #   If no location is specified, a region will be chosen automatically.
+        #   automatically. This field is only populated when used in ProcessDocument
-        #   This field is only populated when used in ProcessDocument method.
+        #   method.
         # @param [Google::Apis::DocumentaiV1beta2::GoogleCloudDocumentaiV1beta2ProcessDocumentRequest] google_cloud_documentai_v1beta2_process_document_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -121,12 +121,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # LRO endpoint to batch process many documents. The output is written
+        # LRO endpoint to batch process many documents. The output is written to Cloud
-        # to Cloud Storage as JSON in the [Document] format.
+        # Storage as JSON in the [Document] format.
         # @param [String] parent
-        #   Target project and location to make a call.
+        #   Target project and location to make a call. Format: `projects/`project-id`/
-        #   Format: `projects/`project-id`/locations/`location-id``.
+        #   locations/`location-id``. If no location is specified, a region will be chosen
-        #   If no location is specified, a region will be chosen automatically.
+        #   automatically.
         # @param [Google::Apis::DocumentaiV1beta2::GoogleCloudDocumentaiV1beta2BatchProcessDocumentsRequest] google_cloud_documentai_v1beta2_batch_process_documents_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -159,10 +159,10 @@ module Google
         
         # Processes a single document.
         # @param [String] parent
-        #   Target project and location to make a call.
+        #   Target project and location to make a call. Format: `projects/`project-id`/
-        #   Format: `projects/`project-id`/locations/`location-id``.
+        #   locations/`location-id``. If no location is specified, a region will be chosen
-        #   If no location is specified, a region will be chosen automatically.
+        #   automatically. This field is only populated when used in ProcessDocument
-        #   This field is only populated when used in ProcessDocument method.
+        #   method.
         # @param [Google::Apis::DocumentaiV1beta2::GoogleCloudDocumentaiV1beta2ProcessDocumentRequest] google_cloud_documentai_v1beta2_process_document_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -193,9 +193,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the latest state of a long-running operation.  Clients can use this
+        # Gets the latest state of a long-running operation. Clients can use this method
-        # method to poll the operation result at intervals as recommended by the API
+        # to poll the operation result at intervals as recommended by the API service.
-        # service.
         # @param [String] name
         #   The name of the operation resource.
         # @param [String] fields
@@ -225,9 +224,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the latest state of a long-running operation.  Clients can use this
+        # Gets the latest state of a long-running operation. Clients can use this method
-        # method to poll the operation result at intervals as recommended by the API
+        # to poll the operation result at intervals as recommended by the API service.
-        # service.
         # @param [String] name
         #   The name of the operation resource.
         # @param [String] fields

generated/google/apis/firebasehosting_v1beta1.rb

@@ -27,7 +27,7 @@ module Google
     # @see https://firebase.google.com/docs/hosting/
     module FirebasehostingV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20200731'
+      REVISION = '20200811'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/firebasehosting_v1beta1/classes.rb

@@ -324,6 +324,26 @@ module Google
         end
       end
       
+      # If provided, i18n rewrites are enabled.
+      class I18nConfig
+        include Google::Apis::Core::Hashable
+      
+        # Required. The user-supplied path where country and language specific content
+        # will be looked for within the public directory.
+        # Corresponds to the JSON property `root`
+        # @return [String]
+        attr_accessor :root
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @root = args[:root] if args.key?(:root)
+        end
+      end
+      
       # The response to listing Domains.
       class ListDomainsResponse
         include Google::Apis::Core::Hashable
@@ -752,6 +772,11 @@ module Google
         # @return [Array<Google::Apis::FirebasehostingV1beta1::Header>]
         attr_accessor :headers
       
+        # If provided, i18n rewrites are enabled.
+        # Corresponds to the JSON property `i18n`
+        # @return [Google::Apis::FirebasehostingV1beta1::I18nConfig]
+        attr_accessor :i18n
+      
         # An array of objects (called redirect rules), where each rule specifies a URL
         # pattern that, if matched to the request URL path, triggers Hosting to respond
         # with a redirect to the specified destination path.
@@ -780,6 +805,7 @@ module Google
           @app_association = args[:app_association] if args.key?(:app_association)
           @clean_urls = args[:clean_urls] if args.key?(:clean_urls)
           @headers = args[:headers] if args.key?(:headers)
+          @i18n = args[:i18n] if args.key?(:i18n)
           @redirects = args[:redirects] if args.key?(:redirects)
           @rewrites = args[:rewrites] if args.key?(:rewrites)
           @trailing_slash_behavior = args[:trailing_slash_behavior] if args.key?(:trailing_slash_behavior)

generated/google/apis/firebasehosting_v1beta1/representations.rb

@@ -76,6 +76,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class I18nConfig
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ListDomainsResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -257,6 +263,13 @@ module Google
         end
       end
       
+      class I18nConfig
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :root, as: 'root'
+        end
+      end
+      
       class ListDomainsResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -372,6 +385,8 @@ module Google
           property :clean_urls, as: 'cleanUrls'
           collection :headers, as: 'headers', class: Google::Apis::FirebasehostingV1beta1::Header, decorator: Google::Apis::FirebasehostingV1beta1::Header::Representation
       
+          property :i18n, as: 'i18n', class: Google::Apis::FirebasehostingV1beta1::I18nConfig, decorator: Google::Apis::FirebasehostingV1beta1::I18nConfig::Representation
+      
           collection :redirects, as: 'redirects', class: Google::Apis::FirebasehostingV1beta1::Redirect, decorator: Google::Apis::FirebasehostingV1beta1::Redirect::Representation
       
           collection :rewrites, as: 'rewrites', class: Google::Apis::FirebasehostingV1beta1::Rewrite, decorator: Google::Apis::FirebasehostingV1beta1::Rewrite::Representation

generated/google/apis/games_configuration_v1configuration.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://developers.google.com/games/
     module GamesConfigurationV1configuration
       VERSION = 'V1configuration'
-      REVISION = '20200720'
+      REVISION = '20200811'
 
       # View and manage your Google Play Developer account
       AUTH_ANDROIDPUBLISHER = 'https://www.googleapis.com/auth/androidpublisher'

generated/google/apis/games_configuration_v1configuration/classes.rb

@@ -57,7 +57,7 @@ module Google
         # @return [Google::Apis::GamesConfigurationV1configuration::AchievementConfigurationDetail]
         attr_accessor :published
       
-        # Steps to unlock.  Only applicable to incremental achievements.
+        # Steps to unlock. Only applicable to incremental achievements.
         # Corresponds to the JSON property `stepsToUnlock`
         # @return [Fixnum]
         attr_accessor :steps_to_unlock
@@ -406,8 +406,7 @@ module Google
         attr_accessor :items
       
         # Uniquely identifies the type of this resource. Value is always the fixed
-        # string
+        # string `gamesConfiguration#leaderboardConfigurationListResponse`.
-        # `gamesConfiguration#leaderboardConfigurationListResponse`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind

generated/google/apis/games_configuration_v1configuration/service.rb

@@ -143,9 +143,9 @@ module Google
         # @param [String] application_id
         #   The application ID from the Google Play developer console.
         # @param [Fixnum] max_results
-        #   The maximum number of resource configurations to return in the response,
+        #   The maximum number of resource configurations to return in the response, used
-        #   used for paging. For any response, the actual number of resources returned
+        #   for paging. For any response, the actual number of resources returned may be
-        #   may be less than the specified `maxResults`.
+        #   less than the specified `maxResults`.
         # @param [String] page_token
         #   The token returned by the previous request.
         # @param [String] fields
@@ -348,9 +348,9 @@ module Google
         # @param [String] application_id
         #   The application ID from the Google Play developer console.
         # @param [Fixnum] max_results
-        #   The maximum number of resource configurations to return in the response,
+        #   The maximum number of resource configurations to return in the response, used
-        #   used for paging. For any response, the actual number of resources returned
+        #   for paging. For any response, the actual number of resources returned may be
-        #   may be less than the specified `maxResults`.
+        #   less than the specified `maxResults`.
         # @param [String] page_token
         #   The token returned by the previous request.
         # @param [String] fields

generated/google/apis/games_management_v1management.rb

@@ -21,13 +21,12 @@ module Google
     # Google Play Game Management
     #
     # The Google Play Game Management API allows developers to manage resources from
-    # the Google
+    # the Google Play Game service.
-    # Play Game service.
     #
     # @see https://developers.google.com/games/
     module GamesManagementV1management
       VERSION = 'V1management'
-      REVISION = '20200720'
+      REVISION = '20200811'
 
       # Create, edit, and delete your Google Play Games activity
       AUTH_GAMES = 'https://www.googleapis.com/auth/games'

generated/google/apis/games_management_v1management/classes.rb

@@ -78,11 +78,10 @@ module Google
       class AchievementResetResponse
         include Google::Apis::Core::Hashable
       
-        # The current state of the achievement.  This is the same as the initial
+        # The current state of the achievement. This is the same as the initial state of
-        # state of the achievement. <br/>Possible values are: <ul>
+        # the achievement. Possible values are: - "`HIDDEN`"- Achievement is hidden. - "`
-        # <li>"`HIDDEN`"- Achievement is hidden.</li>
+        # REVEALED`" - Achievement is revealed. - "`UNLOCKED`" - Achievement is unlocked.
-        # <li>"`REVEALED`" - Achievement is revealed.</li>
+        # 
-        # <li>"`UNLOCKED`" - Achievement is unlocked.</li> </ul>
         # Corresponds to the JSON property `currentState`
         # @return [String]
         attr_accessor :current_state
@@ -157,8 +156,7 @@ module Google
         # @return [Google::Apis::GamesManagementV1management::GamesPlayerLevelResource]
         attr_accessor :current_level
       
-        # The timestamp when the player was leveled up, in millis since Unix epoch
+        # The timestamp when the player was leveled up, in millis since Unix epoch UTC.
-        # UTC.
         # Corresponds to the JSON property `lastLevelUpTimestampMillis`
         # @return [Fixnum]
         attr_accessor :last_level_up_timestamp_millis
@@ -222,8 +220,7 @@ module Google
         attr_accessor :hidden_time_millis
       
         # Output only. Uniquely identifies the type of this resource. Value is always
-        # the fixed
+        # the fixed string `gamesManagement#hiddenPlayer`.
-        # string `gamesManagement#hiddenPlayer`.
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
@@ -319,9 +316,9 @@ module Google
         attr_accessor :name
       
         # The player ID that was used for this player the first time they signed into
-        # the game in question. This is only populated for calls to player.get for
+        # the game in question. This is only populated for calls to player.get for the
-        # the requesting player, only if the player ID has subsequently changed, and
+        # requesting player, only if the player ID has subsequently changed, and only to
-        # only to clients that support remapping player IDs.
+        # clients that support remapping player IDs.
         # Corresponds to the JSON property `originalPlayerId`
         # @return [String]
         attr_accessor :original_player_id
@@ -365,14 +362,12 @@ module Google
         class Name
           include Google::Apis::Core::Hashable
         
-          # The family name of this player. In some places, this is known as the last
+          # The family name of this player. In some places, this is known as the last name.
-          # name.
           # Corresponds to the JSON property `familyName`
           # @return [String]
           attr_accessor :family_name
         
-          # The given name of this player. In some places, this is known as the first
+          # The given name of this player. In some places, this is known as the first name.
-          # name.
           # Corresponds to the JSON property `givenName`
           # @return [String]
           attr_accessor :given_name
@@ -430,10 +425,9 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # The time spans of the updated score. <br/>Possible values are: <ul>
+        # The time spans of the updated score. Possible values are: - "`ALL_TIME`" - The
-        # <li>"`ALL_TIME`" - The score is an all-time score.</li>
+        # score is an all-time score. - "`WEEKLY`" - The score is a weekly score. - "`
-        # <li>"`WEEKLY`" - The score is a weekly score.</li>
+        # DAILY`" - The score is a daily score.
-        # <li>"`DAILY`" - The score is a daily score.</li> </ul>
         # Corresponds to the JSON property `resetScoreTimeSpans`
         # @return [Array<String>]
         attr_accessor :reset_score_time_spans

generated/google/apis/games_management_v1management/service.rb

@@ -23,8 +23,7 @@ module Google
       # Google Play Game Management
       #
       # The Google Play Game Management API allows developers to manage resources from
-      #  the Google
+      #  the Google Play Game service.
-      #  Play Game service.
       #
       # @example
       #    require 'google/apis/games_management_v1management'
@@ -50,8 +49,8 @@ module Google
         end
         
         # Resets the achievement with the given ID for the currently authenticated
-        # player. This method is only accessible to whitelisted tester accounts for
+        # player. This method is only accessible to whitelisted tester accounts for your
-        # your application.
+        # application.
         # @param [String] achievement_id
         #   The ID of the achievement used by this method.
         # @param [String] fields
@@ -82,8 +81,8 @@ module Google
         end
         
         # Resets all achievements for the currently authenticated player for your
-        # application. This method is only accessible to whitelisted tester accounts
+        # application. This method is only accessible to whitelisted tester accounts for
-        # for your application.
+        # your application.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -110,8 +109,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Resets all draft achievements for all players. This method is only
+        # Resets all draft achievements for all players. This method is only available
-        # available to user accounts for your developer console.
+        # to user accounts for your developer console.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -136,9 +135,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Resets the achievement with the given ID for all players. This method is
+        # Resets the achievement with the given ID for all players. This method is only
-        # only available to user accounts for your developer console. Only draft
+        # available to user accounts for your developer console. Only draft achievements
-        # achievements can be reset.
+        # can be reset.
         # @param [String] achievement_id
         #   The ID of the achievement used by this method.
         # @param [String] fields
@@ -167,8 +166,8 @@ module Google
         end
         
         # Resets achievements with the given IDs for all players. This method is only
-        # available to user accounts for your developer console. Only draft
+        # available to user accounts for your developer console. Only draft achievements
-        # achievements may be reset.
+        # may be reset.
         # @param [Google::Apis::GamesManagementV1management::AchievementResetMultipleForAllRequest] achievement_reset_multiple_for_all_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -196,14 +195,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Get the list of players hidden from the given application. This method is
+        # Get the list of players hidden from the given application. This method is only
-        # only available to user accounts for your developer console.
+        # available to user accounts for your developer console.
         # @param [String] application_id
         #   The application ID from the Google Play developer console.
         # @param [Fixnum] max_results
         #   The maximum number of player resources to return in the response, used for
-        #   paging. For any response, the actual number of player resources returned
+        #   paging. For any response, the actual number of player resources returned may
-        #   may be less than the specified `maxResults`.
+        #   be less than the specified `maxResults`.
         # @param [String] page_token
         #   The token returned by the previous request.
         # @param [String] fields
@@ -266,8 +265,8 @@ module Google
         end
         
         # Resets all player progress on all events for the currently authenticated
-        # player. This method is only accessible to whitelisted tester accounts for
+        # player. This method is only accessible to whitelisted tester accounts for your
-        # your application.
+        # application.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -292,8 +291,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Resets all draft events for all players. This method is only available to
+        # Resets all draft events for all players. This method is only available to user
-        # user accounts for your developer console.
+        # accounts for your developer console.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -319,8 +318,8 @@ module Google
         end
         
         # Resets the event with the given ID for all players. This method is only
-        # available to user accounts for your developer console. Only draft events
+        # available to user accounts for your developer console. Only draft events can
-        # can be reset.
+        # be reset.
         # @param [String] event_id
         #   The ID of the event.
         # @param [String] fields
@@ -349,8 +348,8 @@ module Google
         end
         
         # Resets events with the given IDs for all players. This method is only
-        # available to user accounts for your developer console. Only draft events
+        # available to user accounts for your developer console. Only draft events may
-        # may be reset.
+        # be reset.
         # @param [Google::Apis::GamesManagementV1management::EventsResetMultipleForAllRequest] events_reset_multiple_for_all_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -383,8 +382,8 @@ module Google
         # @param [String] application_id
         #   The application ID from the Google Play developer console.
         # @param [String] player_id
-        #   A player ID. A value of `me` may be used in place of the
+        #   A player ID. A value of `me` may be used in place of the authenticated player'
-        #   authenticated player's ID.
+        #   s ID.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -411,13 +410,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Unhide the given player's leaderboard scores from the given application.
+        # Unhide the given player's leaderboard scores from the given application. This
-        # This method is only available to user accounts for your developer console.
+        # method is only available to user accounts for your developer console.
         # @param [String] application_id
         #   The application ID from the Google Play developer console.
         # @param [String] player_id
-        #   A player ID. A value of `me` may be used in place of the
+        #   A player ID. A value of `me` may be used in place of the authenticated player'
-        #   authenticated player's ID.
+        #   s ID.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -476,9 +475,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Resets all scores for all leaderboards for the currently authenticated
+        # Resets all scores for all leaderboards for the currently authenticated players.
-        # players. This method is only accessible to whitelisted tester accounts for
+        # This method is only accessible to whitelisted tester accounts for your
-        # your application.
+        # application.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -505,8 +504,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Resets scores for all draft leaderboards for all players. This method is
+        # Resets scores for all draft leaderboards for all players. This method is only
-        # only available to user accounts for your developer console.
+        # available to user accounts for your developer console.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user

generated/google/apis/games_v1.rb

@@ -21,13 +21,12 @@ module Google
     # Google Play Game Services
     #
     # The Google Play games service allows developers to enhance games with social
-    # leaderboards,
+    # leaderboards, achievements, game state, sign-in with Google, and more.
-    # achievements, game state, sign-in with Google, and more.
     #
     # @see https://developers.google.com/games/
     module GamesV1
       VERSION = 'V1'
-      REVISION = '20200720'
+      REVISION = '20200811'
 
       # View and manage its own configuration data in your Google Drive
       AUTH_DRIVE_APPDATA = 'https://www.googleapis.com/auth/drive.appdata'

generated/google/apis/games_v1/classes.rb

@@ -56,15 +56,15 @@ module Google
         # @return [String]
         attr_accessor :initial_state
       
-        # Indicates whether the revealed icon image being returned is a default
+        # Indicates whether the revealed icon image being returned is a default image,
-        # image, or is provided by the game.
+        # or is provided by the game.
         # Corresponds to the JSON property `isRevealedIconUrlDefault`
         # @return [Boolean]
         attr_accessor :is_revealed_icon_url_default
         alias_method :is_revealed_icon_url_default?, :is_revealed_icon_url_default
       
-        # Indicates whether the unlocked icon image being returned is a default
+        # Indicates whether the unlocked icon image being returned is a default image,
-        # image, or is game-provided.
+        # or is game-provided.
         # Corresponds to the JSON property `isUnlockedIconUrlDefault`
         # @return [Boolean]
         attr_accessor :is_unlocked_icon_url_default
@@ -165,8 +165,8 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # Whether the current steps for the achievement has reached the number of
+        # Whether the current steps for the achievement has reached the number of steps
-        # steps required to unlock.
+        # required to unlock.
         # Corresponds to the JSON property `newlyUnlocked`
         # @return [Boolean]
         attr_accessor :newly_unlocked
@@ -226,8 +226,8 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # Whether the current steps for the achievement has reached the number of
+        # Whether the current steps for the achievement has reached the number of steps
-        # steps required to unlock.
+        # required to unlock.
         # Corresponds to the JSON property `newlyUnlocked`
         # @return [Boolean]
         attr_accessor :newly_unlocked
@@ -334,8 +334,7 @@ module Google
         # @return [String]
         attr_accessor :achievement_id
       
-        # The payload to request to increment an
+        # The payload to request to increment an achievement.
-        # achievement.
         # Corresponds to the JSON property `incrementPayload`
         # @return [Google::Apis::GamesV1::GamesAchievementIncrement]
         attr_accessor :increment_payload
@@ -346,8 +345,7 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # The payload to request to increment an
+        # The payload to request to increment an achievement.
-        # achievement.
         # Corresponds to the JSON property `setStepsAtLeastPayload`
         # @return [Google::Apis::GamesV1::GamesAchievementSetStepsAtLeast]
         attr_accessor :set_steps_at_least_payload
@@ -733,8 +731,8 @@ module Google
         # @return [String]
         attr_accessor :image_url
       
-        # Indicates whether the icon image being returned is a default image, or is
+        # Indicates whether the icon image being returned is a default image, or is game-
-        # game-provided.
+        # provided.
         # Corresponds to the JSON property `isDefaultImageUrl`
         # @return [Boolean]
         attr_accessor :is_default_image_url
@@ -810,14 +808,13 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # The time when this update period ends, in millis, since 1970 UTC (Unix
+        # The time when this update period ends, in millis, since 1970 UTC (Unix Epoch).
-        # Epoch).
         # Corresponds to the JSON property `periodEndMillis`
         # @return [Fixnum]
         attr_accessor :period_end_millis
       
-        # The time when this update period begins, in millis, since 1970 UTC (Unix
+        # The time when this update period begins, in millis, since 1970 UTC (Unix Epoch)
-        # Epoch).
+        # .
         # Corresponds to the JSON property `periodStartMillis`
         # @return [Fixnum]
         attr_accessor :period_start_millis
@@ -902,8 +899,8 @@ module Google
       class EventRecordRequest
         include Google::Apis::Core::Hashable
       
-        # The current time when this update was sent, in milliseconds, since 1970 UTC
+        # The current time when this update was sent, in milliseconds, since 1970 UTC (
-        # (Unix Epoch).
+        # Unix Epoch).
         # Corresponds to the JSON property `currentTimeMillis`
         # @return [Fixnum]
         attr_accessor :current_time_millis
@@ -1007,8 +1004,7 @@ module Google
         end
       end
       
-      # The payload to request to increment an
+      # The payload to request to increment an achievement.
-      # achievement.
       class GamesAchievementIncrement
         include Google::Apis::Core::Hashable
       
@@ -1040,8 +1036,7 @@ module Google
         end
       end
       
-      # The payload to request to increment an
+      # The payload to request to increment an achievement.
-      # achievement.
       class GamesAchievementSetStepsAtLeast
         include Google::Apis::Core::Hashable
       
@@ -1330,8 +1325,8 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # Indicates whether the icon image being returned is a default image, or is
+        # Indicates whether the icon image being returned is a default image, or is game-
-        # game-provided.
+        # provided.
         # Corresponds to the JSON property `isIconUrlDefault`
         # @return [Boolean]
         attr_accessor :is_icon_url_default
@@ -1398,8 +1393,8 @@ module Google
         # @return [Fixnum]
         attr_accessor :score_rank
       
-        # Additional information about the score.  Values must contain no more than
+        # Additional information about the score. Values must contain no more than 64
-        # 64 URI-safe characters as defined by section 2.3 of RFC 3986.
+        # URI-safe characters as defined by section 2.3 of RFC 3986.
         # Corresponds to the JSON property `scoreTag`
         # @return [String]
         attr_accessor :score_tag
@@ -1568,8 +1563,8 @@ module Google
       class MetagameConfig
         include Google::Apis::Core::Hashable
       
-        # Current version of the metagame configuration data. When this data is
+        # Current version of the metagame configuration data. When this data is updated,
-        # updated, the version number will be increased by one.
+        # the version number will be increased by one.
         # Corresponds to the JSON property `currentVersion`
         # @return [Fixnum]
         attr_accessor :current_version
@@ -1644,9 +1639,9 @@ module Google
         attr_accessor :name
       
         # The player ID that was used for this player the first time they signed into
-        # the game in question. This is only populated for calls to player.get for
+        # the game in question. This is only populated for calls to player.get for the
-        # the requesting player, only if the player ID has subsequently changed, and
+        # requesting player, only if the player ID has subsequently changed, and only to
-        # only to clients that support remapping player IDs.
+        # clients that support remapping player IDs.
         # Corresponds to the JSON property `originalPlayerId`
         # @return [String]
         attr_accessor :original_player_id
@@ -1690,14 +1685,12 @@ module Google
         class Name
           include Google::Apis::Core::Hashable
         
-          # The family name of this player. In some places, this is known as the last
+          # The family name of this player. In some places, this is known as the last name.
-          # name.
           # Corresponds to the JSON property `familyName`
           # @return [String]
           attr_accessor :family_name
         
-          # The given name of this player. In some places, this is known as the first
+          # The given name of this player. In some places, this is known as the first name.
-          # name.
           # Corresponds to the JSON property `givenName`
           # @return [String]
           attr_accessor :given_name
@@ -1729,8 +1722,8 @@ module Google
         attr_accessor :current_steps
       
         # Experience points earned for the achievement. This field is absent for
-        # achievements that have not yet been unlocked and 0 for achievements that
+        # achievements that have not yet been unlocked and 0 for achievements that have
-        # have been unlocked by testers but that are unpublished.
+        # been unlocked by testers but that are unpublished.
         # Corresponds to the JSON property `experiencePoints`
         # @return [Fixnum]
         attr_accessor :experience_points
@@ -1902,8 +1895,7 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # The timestamp when the player was leveled up, in millis since Unix epoch
+        # The timestamp when the player was leveled up, in millis since Unix epoch UTC.
-        # UTC.
         # Corresponds to the JSON property `lastLevelUpTimestampMillis`
         # @return [Fixnum]
         attr_accessor :last_level_up_timestamp_millis
@@ -1931,6 +1923,11 @@ module Google
       class PlayerLeaderboardScore
         include Google::Apis::Core::Hashable
       
+        # A score rank in a leaderboard.
+        # Corresponds to the JSON property `friendsRank`
+        # @return [Google::Apis::GamesV1::LeaderboardScoreRank]
+        attr_accessor :friends_rank
+      
         # Uniquely identifies the type of this resource. Value is always the fixed
         # string `games#playerLeaderboardScore`.
         # Corresponds to the JSON property `kind`
@@ -1952,8 +1949,8 @@ module Google
         # @return [String]
         attr_accessor :score_string
       
-        # Additional information about the score.  Values must contain no more than
+        # Additional information about the score. Values must contain no more than 64
-        # 64 URI-safe characters as defined by section 2.3 of RFC 3986.
+        # URI-safe characters as defined by section 2.3 of RFC 3986.
         # Corresponds to the JSON property `scoreTag`
         # @return [String]
         attr_accessor :score_tag
@@ -1985,6 +1982,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @friends_rank = args[:friends_rank] if args.key?(:friends_rank)
           @kind = args[:kind] if args.key?(:kind)
           @leaderboard_id = args[:leaderboard_id] if args.key?(:leaderboard_id)
           @public_rank = args[:public_rank] if args.key?(:public_rank)
@@ -2125,8 +2123,8 @@ module Google
         # @return [Fixnum]
         attr_accessor :score
       
-        # Additional information about this score.  Values will contain no more than
+        # Additional information about this score. Values will contain no more than 64
-        # 64 URI-safe characters as defined by section 2.3 of RFC 3986.
+        # URI-safe characters as defined by section 2.3 of RFC 3986.
         # Corresponds to the JSON property `scoreTag`
         # @return [String]
         attr_accessor :score_tag
@@ -2180,8 +2178,8 @@ module Google
       class PlayerScoreResponse
         include Google::Apis::Core::Hashable
       
-        # The time spans where the submitted score is better than the existing score
+        # The time spans where the submitted score is better than the existing score for
-        # for that time span.
+        # that time span.
         # Corresponds to the JSON property `beatenScoreTimeSpans`
         # @return [Array<String>]
         attr_accessor :beaten_score_time_spans
@@ -2202,16 +2200,15 @@ module Google
         # @return [String]
         attr_accessor :leaderboard_id
       
-        # Additional information about this score.  Values will contain no more than
+        # Additional information about this score. Values will contain no more than 64
-        # 64 URI-safe characters as defined by section 2.3 of RFC 3986.
+        # URI-safe characters as defined by section 2.3 of RFC 3986.
         # Corresponds to the JSON property `scoreTag`
         # @return [String]
         attr_accessor :score_tag
       
-        # The scores in time spans that have not been beaten.  As an example, the
+        # The scores in time spans that have not been beaten. As an example, the
-        # submitted score may be better than the
+        # submitted score may be better than the player's `DAILY` score, but not better
-        # player's `DAILY` score, but not better than the player's scores
+        # than the player's scores for the `WEEKLY` or `ALL_TIME` time spans.
-        # for the `WEEKLY` or `ALL_TIME` time spans.
         # Corresponds to the JSON property `unbeatenScores`
         # @return [Array<Google::Apis::GamesV1::PlayerScore>]
         attr_accessor :unbeaten_scores
@@ -2343,14 +2340,14 @@ module Google
         # @return [Fixnum]
         attr_accessor :score
       
-        # Additional information about this score.  Values will contain no more than
+        # Additional information about this score. Values will contain no more than 64
-        # 64 URI-safe characters as defined by section 2.3 of RFC 3986.
+        # URI-safe characters as defined by section 2.3 of RFC 3986.
         # Corresponds to the JSON property `scoreTag`
         # @return [String]
         attr_accessor :score_tag
       
-        # Signature Values will contain URI-safe characters as defined by section 2.3
+        # Signature Values will contain URI-safe characters as defined by section 2.3 of
-        # of RFC 3986.
+        # RFC 3986.
         # Corresponds to the JSON property `signature`
         # @return [String]
         attr_accessor :signature
@@ -2383,9 +2380,8 @@ module Google
         # @return [String]
         attr_accessor :description
       
-        # The ID of the file underlying this snapshot in the Drive API.  Only present
+        # The ID of the file underlying this snapshot in the Drive API. Only present if
-        # if the snapshot is a view on a Drive file and the file is owned by the
+        # the snapshot is a view on a Drive file and the file is owned by the caller.
-        # caller.
         # Corresponds to the JSON property `driveId`
         # @return [String]
         attr_accessor :drive_id
@@ -2473,8 +2469,8 @@ module Google
         # @return [String]
         attr_accessor :mime_type
       
-        # The URL of the image. This URL may be invalidated at any time and should
+        # The URL of the image. This URL may be invalidated at any time and should not
-        # not be cached.
+        # be cached.
         # Corresponds to the JSON property `url`
         # @return [String]
         attr_accessor :url
@@ -2513,8 +2509,8 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # Token corresponding to the next page of results. If there are no more
+        # Token corresponding to the next page of results. If there are no more results,
-        # results, the token is omitted.
+        # the token is omitted.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -2541,15 +2537,14 @@ module Google
         # @return [Float]
         attr_accessor :avg_session_length_minutes
       
-        # The probability of the player not returning to play the game in the next
+        # The probability of the player not returning to play the game in the next day.
-        # day. E.g., 0, 0.1, 0.5, ..., 1.0. Not populated if there is not enough
+        # E.g., 0, 0.1, 0.5, ..., 1.0. Not populated if there is not enough information.
-        # information.
         # Corresponds to the JSON property `churn_probability`
         # @return [Float]
         attr_accessor :churn_probability
       
-        # Number of days since the player last played this game. E.g., 0, 1, 5, 10,
+        # Number of days since the player last played this game. E.g., 0, 1, 5, 10, ... .
-        # ... . Not populated if there is not enough information.
+        # Not populated if there is not enough information.
         # Corresponds to the JSON property `days_since_last_played`
         # @return [Fixnum]
         attr_accessor :days_since_last_played
@@ -2567,44 +2562,42 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # Number of in-app purchases made by the player in this game. E.g., 0, 1, 5,
+        # Number of in-app purchases made by the player in this game. E.g., 0, 1, 5, 10,
-        # 10, ... . Not populated if there is not enough information.
+        # ... . Not populated if there is not enough information.
         # Corresponds to the JSON property `num_purchases`
         # @return [Fixnum]
         attr_accessor :num_purchases
       
         # The approximate number of sessions of the player within the last 28 days,
-        # where a session begins when the player is connected to Play Games Services
+        # where a session begins when the player is connected to Play Games Services and
-        # and ends when they are disconnected. E.g., 0, 1, 5, 10, ... . Not populated
+        # ends when they are disconnected. E.g., 0, 1, 5, 10, ... . Not populated if
-        # if there is not enough information.
+        # there is not enough information.
         # Corresponds to the JSON property `num_sessions`
         # @return [Fixnum]
         attr_accessor :num_sessions
       
-        # The approximation of the sessions percentile of the player within the last
+        # The approximation of the sessions percentile of the player within the last 30
-        # 30 days, where a session begins when the player is connected to Play Games
+        # days, where a session begins when the player is connected to Play Games
         # Services and ends when they are disconnected. E.g., 0, 0.25, 0.5, 0.75. Not
         # populated if there is not enough information.
         # Corresponds to the JSON property `num_sessions_percentile`
         # @return [Float]
         attr_accessor :num_sessions_percentile
       
-        # The approximate spend percentile of the player in this game. E.g., 0, 0.25,
+        # The approximate spend percentile of the player in this game. E.g., 0, 0.25, 0.
-        # 0.5, 0.75. Not populated if there is not enough information.
+        # 5, 0.75. Not populated if there is not enough information.
         # Corresponds to the JSON property `spend_percentile`
         # @return [Float]
         attr_accessor :spend_percentile
       
-        # The probability of the player going to spend the game in the next seven
+        # The probability of the player going to spend the game in the next seven days.
-        # days. E.g., 0, 0.25, 0.50, 0.75. Not populated if there is not enough
+        # E.g., 0, 0.25, 0.50, 0.75. Not populated if there is not enough information.
-        # information.
         # Corresponds to the JSON property `spend_probability`
         # @return [Float]
         attr_accessor :spend_probability
       
         # The predicted amount of money that the player going to spend in the next 28
-        # days. E.g., 1, 30, 60, ... . Not populated if there is not enough
+        # days. E.g., 1, 30, 60, ... . Not populated if there is not enough information.
-        # information.
         # Corresponds to the JSON property `total_spend_next_28_days`
         # @return [Float]
         attr_accessor :total_spend_next_28_days

generated/google/apis/games_v1/representations.rb

@@ -892,6 +892,8 @@ module Google
       class PlayerLeaderboardScore
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :friends_rank, as: 'friendsRank', class: Google::Apis::GamesV1::LeaderboardScoreRank, decorator: Google::Apis::GamesV1::LeaderboardScoreRank::Representation
+      
           property :kind, as: 'kind'
           property :leaderboard_id, as: 'leaderboard_id'
           property :public_rank, as: 'publicRank', class: Google::Apis::GamesV1::LeaderboardScoreRank, decorator: Google::Apis::GamesV1::LeaderboardScoreRank::Representation

generated/google/apis/games_v1/service.rb

@@ -23,8 +23,7 @@ module Google
       # Google Play Game Services
       #
       # The Google Play games service allows developers to enhance games with social
-      #  leaderboards,
+      #  leaderboards, achievements, game state, sign-in with Google, and more.
-      #  achievements, game state, sign-in with Google, and more.
       #
       # @example
       #    require 'google/apis/games_v1'
@@ -94,9 +93,9 @@ module Google
         # @param [Fixnum] steps_to_increment
         #   The number of steps to increment.
         # @param [Fixnum] request_id
-        #   A randomly generated numeric ID for each request specified by the caller.
+        #   A randomly generated numeric ID for each request specified by the caller. This
-        #   This number is used at the server to ensure that the request is handled
+        #   number is used at the server to ensure that the request is handled correctly
-        #   correctly across retries.
+        #   across retries.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -126,11 +125,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists the progress for all your application's achievements for the
+        # Lists the progress for all your application's achievements for the currently
-        # currently authenticated player.
+        # authenticated player.
         # @param [String] player_id
-        #   A player ID. A value of `me` may be used in place of the
+        #   A player ID. A value of `me` may be used in place of the authenticated player'
-        #   authenticated player's ID.
+        #   s ID.
         # @param [String] language
         #   The preferred language to use for strings returned by this method.
         # @param [Fixnum] max_results
@@ -140,8 +139,8 @@ module Google
         # @param [String] page_token
         #   The token returned by the previous request.
         # @param [String] state
-        #   Tells the server to return only achievements with the specified state.  If
+        #   Tells the server to return only achievements with the specified state. If this
-        #   this parameter isn't specified, all achievements are returned.
+        #   parameter isn't specified, all achievements are returned.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -173,8 +172,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Sets the state of the achievement with the given ID to
+        # Sets the state of the achievement with the given ID to `REVEALED` for the
-        # `REVEALED` for the currently authenticated player.
+        # currently authenticated player.
         # @param [String] achievement_id
         #   The ID of the achievement used by this method.
         # @param [String] fields
@@ -205,9 +204,9 @@ module Google
         end
         
         # Sets the steps for the currently authenticated player towards unlocking an
-        # achievement. If the steps parameter is less than the current number of
+        # achievement. If the steps parameter is less than the current number of steps
-        # steps that the player already gained for the achievement, the achievement
+        # that the player already gained for the achievement, the achievement is not
-        # is not modified.
+        # modified.
         # @param [String] achievement_id
         #   The ID of the achievement used by this method.
         # @param [Fixnum] steps
@@ -300,10 +299,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves the metadata of the application with the given ID. If the
+        # Retrieves the metadata of the application with the given ID. If the requested
-        # requested application is not available for the specified
+        # application is not available for the specified `platformType`, the returned
-        # `platformType`, the returned response will not include any
+        # response will not include any instance data.
-        # instance data.
         # @param [String] application_id
         #   The application ID from the Google Play developer console.
         # @param [String] language
@@ -339,8 +337,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Indicate that the currently authenticated user is playing your
+        # Indicate that the currently authenticated user is playing your application.
-        # application.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -365,8 +362,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Verifies the auth token provided with this request is for the application
+        # Verifies the auth token provided with this request is for the application with
-        # with the specified ID, and returns the ID of the player it was granted for.
+        # the specified ID, and returns the ID of the player it was granted for.
         # @param [String] application_id
         #   The application ID from the Google Play developer console.
         # @param [String] fields
@@ -396,14 +393,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns a list showing the current progress on events in this application
+        # Returns a list showing the current progress on events in this application for
-        # for the currently authenticated user.
+        # the currently authenticated user.
         # @param [String] language
         #   The preferred language to use for strings returned by this method.
         # @param [Fixnum] max_results
-        #   The maximum number of events to return in the response, used for paging.
+        #   The maximum number of events to return in the response, used for paging. For
-        #   For any response, the actual number of events to return may be less than
+        #   any response, the actual number of events to return may be less than the
-        #   the specified maxResults.
+        #   specified maxResults.
         # @param [String] page_token
         #   The token returned by the previous request.
         # @param [String] fields
@@ -440,8 +437,8 @@ module Google
         #   The preferred language to use for strings returned by this method.
         # @param [Fixnum] max_results
         #   The maximum number of event definitions to return in the response, used for
-        #   paging.  For any response, the actual number of event definitions to return
+        #   paging. For any response, the actual number of event definitions to return may
-        #   may be less than the specified `maxResults`.
+        #   be less than the specified `maxResults`.
         # @param [String] page_token
         #   The token returned by the previous request.
         # @param [String] fields
@@ -473,8 +470,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Records a batch of changes to the number of times events have occurred for
+        # Records a batch of changes to the number of times events have occurred for the
-        # the currently authenticated user of this application.
+        # currently authenticated user of this application.
         # @param [Google::Apis::GamesV1::EventRecordRequest] event_record_request_object
         # @param [String] language
         #   The preferred language to use for strings returned by this method.
@@ -544,9 +541,9 @@ module Google
         # @param [String] language
         #   The preferred language to use for strings returned by this method.
         # @param [Fixnum] max_results
-        #   The maximum number of leaderboards to return in the response.  For any
+        #   The maximum number of leaderboards to return in the response. For any response,
-        #   response, the actual number of leaderboards returned may be less than the
+        #   the actual number of leaderboards returned may be less than the specified `
-        #   specified `maxResults`.
+        #   maxResults`.
         # @param [String] page_token
         #   The token returned by the previous request.
         # @param [String] fields
@@ -605,19 +602,19 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # List play data aggregated per category for the player corresponding to
+        # List play data aggregated per category for the player corresponding to `
-        # `playerId`.
+        # playerId`.
         # @param [String] player_id
-        #   A player ID. A value of `me` may be used in place of the
+        #   A player ID. A value of `me` may be used in place of the authenticated player'
-        #   authenticated player's ID.
+        #   s ID.
         # @param [String] collection
         #   The collection of categories for which data will be returned.
         # @param [String] language
         #   The preferred language to use for strings returned by this method.
         # @param [Fixnum] max_results
-        #   The maximum number of category resources to return in the response, used
+        #   The maximum number of category resources to return in the response, used for
-        #   for paging. For any response, the actual number of category resources
+        #   paging. For any response, the actual number of category resources returned may
-        #   returned may be less than the specified `maxResults`.
+        #   be less than the specified `maxResults`.
         # @param [String] page_token
         #   The token returned by the previous request.
         # @param [String] fields
@@ -651,11 +648,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves the Player resource with the given ID.  To retrieve the player
+        # Retrieves the Player resource with the given ID. To retrieve the player for
-        # for the currently authenticated user, set `playerId` to `me`.
+        # the currently authenticated user, set `playerId` to `me`.
         # @param [String] player_id
-        #   A player ID. A value of `me` may be used in place of the
+        #   A player ID. A value of `me` may be used in place of the authenticated player'
-        #   authenticated player's ID.
+        #   s ID.
         # @param [String] language
         #   The preferred language to use for strings returned by this method.
         # @param [String] fields
@@ -693,8 +690,8 @@ module Google
         #   The preferred language to use for strings returned by this method.
         # @param [Fixnum] max_results
         #   The maximum number of player resources to return in the response, used for
-        #   paging. For any response, the actual number of player resources returned
+        #   paging. For any response, the actual number of player resources returned may
-        #   may be less than the specified `maxResults`.
+        #   be less than the specified `maxResults`.
         # @param [String] page_token
         #   The token returned by the previous request.
         # @param [String] fields
@@ -729,11 +726,10 @@ module Google
         
         # Checks whether the games client is out of date.
         # @param [String] client_revision
-        #   The revision of the client SDK used by your application. Format:
+        #   The revision of the client SDK used by your application. Format: `[
-        #   `[PLATFORM_TYPE]:[VERSION_NUMBER]`. Possible values of `PLATFORM_TYPE` are:
+        #   PLATFORM_TYPE]:[VERSION_NUMBER]`. Possible values of `PLATFORM_TYPE` are: * `
-        #   * `ANDROID` - Client is running the Android SDK.
+        #   ANDROID` - Client is running the Android SDK. * `IOS` - Client is running the
-        #   * `IOS` - Client is running the iOS SDK.
+        #   iOS SDK. * `WEB_APP` - Client is running as a Web App.
-        #   * `WEB_APP` - Client is running as a Web App.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -762,16 +758,15 @@ module Google
         end
         
         # Get high scores, and optionally ranks, in leaderboards for the currently
-        # authenticated player.  For a specific time span, `leaderboardId`
+        # authenticated player. For a specific time span, `leaderboardId` can be set to `
-        # can be set to `ALL` to retrieve data for all leaderboards in a
+        # ALL` to retrieve data for all leaderboards in a given time span. `NOTE: You
-        # given time span.  `NOTE: You cannot ask for 'ALL' leaderboards and
+        # cannot ask for 'ALL' leaderboards and 'ALL' timeSpans in the same request;
-        # 'ALL' timeSpans in the same request; only one parameter may be set to
+        # only one parameter may be set to 'ALL'.
-        # 'ALL'.
         # @param [String] player_id
-        #   A player ID. A value of `me` may be used in place of the
+        #   A player ID. A value of `me` may be used in place of the authenticated player'
-        #   authenticated player's ID.
+        #   s ID.
         # @param [String] leaderboard_id
-        #   The ID of the leaderboard.  Can be set to 'ALL' to retrieve data for all
+        #   The ID of the leaderboard. Can be set to 'ALL' to retrieve data for all
         #   leaderboards for this application.
         # @param [String] time_span
         #   The time span for the scores and ranks you're requesting.
@@ -781,9 +776,9 @@ module Google
         # @param [String] language
         #   The preferred language to use for strings returned by this method.
         # @param [Fixnum] max_results
-        #   The maximum number of leaderboard scores to return in the response.  For
+        #   The maximum number of leaderboard scores to return in the response. For any
-        #   any response, the actual number of leaderboard scores returned may be less
+        #   response, the actual number of leaderboard scores returned may be less than
-        #   than the specified `maxResults`.
+        #   the specified `maxResults`.
         # @param [String] page_token
         #   The token returned by the previous request.
         # @param [String] fields
@@ -829,9 +824,9 @@ module Google
         # @param [String] language
         #   The preferred language to use for strings returned by this method.
         # @param [Fixnum] max_results
-        #   The maximum number of leaderboard scores to return in the response.  For
+        #   The maximum number of leaderboard scores to return in the response. For any
-        #   any response, the actual number of leaderboard scores returned may be less
+        #   response, the actual number of leaderboard scores returned may be less than
-        #   than the specified `maxResults`.
+        #   the specified `maxResults`.
         # @param [String] page_token
         #   The token returned by the previous request.
         # @param [String] fields
@@ -876,16 +871,16 @@ module Google
         # @param [String] language
         #   The preferred language to use for strings returned by this method.
         # @param [Fixnum] max_results
-        #   The maximum number of leaderboard scores to return in the response.  For
+        #   The maximum number of leaderboard scores to return in the response. For any
-        #   any response, the actual number of leaderboard scores returned may be less
+        #   response, the actual number of leaderboard scores returned may be less than
-        #   than the specified `maxResults`.
+        #   the specified `maxResults`.
         # @param [String] page_token
         #   The token returned by the previous request.
         # @param [Fixnum] results_above
-        #   The preferred number of scores to return above the player's score. More
+        #   The preferred number of scores to return above the player's score. More scores
-        #   scores may be returned if the player is at the bottom of the leaderboard;
+        #   may be returned if the player is at the bottom of the leaderboard; fewer may
-        #   fewer may be returned if the player is at the top. Must be less than or
+        #   be returned if the player is at the top. Must be less than or equal to
-        #   equal to maxResults.
+        #   maxResults.
         # @param [Boolean] return_top_if_absent
         #   True if the top scores should be returned when the player is not in the
         #   leaderboard. Defaults to true.
@@ -928,17 +923,16 @@ module Google
         #   The ID of the leaderboard.
         # @param [Fixnum] score
         #   The score you're submitting. The submitted score is ignored if it is worse
-        #   than a previously submitted score, where worse depends on the leaderboard
+        #   than a previously submitted score, where worse depends on the leaderboard sort
-        #   sort order. The meaning of the score value depends on the leaderboard
+        #   order. The meaning of the score value depends on the leaderboard format type.
-        #   format type. For fixed-point, the score represents the raw value.  For
+        #   For fixed-point, the score represents the raw value. For time, the score
-        #   time, the score represents elapsed time in milliseconds.  For currency, the
+        #   represents elapsed time in milliseconds. For currency, the score represents a
-        #   score represents a value in micro units.
+        #   value in micro units.
         # @param [String] language
         #   The preferred language to use for strings returned by this method.
         # @param [String] score_tag
-        #   Additional information about the score you're submitting.  Values must
+        #   Additional information about the score you're submitting. Values must contain
-        #   contain no more than 64 URI-safe characters as defined by section 2.3 of
+        #   no more than 64 URI-safe characters as defined by section 2.3 of RFC 3986.
-        #   RFC 3986.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1038,14 +1032,14 @@ module Google
         # Retrieves a list of snapshots created by your application for the player
         # corresponding to the player ID.
         # @param [String] player_id
-        #   A player ID. A value of `me` may be used in place of the authenticated
+        #   A player ID. A value of `me` may be used in place of the authenticated player'
-        #   player's ID.
+        #   s ID.
         # @param [String] language
         #   The preferred language to use for strings returned by this method.
         # @param [Fixnum] max_results
-        #   The maximum number of snapshot resources to return in the response, used
+        #   The maximum number of snapshot resources to return in the response, used for
-        #   for paging. For any response, the actual number of snapshot resources
+        #   paging. For any response, the actual number of snapshot resources returned may
-        #   returned may be less than the specified `maxResults`.
+        #   be less than the specified `maxResults`.
         # @param [String] page_token
         #   The token returned by the previous request.
         # @param [String] fields
@@ -1078,8 +1072,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns engagement and spend statistics in this application for the
+        # Returns engagement and spend statistics in this application for the currently
-        # currently authenticated user.
+        # authenticated user.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user

generated/google/apis/gmail_v1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://developers.google.com/gmail/api/
     module GmailV1
       VERSION = 'V1'
-      REVISION = '20200803'
+      REVISION = '20200810'
 
       # Read, compose, send, and permanently delete all your email from Gmail
       AUTH_SCOPE = 'https://mail.google.com/'

generated/google/apis/gmail_v1/classes.rb

@@ -514,8 +514,7 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The color to assign to the label. Color is only available for labels that have
-        # their `type` set to `user`. @mutable gmail.users.labels.create gmail.users.
+        # their `type` set to `user`.
-        # labels.update
         # Corresponds to the JSON property `color`
         # @return [Google::Apis::GmailV1::LabelColor]
         attr_accessor :color
@@ -525,14 +524,13 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # The visibility of the label in the label list in the Gmail web interface. @
+        # The visibility of the label in the label list in the Gmail web interface.
-        # mutable gmail.users.labels.create gmail.users.labels.update
         # Corresponds to the JSON property `labelListVisibility`
         # @return [String]
         attr_accessor :label_list_visibility
       
         # The visibility of messages with this label in the message list in the Gmail
-        # web interface. @mutable gmail.users.labels.create gmail.users.labels.update
+        # web interface.
         # Corresponds to the JSON property `messageListVisibility`
         # @return [String]
         attr_accessor :message_list_visibility
@@ -547,8 +545,7 @@ module Google
         # @return [Fixnum]
         attr_accessor :messages_unread
       
-        # The display name of the label. @mutable gmail.users.labels.create gmail.users.
+        # The display name of the label.
-        # labels.update
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -600,40 +597,39 @@ module Google
       
         # The background color represented as hex string #RRGGBB (ex #000000). This
         # field is required in order to set the color of a label. Only the following
-        # predefined set of color values are allowed: # 000000, #434343, #666666, #
+        # predefined set of color values are allowed: \#000000, #434343, #666666, #
-        # 999999, #cccccc, #efefef, #f3f3f3, #ffffff, # fb4c2f, #ffad47, #fad165, #
+        # 999999, #cccccc, #efefef, #f3f3f3, #ffffff, \#fb4c2f, #ffad47, #fad165, #
-        # 16a766, #43d692, #4a86e8, #a479e2, #f691b3, # f6c5be, #ffe6c7, #fef1d1, #
+        # 16a766, #43d692, #4a86e8, #a479e2, #f691b3, \#f6c5be, #ffe6c7, #fef1d1, #
-        # b9e4d0, #c6f3de, #c9daf8, #e4d7f5, #fcdee8, # efa093, #ffd6a2, #fce8b3, #
+        # b9e4d0, #c6f3de, #c9daf8, #e4d7f5, #fcdee8, \#efa093, #ffd6a2, #fce8b3, #
-        # 89d3b2, #a0eac9, #a4c2f4, #d0bcf1, #fbc8d9, # e66550, #ffbc6b, #fcda83, #
+        # 89d3b2, #a0eac9, #a4c2f4, #d0bcf1, #fbc8d9, \#e66550, #ffbc6b, #fcda83, #
-        # 44b984, #68dfa9, #6d9eeb, #b694e8, #f7a7c0, # cc3a21, #eaa041, #f2c960, #
+        # 44b984, #68dfa9, #6d9eeb, #b694e8, #f7a7c0, \#cc3a21, #eaa041, #f2c960, #
-        # 149e60, #3dc789, #3c78d8, #8e63ce, #e07798, # ac2b16, #cf8933, #d5ae49, #
+        # 149e60, #3dc789, #3c78d8, #8e63ce, #e07798, \#ac2b16, #cf8933, #d5ae49, #
-        # 0b804b, #2a9c68, #285bac, #653e9b, #b65775, # 822111, #a46a21, #aa8831, #
+        # 0b804b, #2a9c68, #285bac, #653e9b, #b65775, \#822111, #a46a21, #aa8831, #
-        # 076239, #1a764d, #1c4587, #41236d, #83334c # 464646, #e7e7e7, #0d3472, #b6cff5,
+        # 076239, #1a764d, #1c4587, #41236d, #83334c \#464646, #e7e7e7, #0d3472, #b6cff5,
-        # #0d3b44, #98d7e4, #3d188e, #e3d7ff, # 711a36, #fbd3e0, #8a1c0a, #f2b2a8, #
+        # #0d3b44, #98d7e4, #3d188e, #e3d7ff, \#711a36, #fbd3e0, #8a1c0a, #f2b2a8, #
-        # 7a2e0b, #ffc8af, #7a4706, #ffdeb5, # 594c05, #fbe983, #684e07, #fdedc1, #
+        # 7a2e0b, #ffc8af, #7a4706, #ffdeb5, \#594c05, #fbe983, #684e07, #fdedc1, #
-        # 0b4f30, #b3efd3, #04502e, #a2dcc1, # c2c2c2, #4986e7, #2da2bb, #b99aff, #
+        # 0b4f30, #b3efd3, #04502e, #a2dcc1, \#c2c2c2, #4986e7, #2da2bb, #b99aff, #
-        # 994a64, #f691b2, #ff7537, #ffad46, # 662e37, #ebdbde, #cca6ac, #094228, #
+        # 994a64, #f691b2, #ff7537, #ffad46, \#662e37, #ebdbde, #cca6ac, #094228, #
-        # 42d692, #16a765 @mutable gmail.users.labels.create gmail.users.labels.update
+        # 42d692, #16a765
         # Corresponds to the JSON property `backgroundColor`
         # @return [String]
         attr_accessor :background_color
       
         # The text color of the label, represented as hex string. This field is required
         # in order to set the color of a label. Only the following predefined set of
-        # color values are allowed: # 000000, #434343, #666666, #999999, #cccccc, #
+        # color values are allowed: \#000000, #434343, #666666, #999999, #cccccc, #
-        # efefef, #f3f3f3, #ffffff, # fb4c2f, #ffad47, #fad165, #16a766, #43d692, #
+        # efefef, #f3f3f3, #ffffff, \#fb4c2f, #ffad47, #fad165, #16a766, #43d692, #
-        # 4a86e8, #a479e2, #f691b3, # f6c5be, #ffe6c7, #fef1d1, #b9e4d0, #c6f3de, #
+        # 4a86e8, #a479e2, #f691b3, \#f6c5be, #ffe6c7, #fef1d1, #b9e4d0, #c6f3de, #
-        # c9daf8, #e4d7f5, #fcdee8, # efa093, #ffd6a2, #fce8b3, #89d3b2, #a0eac9, #
+        # c9daf8, #e4d7f5, #fcdee8, \#efa093, #ffd6a2, #fce8b3, #89d3b2, #a0eac9, #
-        # a4c2f4, #d0bcf1, #fbc8d9, # e66550, #ffbc6b, #fcda83, #44b984, #68dfa9, #
+        # a4c2f4, #d0bcf1, #fbc8d9, \#e66550, #ffbc6b, #fcda83, #44b984, #68dfa9, #
-        # 6d9eeb, #b694e8, #f7a7c0, # cc3a21, #eaa041, #f2c960, #149e60, #3dc789, #
+        # 6d9eeb, #b694e8, #f7a7c0, \#cc3a21, #eaa041, #f2c960, #149e60, #3dc789, #
-        # 3c78d8, #8e63ce, #e07798, # ac2b16, #cf8933, #d5ae49, #0b804b, #2a9c68, #
+        # 3c78d8, #8e63ce, #e07798, \#ac2b16, #cf8933, #d5ae49, #0b804b, #2a9c68, #
-        # 285bac, #653e9b, #b65775, # 822111, #a46a21, #aa8831, #076239, #1a764d, #
+        # 285bac, #653e9b, #b65775, \#822111, #a46a21, #aa8831, #076239, #1a764d, #
-        # 1c4587, #41236d, #83334c # 464646, #e7e7e7, #0d3472, #b6cff5, #0d3b44, #98d7e4,
+        # 1c4587, #41236d, #83334c \#464646, #e7e7e7, #0d3472, #b6cff5, #0d3b44, #98d7e4,
-        # #3d188e, #e3d7ff, # 711a36, #fbd3e0, #8a1c0a, #f2b2a8, #7a2e0b, #ffc8af, #
+        # #3d188e, #e3d7ff, \#711a36, #fbd3e0, #8a1c0a, #f2b2a8, #7a2e0b, #ffc8af, #
-        # 7a4706, #ffdeb5, # 594c05, #fbe983, #684e07, #fdedc1, #0b4f30, #b3efd3, #
+        # 7a4706, #ffdeb5, \#594c05, #fbe983, #684e07, #fdedc1, #0b4f30, #b3efd3, #
-        # 04502e, #a2dcc1, # c2c2c2, #4986e7, #2da2bb, #b99aff, #994a64, #f691b2, #
+        # 04502e, #a2dcc1, \#c2c2c2, #4986e7, #2da2bb, #b99aff, #994a64, #f691b2, #
-        # ff7537, #ffad46, # 662e37, #ebdbde, #cca6ac, #094228, #42d692, #16a765 @
+        # ff7537, #ffad46, \#662e37, #ebdbde, #cca6ac, #094228, #42d692, #16a765
-        # mutable gmail.users.labels.create gmail.users.labels.update
         # Corresponds to the JSON property `textColor`
         # @return [String]
         attr_accessor :text_color
@@ -682,7 +678,8 @@ module Google
       class ListDelegatesResponse
         include Google::Apis::Core::Hashable
       
-        # List of the user's delegates (with any verification status).
+        # List of the user's delegates (with any verification status). If an account
+        # doesn't have delegates, this field doesn't appear.
         # Corresponds to the JSON property `delegates`
         # @return [Array<Google::Apis::GmailV1::Delegate>]
         attr_accessor :delegates
@@ -948,8 +945,7 @@ module Google
         # @return [Fixnum]
         attr_accessor :internal_date
       
-        # List of IDs of labels applied to this message. @mutable gmail.users.messages.
+        # List of IDs of labels applied to this message.
-        # insert gmail.users.messages.modify
         # Corresponds to the JSON property `labelIds`
         # @return [Array<String>]
         attr_accessor :label_ids
@@ -961,8 +957,7 @@ module Google
       
         # The entire email message in an RFC 2822 formatted and base64url encoded string.
         # Returned in `messages.get` and `drafts.get` responses when the `format=RAW`
-        # parameter is supplied. @mutable gmail.users.messages.insert gmail.users.
+        # parameter is supplied.
-        # messages.send @mutable gmail.users.drafts.create gmail.users.drafts.update
         # Corresponds to the JSON property `raw`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
@@ -982,9 +977,8 @@ module Google
         # thread, the following criteria must be met: 1. The requested `threadId` must
         # be specified on the `Message` or `Draft.Message` you supply with your request.
         # 2. The `References` and `In-Reply-To` headers must be set in compliance with
-        # the RFC 2822 standard. 3. The `Subject` headers must match. @mutable gmail.
+        # the [RFC 2822](https://tools.ietf.org/html/rfc2822) standard. 3. The `Subject`
-        # users.messages.insert gmail.users.messages.send @mutable gmail.users.drafts.
+        # headers must match.
-        # create gmail.users.drafts.update
         # Corresponds to the JSON property `threadId`
         # @return [String]
         attr_accessor :thread_id

generated/google/apis/gmailpostmastertools_v1beta1.rb

@@ -18,16 +18,16 @@ require 'google/apis/gmailpostmastertools_v1beta1/representations.rb'
 
 module Google
   module Apis
-    # Gmail Postmaster Tools API
+    # Postmaster Tools API
     #
-    # The Gmail Postmaster API is a RESTful API that provides programmatic access to
+    # The Postmaster Tools API is a RESTful API that provides programmatic access to
     # email traffic metrics (like spam reports, delivery errors etc) otherwise
     # available through the Gmail Postmaster Tools UI currently.
     #
     # @see https://developers.google.com/gmail/postmaster
     module GmailpostmastertoolsV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20200801'
+      REVISION = '20200811'
 
       # See email traffic metrics for the domains you have registered in Gmail Postmaster Tools
       AUTH_POSTMASTER_READONLY = 'https://www.googleapis.com/auth/postmaster.readonly'

generated/google/apis/gmailpostmastertools_v1beta1/service.rb

@@ -20,9 +20,9 @@ require 'google/apis/errors'
 module Google
   module Apis
     module GmailpostmastertoolsV1beta1
-      # Gmail Postmaster Tools API
+      # Postmaster Tools API
       #
-      # The Gmail Postmaster API is a RESTful API that provides programmatic access to
+      # The Postmaster Tools API is a RESTful API that provides programmatic access to
       #  email traffic metrics (like spam reports, delivery errors etc) otherwise
       #  available through the Gmail Postmaster Tools UI currently.
       #

generated/google/apis/iap_v1.rb

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

generated/google/apis/iap_v1/classes.rb

@@ -22,10 +22,10 @@ module Google
   module Apis
     module IapV1
       
-      # Custom content configuration for access denied page.
+      # Custom content configuration for access denied page. IAP allows customers to
-      # IAP allows customers to define a custom URI to use as the error page when
+      # define a custom URI to use as the error page when access is denied to users.
-      # access is denied to users. If IAP prevents access to this page, the default
+      # If IAP prevents access to this page, the default IAP error page will be
-      # IAP error page will be displayed instead.
+      # displayed instead.
       class AccessDeniedPageSettings
         include Google::Apis::Core::Hashable
       
@@ -65,11 +65,11 @@ module Google
         # @return [Google::Apis::IapV1::OAuthSettings]
         attr_accessor :oauth_settings
       
-        # PolicyDelegationConfig allows google-internal teams to use IAP for apps
+        # PolicyDelegationConfig allows google-internal teams to use IAP for apps hosted
-        # hosted in a tenant project. Using these settings, the app can delegate
+        # in a tenant project. Using these settings, the app can delegate permission
-        # permission check to happen against the linked customer project.
+        # check to happen against the linked customer project. This is only ever
-        # This is only ever supposed to be used by google internal teams, hence the
+        # supposed to be used by google internal teams, hence the restriction on the
-        # restriction on the proto.
+        # proto.
         # Corresponds to the JSON property `policyDelegationSettings`
         # @return [Google::Apis::IapV1::PolicyDelegationSettings]
         attr_accessor :policy_delegation_settings
@@ -91,10 +91,10 @@ module Google
       class ApplicationSettings
         include Google::Apis::Core::Hashable
       
-        # Custom content configuration for access denied page.
+        # Custom content configuration for access denied page. IAP allows customers to
-        # IAP allows customers to define a custom URI to use as the error page when
+        # define a custom URI to use as the error page when access is denied to users.
-        # access is denied to users. If IAP prevents access to this page, the default
+        # If IAP prevents access to this page, the default IAP error page will be
-        # IAP error page will be displayed instead.
+        # displayed instead.
         # Corresponds to the JSON property `accessDeniedPageSettings`
         # @return [Google::Apis::IapV1::AccessDeniedPageSettings]
         attr_accessor :access_denied_page_settings
@@ -107,8 +107,8 @@ module Google
       
         # Configuration for RCTokens generated for CSM workloads protected by IAP.
         # RCTokens are IAP generated JWTs that can be verified at the application. The
-        # RCToken is primarily used for ISTIO deployments, and can be scoped to a
+        # RCToken is primarily used for ISTIO deployments, and can be scoped to a single
-        # single mesh by configuring the audience field accordingly
+        # mesh by configuring the audience field accordingly
         # Corresponds to the JSON property `csmSettings`
         # @return [Google::Apis::IapV1::CsmSettings]
         attr_accessor :csm_settings
@@ -129,69 +129,57 @@ module Google
       class Binding
         include Google::Apis::Core::Hashable
       
-        # Represents a textual expression in the Common Expression Language (CEL)
+        # Represents a textual expression in the Common Expression Language (CEL) syntax.
-        # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
+        # CEL is a C-like expression language. The syntax and semantics of CEL are
-        # are documented at https://github.com/google/cel-spec.
+        # documented at https://github.com/google/cel-spec. Example (Comparison): title:
-        # Example (Comparison):
+        # "Summary size limit" description: "Determines if a summary is less than 100
-        # title: "Summary size limit"
+        # chars" expression: "document.summary.size() < 100" Example (Equality): title: "
-        # description: "Determines if a summary is less than 100 chars"
+        # Requestor is owner" description: "Determines if requestor is the document
-        # expression: "document.summary.size() < 100"
+        # owner" expression: "document.owner == request.auth.claims.email" Example (
-        # Example (Equality):
+        # Logic): title: "Public documents" description: "Determine whether the document
-        # title: "Requestor is owner"
+        # should be publicly visible" expression: "document.type != 'private' &&
-        # description: "Determines if requestor is the document owner"
+        # document.type != 'internal'" Example (Data Manipulation): title: "Notification
-        # expression: "document.owner == request.auth.claims.email"
+        # string" description: "Create a notification string with a timestamp."
-        # Example (Logic):
+        # expression: "'New message received at ' + string(document.create_time)" The
-        # title: "Public documents"
+        # exact variables and functions that may be referenced within an expression are
-        # description: "Determine whether the document should be publicly visible"
+        # determined by the service that evaluates it. See the service documentation for
-        # expression: "document.type != 'private' && document.type != 'internal'"
+        # additional information.
-        # 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::IapV1::Expr]
         attr_accessor :condition
       
-        # Specifies the identities requesting access for a Cloud Platform resource.
+        # Specifies the identities requesting access for a Cloud Platform resource. `
-        # `members` can have the following values:
+        # members` can have the following values: * `allUsers`: A special identifier
-        # * `allUsers`: A special identifier that represents anyone who is
+        # that represents anyone who is on the internet; with or without a Google
-        # on the internet; with or without a Google account.
+        # account. * `allAuthenticatedUsers`: A special identifier that represents
-        # * `allAuthenticatedUsers`: A special identifier that represents anyone
+        # anyone who is authenticated with a Google account or a service account. * `
-        # who is authenticated with a Google account or a service account.
+        # user:`emailid``: An email address that represents a specific Google account.
-        # * `user:`emailid``: An email address that represents a specific Google
+        # For example, `alice@example.com` . * `serviceAccount:`emailid``: An email
-        # account. For example, `alice@example.com` .
+        # address that represents a service account. For example, `my-other-app@appspot.
-        # * `serviceAccount:`emailid``: An email address that represents a service
+        # gserviceaccount.com`. * `group:`emailid``: An email address that represents a
-        # account. For example, `my-other-app@appspot.gserviceaccount.com`.
+        # Google group. For example, `admins@example.com`. * `deleted:user:`emailid`?uid=
-        # * `group:`emailid``: An email address that represents a Google group.
+        # `uniqueid``: An email address (plus unique identifier) representing a user
-        # For example, `admins@example.com`.
+        # that has been recently deleted. For example, `alice@example.com?uid=
-        # * `deleted:user:`emailid`?uid=`uniqueid``: An email address (plus unique
+        # 123456789012345678901`. If the user is recovered, this value reverts to `user:`
-        # identifier) representing a user that has been recently deleted. For
+        # emailid`` and the recovered user retains the role in the binding. * `deleted:
-        # example, `alice@example.com?uid=123456789012345678901`. If the user is
+        # serviceAccount:`emailid`?uid=`uniqueid``: An email address (plus unique
-        # recovered, this value reverts to `user:`emailid`` and the recovered user
+        # identifier) representing a service account that has been recently deleted. For
-        # retains the role in the binding.
+        # example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`.
-        # * `deleted:serviceAccount:`emailid`?uid=`uniqueid``: An email address (plus
+        # If the service account is undeleted, this value reverts to `serviceAccount:`
-        # unique identifier) representing a service account that has been recently
+        # emailid`` and the undeleted service account retains the role in the binding. *
-        # deleted. For example,
+        # `deleted:group:`emailid`?uid=`uniqueid``: An email address (plus unique
-        # `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`.
+        # identifier) representing a Google group that has been recently deleted. For
-        # If the service account is undeleted, this value reverts to
+        # example, `admins@example.com?uid=123456789012345678901`. If the group is
-        # `serviceAccount:`emailid`` and the undeleted service account retains the
+        # recovered, this value reverts to `group:`emailid`` and the recovered group
-        # role in the binding.
+        # retains the role in the binding. * `domain:`domain``: The G Suite domain (
-        # * `deleted:group:`emailid`?uid=`uniqueid``: An email address (plus unique
+        # primary) that represents all the users of that domain. For example, `google.
-        # identifier) representing a Google group that has been recently
+        # com` or `example.com`.
-        # 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`.
+        # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`
-        # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+        # , or `roles/owner`.
         # Corresponds to the JSON property `role`
         # @return [String]
         attr_accessor :role
@@ -208,8 +196,8 @@ module Google
         end
       end
       
-      # OAuth brand data.
+      # OAuth brand data. NOTE: Only contains a portion of the data that describes a
-      # NOTE: Only contains a portion of the data that describes a brand.
+      # brand.
       class Brand
         include Google::Apis::Core::Hashable
       
@@ -218,15 +206,14 @@ module Google
         # @return [String]
         attr_accessor :application_title
       
-        # Output only. Identifier of the brand.
+        # Output only. Identifier of the brand. NOTE: GCP project number achieves the
-        # NOTE: GCP project number achieves the same brand identification purpose as
+        # same brand identification purpose as only one brand per project can be created.
-        # only one brand per project can be created.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # Output only. Whether the brand is only intended for usage inside the
+        # Output only. Whether the brand is only intended for usage inside the G Suite
-        # G Suite organization only.
+        # organization only.
         # Corresponds to the JSON property `orgInternalOnly`
         # @return [Boolean]
         attr_accessor :org_internal_only
@@ -255,8 +242,8 @@ module Google
       class CorsSettings
         include Google::Apis::Core::Hashable
       
-        # Configuration to allow HTTP OPTIONS calls to skip authorization. If
+        # Configuration to allow HTTP OPTIONS calls to skip authorization. If undefined,
-        # undefined, IAP will not apply any special logic to OPTIONS requests.
+        # IAP will not apply any special logic to OPTIONS requests.
         # Corresponds to the JSON property `allowHttpOptions`
         # @return [Boolean]
         attr_accessor :allow_http_options
@@ -274,8 +261,8 @@ module Google
       
       # Configuration for RCTokens generated for CSM workloads protected by IAP.
       # RCTokens are IAP generated JWTs that can be verified at the application. The
-      # RCToken is primarily used for ISTIO deployments, and can be scoped to a
+      # RCToken is primarily used for ISTIO deployments, and can be scoped to a single
-      # single mesh by configuring the audience field accordingly
+      # mesh by configuring the audience field accordingly
       class CsmSettings
         include Google::Apis::Core::Hashable
       
@@ -295,13 +282,11 @@ module Google
         end
       end
       
-      # A generic empty message that you can re-use to avoid defining duplicated
+      # A generic empty message that you can re-use to avoid defining duplicated empty
-      # empty messages in your APIs. A typical example is to use it as the request
+      # messages in your APIs. A typical example is to use it as the request or the
-      # or the response type of an API method. For instance:
+      # response type of an API method. For instance: service Foo ` rpc Bar(google.
-      # service Foo `
+      # protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for
-      # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      # `Empty` is empty JSON object ````.
-      # `
-      # The JSON representation for `Empty` is empty JSON object ````.
       class Empty
         include Google::Apis::Core::Hashable
       
@@ -314,52 +299,43 @@ module Google
         end
       end
       
-      # Represents a textual expression in the Common Expression Language (CEL)
+      # Represents a textual expression in the Common Expression Language (CEL) syntax.
-      # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
+      # CEL is a C-like expression language. The syntax and semantics of CEL are
-      # are documented at https://github.com/google/cel-spec.
+      # documented at https://github.com/google/cel-spec. Example (Comparison): title:
-      # Example (Comparison):
+      # "Summary size limit" description: "Determines if a summary is less than 100
-      # title: "Summary size limit"
+      # chars" expression: "document.summary.size() < 100" Example (Equality): title: "
-      # description: "Determines if a summary is less than 100 chars"
+      # Requestor is owner" description: "Determines if requestor is the document
-      # expression: "document.summary.size() < 100"
+      # owner" expression: "document.owner == request.auth.claims.email" Example (
-      # Example (Equality):
+      # Logic): title: "Public documents" description: "Determine whether the document
-      # title: "Requestor is owner"
+      # should be publicly visible" expression: "document.type != 'private' &&
-      # description: "Determines if requestor is the document owner"
+      # document.type != 'internal'" Example (Data Manipulation): title: "Notification
-      # expression: "document.owner == request.auth.claims.email"
+      # string" description: "Create a notification string with a timestamp."
-      # Example (Logic):
+      # expression: "'New message received at ' + string(document.create_time)" The
-      # title: "Public documents"
+      # exact variables and functions that may be referenced within an expression are
-      # description: "Determine whether the document should be publicly visible"
+      # determined by the service that evaluates it. See the service documentation for
-      # expression: "document.type != 'private' && document.type != 'internal'"
+      # additional information.
-      # 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
+        # Optional. Description of the expression. This is a longer text which describes
-        # describes the expression, e.g. when hovered over it in a UI.
+        # 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
+        # Textual representation of an expression in Common Expression Language syntax.
-        # syntax.
         # Corresponds to the JSON property `expression`
         # @return [String]
         attr_accessor :expression
       
-        # Optional. String indicating the location of the expression for error
+        # Optional. String indicating the location of the expression for error reporting,
-        # reporting, e.g. a file name and a position in the file.
+        # 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
+        # Optional. Title for the expression, i.e. a short string describing its purpose.
-        # its purpose. This can be used e.g. in UIs which allow to enter the
+        # This can be used e.g. in UIs which allow to enter the expression.
-        # expression.
         # Corresponds to the JSON property `title`
         # @return [String]
         attr_accessor :title
@@ -381,18 +357,17 @@ module Google
       class GcipSettings
         include Google::Apis::Core::Hashable
       
-        # Login page URI associated with the GCIP tenants.
+        # Login page URI associated with the GCIP tenants. Typically, all resources
-        # Typically, all resources within the same project share the same login page,
+        # within the same project share the same login page, though it could be
-        # though it could be overridden at the sub resource level.
+        # overridden at the sub resource level.
         # Corresponds to the JSON property `loginPageUri`
         # @return [String]
         attr_accessor :login_page_uri
       
-        # GCIP tenant ids that are linked to the IAP resource.
+        # GCIP tenant ids that are linked to the IAP resource. tenant_ids could be a
-        # tenant_ids could be a string beginning with a number character to indicate
+        # string beginning with a number character to indicate authenticating with GCIP
-        # authenticating with GCIP tenant flow, or in the format of _<ProjectNumber>
+        # tenant flow, or in the format of _ to indicate authenticating with GCIP agent
-        # to indicate authenticating with GCIP agent flow.
+        # flow. If agent flow is used, tenant_ids should only contain one single element,
-        # If agent flow is used, tenant_ids should only contain one single element,
         # while for tenant flow, tenant_ids can contain multiple elements.
         # Corresponds to the JSON property `tenantIds`
         # @return [Array<String>]
@@ -432,15 +407,13 @@ module Google
       class GetPolicyOptions
         include Google::Apis::Core::Hashable
       
-        # Optional. The policy format version to be returned.
+        # Optional. The policy format version to be returned. Valid values are 0, 1, and
-        # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
+        # 3. Requests specifying an invalid value will be rejected. Requests for
-        # rejected.
+        # policies with any conditional bindings must specify version 3. Policies
-        # Requests for policies with any conditional bindings must specify version 3.
+        # without any conditional bindings may specify any valid value or leave the
-        # Policies without any conditional bindings may specify any valid value or
+        # field unset. To learn which resources support conditions in their IAM policies,
-        # leave the field unset.
+        # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
-        # To learn which resources support conditions in their IAM policies, see the
+        # resource-policies).
-        # [IAM
-        # documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
         # Corresponds to the JSON property `requestedPolicyVersion`
         # @return [Fixnum]
         attr_accessor :requested_policy_version
@@ -545,8 +518,8 @@ module Google
         # @return [Array<Google::Apis::IapV1::IdentityAwareProxyClient>]
         attr_accessor :identity_aware_proxy_clients
       
-        # A token, which can be send as `page_token` to retrieve the next page.
+        # A token, which can be send as `page_token` to retrieve the next page. If this
-        # If this field is omitted, there are no subsequent pages.
+        # field is omitted, there are no subsequent pages.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -568,22 +541,20 @@ module Google
         include Google::Apis::Core::Hashable
       
         # OAuth 2.0 client ID used in the OAuth flow to generate an access token. If
-        # this field is set, you can skip obtaining the OAuth credentials in this
+        # this field is set, you can skip obtaining the OAuth credentials in this step:
-        # step:
         # https://developers.google.com/identity/protocols/OAuth2?hl=en_US#1.-obtain-
-        # oauth-2.0-credentials-from-the-google-api-console.
+        # oauth-2.0-credentials-from-the-google-api-console. However, this could allow
-        # However, this could allow for client sharing. The risks of client sharing
+        # for client sharing. The risks of client sharing are outlined here: https://
-        # are outlined here:
+        # cloud.google.com/iap/docs/sharing-oauth-clients#risks.
-        # https://cloud.google.com/iap/docs/sharing-oauth-clients#risks.
         # Corresponds to the JSON property `clientId`
         # @return [String]
         attr_accessor :client_id
       
-        # Domain hint to send as hd=? parameter in OAuth request flow. Enables
+        # Domain hint to send as hd=? parameter in OAuth request flow. Enables redirect
-        # redirect to primary IDP by skipping Google's login screen.
+        # to primary IDP by skipping Google's login screen. https://developers.google.
-        # https://developers.google.com/identity/protocols/OpenIDConnect#hd-param
+        # com/identity/protocols/OpenIDConnect#hd-param Note: IAP does not verify that
-        # Note: IAP does not verify that the id token's hd claim matches this value
+        # the id token's hd claim matches this value since access behavior is managed by
-        # since access behavior is managed by IAM policies.
+        # IAM policies.
         # Corresponds to the JSON property `loginHint`
         # @return [String]
         attr_accessor :login_hint
@@ -600,111 +571,73 @@ module Google
       end
       
       # An Identity and Access Management (IAM) policy, which specifies access
-      # controls for Google Cloud resources.
+      # controls for Google Cloud resources. A `Policy` is a collection of `bindings`.
-      # A `Policy` is a collection of `bindings`. A `binding` binds one or more
+      # A `binding` binds one or more `members` to a single `role`. Members can be
-      # `members` to a single `role`. Members can be user accounts, service accounts,
+      # user accounts, service accounts, Google groups, and domains (such as G Suite).
-      # Google groups, and domains (such as G Suite). A `role` is a named list of
+      # A `role` is a named list of permissions; each `role` can be an IAM predefined
-      # permissions; each `role` can be an IAM predefined role or a user-created
+      # role or a user-created custom role. For some types of Google Cloud resources,
-      # custom role.
+      # a `binding` can also specify a `condition`, which is a logical expression that
-      # For some types of Google Cloud resources, a `binding` can also specify a
+      # allows access to a resource only if the expression evaluates to `true`. A
-      # `condition`, which is a logical expression that allows access to a resource
+      # condition can add constraints based on attributes of the request, the resource,
-      # only if the expression evaluates to `true`. A condition can add constraints
+      # or both. To learn which resources support conditions in their IAM policies,
-      # based on attributes of the request, the resource, or both. To learn which
+      # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
-      # resources support conditions in their IAM policies, see the
+      # resource-policies). **JSON example:** ` "bindings": [ ` "role": "roles/
-      # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
+      # resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "
-      # policies).
+      # group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@
-      # **JSON example:**
+      # appspot.gserviceaccount.com" ] `, ` "role": "roles/resourcemanager.
-      # `
+      # organizationViewer", "members": [ "user:eve@example.com" ], "condition": ` "
-      # "bindings": [
+      # title": "expirable access", "description": "Does not grant access after Sep
-      # `
+      # 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", `
-      # "role": "roles/resourcemanager.organizationAdmin",
+      # ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:** bindings: -
-      # "members": [
+      # members: - user:mike@example.com - group:admins@example.com - domain:google.
-      # "user:mike@example.com",
+      # com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/
-      # "group:admins@example.com",
+      # resourcemanager.organizationAdmin - members: - user:eve@example.com role:
-      # "domain:google.com",
+      # roles/resourcemanager.organizationViewer condition: title: expirable access
-      # "serviceAccount:my-project-id@appspot.gserviceaccount.com"
+      # 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/).
-      # "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
+        # Associates a list of `members` to a `role`. Optionally, may specify a `
-        # `condition` that determines how and when the `bindings` are applied. Each
+        # condition` that determines how and when the `bindings` are applied. Each of
-        # of the `bindings` must contain at least one member.
+        # the `bindings` must contain at least one member.
         # Corresponds to the JSON property `bindings`
         # @return [Array<Google::Apis::IapV1::Binding>]
         attr_accessor :bindings
       
-        # `etag` is used for optimistic concurrency control as a way to help
+        # `etag` is used for optimistic concurrency control as a way to help prevent
-        # prevent simultaneous updates of a policy from overwriting each other.
+        # simultaneous updates of a policy from overwriting each other. It is strongly
-        # It is strongly suggested that systems make use of the `etag` in the
+        # suggested that systems make use of the `etag` in the read-modify-write cycle
-        # read-modify-write cycle to perform policy updates in order to avoid race
+        # to perform policy updates in order to avoid race conditions: An `etag` is
-        # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+        # returned in the response to `getIamPolicy`, and systems are expected to put
-        # systems are expected to put that etag in the request to `setIamPolicy` to
+        # that etag in the request to `setIamPolicy` to ensure that their change will be
-        # ensure that their change will be applied to the same version of the policy.
+        # applied to the same version of the policy. **Important:** If you use IAM
-        # **Important:** If you use IAM Conditions, you must include the `etag` field
+        # Conditions, you must include the `etag` field whenever you call `setIamPolicy`.
-        # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
+        # If you omit this field, then IAM allows you to overwrite a version `3` policy
-        # you to overwrite a version `3` policy with a version `1` policy, and all of
+        # with a version `1` policy, and all of the conditions in the version `3` policy
-        # the conditions in the version `3` policy are lost.
+        # 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.
+        # Specifies the format of the policy. Valid values are `0`, `1`, and `3`.
-        # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
+        # Requests that specify an invalid value are rejected. Any operation that
-        # are rejected.
+        # affects conditional role bindings must specify version `3`. This requirement
-        # Any operation that affects conditional role bindings must specify version
+        # applies to the following operations: * Getting a policy that includes a
-        # `3`. This requirement applies to the following operations:
+        # conditional role binding * Adding a conditional role binding to a policy *
-        # * Getting a policy that includes a conditional role binding
+        # Changing a conditional role binding in a policy * Removing any role binding,
-        # * Adding a conditional role binding to a policy
+        # with or without a condition, from a policy that includes conditions **
-        # * Changing a conditional role binding in a policy
+        # Important:** If you use IAM Conditions, you must include the `etag` field
-        # * Removing any role binding, with or without a condition, from a policy
+        # whenever you call `setIamPolicy`. If you omit this field, then IAM allows you
-        # that includes conditions
+        # to overwrite a version `3` policy with a version `1` policy, and all of the
-        # **Important:** If you use IAM Conditions, you must include the `etag` field
+        # conditions in the version `3` policy are lost. If a policy does not include
-        # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
+        # any conditions, operations on that policy may specify any valid version or
-        # you to overwrite a version `3` policy with a version `1` policy, and all of
+        # leave the field unset. To learn which resources support conditions in their
-        # the conditions in the version `3` policy are lost.
+        # IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/
-        # If a policy does not include any conditions, operations on that policy may
+        # conditions/resource-policies).
-        # 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
@@ -721,11 +654,11 @@ module Google
         end
       end
       
-      # PolicyDelegationConfig allows google-internal teams to use IAP for apps
+      # PolicyDelegationConfig allows google-internal teams to use IAP for apps hosted
-      # hosted in a tenant project. Using these settings, the app can delegate
+      # in a tenant project. Using these settings, the app can delegate permission
-      # permission check to happen against the linked customer project.
+      # check to happen against the linked customer project. This is only ever
-      # This is only ever supposed to be used by google internal teams, hence the
+      # supposed to be used by google internal teams, hence the restriction on the
-      # restriction on the proto.
+      # proto.
       class PolicyDelegationSettings
         include Google::Apis::Core::Hashable
       
@@ -734,11 +667,10 @@ module Google
         # @return [String]
         attr_accessor :iam_permission
       
-        # The DNS name of the service (e.g. "resourcemanager.googleapis.com").
+        # The DNS name of the service (e.g. "resourcemanager.googleapis.com"). This
-        # This should be the domain name part of the full resource names (see
+        # should be the domain name part of the full resource names (see https://aip.dev/
-        # https://aip.dev/122#full-resource-names), which is usually
+        # 122#full-resource-names), which is usually the same as IamServiceSpec.service
-        # the same as IamServiceSpec.service of the service where the resource type
+        # of the service where the resource type is defined.
-        # is defined.
         # Corresponds to the JSON property `iamServiceName`
         # @return [String]
         attr_accessor :iam_service_name
@@ -775,13 +707,10 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # For Cloud IAM:
+        # For Cloud IAM: The location of the Policy. Must be empty or "global" for
-        # The location of the Policy.
+        # Policies owned by global IAM. Must name a region from prodspec/cloud-iam-
-        # Must be empty or "global" for Policies owned by global IAM.  Must name a
+        # cloudspec for Regional IAM Policies, see go/iam-faq#where-is-iam-currently-
-        # region from prodspec/cloud-iam-cloudspec for Regional IAM Policies, see
+        # deployed. For Local IAM: This field should be set to "local".
-        # go/iam-faq#where-is-iam-currently-deployed.
-        # For Local IAM:
-        # This field should be set to "local".
         # Corresponds to the JSON property `region`
         # @return [String]
         attr_accessor :region
@@ -821,51 +750,49 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The service defined labels of the resource on which the conditions will be
-        # evaluated. The semantics - including the key names - are vague to IAM.
+        # evaluated. The semantics - including the key names - are vague to IAM. If the
-        # If the effective condition has a reference to a `resource.labels[foo]`
+        # effective condition has a reference to a `resource.labels[foo]` construct, IAM
-        # construct, IAM consults with this map to retrieve the values associated
+        # consults with this map to retrieve the values associated with `foo` key for
-        # with `foo` key for Conditions evaluation. If the provided key is not found
+        # Conditions evaluation. If the provided key is not found in the labels map, the
-        # in the labels map, the condition would evaluate to false.
+        # condition would evaluate to false. This field is in limited use. If your
-        # This field is in limited use. If your intended use case is not expected
+        # intended use case is not expected to express resource.labels attribute in IAM
-        # to express resource.labels attribute in IAM Conditions, leave this field
+        # Conditions, leave this field empty. Before planning on using this attribute
-        # empty. Before planning on using this attribute please:
+        # please: * Read go/iam-conditions-labels-comm and ensure your service can meet
-        # * Read go/iam-conditions-labels-comm and ensure your service can meet the
+        # the data availability and management requirements. * Talk to iam-conditions-
-        # data availability and management requirements.
+        # eng@ about your use case.
-        # * Talk to iam-conditions-eng@ about your use case.
         # Corresponds to the JSON property `labels`
         # @return [Hash<String,String>]
         attr_accessor :labels
       
-        # Name of the resource on which conditions will be evaluated.
+        # Name of the resource on which conditions will be evaluated. Must use the
-        # Must use the Relative Resource Name of the resource, which is the URI
+        # Relative Resource Name of the resource, which is the URI path of the resource
-        # path of the resource without the leading "/". Examples are
+        # without the leading "/". Examples are "projects/_/buckets/[BUCKET-ID]" for
-        # "projects/_/buckets/[BUCKET-ID]" for storage buckets or
+        # storage buckets or "projects/[PROJECT-ID]/global/firewalls/[FIREWALL-ID]" for
-        # "projects/[PROJECT-ID]/global/firewalls/[FIREWALL-ID]" for a firewall.
+        # a firewall. This field is required for evaluating conditions with rules on
-        # This field is required for evaluating conditions with rules on resource
+        # resource names. For a `list` permission check, the resource.name value must be
-        # names. For a `list` permission check, the resource.name value must be set
+        # set to the parent resource. If the parent resource is a project, this field
-        # to the parent resource. If the parent resource is a project, this field
         # should be left unset.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # The name of the service this resource belongs to. It is configured using
+        # The name of the service this resource belongs to. It is configured using the
-        # the official_service_name of the Service as defined in service
+        # official_service_name of the Service as defined in service configurations
-        # configurations under //configs/cloud/resourcetypes.
+        # under //configs/cloud/resourcetypes. For example, the official_service_name of
-        # For example, the official_service_name of cloud resource manager service
+        # cloud resource manager service is set as 'cloudresourcemanager.googleapis.com'
-        # is set as 'cloudresourcemanager.googleapis.com' according to
+        # according to //configs/cloud/resourcetypes/google/cloud/resourcemanager/prod.
-        # //configs/cloud/resourcetypes/google/cloud/resourcemanager/prod.yaml
+        # yaml
         # Corresponds to the JSON property `service`
         # @return [String]
         attr_accessor :service
       
         # The public resource type name of the resource on which conditions will be
         # evaluated. It is configured using the official_name of the ResourceType as
-        # defined in service configurations under //configs/cloud/resourcetypes.
+        # defined in service configurations under //configs/cloud/resourcetypes. For
-        # For example, the official_name for GCP projects is set as
+        # example, the official_name for GCP projects is set as 'cloudresourcemanager.
-        # 'cloudresourcemanager.googleapis.com/Project' according to
+        # googleapis.com/Project' according to //configs/cloud/resourcetypes/google/
-        # //configs/cloud/resourcetypes/google/cloud/resourcemanager/prod.yaml
+        # cloud/resourcemanager/prod.yaml For details see go/iam-conditions-integration-
-        # For details see go/iam-conditions-integration-guide.
+        # guide.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -888,66 +815,32 @@ module Google
         include Google::Apis::Core::Hashable
       
         # An Identity and Access Management (IAM) policy, which specifies access
-        # controls for Google Cloud resources.
+        # controls for Google Cloud resources. A `Policy` is a collection of `bindings`.
-        # A `Policy` is a collection of `bindings`. A `binding` binds one or more
+        # A `binding` binds one or more `members` to a single `role`. Members can be
-        # `members` to a single `role`. Members can be user accounts, service accounts,
+        # user accounts, service accounts, Google groups, and domains (such as G Suite).
-        # Google groups, and domains (such as G Suite). A `role` is a named list of
+        # A `role` is a named list of permissions; each `role` can be an IAM predefined
-        # permissions; each `role` can be an IAM predefined role or a user-created
+        # role or a user-created custom role. For some types of Google Cloud resources,
-        # custom role.
+        # a `binding` can also specify a `condition`, which is a logical expression that
-        # For some types of Google Cloud resources, a `binding` can also specify a
+        # allows access to a resource only if the expression evaluates to `true`. A
-        # `condition`, which is a logical expression that allows access to a resource
+        # condition can add constraints based on attributes of the request, the resource,
-        # only if the expression evaluates to `true`. A condition can add constraints
+        # or both. To learn which resources support conditions in their IAM policies,
-        # based on attributes of the request, the resource, or both. To learn which
+        # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
-        # resources support conditions in their IAM policies, see the
+        # resource-policies). **JSON example:** ` "bindings": [ ` "role": "roles/
-        # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
+        # resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "
-        # policies).
+        # group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@
-        # **JSON example:**
+        # appspot.gserviceaccount.com" ] `, ` "role": "roles/resourcemanager.
-        # `
+        # organizationViewer", "members": [ "user:eve@example.com" ], "condition": ` "
-        # "bindings": [
+        # title": "expirable access", "description": "Does not grant access after Sep
-        # `
+        # 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", `
-        # "role": "roles/resourcemanager.organizationAdmin",
+        # ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:** bindings: -
-        # "members": [
+        # members: - user:mike@example.com - group:admins@example.com - domain:google.
-        # "user:mike@example.com",
+        # com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/
-        # "group:admins@example.com",
+        # resourcemanager.organizationAdmin - members: - user:eve@example.com role:
-        # "domain:google.com",
+        # roles/resourcemanager.organizationViewer condition: title: expirable access
-        # "serviceAccount:my-project-id@appspot.gserviceaccount.com"
+        # 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/).
-        # "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::IapV1::Policy]
         attr_accessor :policy
@@ -966,10 +859,9 @@ module Google
       class TestIamPermissionsRequest
         include Google::Apis::Core::Hashable
       
-        # The set of permissions to check for the `resource`. Permissions with
+        # The set of permissions to check for the `resource`. Permissions with wildcards
-        # wildcards (such as '*' or 'storage.*') are not allowed. For more
+        # (such as '*' or 'storage.*') are not allowed. For more information see [IAM
-        # information see
+        # Overview](https://cloud.google.com/iam/docs/overview#permissions).
-        # [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
         # Corresponds to the JSON property `permissions`
         # @return [Array<String>]
         attr_accessor :permissions
@@ -988,8 +880,7 @@ module Google
       class TestIamPermissionsResponse
         include Google::Apis::Core::Hashable
       
-        # A subset of `TestPermissionsRequest.permissions` that the caller is
+        # A subset of `TestPermissionsRequest.permissions` that the caller is allowed.
-        # allowed.
         # Corresponds to the JSON property `permissions`
         # @return [Array<String>]
         attr_accessor :permissions

generated/google/apis/iap_v1/service.rb

@@ -47,16 +47,16 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Constructs a new OAuth brand for the project if one does not exist.
+        # Constructs a new OAuth brand for the project if one does not exist. The
-        # The created brand is "internal only", meaning that OAuth clients created
+        # created brand is "internal only", meaning that OAuth clients created under it
-        # under it only accept requests from users who belong to the same G Suite
+        # only accept requests from users who belong to the same G Suite organization as
-        # organization as the project. The brand is created in an un-reviewed status.
+        # the project. The brand is created in an un-reviewed status. NOTE: The "
-        # NOTE: The "internal only" status can be manually changed in the Google
+        # internal only" status can be manually changed in the Google Cloud console.
-        # Cloud console. Requires that a brand does not already exist for the
+        # Requires that a brand does not already exist for the project, and that the
-        # project, and that the specified support email is owned by the caller.
+        # specified support email is owned by the caller.
         # @param [String] parent
-        #   Required. GCP Project number/id under which the brand is to be created.
+        #   Required. GCP Project number/id under which the brand is to be created. In the
-        #   In the following format: projects/`project_number/id`.
+        #   following format: projects/`project_number/id`.
         # @param [Google::Apis::IapV1::Brand] brand_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -89,8 +89,8 @@ module Google
         
         # Retrieves the OAuth brand of the project.
         # @param [String] name
-        #   Required. Name of the brand to be fetched.
+        #   Required. Name of the brand to be fetched. In the following format: projects/`
-        #   In the following format: projects/`project_number/id`/brands/`brand`.
+        #   project_number/id`/brands/`brand`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -120,8 +120,8 @@ module Google
         
         # Lists the existing brands for the project.
         # @param [String] parent
-        #   Required. GCP Project number/id.
+        #   Required. GCP Project number/id. In the following format: projects/`
-        #   In the following format: projects/`project_number/id`.
+        #   project_number/id`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -149,14 +149,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates an Identity Aware Proxy (IAP) OAuth client. The client is owned
+        # Creates an Identity Aware Proxy (IAP) OAuth client. The client is owned by IAP.
-        # by IAP. Requires that the brand for the project exists and that it is
+        # Requires that the brand for the project exists and that it is set for
-        # set for internal-only use.
+        # internal-only use.
         # @param [String] parent
-        #   Required. Path to create the client in.
+        #   Required. Path to create the client in. In the following format: projects/`
-        #   In the following format:
+        #   project_number/id`/brands/`brand`. The project must belong to a G Suite
-        #   projects/`project_number/id`/brands/`brand`.
+        #   account.
-        #   The project must belong to a G Suite account.
         # @param [Google::Apis::IapV1::IdentityAwareProxyClient] identity_aware_proxy_client_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -191,10 +190,9 @@ module Google
         # obsolete clients, managing the number of clients in a given project, and
         # cleaning up after tests. Requires that the client is owned by IAP.
         # @param [String] name
-        #   Required. Name of the Identity Aware Proxy client to be deleted.
+        #   Required. Name of the Identity Aware Proxy client to be deleted. In the
-        #   In the following format:
+        #   following format: projects/`project_number/id`/brands/`brand`/
-        #   projects/`project_number/id`/brands/`brand`/identityAwareProxyClients/`
+        #   identityAwareProxyClients/`client_id`.
-        #   client_id`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -222,13 +220,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves an Identity Aware Proxy (IAP) OAuth client.
+        # Retrieves an Identity Aware Proxy (IAP) OAuth client. Requires that the client
-        # Requires that the client is owned by IAP.
+        # is owned by IAP.
         # @param [String] name
-        #   Required. Name of the Identity Aware Proxy client to be fetched.
+        #   Required. Name of the Identity Aware Proxy client to be fetched. In the
-        #   In the following format:
+        #   following format: projects/`project_number/id`/brands/`brand`/
-        #   projects/`project_number/id`/brands/`brand`/identityAwareProxyClients/`
+        #   identityAwareProxyClients/`client_id`.
-        #   client_id`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -258,19 +255,17 @@ module Google
         
         # Lists the existing clients for the brand.
         # @param [String] parent
-        #   Required. Full brand path.
+        #   Required. Full brand path. In the following format: projects/`project_number/
-        #   In the following format: projects/`project_number/id`/brands/`brand`.
+        #   id`/brands/`brand`.
         # @param [Fixnum] page_size
         #   The maximum number of clients to return. The service may return fewer than
-        #   this value.
+        #   this value. If unspecified, at most 100 clients will be returned. The maximum
-        #   If unspecified, at most 100 clients will be returned.
+        #   value is 1000; values above 1000 will be coerced to 1000.
-        #   The maximum value is 1000; values above 1000 will be coerced to 1000.
         # @param [String] page_token
-        #   A page token, received from a previous `ListIdentityAwareProxyClients`
+        #   A page token, received from a previous `ListIdentityAwareProxyClients` call.
-        #   call. Provide this to retrieve the subsequent page.
+        #   Provide this to retrieve the subsequent page. When paginating, all other
-        #   When paginating, all other parameters provided to
+        #   parameters provided to `ListIdentityAwareProxyClients` must match the call
-        #   `ListIdentityAwareProxyClients` must match the call that provided the page
+        #   that provided the page token.
-        #   token.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -300,13 +295,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Resets an Identity Aware Proxy (IAP) OAuth client secret. Useful if the
+        # Resets an Identity Aware Proxy (IAP) OAuth client secret. Useful if the secret
-        # secret was compromised. Requires that the client is owned by IAP.
+        # was compromised. Requires that the client is owned by IAP.
         # @param [String] name
-        #   Required. Name of the Identity Aware Proxy client to that will have its
+        #   Required. Name of the Identity Aware Proxy client to that will have its secret
-        #   secret reset. In the following format:
+        #   reset. In the following format: projects/`project_number/id`/brands/`brand`/
-        #   projects/`project_number/id`/brands/`brand`/identityAwareProxyClients/`
+        #   identityAwareProxyClients/`client_id`.
-        #   client_id`.
         # @param [Google::Apis::IapV1::ResetIdentityAwareProxyClientSecretRequest] reset_identity_aware_proxy_client_secret_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -337,13 +331,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the access control policy for an Identity-Aware Proxy protected
+        # Gets the access control policy for an Identity-Aware Proxy protected resource.
-        # resource.
+        # More information about managing access via IAP can be found at: https://cloud.
-        # More information about managing access via IAP can be found at:
+        # google.com/iap/docs/managing-access#managing_access_via_the_api
-        # https://cloud.google.com/iap/docs/managing-access#managing_access_via_the_api
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being requested.
+        #   REQUIRED: The resource for which the policy is being requested. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::IapV1::GetIamPolicyRequest] get_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -376,9 +369,8 @@ module Google
         
         # Gets the IAP settings on a particular IAP protected resource.
         # @param [String] name
-        #   Required. The resource name for which to retrieve the settings.
+        #   Required. The resource name for which to retrieve the settings. Authorization:
-        #   Authorization: Requires the `getSettings` permission for the associated
+        #   Requires the `getSettings` permission for the associated resource.
-        #   resource.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -406,13 +398,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Sets the access control policy for an Identity-Aware Proxy protected
+        # Sets the access control policy for an Identity-Aware Proxy protected resource.
-        # resource. Replaces any existing policy.
+        # Replaces any existing policy. More information about managing access via IAP
-        # More information about managing access via IAP can be found at:
+        # can be found at: https://cloud.google.com/iap/docs/managing-access#
-        # https://cloud.google.com/iap/docs/managing-access#managing_access_via_the_api
+        # managing_access_via_the_api
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being specified.
+        #   REQUIRED: The resource for which the policy is being specified. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::IapV1::SetIamPolicyRequest] set_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -444,12 +436,11 @@ module Google
         end
         
         # Returns permissions that a caller has on the Identity-Aware Proxy protected
-        # resource.
+        # resource. More information about managing access via IAP can be found at:
-        # More information about managing access via IAP can be found at:
         # https://cloud.google.com/iap/docs/managing-access#managing_access_via_the_api
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy detail is being requested.
+        #   REQUIRED: The resource for which the policy detail is being requested. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::IapV1::TestIamPermissionsRequest] test_iam_permissions_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -480,16 +471,15 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates the IAP settings on a particular IAP protected resource. It
+        # Updates the IAP settings on a particular IAP protected resource. It replaces
-        # replaces all fields unless the `update_mask` is set.
+        # all fields unless the `update_mask` is set.
         # @param [String] name
         #   Required. The resource name of the IAP protected resource.
         # @param [Google::Apis::IapV1::IapSettings] iap_settings_object
         # @param [String] update_mask
-        #   The field mask specifying which IAP settings should be updated.
+        #   The field mask specifying which IAP settings should be updated. If omitted,
-        #   If omitted, the all of the settings are updated. See
+        #   the all of the settings are updated. See https://developers.google.com/
-        #   https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#
+        #   protocol-buffers/docs/reference/google.protobuf#fieldmask
-        #   fieldmask
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user

generated/google/apis/iap_v1beta1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/iap
     module IapV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20200511'
+      REVISION = '20200807'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/iap_v1beta1/classes.rb

@@ -26,69 +26,57 @@ module Google
       class Binding
         include Google::Apis::Core::Hashable
       
-        # Represents a textual expression in the Common Expression Language (CEL)
+        # Represents a textual expression in the Common Expression Language (CEL) syntax.
-        # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
+        # CEL is a C-like expression language. The syntax and semantics of CEL are
-        # are documented at https://github.com/google/cel-spec.
+        # documented at https://github.com/google/cel-spec. Example (Comparison): title:
-        # Example (Comparison):
+        # "Summary size limit" description: "Determines if a summary is less than 100
-        # title: "Summary size limit"
+        # chars" expression: "document.summary.size() < 100" Example (Equality): title: "
-        # description: "Determines if a summary is less than 100 chars"
+        # Requestor is owner" description: "Determines if requestor is the document
-        # expression: "document.summary.size() < 100"
+        # owner" expression: "document.owner == request.auth.claims.email" Example (
-        # Example (Equality):
+        # Logic): title: "Public documents" description: "Determine whether the document
-        # title: "Requestor is owner"
+        # should be publicly visible" expression: "document.type != 'private' &&
-        # description: "Determines if requestor is the document owner"
+        # document.type != 'internal'" Example (Data Manipulation): title: "Notification
-        # expression: "document.owner == request.auth.claims.email"
+        # string" description: "Create a notification string with a timestamp."
-        # Example (Logic):
+        # expression: "'New message received at ' + string(document.create_time)" The
-        # title: "Public documents"
+        # exact variables and functions that may be referenced within an expression are
-        # description: "Determine whether the document should be publicly visible"
+        # determined by the service that evaluates it. See the service documentation for
-        # expression: "document.type != 'private' && document.type != 'internal'"
+        # additional information.
-        # 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::IapV1beta1::Expr]
         attr_accessor :condition
       
-        # Specifies the identities requesting access for a Cloud Platform resource.
+        # Specifies the identities requesting access for a Cloud Platform resource. `
-        # `members` can have the following values:
+        # members` can have the following values: * `allUsers`: A special identifier
-        # * `allUsers`: A special identifier that represents anyone who is
+        # that represents anyone who is on the internet; with or without a Google
-        # on the internet; with or without a Google account.
+        # account. * `allAuthenticatedUsers`: A special identifier that represents
-        # * `allAuthenticatedUsers`: A special identifier that represents anyone
+        # anyone who is authenticated with a Google account or a service account. * `
-        # who is authenticated with a Google account or a service account.
+        # user:`emailid``: An email address that represents a specific Google account.
-        # * `user:`emailid``: An email address that represents a specific Google
+        # For example, `alice@example.com` . * `serviceAccount:`emailid``: An email
-        # account. For example, `alice@example.com` .
+        # address that represents a service account. For example, `my-other-app@appspot.
-        # * `serviceAccount:`emailid``: An email address that represents a service
+        # gserviceaccount.com`. * `group:`emailid``: An email address that represents a
-        # account. For example, `my-other-app@appspot.gserviceaccount.com`.
+        # Google group. For example, `admins@example.com`. * `deleted:user:`emailid`?uid=
-        # * `group:`emailid``: An email address that represents a Google group.
+        # `uniqueid``: An email address (plus unique identifier) representing a user
-        # For example, `admins@example.com`.
+        # that has been recently deleted. For example, `alice@example.com?uid=
-        # * `deleted:user:`emailid`?uid=`uniqueid``: An email address (plus unique
+        # 123456789012345678901`. If the user is recovered, this value reverts to `user:`
-        # identifier) representing a user that has been recently deleted. For
+        # emailid`` and the recovered user retains the role in the binding. * `deleted:
-        # example, `alice@example.com?uid=123456789012345678901`. If the user is
+        # serviceAccount:`emailid`?uid=`uniqueid``: An email address (plus unique
-        # recovered, this value reverts to `user:`emailid`` and the recovered user
+        # identifier) representing a service account that has been recently deleted. For
-        # retains the role in the binding.
+        # example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`.
-        # * `deleted:serviceAccount:`emailid`?uid=`uniqueid``: An email address (plus
+        # If the service account is undeleted, this value reverts to `serviceAccount:`
-        # unique identifier) representing a service account that has been recently
+        # emailid`` and the undeleted service account retains the role in the binding. *
-        # deleted. For example,
+        # `deleted:group:`emailid`?uid=`uniqueid``: An email address (plus unique
-        # `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`.
+        # identifier) representing a Google group that has been recently deleted. For
-        # If the service account is undeleted, this value reverts to
+        # example, `admins@example.com?uid=123456789012345678901`. If the group is
-        # `serviceAccount:`emailid`` and the undeleted service account retains the
+        # recovered, this value reverts to `group:`emailid`` and the recovered group
-        # role in the binding.
+        # retains the role in the binding. * `domain:`domain``: The G Suite domain (
-        # * `deleted:group:`emailid`?uid=`uniqueid``: An email address (plus unique
+        # primary) that represents all the users of that domain. For example, `google.
-        # identifier) representing a Google group that has been recently
+        # com` or `example.com`.
-        # 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`.
+        # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`
-        # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+        # , or `roles/owner`.
         # Corresponds to the JSON property `role`
         # @return [String]
         attr_accessor :role
@@ -105,52 +93,43 @@ module Google
         end
       end
       
-      # Represents a textual expression in the Common Expression Language (CEL)
+      # Represents a textual expression in the Common Expression Language (CEL) syntax.
-      # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
+      # CEL is a C-like expression language. The syntax and semantics of CEL are
-      # are documented at https://github.com/google/cel-spec.
+      # documented at https://github.com/google/cel-spec. Example (Comparison): title:
-      # Example (Comparison):
+      # "Summary size limit" description: "Determines if a summary is less than 100
-      # title: "Summary size limit"
+      # chars" expression: "document.summary.size() < 100" Example (Equality): title: "
-      # description: "Determines if a summary is less than 100 chars"
+      # Requestor is owner" description: "Determines if requestor is the document
-      # expression: "document.summary.size() < 100"
+      # owner" expression: "document.owner == request.auth.claims.email" Example (
-      # Example (Equality):
+      # Logic): title: "Public documents" description: "Determine whether the document
-      # title: "Requestor is owner"
+      # should be publicly visible" expression: "document.type != 'private' &&
-      # description: "Determines if requestor is the document owner"
+      # document.type != 'internal'" Example (Data Manipulation): title: "Notification
-      # expression: "document.owner == request.auth.claims.email"
+      # string" description: "Create a notification string with a timestamp."
-      # Example (Logic):
+      # expression: "'New message received at ' + string(document.create_time)" The
-      # title: "Public documents"
+      # exact variables and functions that may be referenced within an expression are
-      # description: "Determine whether the document should be publicly visible"
+      # determined by the service that evaluates it. See the service documentation for
-      # expression: "document.type != 'private' && document.type != 'internal'"
+      # additional information.
-      # 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
+        # Optional. Description of the expression. This is a longer text which describes
-        # describes the expression, e.g. when hovered over it in a UI.
+        # 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
+        # Textual representation of an expression in Common Expression Language syntax.
-        # syntax.
         # Corresponds to the JSON property `expression`
         # @return [String]
         attr_accessor :expression
       
-        # Optional. String indicating the location of the expression for error
+        # Optional. String indicating the location of the expression for error reporting,
-        # reporting, e.g. a file name and a position in the file.
+        # 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
+        # Optional. Title for the expression, i.e. a short string describing its purpose.
-        # its purpose. This can be used e.g. in UIs which allow to enter the
+        # This can be used e.g. in UIs which allow to enter the expression.
-        # expression.
         # Corresponds to the JSON property `title`
         # @return [String]
         attr_accessor :title
@@ -191,15 +170,13 @@ module Google
       class GetPolicyOptions
         include Google::Apis::Core::Hashable
       
-        # Optional. The policy format version to be returned.
+        # Optional. The policy format version to be returned. Valid values are 0, 1, and
-        # Valid values are 0, 1, and 3. Requests specifying an invalid value will be
+        # 3. Requests specifying an invalid value will be rejected. Requests for
-        # rejected.
+        # policies with any conditional bindings must specify version 3. Policies
-        # Requests for policies with any conditional bindings must specify version 3.
+        # without any conditional bindings may specify any valid value or leave the
-        # Policies without any conditional bindings may specify any valid value or
+        # field unset. To learn which resources support conditions in their IAM policies,
-        # leave the field unset.
+        # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
-        # To learn which resources support conditions in their IAM policies, see the
+        # resource-policies).
-        # [IAM
-        # documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
         # Corresponds to the JSON property `requestedPolicyVersion`
         # @return [Fixnum]
         attr_accessor :requested_policy_version
@@ -215,111 +192,73 @@ module Google
       end
       
       # An Identity and Access Management (IAM) policy, which specifies access
-      # controls for Google Cloud resources.
+      # controls for Google Cloud resources. A `Policy` is a collection of `bindings`.
-      # A `Policy` is a collection of `bindings`. A `binding` binds one or more
+      # A `binding` binds one or more `members` to a single `role`. Members can be
-      # `members` to a single `role`. Members can be user accounts, service accounts,
+      # user accounts, service accounts, Google groups, and domains (such as G Suite).
-      # Google groups, and domains (such as G Suite). A `role` is a named list of
+      # A `role` is a named list of permissions; each `role` can be an IAM predefined
-      # permissions; each `role` can be an IAM predefined role or a user-created
+      # role or a user-created custom role. For some types of Google Cloud resources,
-      # custom role.
+      # a `binding` can also specify a `condition`, which is a logical expression that
-      # For some types of Google Cloud resources, a `binding` can also specify a
+      # allows access to a resource only if the expression evaluates to `true`. A
-      # `condition`, which is a logical expression that allows access to a resource
+      # condition can add constraints based on attributes of the request, the resource,
-      # only if the expression evaluates to `true`. A condition can add constraints
+      # or both. To learn which resources support conditions in their IAM policies,
-      # based on attributes of the request, the resource, or both. To learn which
+      # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
-      # resources support conditions in their IAM policies, see the
+      # resource-policies). **JSON example:** ` "bindings": [ ` "role": "roles/
-      # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
+      # resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "
-      # policies).
+      # group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@
-      # **JSON example:**
+      # appspot.gserviceaccount.com" ] `, ` "role": "roles/resourcemanager.
-      # `
+      # organizationViewer", "members": [ "user:eve@example.com" ], "condition": ` "
-      # "bindings": [
+      # title": "expirable access", "description": "Does not grant access after Sep
-      # `
+      # 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", `
-      # "role": "roles/resourcemanager.organizationAdmin",
+      # ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:** bindings: -
-      # "members": [
+      # members: - user:mike@example.com - group:admins@example.com - domain:google.
-      # "user:mike@example.com",
+      # com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/
-      # "group:admins@example.com",
+      # resourcemanager.organizationAdmin - members: - user:eve@example.com role:
-      # "domain:google.com",
+      # roles/resourcemanager.organizationViewer condition: title: expirable access
-      # "serviceAccount:my-project-id@appspot.gserviceaccount.com"
+      # 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/).
-      # "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
+        # Associates a list of `members` to a `role`. Optionally, may specify a `
-        # `condition` that determines how and when the `bindings` are applied. Each
+        # condition` that determines how and when the `bindings` are applied. Each of
-        # of the `bindings` must contain at least one member.
+        # the `bindings` must contain at least one member.
         # Corresponds to the JSON property `bindings`
         # @return [Array<Google::Apis::IapV1beta1::Binding>]
         attr_accessor :bindings
       
-        # `etag` is used for optimistic concurrency control as a way to help
+        # `etag` is used for optimistic concurrency control as a way to help prevent
-        # prevent simultaneous updates of a policy from overwriting each other.
+        # simultaneous updates of a policy from overwriting each other. It is strongly
-        # It is strongly suggested that systems make use of the `etag` in the
+        # suggested that systems make use of the `etag` in the read-modify-write cycle
-        # read-modify-write cycle to perform policy updates in order to avoid race
+        # to perform policy updates in order to avoid race conditions: An `etag` is
-        # conditions: An `etag` is returned in the response to `getIamPolicy`, and
+        # returned in the response to `getIamPolicy`, and systems are expected to put
-        # systems are expected to put that etag in the request to `setIamPolicy` to
+        # that etag in the request to `setIamPolicy` to ensure that their change will be
-        # ensure that their change will be applied to the same version of the policy.
+        # applied to the same version of the policy. **Important:** If you use IAM
-        # **Important:** If you use IAM Conditions, you must include the `etag` field
+        # Conditions, you must include the `etag` field whenever you call `setIamPolicy`.
-        # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
+        # If you omit this field, then IAM allows you to overwrite a version `3` policy
-        # you to overwrite a version `3` policy with a version `1` policy, and all of
+        # with a version `1` policy, and all of the conditions in the version `3` policy
-        # the conditions in the version `3` policy are lost.
+        # 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.
+        # Specifies the format of the policy. Valid values are `0`, `1`, and `3`.
-        # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
+        # Requests that specify an invalid value are rejected. Any operation that
-        # are rejected.
+        # affects conditional role bindings must specify version `3`. This requirement
-        # Any operation that affects conditional role bindings must specify version
+        # applies to the following operations: * Getting a policy that includes a
-        # `3`. This requirement applies to the following operations:
+        # conditional role binding * Adding a conditional role binding to a policy *
-        # * Getting a policy that includes a conditional role binding
+        # Changing a conditional role binding in a policy * Removing any role binding,
-        # * Adding a conditional role binding to a policy
+        # with or without a condition, from a policy that includes conditions **
-        # * Changing a conditional role binding in a policy
+        # Important:** If you use IAM Conditions, you must include the `etag` field
-        # * Removing any role binding, with or without a condition, from a policy
+        # whenever you call `setIamPolicy`. If you omit this field, then IAM allows you
-        # that includes conditions
+        # to overwrite a version `3` policy with a version `1` policy, and all of the
-        # **Important:** If you use IAM Conditions, you must include the `etag` field
+        # conditions in the version `3` policy are lost. If a policy does not include
-        # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
+        # any conditions, operations on that policy may specify any valid version or
-        # you to overwrite a version `3` policy with a version `1` policy, and all of
+        # leave the field unset. To learn which resources support conditions in their
-        # the conditions in the version `3` policy are lost.
+        # IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/
-        # If a policy does not include any conditions, operations on that policy may
+        # conditions/resource-policies).
-        # 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
@@ -341,66 +280,32 @@ module Google
         include Google::Apis::Core::Hashable
       
         # An Identity and Access Management (IAM) policy, which specifies access
-        # controls for Google Cloud resources.
+        # controls for Google Cloud resources. A `Policy` is a collection of `bindings`.
-        # A `Policy` is a collection of `bindings`. A `binding` binds one or more
+        # A `binding` binds one or more `members` to a single `role`. Members can be
-        # `members` to a single `role`. Members can be user accounts, service accounts,
+        # user accounts, service accounts, Google groups, and domains (such as G Suite).
-        # Google groups, and domains (such as G Suite). A `role` is a named list of
+        # A `role` is a named list of permissions; each `role` can be an IAM predefined
-        # permissions; each `role` can be an IAM predefined role or a user-created
+        # role or a user-created custom role. For some types of Google Cloud resources,
-        # custom role.
+        # a `binding` can also specify a `condition`, which is a logical expression that
-        # For some types of Google Cloud resources, a `binding` can also specify a
+        # allows access to a resource only if the expression evaluates to `true`. A
-        # `condition`, which is a logical expression that allows access to a resource
+        # condition can add constraints based on attributes of the request, the resource,
-        # only if the expression evaluates to `true`. A condition can add constraints
+        # or both. To learn which resources support conditions in their IAM policies,
-        # based on attributes of the request, the resource, or both. To learn which
+        # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
-        # resources support conditions in their IAM policies, see the
+        # resource-policies). **JSON example:** ` "bindings": [ ` "role": "roles/
-        # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
+        # resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "
-        # policies).
+        # group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@
-        # **JSON example:**
+        # appspot.gserviceaccount.com" ] `, ` "role": "roles/resourcemanager.
-        # `
+        # organizationViewer", "members": [ "user:eve@example.com" ], "condition": ` "
-        # "bindings": [
+        # title": "expirable access", "description": "Does not grant access after Sep
-        # `
+        # 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", `
-        # "role": "roles/resourcemanager.organizationAdmin",
+        # ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:** bindings: -
-        # "members": [
+        # members: - user:mike@example.com - group:admins@example.com - domain:google.
-        # "user:mike@example.com",
+        # com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/
-        # "group:admins@example.com",
+        # resourcemanager.organizationAdmin - members: - user:eve@example.com role:
-        # "domain:google.com",
+        # roles/resourcemanager.organizationViewer condition: title: expirable access
-        # "serviceAccount:my-project-id@appspot.gserviceaccount.com"
+        # 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/).
-        # "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::IapV1beta1::Policy]
         attr_accessor :policy
@@ -419,10 +324,9 @@ module Google
       class TestIamPermissionsRequest
         include Google::Apis::Core::Hashable
       
-        # The set of permissions to check for the `resource`. Permissions with
+        # The set of permissions to check for the `resource`. Permissions with wildcards
-        # wildcards (such as '*' or 'storage.*') are not allowed. For more
+        # (such as '*' or 'storage.*') are not allowed. For more information see [IAM
-        # information see
+        # Overview](https://cloud.google.com/iam/docs/overview#permissions).
-        # [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
         # Corresponds to the JSON property `permissions`
         # @return [Array<String>]
         attr_accessor :permissions
@@ -441,8 +345,7 @@ module Google
       class TestIamPermissionsResponse
         include Google::Apis::Core::Hashable
       
-        # A subset of `TestPermissionsRequest.permissions` that the caller is
+        # A subset of `TestPermissionsRequest.permissions` that the caller is allowed.
-        # allowed.
         # Corresponds to the JSON property `permissions`
         # @return [Array<String>]
         attr_accessor :permissions

generated/google/apis/iap_v1beta1/service.rb

@@ -47,13 +47,12 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Gets the access control policy for an Identity-Aware Proxy protected
+        # Gets the access control policy for an Identity-Aware Proxy protected resource.
-        # resource.
+        # More information about managing access via IAP can be found at: https://cloud.
-        # More information about managing access via IAP can be found at:
+        # google.com/iap/docs/managing-access#managing_access_via_the_api
-        # https://cloud.google.com/iap/docs/managing-access#managing_access_via_the_api
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being requested.
+        #   REQUIRED: The resource for which the policy is being requested. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::IapV1beta1::GetIamPolicyRequest] get_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -84,13 +83,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Sets the access control policy for an Identity-Aware Proxy protected
+        # Sets the access control policy for an Identity-Aware Proxy protected resource.
-        # resource. Replaces any existing policy.
+        # Replaces any existing policy. More information about managing access via IAP
-        # More information about managing access via IAP can be found at:
+        # can be found at: https://cloud.google.com/iap/docs/managing-access#
-        # https://cloud.google.com/iap/docs/managing-access#managing_access_via_the_api
+        # managing_access_via_the_api
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being specified.
+        #   REQUIRED: The resource for which the policy is being specified. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::IapV1beta1::SetIamPolicyRequest] set_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -122,14 +121,13 @@ module Google
         end
         
         # Returns permissions that a caller has on the Identity-Aware Proxy protected
-        # resource. If the resource does not exist or the caller does not have
+        # resource. If the resource does not exist or the caller does not have Identity-
-        # Identity-Aware Proxy permissions a [google.rpc.Code.PERMISSION_DENIED]
+        # Aware Proxy permissions a [google.rpc.Code.PERMISSION_DENIED] will be returned.
-        # will be returned.
+        # More information about managing access via IAP can be found at: https://cloud.
-        # More information about managing access via IAP can be found at:
+        # google.com/iap/docs/managing-access#managing_access_via_the_api
-        # https://cloud.google.com/iap/docs/managing-access#managing_access_via_the_api
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy detail is being requested.
+        #   REQUIRED: The resource for which the policy detail is being requested. See the
-        #   See the operation documentation for the appropriate value for this field.
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::IapV1beta1::TestIamPermissionsRequest] test_iam_permissions_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.

generated/google/apis/oauth2_v2.rb

@@ -1,40 +0,0 @@
-# Copyright 2015 Google Inc.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#      http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-require 'google/apis/oauth2_v2/service.rb'
-require 'google/apis/oauth2_v2/classes.rb'
-require 'google/apis/oauth2_v2/representations.rb'
-
-module Google
-  module Apis
-    # Google OAuth2 API
-    #
-    # Obtains end-user authorization grants for use with other Google APIs.
-    #
-    # @see https://developers.google.com/identity/protocols/oauth2/
-    module Oauth2V2
-      VERSION = 'V2'
-      REVISION = '20200213'
-
-      # View your email address
-      AUTH_USERINFO_EMAIL = 'https://www.googleapis.com/auth/userinfo.email'
-
-      # See your personal info, including any personal info you've made publicly available
-      AUTH_USERINFO_PROFILE = 'https://www.googleapis.com/auth/userinfo.profile'
-
-      # Associate you with your personal info on Google
-      PENID = 'openid'
-    end
-  end
-end

generated/google/apis/oauth2_v2/classes.rb

@@ -1,165 +0,0 @@
-# Copyright 2015 Google Inc.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#      http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-require 'date'
-require 'google/apis/core/base_service'
-require 'google/apis/core/json_representation'
-require 'google/apis/core/hashable'
-require 'google/apis/errors'
-
-module Google
-  module Apis
-    module Oauth2V2
-      
-      # 
-      class Tokeninfo
-        include Google::Apis::Core::Hashable
-      
-        # Who is the intended audience for this token. In general the same as issued_to.
-        # Corresponds to the JSON property `audience`
-        # @return [String]
-        attr_accessor :audience
-      
-        # The email address of the user. Present only if the email scope is present in
-        # the request.
-        # Corresponds to the JSON property `email`
-        # @return [String]
-        attr_accessor :email
-      
-        # The expiry time of the token, as number of seconds left until expiry.
-        # Corresponds to the JSON property `expires_in`
-        # @return [Fixnum]
-        attr_accessor :expires_in
-      
-        # To whom was the token issued to. In general the same as audience.
-        # Corresponds to the JSON property `issued_to`
-        # @return [String]
-        attr_accessor :issued_to
-      
-        # The space separated list of scopes granted to this token.
-        # Corresponds to the JSON property `scope`
-        # @return [String]
-        attr_accessor :scope
-      
-        # The obfuscated user id.
-        # Corresponds to the JSON property `user_id`
-        # @return [String]
-        attr_accessor :user_id
-      
-        # Boolean flag which is true if the email address is verified. Present only if
-        # the email scope is present in the request.
-        # Corresponds to the JSON property `verified_email`
-        # @return [Boolean]
-        attr_accessor :verified_email
-        alias_method :verified_email?, :verified_email
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @audience = args[:audience] if args.key?(:audience)
-          @email = args[:email] if args.key?(:email)
-          @expires_in = args[:expires_in] if args.key?(:expires_in)
-          @issued_to = args[:issued_to] if args.key?(:issued_to)
-          @scope = args[:scope] if args.key?(:scope)
-          @user_id = args[:user_id] if args.key?(:user_id)
-          @verified_email = args[:verified_email] if args.key?(:verified_email)
-        end
-      end
-      
-      # 
-      class Userinfo
-        include Google::Apis::Core::Hashable
-      
-        # The user's email address.
-        # Corresponds to the JSON property `email`
-        # @return [String]
-        attr_accessor :email
-      
-        # The user's last name.
-        # Corresponds to the JSON property `family_name`
-        # @return [String]
-        attr_accessor :family_name
-      
-        # The user's gender.
-        # Corresponds to the JSON property `gender`
-        # @return [String]
-        attr_accessor :gender
-      
-        # The user's first name.
-        # Corresponds to the JSON property `given_name`
-        # @return [String]
-        attr_accessor :given_name
-      
-        # The hosted domain e.g. example.com if the user is Google apps user.
-        # Corresponds to the JSON property `hd`
-        # @return [String]
-        attr_accessor :hd
-      
-        # The obfuscated ID of the user.
-        # Corresponds to the JSON property `id`
-        # @return [String]
-        attr_accessor :id
-      
-        # URL of the profile page.
-        # Corresponds to the JSON property `link`
-        # @return [String]
-        attr_accessor :link
-      
-        # The user's preferred locale.
-        # Corresponds to the JSON property `locale`
-        # @return [String]
-        attr_accessor :locale
-      
-        # The user's full name.
-        # Corresponds to the JSON property `name`
-        # @return [String]
-        attr_accessor :name
-      
-        # URL of the user's picture image.
-        # Corresponds to the JSON property `picture`
-        # @return [String]
-        attr_accessor :picture
-      
-        # Boolean flag which is true if the email address is verified. Always verified
-        # because we only return the user's primary email address.
-        # Corresponds to the JSON property `verified_email`
-        # @return [Boolean]
-        attr_accessor :verified_email
-        alias_method :verified_email?, :verified_email
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @email = args[:email] if args.key?(:email)
-          @family_name = args[:family_name] if args.key?(:family_name)
-          @gender = args[:gender] if args.key?(:gender)
-          @given_name = args[:given_name] if args.key?(:given_name)
-          @hd = args[:hd] if args.key?(:hd)
-          @id = args[:id] if args.key?(:id)
-          @link = args[:link] if args.key?(:link)
-          @locale = args[:locale] if args.key?(:locale)
-          @name = args[:name] if args.key?(:name)
-          @picture = args[:picture] if args.key?(:picture)
-          @verified_email = args[:verified_email] if args.key?(:verified_email)
-        end
-      end
-    end
-  end
-end

generated/google/apis/oauth2_v2/representations.rb

@@ -1,68 +0,0 @@
-# Copyright 2015 Google Inc.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#      http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-require 'date'
-require 'google/apis/core/base_service'
-require 'google/apis/core/json_representation'
-require 'google/apis/core/hashable'
-require 'google/apis/errors'
-
-module Google
-  module Apis
-    module Oauth2V2
-      
-      class Tokeninfo
-        class Representation < Google::Apis::Core::JsonRepresentation; end
-      
-        include Google::Apis::Core::JsonObjectSupport
-      end
-      
-      class Userinfo
-        class Representation < Google::Apis::Core::JsonRepresentation; end
-      
-        include Google::Apis::Core::JsonObjectSupport
-      end
-      
-      class Tokeninfo
-        # @private
-        class Representation < Google::Apis::Core::JsonRepresentation
-          property :audience, as: 'audience'
-          property :email, as: 'email'
-          property :expires_in, as: 'expires_in'
-          property :issued_to, as: 'issued_to'
-          property :scope, as: 'scope'
-          property :user_id, as: 'user_id'
-          property :verified_email, as: 'verified_email'
-        end
-      end
-      
-      class Userinfo
-        # @private
-        class Representation < Google::Apis::Core::JsonRepresentation
-          property :email, as: 'email'
-          property :family_name, as: 'family_name'
-          property :gender, as: 'gender'
-          property :given_name, as: 'given_name'
-          property :hd, as: 'hd'
-          property :id, as: 'id'
-          property :link, as: 'link'
-          property :locale, as: 'locale'
-          property :name, as: 'name'
-          property :picture, as: 'picture'
-          property :verified_email, as: 'verified_email'
-        end
-      end
-    end
-  end
-end

generated/google/apis/oauth2_v2/service.rb

@@ -1,158 +0,0 @@
-# Copyright 2015 Google Inc.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#      http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-require 'google/apis/core/base_service'
-require 'google/apis/core/json_representation'
-require 'google/apis/core/hashable'
-require 'google/apis/errors'
-
-module Google
-  module Apis
-    module Oauth2V2
-      # Google OAuth2 API
-      #
-      # Obtains end-user authorization grants for use with other Google APIs.
-      #
-      # @example
-      #    require 'google/apis/oauth2_v2'
-      #
-      #    Oauth2 = Google::Apis::Oauth2V2 # Alias the module
-      #    service = Oauth2::Oauth2Service.new
-      #
-      # @see https://developers.google.com/identity/protocols/oauth2/
-      class Oauth2Service < Google::Apis::Core::BaseService
-        # @return [String]
-        #  API key. Your API key identifies your project and provides you with API access,
-        #  quota, and reports. Required unless you provide an OAuth 2.0 token.
-        attr_accessor :key
-
-        # @return [String]
-        #  An opaque string that represents a user for quota purposes. Must not exceed 40
-        #  characters.
-        attr_accessor :quota_user
-
-        # @return [String]
-        #  Deprecated. Please use quotaUser instead.
-        attr_accessor :user_ip
-
-        def initialize
-          super('https://www.googleapis.com/', '')
-          @batch_path = 'batch/oauth2/v2'
-        end
-        
-        # 
-        # @param [String] access_token
-        # @param [String] id_token
-        # @param [String] fields
-        #   Selector specifying which fields to include in a partial response.
-        # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
-        # @param [Google::Apis::RequestOptions] options
-        #   Request-specific options
-        #
-        # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::Oauth2V2::Tokeninfo] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::Oauth2V2::Tokeninfo]
-        #
-        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
-        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
-        # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def tokeninfo(access_token: nil, id_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:post, 'oauth2/v2/tokeninfo', options)
-          command.response_representation = Google::Apis::Oauth2V2::Tokeninfo::Representation
-          command.response_class = Google::Apis::Oauth2V2::Tokeninfo
-          command.query['access_token'] = access_token unless access_token.nil?
-          command.query['id_token'] = id_token unless id_token.nil?
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
-          execute_or_queue_command(command, &block)
-        end
-        
-        # 
-        # @param [String] fields
-        #   Selector specifying which fields to include in a partial response.
-        # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
-        # @param [Google::Apis::RequestOptions] options
-        #   Request-specific options
-        #
-        # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::Oauth2V2::Userinfo] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::Oauth2V2::Userinfo]
-        #
-        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
-        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
-        # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def get_userinfo(fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, 'oauth2/v2/userinfo', options)
-          command.response_representation = Google::Apis::Oauth2V2::Userinfo::Representation
-          command.response_class = Google::Apis::Oauth2V2::Userinfo
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
-          execute_or_queue_command(command, &block)
-        end
-        
-        # 
-        # @param [String] fields
-        #   Selector specifying which fields to include in a partial response.
-        # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
-        # @param [Google::Apis::RequestOptions] options
-        #   Request-specific options
-        #
-        # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::Oauth2V2::Userinfo] parsed result object
-        # @yieldparam err [StandardError] error object if request failed
-        #
-        # @return [Google::Apis::Oauth2V2::Userinfo]
-        #
-        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
-        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
-        # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def get_userinfo_v2(fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, 'userinfo/v2/me', options)
-          command.response_representation = Google::Apis::Oauth2V2::Userinfo::Representation
-          command.response_class = Google::Apis::Oauth2V2::Userinfo
-          command.query['fields'] = fields unless fields.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
-          execute_or_queue_command(command, &block)
-        end
-
-        protected
-
-        def apply_command_defaults(command)
-          command.query['key'] = key unless key.nil?
-          command.query['quotaUser'] = quota_user unless quota_user.nil?
-          command.query['userIp'] = user_ip unless user_ip.nil?
-        end
-      end
-    end
-  end
-end

generated/google/apis/redis_v1.rb

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

generated/google/apis/redis_v1/classes.rb

@@ -22,13 +22,11 @@ module Google
   module Apis
     module RedisV1
       
-      # A generic empty message that you can re-use to avoid defining duplicated
+      # A generic empty message that you can re-use to avoid defining duplicated empty
-      # empty messages in your APIs. A typical example is to use it as the request
+      # messages in your APIs. A typical example is to use it as the request or the
-      # or the response type of an API method. For instance:
+      # response type of an API method. For instance: service Foo ` rpc Bar(google.
-      # service Foo `
+      # protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for
-      # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      # `Empty` is empty JSON object ````.
-      # `
-      # The JSON representation for `Empty` is empty JSON object ````.
       class Empty
         include Google::Apis::Core::Hashable
       
@@ -84,8 +82,8 @@ module Google
       class GcsDestination
         include Google::Apis::Core::Hashable
       
-        # Required. Data destination URI (e.g.
+        # Required. Data destination URI (e.g. 'gs://my_bucket/my_object'). Existing
-        # 'gs://my_bucket/my_object'). Existing files will be overwritten.
+        # files will be overwritten.
         # Corresponds to the JSON property `uri`
         # @return [String]
         attr_accessor :uri
@@ -119,17 +117,16 @@ module Google
         end
       end
       
-      # This location metadata represents additional configuration options for a
+      # This location metadata represents additional configuration options for a given
-      # given location where a Redis instance may be created. All fields are output
+      # location where a Redis instance may be created. All fields are output only. It
-      # only. It is returned as content of the
+      # is returned as content of the `google.cloud.location.Location.metadata` field.
-      # `google.cloud.location.Location.metadata` field.
       class GoogleCloudRedisV1LocationMetadata
         include Google::Apis::Core::Hashable
       
-        # Output only. The set of available zones in the location. The map is keyed
+        # Output only. The set of available zones in the location. The map is keyed by
-        # by the lowercase ID of each zone, as defined by GCE. These keys can be
+        # the lowercase ID of each zone, as defined by GCE. These keys can be specified
-        # specified in `location_id` or `alternative_location_id` fields when
+        # in `location_id` or `alternative_location_id` fields when creating a Redis
-        # creating a Redis instance.
+        # instance.
         # Corresponds to the JSON property `availableZones`
         # @return [Hash<String,Google::Apis::RedisV1::GoogleCloudRedisV1ZoneMetadata>]
         attr_accessor :available_zones
@@ -219,10 +216,9 @@ module Google
         include Google::Apis::Core::Hashable
       
         # consumer_defined_name is the name that is set by the consumer. On the other
-        # hand Name field represents system-assigned id of an instance so consumers
+        # hand Name field represents system-assigned id of an instance so consumers are
-        # are not necessarily aware of it.
+        # not necessarily aware of it. consumer_defined_name is used for notification/UI
-        # consumer_defined_name is used for notification/UI purposes for consumer to
+        # purposes for consumer to recognize their instances.
-        # recognize their instances.
         # Corresponds to the JSON property `consumerDefinedName`
         # @return [String]
         attr_accessor :consumer_defined_name
@@ -232,18 +228,17 @@ module Google
         # @return [String]
         attr_accessor :create_time
       
-        # Optional. Resource labels to represent user provided metadata. Each label
+        # Optional. Resource labels to represent user provided metadata. Each label is a
-        # is a key-value pair, where both the key and the value are arbitrary strings
+        # key-value pair, where both the key and the value are arbitrary strings
         # provided by the user.
         # Corresponds to the JSON property `labels`
         # @return [Hash<String,String>]
         attr_accessor :labels
       
-        # The MaintenancePolicies that have been attached to the instance.
+        # The MaintenancePolicies that have been attached to the instance. The key must
-        # The key must be of the type name of the oneof policy name defined in
+        # be of the type name of the oneof policy name defined in MaintenancePolicy, and
-        # MaintenancePolicy, and the referenced policy must define the same policy
+        # the referenced policy must define the same policy type. For complete details
-        # type. For complete details of MaintenancePolicy, please refer to
+        # of MaintenancePolicy, please refer to go/cloud-saas-mw-ug.
-        # go/cloud-saas-mw-ug.
         # Corresponds to the JSON property `maintenancePolicyNames`
         # @return [Hash<String,String>]
         attr_accessor :maintenance_policy_names
@@ -260,29 +255,28 @@ module Google
         # @return [Google::Apis::RedisV1::GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings]
         attr_accessor :maintenance_settings
       
-        # Unique name of the resource. It uses the form:
+        # Unique name of the resource. It uses the form: `projects/`project_id`/
-        # `projects/`project_id`/locations/`location_id`/instances/`instance_id``
+        # locations/`location_id`/instances/`instance_id``
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # Output only. Custom string attributes used primarily to expose
+        # Output only. Custom string attributes used primarily to expose producer-
-        # producer-specific information in monitoring dashboards.
+        # specific information in monitoring dashboards. See go/get-instance-metadata.
-        # See go/get-instance-metadata.
         # Corresponds to the JSON property `producerMetadata`
         # @return [Hash<String,String>]
         attr_accessor :producer_metadata
       
-        # Output only. The list of data plane resources provisioned for this
+        # Output only. The list of data plane resources provisioned for this instance, e.
-        # instance, e.g. compute VMs. See go/get-instance-metadata.
+        # g. compute VMs. See go/get-instance-metadata.
         # Corresponds to the JSON property `provisionedResources`
         # @return [Array<Google::Apis::RedisV1::GoogleCloudSaasacceleratorManagementProvidersV1ProvisionedResource>]
         attr_accessor :provisioned_resources
       
-        # Link to the SLM instance template. Only populated when updating SLM
+        # Link to the SLM instance template. Only populated when updating SLM instances
-        # instances via SSA's Actuation service adaptor.
+        # via SSA's Actuation service adaptor. Service producers with custom control
-        # Service producers with custom control plane (e.g. Cloud SQL) doesn't
+        # plane (e.g. Cloud SQL) doesn't need to populate this field. Instead they
-        # need to populate this field. Instead they should use software_versions.
+        # should use software_versions.
         # Corresponds to the JSON property `slmInstanceTemplate`
         # @return [String]
         attr_accessor :slm_instance_template
@@ -293,8 +287,8 @@ module Google
         # @return [Google::Apis::RedisV1::GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata]
         attr_accessor :slo_metadata
       
-        # Software versions that are used to deploy this instance. This can be
+        # Software versions that are used to deploy this instance. This can be mutated
-        # mutated by rollout services.
+        # by rollout services.
         # Corresponds to the JSON property `softwareVersions`
         # @return [Hash<String,String>]
         attr_accessor :software_versions
@@ -305,8 +299,8 @@ module Google
         # @return [String]
         attr_accessor :state
       
-        # Output only. ID of the associated GCP tenant project.
+        # Output only. ID of the associated GCP tenant project. See go/get-instance-
-        # See go/get-instance-metadata.
+        # metadata.
         # Corresponds to the JSON property `tenantProjectId`
         # @return [String]
         attr_accessor :tenant_project_id
@@ -345,9 +339,9 @@ module Google
       class GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule
         include Google::Apis::Core::Hashable
       
-        # Can this scheduled update be rescheduled?
+        # Can this scheduled update be rescheduled? By default, it's true and API needs
-        # By default, it's true and API needs to do explicitly check whether it's
+        # to do explicitly check whether it's set, if it's set as false explicitly, it's
-        # set, if it's set as false explicitly, it's false
+        # false
         # Corresponds to the JSON property `canReschedule`
         # @return [Boolean]
         attr_accessor :can_reschedule
@@ -358,9 +352,9 @@ module Google
         # @return [String]
         attr_accessor :end_time
       
-        # The rollout management policy this maintenance schedule is associated
+        # The rollout management policy this maintenance schedule is associated with.
-        # with. When doing reschedule update request, the reschedule should be
+        # When doing reschedule update request, the reschedule should be against this
-        # against this given policy.
+        # given policy.
         # Corresponds to the JSON property `rolloutManagementPolicy`
         # @return [String]
         attr_accessor :rollout_management_policy
@@ -389,8 +383,7 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Optional. Exclude instance from maintenance. When true, rollout service will
-        # not
+        # not attempt maintenance on the instance. Rollout service will include the
-        # attempt maintenance on the instance. Rollout service will include the
         # instance in reported rollout progress as not attempted.
         # Corresponds to the JSON property `exclude`
         # @return [Boolean]
@@ -407,18 +400,17 @@ module Google
         end
       end
       
-      # Node information for custom per-node SLO implementations.
+      # Node information for custom per-node SLO implementations. SSA does not support
-      # SSA does not support per-node SLO, but producers can populate per-node
+      # per-node SLO, but producers can populate per-node information in SloMetadata
-      # information in SloMetadata for custom precomputations.
+      # for custom precomputations. SSA Eligibility Exporter will emit per-node metric
-      # SSA Eligibility Exporter will emit per-node metric based on this information.
+      # based on this information.
       class GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata
         include Google::Apis::Core::Hashable
       
-        # By default node is eligible if instance is eligible.
+        # By default node is eligible if instance is eligible. But individual node might
-        # But individual node might be excluded from SLO by adding entry here.
+        # be excluded from SLO by adding entry here. For semantic see SloMetadata.
-        # For semantic see SloMetadata.exclusions.
+        # exclusions. If both instance and node level exclusions are present for time
-        # If both instance and node level exclusions are present for time period,
+        # period, the node level's reason will be reported by Eligibility Exporter.
-        # the node level's reason will be reported by Eligibility Exporter.
         # Corresponds to the JSON property `exclusions`
         # @return [Array<Google::Apis::RedisV1::GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion>]
         attr_accessor :exclusions
@@ -428,8 +420,7 @@ module Google
         # @return [String]
         attr_accessor :location
       
-        # The id of the node.
+        # The id of the node. This should be equal to SaasInstanceNode.node_id.
-        # This should be equal to SaasInstanceNode.node_id.
         # Corresponds to the JSON property `nodeId`
         # @return [String]
         attr_accessor :node_id
@@ -450,18 +441,17 @@ module Google
       class GoogleCloudSaasacceleratorManagementProvidersV1ProvisionedResource
         include Google::Apis::Core::Hashable
       
-        # Type of the resource. This can be either a GCP resource or a custom one
+        # Type of the resource. This can be either a GCP resource or a custom one (e.g.
-        # (e.g. another cloud provider's VM). For GCP compute resources use singular
+        # another cloud provider's VM). For GCP compute resources use singular form of
-        # form of the names listed in GCP compute API documentation
+        # the names listed in GCP compute API documentation (https://cloud.google.com/
-        # (https://cloud.google.com/compute/docs/reference/rest/v1/), prefixed with
+        # compute/docs/reference/rest/v1/), prefixed with 'compute-', for example: '
-        # 'compute-', for example: 'compute-instance', 'compute-disk',
+        # compute-instance', 'compute-disk', 'compute-autoscaler'.
-        # 'compute-autoscaler'.
         # Corresponds to the JSON property `resourceType`
         # @return [String]
         attr_accessor :resource_type
       
-        # URL identifying the resource, e.g.
+        # URL identifying the resource, e.g. "https://www.googleapis.com/compute/v1/
-        # "https://www.googleapis.com/compute/v1/projects/...)".
+        # projects/...)".
         # Corresponds to the JSON property `resourceUrl`
         # @return [String]
         attr_accessor :resource_url
@@ -477,9 +467,9 @@ module Google
         end
       end
       
-      # SloEligibility is a tuple containing eligibility value: true if an instance
+      # SloEligibility is a tuple containing eligibility value: true if an instance is
-      # is eligible for SLO calculation or false if it should be excluded from all
+      # eligible for SLO calculation or false if it should be excluded from all SLO-
-      # SLO-related calculations along with a user-defined reason.
+      # related calculations along with a user-defined reason.
       class GoogleCloudSaasacceleratorManagementProvidersV1SloEligibility
         include Google::Apis::Core::Hashable
       
@@ -490,8 +480,7 @@ module Google
         alias_method :eligible?, :eligible
       
         # User-defined reason for the current value of instance eligibility. Usually,
-        # this can be directly mapped to the internal state. An empty reason is
+        # this can be directly mapped to the internal state. An empty reason is allowed.
-        # allowed.
         # Corresponds to the JSON property `reason`
         # @return [String]
         attr_accessor :reason
@@ -511,28 +500,27 @@ module Google
       class GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion
         include Google::Apis::Core::Hashable
       
-        # Exclusion duration. No restrictions on the possible values.
+        # Exclusion duration. No restrictions on the possible values. When an ongoing
-        # When an ongoing operation is taking longer than initially expected,
+        # operation is taking longer than initially expected, an existing entry in the
-        # an existing entry in the exclusion list can be updated by extending the
+        # exclusion list can be updated by extending the duration. This is supported by
-        # duration. This is supported by the subsystem exporting eligibility data
+        # the subsystem exporting eligibility data as long as such extension is
-        # as long as such extension is committed at least 10 minutes before the
+        # committed at least 10 minutes before the original exclusion expiration -
-        # original exclusion expiration - otherwise it is possible that there will
+        # otherwise it is possible that there will be "gaps" in the exclusion
-        # be "gaps" in the exclusion application in the exported timeseries.
+        # application in the exported timeseries.
         # Corresponds to the JSON property `duration`
         # @return [String]
         attr_accessor :duration
       
-        # Human-readable reason for the exclusion.
+        # Human-readable reason for the exclusion. This should be a static string (e.g. "
-        # This should be a static string (e.g. "Disruptive update in progress")
+        # Disruptive update in progress") and should not contain dynamically generated
-        # and should not contain dynamically generated data (e.g. instance name).
+        # data (e.g. instance name). Can be left empty.
-        # Can be left empty.
         # Corresponds to the JSON property `reason`
         # @return [String]
         attr_accessor :reason
       
-        # Name of an SLI that this exclusion applies to. Can be left empty,
+        # Name of an SLI that this exclusion applies to. Can be left empty, signaling
-        # signaling that the instance should be excluded from all SLIs defined
+        # that the instance should be excluded from all SLIs defined in the service SLO
-        # in the service SLO configuration.
+        # configuration.
         # Corresponds to the JSON property `sliName`
         # @return [String]
         attr_accessor :sli_name
@@ -560,40 +548,38 @@ module Google
       class GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata
         include Google::Apis::Core::Hashable
       
-        # SloEligibility is a tuple containing eligibility value: true if an instance
+        # SloEligibility is a tuple containing eligibility value: true if an instance is
-        # is eligible for SLO calculation or false if it should be excluded from all
+        # eligible for SLO calculation or false if it should be excluded from all SLO-
-        # SLO-related calculations along with a user-defined reason.
+        # related calculations along with a user-defined reason.
         # Corresponds to the JSON property `eligibility`
         # @return [Google::Apis::RedisV1::GoogleCloudSaasacceleratorManagementProvidersV1SloEligibility]
         attr_accessor :eligibility
       
-        # List of SLO exclusion windows. When multiple entries in the list match
+        # List of SLO exclusion windows. When multiple entries in the list match (
-        # (matching the exclusion time-window against current time point)
+        # matching the exclusion time-window against current time point) the exclusion
-        # the exclusion reason used in the first matching entry will be published.
+        # reason used in the first matching entry will be published. It is not needed to
-        # It is not needed to include expired exclusion in this list, as only the
+        # include expired exclusion in this list, as only the currently applicable
-        # currently applicable exclusions are taken into account by the eligibility
+        # exclusions are taken into account by the eligibility exporting subsystem (the
-        # exporting subsystem (the historical state of exclusions will be reflected
+        # historical state of exclusions will be reflected in the historically produced
-        # in the historically produced timeseries regardless of the current state).
+        # timeseries regardless of the current state). This field can be used to mark
-        # This field can be used to mark the instance as temporary ineligible
+        # the instance as temporary ineligible for the purpose of SLO calculation. For
-        # for the purpose of SLO calculation. For permanent instance SLO exclusion,
+        # permanent instance SLO exclusion, use of custom instance eligibility is
-        # use of custom instance eligibility is recommended. See 'eligibility' field
+        # recommended. See 'eligibility' field below.
-        # below.
         # Corresponds to the JSON property `exclusions`
         # @return [Array<Google::Apis::RedisV1::GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion>]
         attr_accessor :exclusions
       
-        # Optional. List of nodes.
+        # Optional. List of nodes. Some producers need to use per-node metadata to
-        # Some producers need to use per-node metadata to calculate SLO.
+        # calculate SLO. This field allows such producers to publish per-node SLO meta
-        # This field allows such producers to publish per-node SLO meta data,
+        # data, which will be consumed by SSA Eligibility Exporter and published in the
-        # which will be consumed by SSA Eligibility Exporter and published in the
         # form of per node metric to Monarch.
         # Corresponds to the JSON property `nodes`
         # @return [Array<Google::Apis::RedisV1::GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata>]
         attr_accessor :nodes
       
         # Name of the SLO tier the Instance belongs to. This name will be expected to
-        # match the tiers specified in the service SLO configuration.
+        # match the tiers specified in the service SLO configuration. Field is mandatory
-        # Field is mandatory and must not be empty.
+        # and must not be empty.
         # Corresponds to the JSON property `tier`
         # @return [String]
         attr_accessor :tier
@@ -660,16 +646,15 @@ module Google
         # @return [String]
         attr_accessor :alternative_location_id
       
-        # Optional. The full name of the Google Compute Engine
+        # Optional. The full name of the Google Compute Engine [network](https://cloud.
-        # [network](https://cloud.google.com/vpc/docs/vpc) to which the
+        # google.com/vpc/docs/vpc) to which the instance is connected. If left
-        # instance is connected. If left unspecified, the `default` network
+        # unspecified, the `default` network will be used.
-        # will be used.
         # Corresponds to the JSON property `authorizedNetwork`
         # @return [String]
         attr_accessor :authorized_network
       
-        # Optional. The network connect mode of the Redis instance.
+        # Optional. The network connect mode of the Redis instance. If not provided, the
-        # If not provided, the connect mode defaults to DIRECT_PEERING.
+        # connect mode defaults to DIRECT_PEERING.
         # Corresponds to the JSON property `connectMode`
         # @return [String]
         attr_accessor :connect_mode
@@ -680,10 +665,9 @@ module Google
         attr_accessor :create_time
       
         # Output only. The current zone where the Redis endpoint is placed. For Basic
-        # Tier instances, this will always be the same as the location_id
+        # Tier instances, this will always be the same as the location_id provided by
-        # provided by the user at creation time. For Standard Tier instances,
+        # the user at creation time. For Standard Tier instances, this can be either
-        # this can be either location_id or alternative_location_id and can
+        # location_id or alternative_location_id and can change after a failover event.
-        # change after a failover event.
         # Corresponds to the JSON property `currentLocationId`
         # @return [String]
         attr_accessor :current_location_id
@@ -707,8 +691,8 @@ module Google
         # Optional. The zone where the instance will be provisioned. If not provided,
         # the service will choose a zone for the instance. For STANDARD_HA tier,
         # instances will be created across two zones for protection against zonal
-        # failures. If alternative_location_id is also provided, it must be
+        # failures. If alternative_location_id is also provided, it must be different
-        # different from location_id.
+        # from location_id.
         # Corresponds to the JSON property `locationId`
         # @return [String]
         attr_accessor :location_id
@@ -719,21 +703,19 @@ module Google
         attr_accessor :memory_size_gb
       
         # Required. Unique name of the resource in this scope including project and
-        # location using the form:
+        # location using the form: `projects/`project_id`/locations/`location_id`/
-        # `projects/`project_id`/locations/`location_id`/instances/`instance_id``
+        # instances/`instance_id`` Note: Redis instances are managed and addressed at
-        # Note: Redis instances are managed and addressed at regional level so
+        # regional level so location_id here refers to a GCP region; however, users may
-        # location_id here refers to a GCP region; however, users may choose which
+        # choose which specific zone (or collection of zones for cross-zone instances)
-        # specific zone (or collection of zones for cross-zone instances) an instance
+        # an instance should be provisioned in. Refer to location_id and
-        # should be provisioned in. Refer to location_id and
         # alternative_location_id fields for more details.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # Output only. Cloud IAM identity used by import / export operations to
+        # Output only. Cloud IAM identity used by import / export operations to transfer
-        # transfer data to/from Cloud Storage. Format is
+        # data to/from Cloud Storage. Format is "serviceAccount:". The value may change
-        # "serviceAccount:<service_account_email>". The value may change over time
+        # over time for a given instance so should be checked before each import/export
-        # for a given instance so should be checked before each import/export
         # operation.
         # Corresponds to the JSON property `persistenceIamIdentity`
         # @return [String]
@@ -744,38 +726,27 @@ module Google
         # @return [Fixnum]
         attr_accessor :port
       
-        # Optional. Redis configuration parameters, according to
+        # Optional. Redis configuration parameters, according to http://redis.io/topics/
-        # http://redis.io/topics/config. Currently, the only supported parameters
+        # config. Currently, the only supported parameters are: Redis version 3.2 and
-        # are:
+        # newer: * maxmemory-policy * notify-keyspace-events Redis version 4.0 and newer:
-        # Redis version 3.2 and newer:
+        # * activedefrag * lfu-decay-time * lfu-log-factor * maxmemory-gb Redis version
-        # *   maxmemory-policy
+        # 5.0 and newer: * stream-node-max-bytes * stream-node-max-entries
-        # *   notify-keyspace-events
-        # Redis version 4.0 and newer:
-        # *   activedefrag
-        # *   lfu-decay-time
-        # *   lfu-log-factor
-        # *   maxmemory-gb
-        # Redis version 5.0 and newer:
-        # *   stream-node-max-bytes
-        # *   stream-node-max-entries
         # Corresponds to the JSON property `redisConfigs`
         # @return [Hash<String,String>]
         attr_accessor :redis_configs
       
-        # Optional. The version of Redis software.
+        # Optional. The version of Redis software. If not provided, latest supported
-        # If not provided, latest supported version will be used. Currently, the
+        # version will be used. Currently, the supported values are: * `REDIS_3_2` for
-        # supported values are:
+        # Redis 3.2 compatibility * `REDIS_4_0` for Redis 4.0 compatibility (default) * `
-        # *   `REDIS_3_2` for Redis 3.2 compatibility
+        # REDIS_5_0` for Redis 5.0 compatibility
-        # *   `REDIS_4_0` for Redis 4.0 compatibility (default)
-        # *   `REDIS_5_0` for Redis 5.0 compatibility
         # Corresponds to the JSON property `redisVersion`
         # @return [String]
         attr_accessor :redis_version
       
         # Optional. The CIDR range of internal addresses that are reserved for this
-        # instance. If not provided, the service will choose an unused /29 block,
+        # instance. If not provided, the service will choose an unused /29 block, for
-        # for example, 10.0.0.0/29 or 192.168.0.0/29. Ranges must be unique
+        # example, 10.0.0.0/29 or 192.168.0.0/29. Ranges must be unique and non-
-        # and non-overlapping with existing subnets in an authorized network.
+        # overlapping with existing subnets in an authorized network.
         # Corresponds to the JSON property `reservedIpRange`
         # @return [String]
         attr_accessor :reserved_ip_range
@@ -785,8 +756,8 @@ module Google
         # @return [String]
         attr_accessor :state
       
-        # Output only. Additional information about the current status of this
+        # Output only. Additional information about the current status of this instance,
-        # instance, if available.
+        # if available.
         # Corresponds to the JSON property `statusMessage`
         # @return [String]
         attr_accessor :status_message
@@ -828,15 +799,14 @@ module Google
       class ListInstancesResponse
         include Google::Apis::Core::Hashable
       
-        # A list of Redis instances in the project in the specified location,
+        # A list of Redis instances in the project in the specified location, or across
-        # or across all locations.
+        # all locations. If the `location_id` in the parent field of the request is "-",
-        # If the `location_id` in the parent field of the request is "-", all regions
+        # all regions available to the project are queried, and the results aggregated.
-        # available to the project are queried, and the results aggregated.
+        # If in such an aggregated query a location is unavailable, a dummy Redis entry
-        # If in such an aggregated query a location is unavailable, a dummy Redis
+        # is included in the response with the `name` field set to a value of the form `
-        # entry is included in the response with the `name` field set to a value of
+        # projects/`project_id`/locations/`location_id`/instances/`- and the `status`
-        # the form `projects/`project_id`/locations/`location_id`/instances/`- and
+        # field set to ERROR and `status_message` field set to "location not available
-        # the `status` field set to ERROR and `status_message` field set to "location
+        # for ListInstances".
-        # not available for ListInstances".
         # Corresponds to the JSON property `instances`
         # @return [Array<Google::Apis::RedisV1::Instance>]
         attr_accessor :instances
@@ -918,14 +888,14 @@ module Google
       class Location
         include Google::Apis::Core::Hashable
       
-        # The friendly name for this location, typically a nearby city name.
+        # The friendly name for this location, typically a nearby city name. For example,
-        # For example, "Tokyo".
+        # "Tokyo".
         # Corresponds to the JSON property `displayName`
         # @return [String]
         attr_accessor :display_name
       
-        # Cross-service attributes for the location. For example
+        # Cross-service attributes for the location. For example `"cloud.googleapis.com/
-        # `"cloud.googleapis.com/region": "us-east1"`
+        # region": "us-east1"`
         # Corresponds to the JSON property `labels`
         # @return [Hash<String,String>]
         attr_accessor :labels
@@ -968,55 +938,49 @@ module Google
       class Operation
         include Google::Apis::Core::Hashable
       
-        # If the value is `false`, it means the operation is still in progress.
+        # If the value is `false`, it means the operation is still in progress. If `true`
-        # If `true`, the operation is completed, and either `error` or `response` is
+        # , the operation is completed, and either `error` or `response` is available.
-        # available.
         # Corresponds to the JSON property `done`
         # @return [Boolean]
         attr_accessor :done
         alias_method :done?, :done
       
-        # The `Status` type defines a logical error model that is suitable for
+        # The `Status` type defines a logical error model that is suitable for different
-        # different programming environments, including REST APIs and RPC APIs. It is
+        # programming environments, including REST APIs and RPC APIs. It is used by [
-        # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+        # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
-        # three pieces of data: error code, error message, and error details.
+        # data: error code, error message, and error details. You can find out more
-        # You can find out more about this error model and how to work with it in the
+        # about this error model and how to work with it in the [API Design Guide](https:
-        # [API Design Guide](https://cloud.google.com/apis/design/errors).
+        # //cloud.google.com/apis/design/errors).
         # Corresponds to the JSON property `error`
         # @return [Google::Apis::RedisV1::Status]
         attr_accessor :error
       
-        # `
+        # ` `createTime`: The time the operation was created. `endTime`: The time the
-        # `createTime`: The time the operation was created.
+        # operation finished running. `target`: Server-defined resource path for the
-        # `endTime`: The time the operation finished running.
+        # target of the operation. `verb`: Name of the verb executed by the operation. `
-        # `target`: Server-defined resource path for the target of the operation.
+        # statusDetail`: Human-readable status of the operation, if any. `
-        # `verb`: Name of the verb executed by the operation.
+        # cancelRequested`: Identifies whether the user has requested cancellation of
-        # `statusDetail`: Human-readable status of the operation, if any.
-        # `cancelRequested`: Identifies whether the user has requested cancellation of
         # the operation. Operations that have successfully been cancelled have Operation.
         # error value with a google.rpc.Status.code of 1, corresponding to `Code.
-        # CANCELLED`.
+        # CANCELLED`. `apiVersion`: API version used to start the operation. `
-        # `apiVersion`: API version used to start the operation.
-        # `
         # Corresponds to the JSON property `metadata`
         # @return [Hash<String,Object>]
         attr_accessor :metadata
       
         # The server-assigned name, which is only unique within the same service that
-        # originally returns it. If you use the default HTTP mapping, the
+        # originally returns it. If you use the default HTTP mapping, the `name` should
-        # `name` should be a resource name ending with `operations/`unique_id``.
+        # be a resource name ending with `operations/`unique_id``.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # The normal response of the operation in case of success.  If the original
+        # The normal response of the operation in case of success. If the original
-        # method returns no data on success, such as `Delete`, the response is
+        # method returns no data on success, such as `Delete`, the response is `google.
-        # `google.protobuf.Empty`.  If the original method is standard
+        # protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`,
-        # `Get`/`Create`/`Update`, the response should be the resource.  For other
+        # the response should be the resource. For other methods, the response should
-        # methods, the response should have the type `XxxResponse`, where `Xxx`
+        # have the type `XxxResponse`, where `Xxx` is the original method name. For
-        # is the original method name.  For example, if the original method name
+        # example, if the original method name is `TakeSnapshot()`, the inferred
-        # is `TakeSnapshot()`, the inferred response type is
+        # response type is `TakeSnapshotResponse`.
-        # `TakeSnapshotResponse`.
         # Corresponds to the JSON property `response`
         # @return [Hash<String,Object>]
         attr_accessor :response
@@ -1054,12 +1018,12 @@ module Google
         end
       end
       
-      # The `Status` type defines a logical error model that is suitable for
+      # The `Status` type defines a logical error model that is suitable for different
-      # different programming environments, including REST APIs and RPC APIs. It is
+      # programming environments, including REST APIs and RPC APIs. It is used by [
-      # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+      # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
-      # three pieces of data: error code, error message, and error details.
+      # data: error code, error message, and error details. You can find out more
-      # You can find out more about this error model and how to work with it in the
+      # about this error model and how to work with it in the [API Design Guide](https:
-      # [API Design Guide](https://cloud.google.com/apis/design/errors).
+      # //cloud.google.com/apis/design/errors).
       class Status
         include Google::Apis::Core::Hashable
       
@@ -1068,15 +1032,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
+        # A developer-facing error message, which should be in English. Any user-facing
-        # user-facing error message should be localized and sent in the
+        # error message should be localized and sent in the google.rpc.Status.details
-        # google.rpc.Status.details field, or localized by the client.
+        # field, or localized by the client.
         # Corresponds to the JSON property `message`
         # @return [String]
         attr_accessor :message

generated/google/apis/redis_v1/service.rb

@@ -116,28 +116,25 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a Redis instance based on the specified tier and memory size.
+        # Creates a Redis instance based on the specified tier and memory size. By
-        # By default, the instance is accessible from the project's
+        # default, the instance is accessible from the project's [default network](https:
-        # [default network](https://cloud.google.com/vpc/docs/vpc).
+        # //cloud.google.com/vpc/docs/vpc). The creation is executed asynchronously and
-        # The creation is executed asynchronously and callers may check the returned
+        # callers may check the returned operation to track its progress. Once the
-        # operation to track its progress. Once the operation is completed the Redis
+        # operation is completed the Redis instance will be fully functional. Completed
-        # instance will be fully functional. Completed longrunning.Operation will
+        # longrunning.Operation will contain the new instance object in the response
-        # contain the new instance object in the response field.
+        # field. The returned operation is automatically deleted after a few hours, so
-        # The returned operation is automatically deleted after a few hours, so there
+        # there is no need to call DeleteOperation.
-        # is no need to call DeleteOperation.
         # @param [String] parent
-        #   Required. The resource name of the instance location using the form:
+        #   Required. The resource name of the instance location using the form: `projects/
-        #   `projects/`project_id`/locations/`location_id``
+        #   `project_id`/locations/`location_id`` where `location_id` refers to a GCP
-        #   where `location_id` refers to a GCP region.
+        #   region.
         # @param [Google::Apis::RedisV1::Instance] instance_object
         # @param [String] instance_id
-        #   Required. The logical name of the Redis instance in the customer project
+        #   Required. The logical name of the Redis instance in the customer project with
-        #   with the following restrictions:
+        #   the following restrictions: * Must contain only lowercase letters, numbers,
-        #   * Must contain only lowercase letters, numbers, and hyphens.
+        #   and hyphens. * Must start with a letter. * Must be between 1-40 characters. *
-        #   * Must start with a letter.
+        #   Must end with a number or a letter. * Must be unique within the customer
-        #   * Must be between 1-40 characters.
+        #   project / location
-        #   * Must end with a number or a letter.
-        #   * Must be unique within the customer project / location
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -168,12 +165,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a specific Redis instance.  Instance stops serving and data is
+        # Deletes a specific Redis instance. Instance stops serving and data is deleted.
-        # deleted.
         # @param [String] name
-        #   Required. Redis instance resource name using the form:
+        #   Required. Redis instance resource name using the form: `projects/`project_id`/
-        #   `projects/`project_id`/locations/`location_id`/instances/`instance_id``
+        #   locations/`location_id`/instances/`instance_id`` where `location_id` refers to
-        #   where `location_id` refers to a GCP region.
+        #   a GCP region.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -202,13 +198,13 @@ module Google
         end
         
         # Export Redis instance data into a Redis RDB format file in Cloud Storage.
-        # Redis will continue serving during this operation.
+        # Redis will continue serving during this operation. The returned operation is
-        # The returned operation is automatically deleted after a few hours, so
+        # automatically deleted after a few hours, so there is no need to call
-        # there is no need to call DeleteOperation.
+        # DeleteOperation.
         # @param [String] name
-        #   Required. Redis instance resource name using the form:
+        #   Required. Redis instance resource name using the form: `projects/`project_id`/
-        #   `projects/`project_id`/locations/`location_id`/instances/`instance_id``
+        #   locations/`location_id`/instances/`instance_id`` where `location_id` refers to
-        #   where `location_id` refers to a GCP region.
+        #   a GCP region.
         # @param [Google::Apis::RedisV1::ExportInstanceRequest] export_instance_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -239,12 +235,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Initiates a failover of the master node to current replica node for a
+        # Initiates a failover of the master node to current replica node for a specific
-        # specific STANDARD tier Cloud Memorystore for Redis instance.
+        # STANDARD tier Cloud Memorystore for Redis instance.
         # @param [String] name
-        #   Required. Redis instance resource name using the form:
+        #   Required. Redis instance resource name using the form: `projects/`project_id`/
-        #   `projects/`project_id`/locations/`location_id`/instances/`instance_id``
+        #   locations/`location_id`/instances/`instance_id`` where `location_id` refers to
-        #   where `location_id` refers to a GCP region.
+        #   a GCP region.
         # @param [Google::Apis::RedisV1::FailoverInstanceRequest] failover_instance_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -277,9 +273,9 @@ module Google
         
         # Gets the details of a specific Redis instance.
         # @param [String] name
-        #   Required. Redis instance resource name using the form:
+        #   Required. Redis instance resource name using the form: `projects/`project_id`/
-        #   `projects/`project_id`/locations/`location_id`/instances/`instance_id``
+        #   locations/`location_id`/instances/`instance_id`` where `location_id` refers to
-        #   where `location_id` refers to a GCP region.
+        #   a GCP region.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -308,15 +304,14 @@ module Google
         end
         
         # Import a Redis RDB snapshot file from Cloud Storage into a Redis instance.
-        # Redis may stop serving during this operation. Instance state will be
+        # Redis may stop serving during this operation. Instance state will be IMPORTING
-        # IMPORTING for entire operation. When complete, the instance will contain
+        # for entire operation. When complete, the instance will contain only data from
-        # only data from the imported file.
+        # the imported file. The returned operation is automatically deleted after a few
-        # The returned operation is automatically deleted after a few hours, so
+        # hours, so there is no need to call DeleteOperation.
-        # there is no need to call DeleteOperation.
         # @param [String] name
-        #   Required. Redis instance resource name using the form:
+        #   Required. Redis instance resource name using the form: `projects/`project_id`/
-        #   `projects/`project_id`/locations/`location_id`/instances/`instance_id``
+        #   locations/`location_id`/instances/`instance_id`` where `location_id` refers to
-        #   where `location_id` refers to a GCP region.
+        #   a GCP region.
         # @param [Google::Apis::RedisV1::ImportInstanceRequest] import_instance_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -347,26 +342,24 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists all Redis instances owned by a project in either the specified
+        # Lists all Redis instances owned by a project in either the specified location (
-        # location (region) or all locations.
+        # region) or all locations. The location should have the following format: * `
-        # The location should have the following format:
+        # projects/`project_id`/locations/`location_id`` If `location_id` is specified
-        # * `projects/`project_id`/locations/`location_id``
+        # as `-` (wildcard), then all regions available to the project are queried, and
-        # If `location_id` is specified as `-` (wildcard), then all regions
+        # the results are aggregated.
-        # available to the project are queried, and the results are aggregated.
         # @param [String] parent
-        #   Required. The resource name of the instance location using the form:
+        #   Required. The resource name of the instance location using the form: `projects/
-        #   `projects/`project_id`/locations/`location_id``
+        #   `project_id`/locations/`location_id`` where `location_id` refers to a GCP
-        #   where `location_id` refers to a GCP region.
+        #   region.
         # @param [Fixnum] page_size
-        #   The maximum number of items to return.
+        #   The maximum number of items to return. If not specified, a default value of
-        #   If not specified, a default value of 1000 will be used by the service.
+        #   1000 will be used by the service. Regardless of the page_size value, the
-        #   Regardless of the page_size value, the response may include a partial list
+        #   response may include a partial list and a caller should only rely on response'
-        #   and a caller should only rely on response's
+        #   s `next_page_token` to determine if there are more instances left to be
-        #   `next_page_token`
+        #   queried.
-        #   to determine if there are more instances left to be queried.
         # @param [String] page_token
-        #   The `next_page_token` value returned from a previous
+        #   The `next_page_token` value returned from a previous ListInstances request, if
-        #   ListInstances request, if any.
+        #   any.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -396,28 +389,23 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates the metadata and configuration of a specific Redis instance.
+        # Updates the metadata and configuration of a specific Redis instance. Completed
-        # Completed longrunning.Operation will contain the new instance object
+        # longrunning.Operation will contain the new instance object in the response
-        # in the response field. The returned operation is automatically deleted
+        # field. The returned operation is automatically deleted after a few hours, so
-        # after a few hours, so there is no need to call DeleteOperation.
+        # there is no need to call DeleteOperation.
         # @param [String] name
         #   Required. Unique name of the resource in this scope including project and
-        #   location using the form:
+        #   location using the form: `projects/`project_id`/locations/`location_id`/
-        #   `projects/`project_id`/locations/`location_id`/instances/`instance_id``
+        #   instances/`instance_id`` Note: Redis instances are managed and addressed at
-        #   Note: Redis instances are managed and addressed at regional level so
+        #   regional level so location_id here refers to a GCP region; however, users may
-        #   location_id here refers to a GCP region; however, users may choose which
+        #   choose which specific zone (or collection of zones for cross-zone instances)
-        #   specific zone (or collection of zones for cross-zone instances) an instance
+        #   an instance should be provisioned in. Refer to location_id and
-        #   should be provisioned in. Refer to location_id and
         #   alternative_location_id fields for more details.
         # @param [Google::Apis::RedisV1::Instance] instance_object
         # @param [String] update_mask
-        #   Required. Mask of fields to update. At least one path must be supplied in
+        #   Required. Mask of fields to update. At least one path must be supplied in this
-        #   this field. The elements of the repeated paths field may only include these
+        #   field. The elements of the repeated paths field may only include these fields
-        #   fields from Instance:
+        #   from Instance: * `displayName` * `labels` * `memorySizeGb` * `redisConfig`
-        #   *   `displayName`
-        #   *   `labels`
-        #   *   `memorySizeGb`
-        #   *   `redisConfig`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -448,12 +436,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Upgrades Redis instance to the newer Redis version specified in the
+        # Upgrades Redis instance to the newer Redis version specified in the request.
-        # request.
         # @param [String] name
-        #   Required. Redis instance resource name using the form:
+        #   Required. Redis instance resource name using the form: `projects/`project_id`/
-        #   `projects/`project_id`/locations/`location_id`/instances/`instance_id``
+        #   locations/`location_id`/instances/`instance_id`` where `location_id` refers to
-        #   where `location_id` refers to a GCP region.
+        #   a GCP region.
         # @param [Google::Apis::RedisV1::UpgradeInstanceRequest] upgrade_instance_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -484,15 +471,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Starts asynchronous cancellation on a long-running operation.  The server
+        # Starts asynchronous cancellation on a long-running operation. The server makes
-        # makes a best effort to cancel the operation, but success is not
+        # a best effort to cancel the operation, but success is not guaranteed. If the
-        # guaranteed.  If the server doesn't support this method, it returns
+        # server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.
-        # `google.rpc.Code.UNIMPLEMENTED`.  Clients can use
+        # Clients can use Operations.GetOperation or other methods to check whether the
-        # Operations.GetOperation or
+        # cancellation succeeded or whether the operation completed despite cancellation.
-        # other methods to check whether the cancellation succeeded or whether the
+        # On successful cancellation, the operation is not deleted; instead, it becomes
-        # operation completed despite cancellation. On successful cancellation,
+        # an operation with an Operation.error value with a google.rpc.Status.code of 1,
-        # the operation is not deleted; instead, it becomes an operation with
-        # an Operation.error value with a google.rpc.Status.code of 1,
         # corresponding to `Code.CANCELLED`.
         # @param [String] name
         #   The name of the operation resource to be cancelled.
@@ -523,10 +508,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a long-running operation. This method indicates that the client is
+        # Deletes a long-running operation. This method indicates that the client is no
-        # no longer interested in the operation result. It does not cancel the
+        # longer interested in the operation result. It does not cancel the operation.
-        # operation. If the server doesn't support this method, it returns
+        # If the server doesn't support this method, it returns `google.rpc.Code.
-        # `google.rpc.Code.UNIMPLEMENTED`.
+        # UNIMPLEMENTED`.
         # @param [String] name
         #   The name of the operation resource to be deleted.
         # @param [String] fields
@@ -556,9 +541,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the latest state of a long-running operation.  Clients can use this
+        # Gets the latest state of a long-running operation. Clients can use this method
-        # method to poll the operation result at intervals as recommended by the API
+        # to poll the operation result at intervals as recommended by the API service.
-        # service.
         # @param [String] name
         #   The name of the operation resource.
         # @param [String] fields
@@ -588,15 +572,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists operations that match the specified filter in the request. If the
+        # Lists operations that match the specified filter in the request. If the server
-        # server doesn't support this method, it returns `UNIMPLEMENTED`.
+        # doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name`
-        # NOTE: the `name` binding allows API services to override the binding
+        # binding allows API services to override the binding to use different resource
-        # to use different resource name schemes, such as `users/*/operations`. To
+        # name schemes, such as `users/*/operations`. To override the binding, API
-        # override the binding, API services can add a binding such as
+        # services can add a binding such as `"/v1/`name=users/*`/operations"` to their
-        # `"/v1/`name=users/*`/operations"` to their service configuration.
+        # service configuration. For backwards compatibility, the default name includes
-        # For backwards compatibility, the default name includes the operations
+        # the operations collection id, however overriding users must ensure the name
-        # collection id, however overriding users must ensure the name binding
+        # binding is the parent resource, without the operations collection id.
-        # is the parent resource, without the operations collection id.
         # @param [String] name
         #   The name of the operation's parent resource.
         # @param [String] filter

generated/google/apis/redis_v1beta1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/memorystore/docs/redis/
     module RedisV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20200722'
+      REVISION = '20200810'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

generated/google/apis/redis_v1beta1/classes.rb

@@ -22,13 +22,11 @@ module Google
   module Apis
     module RedisV1beta1
       
-      # A generic empty message that you can re-use to avoid defining duplicated
+      # A generic empty message that you can re-use to avoid defining duplicated empty
-      # empty messages in your APIs. A typical example is to use it as the request
+      # messages in your APIs. A typical example is to use it as the request or the
-      # or the response type of an API method. For instance:
+      # response type of an API method. For instance: service Foo ` rpc Bar(google.
-      # service Foo `
+      # protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for
-      # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      # `Empty` is empty JSON object ````.
-      # `
-      # The JSON representation for `Empty` is empty JSON object ````.
       class Empty
         include Google::Apis::Core::Hashable
       
@@ -84,8 +82,8 @@ module Google
       class GcsDestination
         include Google::Apis::Core::Hashable
       
-        # Required. Data destination URI (e.g.
+        # Required. Data destination URI (e.g. 'gs://my_bucket/my_object'). Existing
-        # 'gs://my_bucket/my_object'). Existing files will be overwritten.
+        # files will be overwritten.
         # Corresponds to the JSON property `uri`
         # @return [String]
         attr_accessor :uri
@@ -128,10 +126,10 @@ module Google
         # @return [String]
         attr_accessor :api_version
       
-        # [Output only] Identifies whether the user has requested cancellation
+        # [Output only] Identifies whether the user has requested cancellation of the
-        # of the operation. Operations that have successfully been cancelled
+        # operation. Operations that have successfully been cancelled have Operation.
-        # have Operation.error value with a google.rpc.Status.code of 1,
+        # error value with a google.rpc.Status.code of 1, corresponding to `Code.
-        # corresponding to `Code.CANCELLED`.
+        # CANCELLED`.
         # Corresponds to the JSON property `cancelRequested`
         # @return [Boolean]
         attr_accessor :cancel_requested
@@ -178,17 +176,16 @@ module Google
         end
       end
       
-      # This location metadata represents additional configuration options for a
+      # This location metadata represents additional configuration options for a given
-      # given location where a Redis instance may be created. All fields are output
+      # location where a Redis instance may be created. All fields are output only. It
-      # only. It is returned as content of the
+      # is returned as content of the `google.cloud.location.Location.metadata` field.
-      # `google.cloud.location.Location.metadata` field.
       class GoogleCloudRedisV1beta1LocationMetadata
         include Google::Apis::Core::Hashable
       
-        # Output only. The set of available zones in the location. The map is keyed
+        # Output only. The set of available zones in the location. The map is keyed by
-        # by the lowercase ID of each zone, as defined by GCE. These keys can be
+        # the lowercase ID of each zone, as defined by GCE. These keys can be specified
-        # specified in `location_id` or `alternative_location_id` fields when
+        # in `location_id` or `alternative_location_id` fields when creating a Redis
-        # creating a Redis instance.
+        # instance.
         # Corresponds to the JSON property `availableZones`
         # @return [Hash<String,Google::Apis::RedisV1beta1::GoogleCloudRedisV1beta1ZoneMetadata>]
         attr_accessor :available_zones
@@ -222,10 +219,9 @@ module Google
         include Google::Apis::Core::Hashable
       
         # consumer_defined_name is the name that is set by the consumer. On the other
-        # hand Name field represents system-assigned id of an instance so consumers
+        # hand Name field represents system-assigned id of an instance so consumers are
-        # are not necessarily aware of it.
+        # not necessarily aware of it. consumer_defined_name is used for notification/UI
-        # consumer_defined_name is used for notification/UI purposes for consumer to
+        # purposes for consumer to recognize their instances.
-        # recognize their instances.
         # Corresponds to the JSON property `consumerDefinedName`
         # @return [String]
         attr_accessor :consumer_defined_name
@@ -235,18 +231,17 @@ module Google
         # @return [String]
         attr_accessor :create_time
       
-        # Optional. Resource labels to represent user provided metadata. Each label
+        # Optional. Resource labels to represent user provided metadata. Each label is a
-        # is a key-value pair, where both the key and the value are arbitrary strings
+        # key-value pair, where both the key and the value are arbitrary strings
         # provided by the user.
         # Corresponds to the JSON property `labels`
         # @return [Hash<String,String>]
         attr_accessor :labels
       
-        # The MaintenancePolicies that have been attached to the instance.
+        # The MaintenancePolicies that have been attached to the instance. The key must
-        # The key must be of the type name of the oneof policy name defined in
+        # be of the type name of the oneof policy name defined in MaintenancePolicy, and
-        # MaintenancePolicy, and the referenced policy must define the same policy
+        # the referenced policy must define the same policy type. For complete details
-        # type. For complete details of MaintenancePolicy, please refer to
+        # of MaintenancePolicy, please refer to go/cloud-saas-mw-ug.
-        # go/cloud-saas-mw-ug.
         # Corresponds to the JSON property `maintenancePolicyNames`
         # @return [Hash<String,String>]
         attr_accessor :maintenance_policy_names
@@ -263,29 +258,28 @@ module Google
         # @return [Google::Apis::RedisV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings]
         attr_accessor :maintenance_settings
       
-        # Unique name of the resource. It uses the form:
+        # Unique name of the resource. It uses the form: `projects/`project_id`/
-        # `projects/`project_id`/locations/`location_id`/instances/`instance_id``
+        # locations/`location_id`/instances/`instance_id``
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # Output only. Custom string attributes used primarily to expose
+        # Output only. Custom string attributes used primarily to expose producer-
-        # producer-specific information in monitoring dashboards.
+        # specific information in monitoring dashboards. See go/get-instance-metadata.
-        # See go/get-instance-metadata.
         # Corresponds to the JSON property `producerMetadata`
         # @return [Hash<String,String>]
         attr_accessor :producer_metadata
       
-        # Output only. The list of data plane resources provisioned for this
+        # Output only. The list of data plane resources provisioned for this instance, e.
-        # instance, e.g. compute VMs. See go/get-instance-metadata.
+        # g. compute VMs. See go/get-instance-metadata.
         # Corresponds to the JSON property `provisionedResources`
         # @return [Array<Google::Apis::RedisV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1ProvisionedResource>]
         attr_accessor :provisioned_resources
       
-        # Link to the SLM instance template. Only populated when updating SLM
+        # Link to the SLM instance template. Only populated when updating SLM instances
-        # instances via SSA's Actuation service adaptor.
+        # via SSA's Actuation service adaptor. Service producers with custom control
-        # Service producers with custom control plane (e.g. Cloud SQL) doesn't
+        # plane (e.g. Cloud SQL) doesn't need to populate this field. Instead they
-        # need to populate this field. Instead they should use software_versions.
+        # should use software_versions.
         # Corresponds to the JSON property `slmInstanceTemplate`
         # @return [String]
         attr_accessor :slm_instance_template
@@ -296,8 +290,8 @@ module Google
         # @return [Google::Apis::RedisV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata]
         attr_accessor :slo_metadata
       
-        # Software versions that are used to deploy this instance. This can be
+        # Software versions that are used to deploy this instance. This can be mutated
-        # mutated by rollout services.
+        # by rollout services.
         # Corresponds to the JSON property `softwareVersions`
         # @return [Hash<String,String>]
         attr_accessor :software_versions
@@ -308,8 +302,8 @@ module Google
         # @return [String]
         attr_accessor :state
       
-        # Output only. ID of the associated GCP tenant project.
+        # Output only. ID of the associated GCP tenant project. See go/get-instance-
-        # See go/get-instance-metadata.
+        # metadata.
         # Corresponds to the JSON property `tenantProjectId`
         # @return [String]
         attr_accessor :tenant_project_id
@@ -348,9 +342,9 @@ module Google
       class GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule
         include Google::Apis::Core::Hashable
       
-        # Can this scheduled update be rescheduled?
+        # Can this scheduled update be rescheduled? By default, it's true and API needs
-        # By default, it's true and API needs to do explicitly check whether it's
+        # to do explicitly check whether it's set, if it's set as false explicitly, it's
-        # set, if it's set as false explicitly, it's false
+        # false
         # Corresponds to the JSON property `canReschedule`
         # @return [Boolean]
         attr_accessor :can_reschedule
@@ -361,9 +355,9 @@ module Google
         # @return [String]
         attr_accessor :end_time
       
-        # The rollout management policy this maintenance schedule is associated
+        # The rollout management policy this maintenance schedule is associated with.
-        # with. When doing reschedule update request, the reschedule should be
+        # When doing reschedule update request, the reschedule should be against this
-        # against this given policy.
+        # given policy.
         # Corresponds to the JSON property `rolloutManagementPolicy`
         # @return [String]
         attr_accessor :rollout_management_policy
@@ -392,8 +386,7 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Optional. Exclude instance from maintenance. When true, rollout service will
-        # not
+        # not attempt maintenance on the instance. Rollout service will include the
-        # attempt maintenance on the instance. Rollout service will include the
         # instance in reported rollout progress as not attempted.
         # Corresponds to the JSON property `exclude`
         # @return [Boolean]
@@ -410,18 +403,17 @@ module Google
         end
       end
       
-      # Node information for custom per-node SLO implementations.
+      # Node information for custom per-node SLO implementations. SSA does not support
-      # SSA does not support per-node SLO, but producers can populate per-node
+      # per-node SLO, but producers can populate per-node information in SloMetadata
-      # information in SloMetadata for custom precomputations.
+      # for custom precomputations. SSA Eligibility Exporter will emit per-node metric
-      # SSA Eligibility Exporter will emit per-node metric based on this information.
+      # based on this information.
       class GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata
         include Google::Apis::Core::Hashable
       
-        # By default node is eligible if instance is eligible.
+        # By default node is eligible if instance is eligible. But individual node might
-        # But individual node might be excluded from SLO by adding entry here.
+        # be excluded from SLO by adding entry here. For semantic see SloMetadata.
-        # For semantic see SloMetadata.exclusions.
+        # exclusions. If both instance and node level exclusions are present for time
-        # If both instance and node level exclusions are present for time period,
+        # period, the node level's reason will be reported by Eligibility Exporter.
-        # the node level's reason will be reported by Eligibility Exporter.
         # Corresponds to the JSON property `exclusions`
         # @return [Array<Google::Apis::RedisV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion>]
         attr_accessor :exclusions
@@ -431,8 +423,7 @@ module Google
         # @return [String]
         attr_accessor :location
       
-        # The id of the node.
+        # The id of the node. This should be equal to SaasInstanceNode.node_id.
-        # This should be equal to SaasInstanceNode.node_id.
         # Corresponds to the JSON property `nodeId`
         # @return [String]
         attr_accessor :node_id
@@ -453,18 +444,17 @@ module Google
       class GoogleCloudSaasacceleratorManagementProvidersV1ProvisionedResource
         include Google::Apis::Core::Hashable
       
-        # Type of the resource. This can be either a GCP resource or a custom one
+        # Type of the resource. This can be either a GCP resource or a custom one (e.g.
-        # (e.g. another cloud provider's VM). For GCP compute resources use singular
+        # another cloud provider's VM). For GCP compute resources use singular form of
-        # form of the names listed in GCP compute API documentation
+        # the names listed in GCP compute API documentation (https://cloud.google.com/
-        # (https://cloud.google.com/compute/docs/reference/rest/v1/), prefixed with
+        # compute/docs/reference/rest/v1/), prefixed with 'compute-', for example: '
-        # 'compute-', for example: 'compute-instance', 'compute-disk',
+        # compute-instance', 'compute-disk', 'compute-autoscaler'.
-        # 'compute-autoscaler'.
         # Corresponds to the JSON property `resourceType`
         # @return [String]
         attr_accessor :resource_type
       
-        # URL identifying the resource, e.g.
+        # URL identifying the resource, e.g. "https://www.googleapis.com/compute/v1/
-        # "https://www.googleapis.com/compute/v1/projects/...)".
+        # projects/...)".
         # Corresponds to the JSON property `resourceUrl`
         # @return [String]
         attr_accessor :resource_url
@@ -480,9 +470,9 @@ module Google
         end
       end
       
-      # SloEligibility is a tuple containing eligibility value: true if an instance
+      # SloEligibility is a tuple containing eligibility value: true if an instance is
-      # is eligible for SLO calculation or false if it should be excluded from all
+      # eligible for SLO calculation or false if it should be excluded from all SLO-
-      # SLO-related calculations along with a user-defined reason.
+      # related calculations along with a user-defined reason.
       class GoogleCloudSaasacceleratorManagementProvidersV1SloEligibility
         include Google::Apis::Core::Hashable
       
@@ -493,8 +483,7 @@ module Google
         alias_method :eligible?, :eligible
       
         # User-defined reason for the current value of instance eligibility. Usually,
-        # this can be directly mapped to the internal state. An empty reason is
+        # this can be directly mapped to the internal state. An empty reason is allowed.
-        # allowed.
         # Corresponds to the JSON property `reason`
         # @return [String]
         attr_accessor :reason
@@ -514,28 +503,27 @@ module Google
       class GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion
         include Google::Apis::Core::Hashable
       
-        # Exclusion duration. No restrictions on the possible values.
+        # Exclusion duration. No restrictions on the possible values. When an ongoing
-        # When an ongoing operation is taking longer than initially expected,
+        # operation is taking longer than initially expected, an existing entry in the
-        # an existing entry in the exclusion list can be updated by extending the
+        # exclusion list can be updated by extending the duration. This is supported by
-        # duration. This is supported by the subsystem exporting eligibility data
+        # the subsystem exporting eligibility data as long as such extension is
-        # as long as such extension is committed at least 10 minutes before the
+        # committed at least 10 minutes before the original exclusion expiration -
-        # original exclusion expiration - otherwise it is possible that there will
+        # otherwise it is possible that there will be "gaps" in the exclusion
-        # be "gaps" in the exclusion application in the exported timeseries.
+        # application in the exported timeseries.
         # Corresponds to the JSON property `duration`
         # @return [String]
         attr_accessor :duration
       
-        # Human-readable reason for the exclusion.
+        # Human-readable reason for the exclusion. This should be a static string (e.g. "
-        # This should be a static string (e.g. "Disruptive update in progress")
+        # Disruptive update in progress") and should not contain dynamically generated
-        # and should not contain dynamically generated data (e.g. instance name).
+        # data (e.g. instance name). Can be left empty.
-        # Can be left empty.
         # Corresponds to the JSON property `reason`
         # @return [String]
         attr_accessor :reason
       
-        # Name of an SLI that this exclusion applies to. Can be left empty,
+        # Name of an SLI that this exclusion applies to. Can be left empty, signaling
-        # signaling that the instance should be excluded from all SLIs defined
+        # that the instance should be excluded from all SLIs defined in the service SLO
-        # in the service SLO configuration.
+        # configuration.
         # Corresponds to the JSON property `sliName`
         # @return [String]
         attr_accessor :sli_name
@@ -563,40 +551,38 @@ module Google
       class GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata
         include Google::Apis::Core::Hashable
       
-        # SloEligibility is a tuple containing eligibility value: true if an instance
+        # SloEligibility is a tuple containing eligibility value: true if an instance is
-        # is eligible for SLO calculation or false if it should be excluded from all
+        # eligible for SLO calculation or false if it should be excluded from all SLO-
-        # SLO-related calculations along with a user-defined reason.
+        # related calculations along with a user-defined reason.
         # Corresponds to the JSON property `eligibility`
         # @return [Google::Apis::RedisV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1SloEligibility]
         attr_accessor :eligibility
       
-        # List of SLO exclusion windows. When multiple entries in the list match
+        # List of SLO exclusion windows. When multiple entries in the list match (
-        # (matching the exclusion time-window against current time point)
+        # matching the exclusion time-window against current time point) the exclusion
-        # the exclusion reason used in the first matching entry will be published.
+        # reason used in the first matching entry will be published. It is not needed to
-        # It is not needed to include expired exclusion in this list, as only the
+        # include expired exclusion in this list, as only the currently applicable
-        # currently applicable exclusions are taken into account by the eligibility
+        # exclusions are taken into account by the eligibility exporting subsystem (the
-        # exporting subsystem (the historical state of exclusions will be reflected
+        # historical state of exclusions will be reflected in the historically produced
-        # in the historically produced timeseries regardless of the current state).
+        # timeseries regardless of the current state). This field can be used to mark
-        # This field can be used to mark the instance as temporary ineligible
+        # the instance as temporary ineligible for the purpose of SLO calculation. For
-        # for the purpose of SLO calculation. For permanent instance SLO exclusion,
+        # permanent instance SLO exclusion, use of custom instance eligibility is
-        # use of custom instance eligibility is recommended. See 'eligibility' field
+        # recommended. See 'eligibility' field below.
-        # below.
         # Corresponds to the JSON property `exclusions`
         # @return [Array<Google::Apis::RedisV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion>]
         attr_accessor :exclusions
       
-        # Optional. List of nodes.
+        # Optional. List of nodes. Some producers need to use per-node metadata to
-        # Some producers need to use per-node metadata to calculate SLO.
+        # calculate SLO. This field allows such producers to publish per-node SLO meta
-        # This field allows such producers to publish per-node SLO meta data,
+        # data, which will be consumed by SSA Eligibility Exporter and published in the
-        # which will be consumed by SSA Eligibility Exporter and published in the
         # form of per node metric to Monarch.
         # Corresponds to the JSON property `nodes`
         # @return [Array<Google::Apis::RedisV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata>]
         attr_accessor :nodes
       
         # Name of the SLO tier the Instance belongs to. This name will be expected to
-        # match the tiers specified in the service SLO configuration.
+        # match the tiers specified in the service SLO configuration. Field is mandatory
-        # Field is mandatory and must not be empty.
+        # and must not be empty.
         # Corresponds to the JSON property `tier`
         # @return [String]
         attr_accessor :tier
@@ -663,16 +649,15 @@ module Google
         # @return [String]
         attr_accessor :alternative_location_id
       
-        # Optional. The full name of the Google Compute Engine
+        # Optional. The full name of the Google Compute Engine [network](https://cloud.
-        # [network](https://cloud.google.com/vpc/docs/vpc) to which the
+        # google.com/vpc/docs/vpc) to which the instance is connected. If left
-        # instance is connected. If left unspecified, the `default` network
+        # unspecified, the `default` network will be used.
-        # will be used.
         # Corresponds to the JSON property `authorizedNetwork`
         # @return [String]
         attr_accessor :authorized_network
       
-        # Optional. The network connect mode of the Redis instance.
+        # Optional. The network connect mode of the Redis instance. If not provided, the
-        # If not provided, the connect mode defaults to DIRECT_PEERING.
+        # connect mode defaults to DIRECT_PEERING.
         # Corresponds to the JSON property `connectMode`
         # @return [String]
         attr_accessor :connect_mode
@@ -683,10 +668,9 @@ module Google
         attr_accessor :create_time
       
         # Output only. The current zone where the Redis endpoint is placed. For Basic
-        # Tier instances, this will always be the same as the location_id
+        # Tier instances, this will always be the same as the location_id provided by
-        # provided by the user at creation time. For Standard Tier instances,
+        # the user at creation time. For Standard Tier instances, this can be either
-        # this can be either location_id or alternative_location_id and can
+        # location_id or alternative_location_id and can change after a failover event.
-        # change after a failover event.
         # Corresponds to the JSON property `currentLocationId`
         # @return [String]
         attr_accessor :current_location_id
@@ -710,8 +694,8 @@ module Google
         # Optional. The zone where the instance will be provisioned. If not provided,
         # the service will choose a zone for the instance. For STANDARD_HA tier,
         # instances will be created across two zones for protection against zonal
-        # failures. If alternative_location_id is also provided, it must be
+        # failures. If alternative_location_id is also provided, it must be different
-        # different from location_id.
+        # from location_id.
         # Corresponds to the JSON property `locationId`
         # @return [String]
         attr_accessor :location_id
@@ -722,21 +706,19 @@ module Google
         attr_accessor :memory_size_gb
       
         # Required. Unique name of the resource in this scope including project and
-        # location using the form:
+        # location using the form: `projects/`project_id`/locations/`location_id`/
-        # `projects/`project_id`/locations/`location_id`/instances/`instance_id``
+        # instances/`instance_id`` Note: Redis instances are managed and addressed at
-        # Note: Redis instances are managed and addressed at regional level so
+        # regional level so location_id here refers to a GCP region; however, users may
-        # location_id here refers to a GCP region; however, users may choose which
+        # choose which specific zone (or collection of zones for cross-zone instances)
-        # specific zone (or collection of zones for cross-zone instances) an instance
+        # an instance should be provisioned in. Refer to location_id and
-        # should be provisioned in. Refer to location_id and
         # alternative_location_id fields for more details.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # Output only. Cloud IAM identity used by import / export operations to
+        # Output only. Cloud IAM identity used by import / export operations to transfer
-        # transfer data to/from Cloud Storage. Format is
+        # data to/from Cloud Storage. Format is "serviceAccount:". The value may change
-        # "serviceAccount:<service_account_email>". The value may change over time
+        # over time for a given instance so should be checked before each import/export
-        # for a given instance so should be checked before each import/export
         # operation.
         # Corresponds to the JSON property `persistenceIamIdentity`
         # @return [String]
@@ -747,38 +729,27 @@ module Google
         # @return [Fixnum]
         attr_accessor :port
       
-        # Optional. Redis configuration parameters, according to
+        # Optional. Redis configuration parameters, according to http://redis.io/topics/
-        # http://redis.io/topics/config. Currently, the only supported parameters
+        # config. Currently, the only supported parameters are: Redis version 3.2 and
-        # are:
+        # newer: * maxmemory-policy * notify-keyspace-events Redis version 4.0 and newer:
-        # Redis version 3.2 and newer:
+        # * activedefrag * lfu-decay-time * lfu-log-factor * maxmemory-gb Redis version
-        # *   maxmemory-policy
+        # 5.0 and newer: * stream-node-max-bytes * stream-node-max-entries
-        # *   notify-keyspace-events
-        # Redis version 4.0 and newer:
-        # *   activedefrag
-        # *   lfu-decay-time
-        # *   lfu-log-factor
-        # *   maxmemory-gb
-        # Redis version 5.0 and newer:
-        # *   stream-node-max-bytes
-        # *   stream-node-max-entries
         # Corresponds to the JSON property `redisConfigs`
         # @return [Hash<String,String>]
         attr_accessor :redis_configs
       
-        # Optional. The version of Redis software.
+        # Optional. The version of Redis software. If not provided, latest supported
-        # If not provided, latest supported version will be used. Currently, the
+        # version will be used. Currently, the supported values are: * `REDIS_3_2` for
-        # supported values are:
+        # Redis 3.2 compatibility * `REDIS_4_0` for Redis 4.0 compatibility (default) * `
-        # *   `REDIS_3_2` for Redis 3.2 compatibility
+        # REDIS_5_0` for Redis 5.0 compatibility
-        # *   `REDIS_4_0` for Redis 4.0 compatibility (default)
-        # *   `REDIS_5_0` for Redis 5.0 compatibility
         # Corresponds to the JSON property `redisVersion`
         # @return [String]
         attr_accessor :redis_version
       
         # Optional. The CIDR range of internal addresses that are reserved for this
-        # instance. If not provided, the service will choose an unused /29 block,
+        # instance. If not provided, the service will choose an unused /29 block, for
-        # for example, 10.0.0.0/29 or 192.168.0.0/29. Ranges must be unique
+        # example, 10.0.0.0/29 or 192.168.0.0/29. Ranges must be unique and non-
-        # and non-overlapping with existing subnets in an authorized network.
+        # overlapping with existing subnets in an authorized network.
         # Corresponds to the JSON property `reservedIpRange`
         # @return [String]
         attr_accessor :reserved_ip_range
@@ -788,8 +759,8 @@ module Google
         # @return [String]
         attr_accessor :state
       
-        # Output only. Additional information about the current status of this
+        # Output only. Additional information about the current status of this instance,
-        # instance, if available.
+        # if available.
         # Corresponds to the JSON property `statusMessage`
         # @return [String]
         attr_accessor :status_message
@@ -831,15 +802,14 @@ module Google
       class ListInstancesResponse
         include Google::Apis::Core::Hashable
       
-        # A list of Redis instances in the project in the specified location,
+        # A list of Redis instances in the project in the specified location, or across
-        # or across all locations.
+        # all locations. If the `location_id` in the parent field of the request is "-",
-        # If the `location_id` in the parent field of the request is "-", all regions
+        # all regions available to the project are queried, and the results aggregated.
-        # available to the project are queried, and the results aggregated.
+        # If in such an aggregated query a location is unavailable, a dummy Redis entry
-        # If in such an aggregated query a location is unavailable, a dummy Redis
+        # is included in the response with the `name` field set to a value of the form `
-        # entry is included in the response with the `name` field set to a value of
+        # projects/`project_id`/locations/`location_id`/instances/`- and the `status`
-        # the form `projects/`project_id`/locations/`location_id`/instances/`- and
+        # field set to ERROR and `status_message` field set to "location not available
-        # the `status` field set to ERROR and `status_message` field set to "location
+        # for ListInstances".
-        # not available for ListInstances".
         # Corresponds to the JSON property `instances`
         # @return [Array<Google::Apis::RedisV1beta1::Instance>]
         attr_accessor :instances
@@ -921,14 +891,14 @@ module Google
       class Location
         include Google::Apis::Core::Hashable
       
-        # The friendly name for this location, typically a nearby city name.
+        # The friendly name for this location, typically a nearby city name. For example,
-        # For example, "Tokyo".
+        # "Tokyo".
         # Corresponds to the JSON property `displayName`
         # @return [String]
         attr_accessor :display_name
       
-        # Cross-service attributes for the location. For example
+        # Cross-service attributes for the location. For example `"cloud.googleapis.com/
-        # `"cloud.googleapis.com/region": "us-east1"`
+        # region": "us-east1"`
         # Corresponds to the JSON property `labels`
         # @return [Hash<String,String>]
         attr_accessor :labels
@@ -971,55 +941,49 @@ module Google
       class Operation
         include Google::Apis::Core::Hashable
       
-        # If the value is `false`, it means the operation is still in progress.
+        # If the value is `false`, it means the operation is still in progress. If `true`
-        # If `true`, the operation is completed, and either `error` or `response` is
+        # , the operation is completed, and either `error` or `response` is available.
-        # available.
         # Corresponds to the JSON property `done`
         # @return [Boolean]
         attr_accessor :done
         alias_method :done?, :done
       
-        # The `Status` type defines a logical error model that is suitable for
+        # The `Status` type defines a logical error model that is suitable for different
-        # different programming environments, including REST APIs and RPC APIs. It is
+        # programming environments, including REST APIs and RPC APIs. It is used by [
-        # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+        # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
-        # three pieces of data: error code, error message, and error details.
+        # data: error code, error message, and error details. You can find out more
-        # You can find out more about this error model and how to work with it in the
+        # about this error model and how to work with it in the [API Design Guide](https:
-        # [API Design Guide](https://cloud.google.com/apis/design/errors).
+        # //cloud.google.com/apis/design/errors).
         # Corresponds to the JSON property `error`
         # @return [Google::Apis::RedisV1beta1::Status]
         attr_accessor :error
       
-        # `
+        # ` `createTime`: The time the operation was created. `endTime`: The time the
-        # `createTime`: The time the operation was created.
+        # operation finished running. `target`: Server-defined resource path for the
-        # `endTime`: The time the operation finished running.
+        # target of the operation. `verb`: Name of the verb executed by the operation. `
-        # `target`: Server-defined resource path for the target of the operation.
+        # statusDetail`: Human-readable status of the operation, if any. `
-        # `verb`: Name of the verb executed by the operation.
+        # cancelRequested`: Identifies whether the user has requested cancellation of
-        # `statusDetail`: Human-readable status of the operation, if any.
-        # `cancelRequested`: Identifies whether the user has requested cancellation of
         # the operation. Operations that have successfully been cancelled have Operation.
         # error value with a google.rpc.Status.code of 1, corresponding to `Code.
-        # CANCELLED`.
+        # CANCELLED`. `apiVersion`: API version used to start the operation. `
-        # `apiVersion`: API version used to start the operation.
-        # `
         # Corresponds to the JSON property `metadata`
         # @return [Hash<String,Object>]
         attr_accessor :metadata
       
         # The server-assigned name, which is only unique within the same service that
-        # originally returns it. If you use the default HTTP mapping, the
+        # originally returns it. If you use the default HTTP mapping, the `name` should
-        # `name` should be a resource name ending with `operations/`unique_id``.
+        # be a resource name ending with `operations/`unique_id``.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # The normal response of the operation in case of success.  If the original
+        # The normal response of the operation in case of success. If the original
-        # method returns no data on success, such as `Delete`, the response is
+        # method returns no data on success, such as `Delete`, the response is `google.
-        # `google.protobuf.Empty`.  If the original method is standard
+        # protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`,
-        # `Get`/`Create`/`Update`, the response should be the resource.  For other
+        # the response should be the resource. For other methods, the response should
-        # methods, the response should have the type `XxxResponse`, where `Xxx`
+        # have the type `XxxResponse`, where `Xxx` is the original method name. For
-        # is the original method name.  For example, if the original method name
+        # example, if the original method name is `TakeSnapshot()`, the inferred
-        # is `TakeSnapshot()`, the inferred response type is
+        # response type is `TakeSnapshotResponse`.
-        # `TakeSnapshotResponse`.
         # Corresponds to the JSON property `response`
         # @return [Hash<String,Object>]
         attr_accessor :response
@@ -1057,12 +1021,12 @@ module Google
         end
       end
       
-      # The `Status` type defines a logical error model that is suitable for
+      # The `Status` type defines a logical error model that is suitable for different
-      # different programming environments, including REST APIs and RPC APIs. It is
+      # programming environments, including REST APIs and RPC APIs. It is used by [
-      # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+      # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
-      # three pieces of data: error code, error message, and error details.
+      # data: error code, error message, and error details. You can find out more
-      # You can find out more about this error model and how to work with it in the
+      # about this error model and how to work with it in the [API Design Guide](https:
-      # [API Design Guide](https://cloud.google.com/apis/design/errors).
+      # //cloud.google.com/apis/design/errors).
       class Status
         include Google::Apis::Core::Hashable
       
@@ -1071,15 +1035,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
+        # A developer-facing error message, which should be in English. Any user-facing
-        # user-facing error message should be localized and sent in the
+        # error message should be localized and sent in the google.rpc.Status.details
-        # google.rpc.Status.details field, or localized by the client.
+        # field, or localized by the client.
         # Corresponds to the JSON property `message`
         # @return [String]
         attr_accessor :message

generated/google/apis/redis_v1beta1/service.rb

@@ -116,28 +116,25 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a Redis instance based on the specified tier and memory size.
+        # Creates a Redis instance based on the specified tier and memory size. By
-        # By default, the instance is accessible from the project's
+        # default, the instance is accessible from the project's [default network](https:
-        # [default network](https://cloud.google.com/vpc/docs/vpc).
+        # //cloud.google.com/vpc/docs/vpc). The creation is executed asynchronously and
-        # The creation is executed asynchronously and callers may check the returned
+        # callers may check the returned operation to track its progress. Once the
-        # operation to track its progress. Once the operation is completed the Redis
+        # operation is completed the Redis instance will be fully functional. Completed
-        # instance will be fully functional. Completed longrunning.Operation will
+        # longrunning.Operation will contain the new instance object in the response
-        # contain the new instance object in the response field.
+        # field. The returned operation is automatically deleted after a few hours, so
-        # The returned operation is automatically deleted after a few hours, so there
+        # there is no need to call DeleteOperation.
-        # is no need to call DeleteOperation.
         # @param [String] parent
-        #   Required. The resource name of the instance location using the form:
+        #   Required. The resource name of the instance location using the form: `projects/
-        #   `projects/`project_id`/locations/`location_id``
+        #   `project_id`/locations/`location_id`` where `location_id` refers to a GCP
-        #   where `location_id` refers to a GCP region.
+        #   region.
         # @param [Google::Apis::RedisV1beta1::Instance] instance_object
         # @param [String] instance_id
-        #   Required. The logical name of the Redis instance in the customer project
+        #   Required. The logical name of the Redis instance in the customer project with
-        #   with the following restrictions:
+        #   the following restrictions: * Must contain only lowercase letters, numbers,
-        #   * Must contain only lowercase letters, numbers, and hyphens.
+        #   and hyphens. * Must start with a letter. * Must be between 1-40 characters. *
-        #   * Must start with a letter.
+        #   Must end with a number or a letter. * Must be unique within the customer
-        #   * Must be between 1-40 characters.
+        #   project / location
-        #   * Must end with a number or a letter.
-        #   * Must be unique within the customer project / location
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -168,12 +165,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a specific Redis instance.  Instance stops serving and data is
+        # Deletes a specific Redis instance. Instance stops serving and data is deleted.
-        # deleted.
         # @param [String] name
-        #   Required. Redis instance resource name using the form:
+        #   Required. Redis instance resource name using the form: `projects/`project_id`/
-        #   `projects/`project_id`/locations/`location_id`/instances/`instance_id``
+        #   locations/`location_id`/instances/`instance_id`` where `location_id` refers to
-        #   where `location_id` refers to a GCP region.
+        #   a GCP region.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -202,13 +198,13 @@ module Google
         end
         
         # Export Redis instance data into a Redis RDB format file in Cloud Storage.
-        # Redis will continue serving during this operation.
+        # Redis will continue serving during this operation. The returned operation is
-        # The returned operation is automatically deleted after a few hours, so
+        # automatically deleted after a few hours, so there is no need to call
-        # there is no need to call DeleteOperation.
+        # DeleteOperation.
         # @param [String] name
-        #   Required. Redis instance resource name using the form:
+        #   Required. Redis instance resource name using the form: `projects/`project_id`/
-        #   `projects/`project_id`/locations/`location_id`/instances/`instance_id``
+        #   locations/`location_id`/instances/`instance_id`` where `location_id` refers to
-        #   where `location_id` refers to a GCP region.
+        #   a GCP region.
         # @param [Google::Apis::RedisV1beta1::ExportInstanceRequest] export_instance_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -239,12 +235,12 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Initiates a failover of the master node to current replica node for a
+        # Initiates a failover of the master node to current replica node for a specific
-        # specific STANDARD tier Cloud Memorystore for Redis instance.
+        # STANDARD tier Cloud Memorystore for Redis instance.
         # @param [String] name
-        #   Required. Redis instance resource name using the form:
+        #   Required. Redis instance resource name using the form: `projects/`project_id`/
-        #   `projects/`project_id`/locations/`location_id`/instances/`instance_id``
+        #   locations/`location_id`/instances/`instance_id`` where `location_id` refers to
-        #   where `location_id` refers to a GCP region.
+        #   a GCP region.
         # @param [Google::Apis::RedisV1beta1::FailoverInstanceRequest] failover_instance_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -277,9 +273,9 @@ module Google
         
         # Gets the details of a specific Redis instance.
         # @param [String] name
-        #   Required. Redis instance resource name using the form:
+        #   Required. Redis instance resource name using the form: `projects/`project_id`/
-        #   `projects/`project_id`/locations/`location_id`/instances/`instance_id``
+        #   locations/`location_id`/instances/`instance_id`` where `location_id` refers to
-        #   where `location_id` refers to a GCP region.
+        #   a GCP region.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -308,15 +304,14 @@ module Google
         end
         
         # Import a Redis RDB snapshot file from Cloud Storage into a Redis instance.
-        # Redis may stop serving during this operation. Instance state will be
+        # Redis may stop serving during this operation. Instance state will be IMPORTING
-        # IMPORTING for entire operation. When complete, the instance will contain
+        # for entire operation. When complete, the instance will contain only data from
-        # only data from the imported file.
+        # the imported file. The returned operation is automatically deleted after a few
-        # The returned operation is automatically deleted after a few hours, so
+        # hours, so there is no need to call DeleteOperation.
-        # there is no need to call DeleteOperation.
         # @param [String] name
-        #   Required. Redis instance resource name using the form:
+        #   Required. Redis instance resource name using the form: `projects/`project_id`/
-        #   `projects/`project_id`/locations/`location_id`/instances/`instance_id``
+        #   locations/`location_id`/instances/`instance_id`` where `location_id` refers to
-        #   where `location_id` refers to a GCP region.
+        #   a GCP region.
         # @param [Google::Apis::RedisV1beta1::ImportInstanceRequest] import_instance_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -347,26 +342,24 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists all Redis instances owned by a project in either the specified
+        # Lists all Redis instances owned by a project in either the specified location (
-        # location (region) or all locations.
+        # region) or all locations. The location should have the following format: * `
-        # The location should have the following format:
+        # projects/`project_id`/locations/`location_id`` If `location_id` is specified
-        # * `projects/`project_id`/locations/`location_id``
+        # as `-` (wildcard), then all regions available to the project are queried, and
-        # If `location_id` is specified as `-` (wildcard), then all regions
+        # the results are aggregated.
-        # available to the project are queried, and the results are aggregated.
         # @param [String] parent
-        #   Required. The resource name of the instance location using the form:
+        #   Required. The resource name of the instance location using the form: `projects/
-        #   `projects/`project_id`/locations/`location_id``
+        #   `project_id`/locations/`location_id`` where `location_id` refers to a GCP
-        #   where `location_id` refers to a GCP region.
+        #   region.
         # @param [Fixnum] page_size
-        #   The maximum number of items to return.
+        #   The maximum number of items to return. If not specified, a default value of
-        #   If not specified, a default value of 1000 will be used by the service.
+        #   1000 will be used by the service. Regardless of the page_size value, the
-        #   Regardless of the page_size value, the response may include a partial list
+        #   response may include a partial list and a caller should only rely on response'
-        #   and a caller should only rely on response's
+        #   s `next_page_token` to determine if there are more instances left to be
-        #   `next_page_token`
+        #   queried.
-        #   to determine if there are more instances left to be queried.
         # @param [String] page_token
-        #   The `next_page_token` value returned from a previous
+        #   The `next_page_token` value returned from a previous ListInstances request, if
-        #   ListInstances request, if any.
+        #   any.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -396,28 +389,23 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates the metadata and configuration of a specific Redis instance.
+        # Updates the metadata and configuration of a specific Redis instance. Completed
-        # Completed longrunning.Operation will contain the new instance object
+        # longrunning.Operation will contain the new instance object in the response
-        # in the response field. The returned operation is automatically deleted
+        # field. The returned operation is automatically deleted after a few hours, so
-        # after a few hours, so there is no need to call DeleteOperation.
+        # there is no need to call DeleteOperation.
         # @param [String] name
         #   Required. Unique name of the resource in this scope including project and
-        #   location using the form:
+        #   location using the form: `projects/`project_id`/locations/`location_id`/
-        #   `projects/`project_id`/locations/`location_id`/instances/`instance_id``
+        #   instances/`instance_id`` Note: Redis instances are managed and addressed at
-        #   Note: Redis instances are managed and addressed at regional level so
+        #   regional level so location_id here refers to a GCP region; however, users may
-        #   location_id here refers to a GCP region; however, users may choose which
+        #   choose which specific zone (or collection of zones for cross-zone instances)
-        #   specific zone (or collection of zones for cross-zone instances) an instance
+        #   an instance should be provisioned in. Refer to location_id and
-        #   should be provisioned in. Refer to location_id and
         #   alternative_location_id fields for more details.
         # @param [Google::Apis::RedisV1beta1::Instance] instance_object
         # @param [String] update_mask
-        #   Required. Mask of fields to update. At least one path must be supplied in
+        #   Required. Mask of fields to update. At least one path must be supplied in this
-        #   this field. The elements of the repeated paths field may only include these
+        #   field. The elements of the repeated paths field may only include these fields
-        #   fields from Instance:
+        #   from Instance: * `displayName` * `labels` * `memorySizeGb` * `redisConfig`
-        #   *   `displayName`
-        #   *   `labels`
-        #   *   `memorySizeGb`
-        #   *   `redisConfig`
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -448,12 +436,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Upgrades Redis instance to the newer Redis version specified in the
+        # Upgrades Redis instance to the newer Redis version specified in the request.
-        # request.
         # @param [String] name
-        #   Required. Redis instance resource name using the form:
+        #   Required. Redis instance resource name using the form: `projects/`project_id`/
-        #   `projects/`project_id`/locations/`location_id`/instances/`instance_id``
+        #   locations/`location_id`/instances/`instance_id`` where `location_id` refers to
-        #   where `location_id` refers to a GCP region.
+        #   a GCP region.
         # @param [Google::Apis::RedisV1beta1::UpgradeInstanceRequest] upgrade_instance_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -484,15 +471,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Starts asynchronous cancellation on a long-running operation.  The server
+        # Starts asynchronous cancellation on a long-running operation. The server makes
-        # makes a best effort to cancel the operation, but success is not
+        # a best effort to cancel the operation, but success is not guaranteed. If the
-        # guaranteed.  If the server doesn't support this method, it returns
+        # server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.
-        # `google.rpc.Code.UNIMPLEMENTED`.  Clients can use
+        # Clients can use Operations.GetOperation or other methods to check whether the
-        # Operations.GetOperation or
+        # cancellation succeeded or whether the operation completed despite cancellation.
-        # other methods to check whether the cancellation succeeded or whether the
+        # On successful cancellation, the operation is not deleted; instead, it becomes
-        # operation completed despite cancellation. On successful cancellation,
+        # an operation with an Operation.error value with a google.rpc.Status.code of 1,
-        # the operation is not deleted; instead, it becomes an operation with
-        # an Operation.error value with a google.rpc.Status.code of 1,
         # corresponding to `Code.CANCELLED`.
         # @param [String] name
         #   The name of the operation resource to be cancelled.
@@ -523,10 +508,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a long-running operation. This method indicates that the client is
+        # Deletes a long-running operation. This method indicates that the client is no
-        # no longer interested in the operation result. It does not cancel the
+        # longer interested in the operation result. It does not cancel the operation.
-        # operation. If the server doesn't support this method, it returns
+        # If the server doesn't support this method, it returns `google.rpc.Code.
-        # `google.rpc.Code.UNIMPLEMENTED`.
+        # UNIMPLEMENTED`.
         # @param [String] name
         #   The name of the operation resource to be deleted.
         # @param [String] fields
@@ -556,9 +541,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the latest state of a long-running operation.  Clients can use this
+        # Gets the latest state of a long-running operation. Clients can use this method
-        # method to poll the operation result at intervals as recommended by the API
+        # to poll the operation result at intervals as recommended by the API service.
-        # service.
         # @param [String] name
         #   The name of the operation resource.
         # @param [String] fields
@@ -588,15 +572,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists operations that match the specified filter in the request. If the
+        # Lists operations that match the specified filter in the request. If the server
-        # server doesn't support this method, it returns `UNIMPLEMENTED`.
+        # doesn't support this method, it returns `UNIMPLEMENTED`. NOTE: the `name`
-        # NOTE: the `name` binding allows API services to override the binding
+        # binding allows API services to override the binding to use different resource
-        # to use different resource name schemes, such as `users/*/operations`. To
+        # name schemes, such as `users/*/operations`. To override the binding, API
-        # override the binding, API services can add a binding such as
+        # services can add a binding such as `"/v1/`name=users/*`/operations"` to their
-        # `"/v1/`name=users/*`/operations"` to their service configuration.
+        # service configuration. For backwards compatibility, the default name includes
-        # For backwards compatibility, the default name includes the operations
+        # the operations collection id, however overriding users must ensure the name
-        # collection id, however overriding users must ensure the name binding
+        # binding is the parent resource, without the operations collection id.
-        # is the parent resource, without the operations collection id.
         # @param [String] name
         #   The name of the operation's parent resource.
         # @param [String] filter

generated/google/apis/script_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/apps-script/api/
     module ScriptV1
       VERSION = 'V1'
-      REVISION = '20200411'
+      REVISION = '20200811'
 
       # Read, compose, send, and permanently delete all your email from Gmail
       AUTH_SCOPE = 'https://mail.google.com/'

generated/google/apis/script_v1/classes.rb

@@ -26,10 +26,9 @@ module Google
       class Content
         include Google::Apis::Core::Hashable
       
-        # The list of script project files.
+        # The list of script project files. One of the files is a script manifest; it
-        # One of the files is a script manifest; it must be named "appsscript",
+        # must be named "appsscript", must have type of JSON, and include the manifest
-        # must have type of JSON, and include the manifest configurations for the
+        # configurations for the project.
-        # project.
         # Corresponds to the JSON property `files`
         # @return [Array<Google::Apis::ScriptV1::File>]
         attr_accessor :files
@@ -55,8 +54,8 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The Drive ID of a parent file that the created script project is bound to.
-        # This is usually the ID of a Google Doc, Google Sheet, Google Form, or
+        # This is usually the ID of a Google Doc, Google Sheet, Google Form, or Google
-        # Google Slides file. If not set, a standalone script project is created.
+        # Slides file. If not set, a standalone script project is created.
         # Corresponds to the JSON property `parentId`
         # @return [String]
         attr_accessor :parent_id
@@ -151,13 +150,11 @@ module Google
         end
       end
       
-      # A generic empty message that you can re-use to avoid defining duplicated
+      # A generic empty message that you can re-use to avoid defining duplicated empty
-      # empty messages in your APIs. A typical example is to use it as the request
+      # messages in your APIs. A typical example is to use it as the request or the
-      # or the response type of an API method. For instance:
+      # response type of an API method. For instance: service Foo ` rpc Bar(google.
-      # service Foo `
+      # protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for
-      # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+      # `Empty` is empty JSON object ````.
-      # `
-      # The JSON representation for `Empty` is empty JSON object ````.
       class Empty
         include Google::Apis::Core::Hashable
       
@@ -227,13 +224,11 @@ module Google
       end
       
       # An object that provides information about the nature of an error resulting
-      # from an attempted execution of a script function using the Apps Script API.
+      # from an attempted execution of a script function using the Apps Script API. If
-      # If a run call
+      # a run call succeeds but the script function (or Apps Script itself) throws an
-      # succeeds but the script function (or Apps Script itself) throws an exception,
+      # exception, the response body's error field contains a Status object. The `
-      # the response body's error field
+      # Status` object's `details` field contains an array with a single one of these `
-      # contains a
+      # ExecutionError` objects.
-      # Status object. The `Status` object's `details` field
-      # contains an array with a single one of these `ExecutionError` objects.
       class ExecutionError
         include Google::Apis::Core::Hashable
       
@@ -243,8 +238,8 @@ module Google
         # @return [String]
         attr_accessor :error_message
       
-        # The error type, for example `TypeError` or `ReferenceError`. If the error
+        # The error type, for example `TypeError` or `ReferenceError`. If the error type
-        # type is unavailable, this field is not included.
+        # is unavailable, this field is not included.
         # Corresponds to the JSON property `errorType`
         # @return [String]
         attr_accessor :error_type
@@ -268,47 +263,44 @@ module Google
       end
       
       # A request to run the function in a script. The script is identified by the
-      # specified `script_id`. Executing a function on a script returns results
+      # specified `script_id`. Executing a function on a script returns results based
-      # based on the implementation of the script.
+      # on the implementation of the script.
       class ExecutionRequest
         include Google::Apis::Core::Hashable
       
-        # If `true` and the user is an owner of the script, the script runs at the
+        # If `true` and the user is an owner of the script, the script runs at the most
-        # most recently saved version rather than the version deployed for use with
+        # recently saved version rather than the version deployed for use with the Apps
-        # the Apps Script API. Optional; default is `false`.
+        # Script API. Optional; default is `false`.
         # Corresponds to the JSON property `devMode`
         # @return [Boolean]
         attr_accessor :dev_mode
         alias_method :dev_mode?, :dev_mode
       
         # The name of the function to execute in the given script. The name does not
-        # include parentheses or parameters. It can reference a function in an
+        # include parentheses or parameters. It can reference a function in an included
-        # included library such as `Library.libFunction1`.
+        # library such as `Library.libFunction1`.
         # Corresponds to the JSON property `function`
         # @return [String]
         attr_accessor :function
       
         # The parameters to be passed to the function being executed. The object type
-        # for each parameter should match the expected type in Apps Script.
+        # for each parameter should match the expected type in Apps Script. Parameters
-        # Parameters cannot be Apps Script-specific object types (such as a
+        # cannot be Apps Script-specific object types (such as a `Document` or a `
-        # `Document` or a `Calendar`); they can only be primitive types such as
+        # Calendar`); they can only be primitive types such as `string`, `number`, `
-        # `string`, `number`, `array`, `object`, or `boolean`. Optional.
+        # array`, `object`, or `boolean`. Optional.
         # Corresponds to the JSON property `parameters`
         # @return [Array<Object>]
         attr_accessor :parameters
       
-        # <b>Deprecated</b>. For use with Android add-ons only. An ID that represents
+        # *Deprecated*. For use with Android add-ons only. An ID that represents the
-        # the user's current session in the Android app for Google Docs or Sheets,
+        # user's current session in the Android app for Google Docs or Sheets, included
-        # included as extra data in the
+        # as extra data in the [Intent](https://developer.android.com/guide/components/
-        # [Intent](https://developer.android.com/guide/components/intents-filters.html)
+        # intents-filters.html) that launches the add-on. When an Android add-on is run
-        # that launches the add-on. When an Android add-on is run with a session
+        # with a session state, it gains the privileges of a [bound](https://developers.
-        # state, it gains the privileges of a
+        # google.com/apps-script/guides/bound) script—that is, it can access information
-        # [bound](https://developers.google.com/apps-script/guides/bound)
+        # like the user's current cursor position (in Docs) or selected cell (in Sheets).
-        # script&mdash;that is, it can access information like the user's current
+        # To retrieve the state, call `Intent.getStringExtra("com.google.android.apps.
-        # cursor position (in Docs) or selected cell (in Sheets). To retrieve the
+        # docs.addons.SessionState")`. Optional.
-        # state, call
-        # `Intent.getStringExtra("com.google.android.apps.docs.addons.SessionState")`.
-        # Optional.
         # Corresponds to the JSON property `sessionState`
         # @return [String]
         attr_accessor :session_state
@@ -326,18 +318,17 @@ module Google
         end
       end
       
-      # An object that provides the return value of a function executed using the
+      # An object that provides the return value of a function executed using the Apps
-      # Apps Script API. If the script function returns successfully, the response
+      # Script API. If the script function returns successfully, the response body's
-      # body's response field contains this
+      # response field contains this `ExecutionResponse` object.
-      # `ExecutionResponse` object.
       class ExecutionResponse
         include Google::Apis::Core::Hashable
       
         # The return value of the script function. The type matches the object type
         # returned in Apps Script. Functions called using the Apps Script API cannot
         # return Apps Script-specific objects (such as a `Document` or a `Calendar`);
-        # they can only return primitive types such as a `string`, `number`, `array`,
+        # they can only return primitive types such as a `string`, `number`, `array`, `
-        # `object`, or `boolean`.
+        # object`, or `boolean`.
         # Corresponds to the JSON property `result`
         # @return [Object]
         attr_accessor :result
@@ -352,16 +343,14 @@ module Google
         end
       end
       
-      # An individual file within a script project.
+      # An individual file within a script project. A file is a third-party source
-      # A file is a third-party source code created by one or more
+      # code created by one or more developers. It can be a server-side JS code, HTML,
-      # developers. It can be a server-side JS code, HTML, or a
+      # or a configuration file. Each script project can contain multiple files.
-      # configuration file. Each script project can contain multiple files.
       class File
         include Google::Apis::Core::Hashable
       
-        # Creation date timestamp.
+        # Creation date timestamp. This read-only field is only visible to users who
-        # This read-only field is only visible to users who have WRITER
+        # have WRITER permission for the script project.
-        # permission for the script project.
         # Corresponds to the JSON property `createTime`
         # @return [String]
         attr_accessor :create_time
@@ -376,8 +365,8 @@ module Google
         # @return [Google::Apis::ScriptV1::GoogleAppsScriptTypeUser]
         attr_accessor :last_modify_user
       
-        # The name of the file. The file extension is not part of the file
+        # The name of the file. The file extension is not part of the file name, which
-        # name, which can be identified from the type field.
+        # can be identified from the type field.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -392,9 +381,8 @@ module Google
         # @return [String]
         attr_accessor :type
       
-        # Last modified date timestamp.
+        # Last modified date timestamp. This read-only field is only visible to users
-        # This read-only field is only visible to users who have WRITER
+        # who have WRITER permission for the script project.
-        # permission for the script project.
         # Corresponds to the JSON property `updateTime`
         # @return [String]
         attr_accessor :update_time
@@ -540,10 +528,10 @@ module Google
         end
       end
       
-      # Representation of a single script process execution that was started from
+      # Representation of a single script process execution that was started from the
-      # the script editor, a trigger, an application, or using the Apps Script API.
+      # script editor, a trigger, an application, or using the Apps Script API. This
-      # This is distinct from the `Operation`
+      # is distinct from the `Operation` resource, which only represents executions
-      # resource, which only represents executions started via the Apps Script API.
+      # started via the Apps Script API.
       class GoogleAppsScriptTypeProcess
         include Google::Apis::Core::Hashable
       
@@ -694,8 +682,7 @@ module Google
         # @return [Array<Google::Apis::ScriptV1::Deployment>]
         attr_accessor :deployments
       
-        # The token that can be used in the next call to get the next page of
+        # The token that can be used in the next call to get the next page of results.
-        # results.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -711,8 +698,7 @@ module Google
         end
       end
       
-      # Response with the list of
+      # Response with the list of Process resources.
-      # Process resources.
       class ListScriptProcessesResponse
         include Google::Apis::Core::Hashable
       
@@ -738,8 +724,7 @@ module Google
         end
       end
       
-      # Response with the list of
+      # Response with the list of Process resources.
-      # Process resources.
       class ListUserProcessesResponse
         include Google::Apis::Core::Hashable
       
@@ -788,8 +773,8 @@ module Google
       class ListVersionsResponse
         include Google::Apis::Core::Hashable
       
-        # The token use to fetch the next page of records. if not exist in the
+        # The token use to fetch the next page of records. if not exist in the response,
-        # response, that means no more versions to list.
+        # that means no more versions to list.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -876,27 +861,19 @@ module Google
       # A representation of an execution of an Apps Script function started with run.
       # The execution response does not arrive until the function finishes executing.
       # The maximum execution runtime is listed in the [Apps Script quotas guide](/
-      # apps-script/guides/services/quotas#current_limitations). <p>After execution
+      # apps-script/guides/services/quotas#current_limitations). After execution has
-      # has started, it can have one of four outcomes:</p> <ul> <li> If the script
+      # started, it can have one of four outcomes: - If the script function returns
-      # function returns successfully, the
+      # successfully, the response field contains an ExecutionResponse object with the
-      # response field contains an
+      # function's return value in the object's `result` field. - If the script
-      # ExecutionResponse object
+      # function (or Apps Script itself) throws an exception, the error field contains
-      # with the function's return value in the object's `result` field.</li>
+      # a Status object. The `Status` object's `details` field contains an array with
-      # <li> If the script function (or Apps Script itself) throws an exception, the
+      # a single ExecutionError object that provides information about the nature of
-      # error field contains a
+      # the error. - If the execution has not yet completed, the done field is `false`
-      # Status object. The `Status` object's `details`
+      # and the neither the `response` nor `error` fields are present. - If the `run`
-      # field contains an array with a single
+      # call itself fails (for example, because of a malformed request or an
-      # ExecutionError object that
+      # authorization error), the method returns an HTTP response code in the 4XX
-      # provides information about the nature of the error.</li>
+      # range with a different format for the response body. Client libraries
-      # <li> If the execution has not yet completed,
+      # automatically convert a 4XX response into an exception class.
-      # the done field is `false` and
-      # the neither the `response` nor `error` fields are present.</li>
-      # <li> If the `run` call itself fails (for example, because of a
-      # malformed request or an authorization error), the method returns an HTTP
-      # response code in the 4XX range with a different format for the response
-      # body. Client libraries automatically convert a 4XX response into an
-      # exception class.</li>
-      # </ul>
       class Operation
         include Google::Apis::Core::Hashable
       
@@ -952,9 +929,9 @@ module Google
         # @return [Google::Apis::ScriptV1::GoogleAppsScriptTypeUser]
         attr_accessor :last_modify_user
       
-        # The parent's Drive ID that the script will be attached to. This is usually
+        # The parent's Drive ID that the script will be attached to. This is usually the
-        # the ID of a Google Document or Google Sheet. This filed is optional, and
+        # ID of a Google Document or Google Sheet. This filed is optional, and if not
-        # if not set, a stand-alone script will be created.
+        # set, a stand-alone script will be created.
         # Corresponds to the JSON property `parentId`
         # @return [String]
         attr_accessor :parent_id
@@ -1041,9 +1018,9 @@ module Google
       class Status
         include Google::Apis::Core::Hashable
       
-        # The status code. For this API, this value either: <ul> <li> 10, indicating a `
+        # The status code. For this API, this value either: - 10, indicating a `
-        # SCRIPT_TIMEOUT` error,</li> <li> 3, indicating an `INVALID_ARGUMENT` error, or<
+        # SCRIPT_TIMEOUT` error, - 3, indicating an `INVALID_ARGUMENT` error, or - 1,
-        # /li> <li> 1, indicating a `CANCELLED` execution.</li> </ul>
+        # indicating a `CANCELLED` execution.
         # Corresponds to the JSON property `code`
         # @return [Fixnum]
         attr_accessor :code
@@ -1072,8 +1049,8 @@ module Google
         end
       end
       
-      # `Struct` represents a structured data value, consisting of fields which map
+      # `Struct` represents a structured data value, consisting of fields which map to
-      # to dynamically typed values.
+      # dynamically typed values.
       class Struct
         include Google::Apis::Core::Hashable
       
@@ -1158,8 +1135,8 @@ module Google
         # @return [String]
         attr_accessor :string_value
       
-        # `Struct` represents a structured data value, consisting of fields which map
+        # `Struct` represents a structured data value, consisting of fields which map to
-        # to dynamically typed values.
+        # dynamically typed values.
         # Corresponds to the JSON property `structValue`
         # @return [Google::Apis::ScriptV1::Struct]
         attr_accessor :struct_value
@@ -1182,9 +1159,9 @@ module Google
         end
       end
       
-      # A resource representing a script project version. A version is a "snapshot"
+      # A resource representing a script project version. A version is a "snapshot" of
-      # of a script project and is similar to a read-only branched release. When
+      # a script project and is similar to a read-only branched release. When creating
-      # creating deployments, the version to use must be specified.
+      # deployments, the version to use must be specified.
       class Version
         include Google::Apis::Core::Hashable
       
@@ -1203,8 +1180,8 @@ module Google
         # @return [String]
         attr_accessor :script_id
       
-        # The incremental ID that is created by Apps Script when a version is
+        # The incremental ID that is created by Apps Script when a version is created.
-        # created. This is system assigned number and is immutable once created.
+        # This is system assigned number and is immutable once created.
         # Corresponds to the JSON property `versionNumber`
         # @return [Fixnum]
         attr_accessor :version_number

generated/google/apis/script_v1/service.rb

@@ -47,23 +47,22 @@ module Google
           @batch_path = 'batch'
         end
         
-        # List information about processes made by or on behalf of a user,
+        # List information about processes made by or on behalf of a user, such as
-        # such as process type and current status.
+        # process type and current status.
         # @param [Fixnum] page_size
-        #   The maximum number of returned processes per page of results. Defaults to
+        #   The maximum number of returned processes per page of results. Defaults to 50.
-        #   50.
         # @param [String] page_token
-        #   The token for continuing a previous list request on the next page. This
+        #   The token for continuing a previous list request on the next page. This should
-        #   should be set to the value of `nextPageToken` from a previous response.
+        #   be set to the value of `nextPageToken` from a previous response.
         # @param [String] user_process_filter_deployment_id
         #   Optional field used to limit returned processes to those originating from
         #   projects with a specific deployment ID.
         # @param [String] user_process_filter_end_time
-        #   Optional field used to limit returned processes to those that completed
+        #   Optional field used to limit returned processes to those that completed on or
-        #   on or before the given timestamp.
+        #   before the given timestamp.
         # @param [String] user_process_filter_function_name
-        #   Optional field used to limit returned processes to those originating from
+        #   Optional field used to limit returned processes to those originating from a
-        #   a script function with the given function name.
+        #   script function with the given function name.
         # @param [String] user_process_filter_project_name
         #   Optional field used to limit returned processes to those originating from
         #   projects with project names containing a specific string.
@@ -71,17 +70,17 @@ module Google
         #   Optional field used to limit returned processes to those originating from
         #   projects with a specific script ID.
         # @param [String] user_process_filter_start_time
-        #   Optional field used to limit returned processes to those that were
+        #   Optional field used to limit returned processes to those that were started on
-        #   started on or after the given timestamp.
+        #   or after the given timestamp.
         # @param [Array<String>, String] user_process_filter_statuses
-        #   Optional field used to limit returned processes to those having one of
+        #   Optional field used to limit returned processes to those having one of the
-        #   the specified process statuses.
+        #   specified process statuses.
         # @param [Array<String>, String] user_process_filter_types
-        #   Optional field used to limit returned processes to those having one of
+        #   Optional field used to limit returned processes to those having one of the
-        #   the specified process types.
+        #   specified process types.
         # @param [Array<String>, String] user_process_filter_user_access_levels
-        #   Optional field used to limit returned processes to those having one of
+        #   Optional field used to limit returned processes to those having one of the
-        #   the specified user access levels.
+        #   specified user access levels.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -119,37 +118,36 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # List information about a script's executed processes, such as process type
+        # List information about a script's executed processes, such as process type and
-        # and current status.
+        # current status.
         # @param [Fixnum] page_size
-        #   The maximum number of returned processes per page of results. Defaults to
+        #   The maximum number of returned processes per page of results. Defaults to 50.
-        #   50.
         # @param [String] page_token
-        #   The token for continuing a previous list request on the next page. This
+        #   The token for continuing a previous list request on the next page. This should
-        #   should be set to the value of `nextPageToken` from a previous response.
+        #   be set to the value of `nextPageToken` from a previous response.
         # @param [String] script_id
         #   The script ID of the project whose processes are listed.
         # @param [String] script_process_filter_deployment_id
         #   Optional field used to limit returned processes to those originating from
         #   projects with a specific deployment ID.
         # @param [String] script_process_filter_end_time
-        #   Optional field used to limit returned processes to those that completed
+        #   Optional field used to limit returned processes to those that completed on or
-        #   on or before the given timestamp.
+        #   before the given timestamp.
         # @param [String] script_process_filter_function_name
-        #   Optional field used to limit returned processes to those originating from
+        #   Optional field used to limit returned processes to those originating from a
-        #   a script function with the given function name.
+        #   script function with the given function name.
         # @param [String] script_process_filter_start_time
-        #   Optional field used to limit returned processes to those that were
+        #   Optional field used to limit returned processes to those that were started on
-        #   started on or after the given timestamp.
+        #   or after the given timestamp.
         # @param [Array<String>, String] script_process_filter_statuses
-        #   Optional field used to limit returned processes to those having one of
+        #   Optional field used to limit returned processes to those having one of the
-        #   the specified process statuses.
+        #   specified process statuses.
         # @param [Array<String>, String] script_process_filter_types
-        #   Optional field used to limit returned processes to those having one of
+        #   Optional field used to limit returned processes to those having one of the
-        #   the specified process types.
+        #   specified process types.
         # @param [Array<String>, String] script_process_filter_user_access_levels
-        #   Optional field used to limit returned processes to those having one of
+        #   Optional field used to limit returned processes to those having one of the
-        #   the specified user access levels.
+        #   specified user access levels.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -186,8 +184,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new, empty script project with no script files and a base
+        # Creates a new, empty script project with no script files and a base manifest
-        # manifest file.
+        # file.
         # @param [Google::Apis::ScriptV1::CreateProjectRequest] create_project_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -247,13 +245,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the content of the script project, including the code source and
+        # Gets the content of the script project, including the code source and metadata
-        # metadata for each script file.
+        # for each script file.
         # @param [String] script_id
         #   The script project's Drive ID.
         # @param [Fixnum] version_number
-        #   The version number of the project to retrieve. If not provided, the
+        #   The version number of the project to retrieve. If not provided, the project's
-        #   project's HEAD version is returned.
+        #   HEAD version is returned.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -282,8 +280,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Get metrics data for scripts, such as number of executions and
+        # Get metrics data for scripts, such as number of executions and active users.
-        # active users.
         # @param [String] script_id
         #   Required field indicating the script to get metrics for.
         # @param [String] metrics_filter_deployment_id
@@ -319,11 +316,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates the content of the specified script project.
+        # Updates the content of the specified script project. This content is stored as
-        # This content is stored as the HEAD version, and is used when the script is
+        # the HEAD version, and is used when the script is executed as a trigger, in the
-        # executed as a trigger, in the script editor, in add-on preview mode, or as
+        # script editor, in add-on preview mode, or as a web app or Apps Script API in
-        # a web app or Apps Script API in development mode. This clears all the
+        # development mode. This clears all the existing files in the project.
-        # existing files in the project.
         # @param [String] script_id
         #   The script project's Drive ID.
         # @param [Google::Apis::ScriptV1::Content] content_object
@@ -461,8 +457,8 @@ module Google
         # @param [Fixnum] page_size
         #   The maximum number of deployments on each returned page. Defaults to 50.
         # @param [String] page_token
-        #   The token for continuing a previous list request on the next page. This
+        #   The token for continuing a previous list request on the next page. This should
-        #   should be set to the value of `nextPageToken` from a previous response.
+        #   be set to the value of `nextPageToken` from a previous response.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -528,8 +524,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a new immutable version using the current code, with a unique
+        # Creates a new immutable version using the current code, with a unique version
-        # version number.
+        # number.
         # @param [String] script_id
         #   The script project's Drive ID.
         # @param [Google::Apis::ScriptV1::Version] version_object
@@ -601,8 +597,8 @@ module Google
         # @param [Fixnum] page_size
         #   The maximum number of versions on each returned page. Defaults to 50.
         # @param [String] page_token
-        #   The token for continuing a previous list request on the next page. This
+        #   The token for continuing a previous list request on the next page. This should
-        #   should be set to the value of `nextPageToken` from a previous response.
+        #   be set to the value of `nextPageToken` from a previous response.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -632,22 +628,20 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Runs a function in an Apps Script project. The script project must be
+        # Runs a function in an Apps Script project. The script project must be deployed
-        # deployed for use with the Apps Script API and the calling application must
+        # for use with the Apps Script API and the calling application must share the
-        # share the same Cloud Platform project.
+        # same Cloud Platform project. This method requires authorization with an OAuth
-        # This method requires authorization with an OAuth 2.0 token that includes at
+        # 2.0 token that includes at least one of the scopes listed in the [
-        # least one of the scopes listed in the
+        # Authorization](#authorization-scopes) section; script projects that do not
-        # [Authorization](#authorization-scopes) section; script projects that do not
+        # require authorization cannot be executed through this API. To find the correct
-        # require authorization cannot be executed through this API. To find the
+        # scopes to include in the authentication token, open the project in the script
-        # correct scopes to include in the authentication token, open the project in
+        # editor, then select **File > Project properties** and click the **Scopes** tab.
-        # the script editor, then select **File > Project properties** and click the
-        # **Scopes** tab.
         # The error `403, PERMISSION_DENIED: The caller does not have permission`
-        # indicates that the Cloud Platform project used to authorize the request is
+        # indicates that the Cloud Platform project used to authorize the request is not
-        # not the same as the one used by the script.
+        # the same as the one used by the script.
         # @param [String] script_id
-        #   The script ID of the script to be executed. To find the script ID, open
+        #   The script ID of the script to be executed. To find the script ID, open the
-        #   the project in the script editor and select **File > Project properties**.
+        #   project in the script editor and select **File > Project properties**.
         # @param [Google::Apis::ScriptV1::ExecutionRequest] execution_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.

generated/google/apis/servicecontrol_v1.rb

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

generated/google/apis/servicecontrol_v1/service.rb

@@ -49,18 +49,16 @@ module Google
         end
         
         # Attempts to allocate quota for the specified consumer. It should be called
-        # before the operation is executed.
+        # before the operation is executed. This method requires the `servicemanagement.
-        # This method requires the `servicemanagement.services.quota`
+        # services.quota` permission on the specified service. For more information, see
-        # permission on the specified service. For more information, see
+        # [Cloud IAM](https://cloud.google.com/iam). **NOTE:** The client **must** fail-
-        # [Cloud IAM](https://cloud.google.com/iam).
+        # open on server errors `INTERNAL`, `UNKNOWN`, `DEADLINE_EXCEEDED`, and `
-        # **NOTE:** The client **must** fail-open on server errors `INTERNAL`,
+        # UNAVAILABLE`. To ensure system reliability, the server may inject these errors
-        # `UNKNOWN`, `DEADLINE_EXCEEDED`, and `UNAVAILABLE`. To ensure system
+        # to prohibit any hard dependency on the quota functionality.
-        # reliability, the server may inject these errors to prohibit any hard
-        # dependency on the quota functionality.
         # @param [String] service_name
-        #   Name of the service as specified in the service configuration. For example,
+        #   Name of the service as specified in the service configuration. For example, `"
-        #   `"pubsub.googleapis.com"`.
+        #   pubsub.googleapis.com"`. See google.api.Service for the definition of a
-        #   See google.api.Service for the definition of a service name.
+        #   service name.
         # @param [Google::Apis::ServicecontrolV1::AllocateQuotaRequest] allocate_quota_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -91,26 +89,22 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Checks whether an operation on a service should be allowed to proceed
+        # Checks whether an operation on a service should be allowed to proceed based on
-        # based on the configuration of the service and related policies. It must be
+        # the configuration of the service and related policies. It must be called
-        # called before the operation is executed.
+        # before the operation is executed. If feasible, the client should cache the
-        # If feasible, the client should cache the check results and reuse them for
+        # check results and reuse them for 60 seconds. In case of any server errors, the
-        # 60 seconds. In case of any server errors, the client should rely on the
+        # client should rely on the cached results for much longer time to avoid outage.
-        # cached results for much longer time to avoid outage.
         # WARNING: There is general 60s delay for the configuration and policy
         # propagation, therefore callers MUST NOT depend on the `Check` method having
-        # the latest policy information.
+        # the latest policy information. NOTE: the CheckRequest has the size limit of
-        # NOTE: the CheckRequest has the size limit of 64KB.
+        # 64KB. This method requires the `servicemanagement.services.check` permission
-        # This method requires the `servicemanagement.services.check` permission
+        # on the specified service. For more information, see [Cloud IAM](https://cloud.
-        # on the specified service. For more information, see
+        # google.com/iam).
-        # [Cloud IAM](https://cloud.google.com/iam).
         # @param [String] service_name
-        #   The service name as specified in its service configuration. For example,
+        #   The service name as specified in its service configuration. For example, `"
-        #   `"pubsub.googleapis.com"`.
+        #   pubsub.googleapis.com"`. See [google.api.Service](https://cloud.google.com/
-        #   See
+        #   service-management/reference/rpc/google.api#google.api.Service) for the
-        #   [google.api.Service](https://cloud.google.com/service-management/reference/rpc/
+        #   definition of a service name.
-        #   google.api#google.api.Service)
-        #   for the definition of a service name.
         # @param [Google::Apis::ServicecontrolV1::CheckRequest] check_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -141,25 +135,21 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Reports operation results to Google Service Control, such as logs and
+        # Reports operation results to Google Service Control, such as logs and metrics.
-        # metrics. It should be called after an operation is completed.
+        # It should be called after an operation is completed. If feasible, the client
-        # If feasible, the client should aggregate reporting data for up to 5
+        # should aggregate reporting data for up to 5 seconds to reduce API traffic.
-        # seconds to reduce API traffic. Limiting aggregation to 5 seconds is to
+        # Limiting aggregation to 5 seconds is to reduce data loss during client crashes.
-        # reduce data loss during client crashes. Clients should carefully choose
+        # Clients should carefully choose the aggregation time window to avoid data
-        # the aggregation time window to avoid data loss risk more than 0.01%
+        # loss risk more than 0.01% for business and compliance reasons. NOTE: the
-        # for business and compliance reasons.
+        # ReportRequest has the size limit (wire-format byte size) of 1MB. This method
-        # NOTE: the ReportRequest has the size limit (wire-format byte size) of
+        # requires the `servicemanagement.services.report` permission on the specified
-        # 1MB.
+        # service. For more information, see [Google Cloud IAM](https://cloud.google.com/
-        # This method requires the `servicemanagement.services.report` permission
+        # iam).
-        # on the specified service. For more information, see
-        # [Google Cloud IAM](https://cloud.google.com/iam).
         # @param [String] service_name
-        #   The service name as specified in its service configuration. For example,
+        #   The service name as specified in its service configuration. For example, `"
-        #   `"pubsub.googleapis.com"`.
+        #   pubsub.googleapis.com"`. See [google.api.Service](https://cloud.google.com/
-        #   See
+        #   service-management/reference/rpc/google.api#google.api.Service) for the
-        #   [google.api.Service](https://cloud.google.com/service-management/reference/rpc/
+        #   definition of a service name.
-        #   google.api#google.api.Service)
-        #   for the definition of a service name.
         # @param [Google::Apis::ServicecontrolV1::ReportRequest] report_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.

generated/google/apis/servicemanagement_v1.rb

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