google-cloud-asset-v1 0.26.0 → 0.27.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 85b40207f1ac183624644ec8b78eab9950322a0c5e43f39f6cf2ff236381f45c
-  data.tar.gz: 2d1e82dc8a21a0043ebdc9974b0a16e11e0ff317c9384f09cfdd874c3f1482b0
+  metadata.gz: ce8dc4fea3414af0a84ee4b12cf7c991b4a6bd44dc1a86339cc70ffb514bad35
+  data.tar.gz: 3798fd9b888bb17b535f979a31e982b70a95c8111ab979961e8b044eced9b95d
 SHA512:
-  metadata.gz: b28dc9c926d819e43ee4c7981d7ccaeca4cfeffdaf3361ced66cb791baf9c3192bafa18ffb4b655535e26b8aed2f8c9b9332f860c342a3275c3b233c6320c62f
-  data.tar.gz: 7c29ae6e58d9f454b79336b17fdea850aa69327b8850dfc136e626dcbba92aa4c06b969d857fa7e50f5670e977537464e7d655534f0b25fb1b13a15caaabc59d
+  metadata.gz: e8f68cbe594e330ae2029da80fafe4a049ec88709ca9de00d38100b8c574c0f722be312914d8f0e50c541d77d3e9e1bf8f5e130b8ccc6b2345d7f186c857f2fb
+  data.tar.gz: 8457d1254fb5b7bc87c4b2f379de5bcc56c88838a8956bd3980525e7f34d05b00c929ad2f2aefc2e64fc63d8c13a675a057474a5d630e6db4afd829a8d1555fd

data/lib/google/cloud/asset/v1/asset_service/client.rb

@@ -236,7 +236,8 @@ module Google
                 credentials:  credentials,
                 endpoint:     @config.endpoint,
                 channel_args: @config.channel_args,
-                interceptors: @config.interceptors
+                interceptors: @config.interceptors,
+                channel_pool_config: @config.channel_pool
               )
             end
 
@@ -3114,6 +3115,14 @@ module Google
                 end
               end
 
+              ##
+              # Configuration for the channel pool
+              # @return [::Gapic::ServiceStub::ChannelPool::Configuration]
+              #
+              def channel_pool
+                @channel_pool ||= ::Gapic::ServiceStub::ChannelPool::Configuration.new
+              end
+
               ##
               # Configuration RPC class for the AssetService API.
               #

data/lib/google/cloud/asset/v1/asset_service/operations.rb

@@ -93,7 +93,8 @@ module Google
                 credentials:  credentials,
                 endpoint:     @config.endpoint,
                 channel_args: @config.channel_args,
-                interceptors: @config.interceptors
+                interceptors: @config.interceptors,
+                channel_pool_config: @config.channel_pool
               )
 
               # Used by an LRO wrapper for some methods of this service
@@ -701,6 +702,14 @@ module Google
                 end
               end
 
+              ##
+              # Configuration for the channel pool
+              # @return [::Gapic::ServiceStub::ChannelPool::Configuration]
+              #
+              def channel_pool
+                @channel_pool ||= ::Gapic::ServiceStub::ChannelPool::Configuration.new
+              end
+
               ##
               # Configuration RPC class for the Operations API.
               #

data/lib/google/cloud/asset/v1/asset_service/rest/client.rb

@@ -327,6 +327,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::ExportAssetsRequest.new
+              #
+              #   # Call the export_assets method.
+              #   result = client.export_assets request
+              #
+              #   # The returned object is of type Gapic::Operation. You can use it to
+              #   # check the status of an operation, cancel it, or wait for results.
+              #   # Here is how to wait for a response.
+              #   result.wait_until_done! timeout: 60
+              #   if result.response?
+              #     p result.response
+              #   else
+              #     puts "No response received."
+              #   end
+              #
               def export_assets request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -446,6 +469,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Asset::V1::Asset>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::ListAssetsRequest.new
+              #
+              #   # Call the list_assets method.
+              #   result = client.list_assets request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Cloud::Asset::V1::Asset.
+              #     p item
+              #   end
+              #
               def list_assets request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -552,6 +595,22 @@ module Google
               # @return [::Google::Cloud::Asset::V1::BatchGetAssetsHistoryResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::BatchGetAssetsHistoryRequest.new
+              #
+              #   # Call the batch_get_assets_history method.
+              #   result = client.batch_get_assets_history request
+              #
+              #   # The returned object is of type Google::Cloud::Asset::V1::BatchGetAssetsHistoryResponse.
+              #   p result
+              #
               def batch_get_assets_history request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -627,6 +686,22 @@ module Google
               # @return [::Google::Cloud::Asset::V1::Feed]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::CreateFeedRequest.new
+              #
+              #   # Call the create_feed method.
+              #   result = client.create_feed request
+              #
+              #   # The returned object is of type Google::Cloud::Asset::V1::Feed.
+              #   p result
+              #
               def create_feed request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -692,6 +767,22 @@ module Google
               # @return [::Google::Cloud::Asset::V1::Feed]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::GetFeedRequest.new
+              #
+              #   # Call the get_feed method.
+              #   result = client.get_feed request
+              #
+              #   # The returned object is of type Google::Cloud::Asset::V1::Feed.
+              #   p result
+              #
               def get_feed request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -756,6 +847,22 @@ module Google
               # @return [::Google::Cloud::Asset::V1::ListFeedsResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::ListFeedsRequest.new
+              #
+              #   # Call the list_feeds method.
+              #   result = client.list_feeds request
+              #
+              #   # The returned object is of type Google::Cloud::Asset::V1::ListFeedsResponse.
+              #   p result
+              #
               def list_feeds request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -826,6 +933,22 @@ module Google
               # @return [::Google::Cloud::Asset::V1::Feed]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::UpdateFeedRequest.new
+              #
+              #   # Call the update_feed method.
+              #   result = client.update_feed request
+              #
+              #   # The returned object is of type Google::Cloud::Asset::V1::Feed.
+              #   p result
+              #
               def update_feed request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -891,6 +1014,22 @@ module Google
               # @return [::Google::Protobuf::Empty]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::DeleteFeedRequest.new
+              #
+              #   # Call the delete_feed method.
+              #   result = client.delete_feed request
+              #
+              #   # The returned object is of type Google::Protobuf::Empty.
+              #   p result
+              #
               def delete_feed request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1102,6 +1241,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Asset::V1::ResourceSearchResult>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::SearchAllResourcesRequest.new
+              #
+              #   # Call the search_all_resources method.
+              #   result = client.search_all_resources request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Cloud::Asset::V1::ResourceSearchResult.
+              #     p item
+              #   end
+              #
               def search_all_resources request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1262,6 +1421,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Asset::V1::IamPolicySearchResult>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::SearchAllIamPoliciesRequest.new
+              #
+              #   # Call the search_all_iam_policies method.
+              #   result = client.search_all_iam_policies request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Cloud::Asset::V1::IamPolicySearchResult.
+              #     p item
+              #   end
+              #
               def search_all_iam_policies request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1355,6 +1534,22 @@ module Google
               # @return [::Google::Cloud::Asset::V1::AnalyzeIamPolicyResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::AnalyzeIamPolicyRequest.new
+              #
+              #   # Call the analyze_iam_policy method.
+              #   result = client.analyze_iam_policy request
+              #
+              #   # The returned object is of type Google::Cloud::Asset::V1::AnalyzeIamPolicyResponse.
+              #   p result
+              #
               def analyze_iam_policy request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1446,6 +1641,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::AnalyzeIamPolicyLongrunningRequest.new
+              #
+              #   # Call the analyze_iam_policy_longrunning method.
+              #   result = client.analyze_iam_policy_longrunning request
+              #
+              #   # The returned object is of type Gapic::Operation. You can use it to
+              #   # check the status of an operation, cancel it, or wait for results.
+              #   # Here is how to wait for a response.
+              #   result.wait_until_done! timeout: 60
+              #   if result.response?
+              #     p result.response
+              #   else
+              #     puts "No response received."
+              #   end
+              #
               def analyze_iam_policy_longrunning request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1525,6 +1743,22 @@ module Google
               # @return [::Google::Cloud::Asset::V1::AnalyzeMoveResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::AnalyzeMoveRequest.new
+              #
+              #   # Call the analyze_move method.
+              #   result = client.analyze_move request
+              #
+              #   # The returned object is of type Google::Cloud::Asset::V1::AnalyzeMoveResponse.
+              #   p result
+              #
               def analyze_move request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1654,6 +1888,22 @@ module Google
               # @return [::Google::Cloud::Asset::V1::QueryAssetsResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::QueryAssetsRequest.new
+              #
+              #   # Call the query_assets method.
+              #   result = client.query_assets request
+              #
+              #   # The returned object is of type Google::Cloud::Asset::V1::QueryAssetsResponse.
+              #   p result
+              #
               def query_assets request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1733,6 +1983,22 @@ module Google
               # @return [::Google::Cloud::Asset::V1::SavedQuery]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::CreateSavedQueryRequest.new
+              #
+              #   # Call the create_saved_query method.
+              #   result = client.create_saved_query request
+              #
+              #   # The returned object is of type Google::Cloud::Asset::V1::SavedQuery.
+              #   p result
+              #
               def create_saved_query request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1799,6 +2065,22 @@ module Google
               # @return [::Google::Cloud::Asset::V1::SavedQuery]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::GetSavedQueryRequest.new
+              #
+              #   # Call the get_saved_query method.
+              #   result = client.get_saved_query request
+              #
+              #   # The returned object is of type Google::Cloud::Asset::V1::SavedQuery.
+              #   p result
+              #
               def get_saved_query request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1882,6 +2164,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Asset::V1::SavedQuery>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::ListSavedQueriesRequest.new
+              #
+              #   # Call the list_saved_queries method.
+              #   result = client.list_saved_queries request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Cloud::Asset::V1::SavedQuery.
+              #     p item
+              #   end
+              #
               def list_saved_queries request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1954,6 +2256,22 @@ module Google
               # @return [::Google::Cloud::Asset::V1::SavedQuery]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::UpdateSavedQueryRequest.new
+              #
+              #   # Call the update_saved_query method.
+              #   result = client.update_saved_query request
+              #
+              #   # The returned object is of type Google::Cloud::Asset::V1::SavedQuery.
+              #   p result
+              #
               def update_saved_query request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2021,6 +2339,22 @@ module Google
               # @return [::Google::Protobuf::Empty]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::DeleteSavedQueryRequest.new
+              #
+              #   # Call the delete_saved_query method.
+              #   result = client.delete_saved_query request
+              #
+              #   # The returned object is of type Google::Protobuf::Empty.
+              #   p result
+              #
               def delete_saved_query request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2099,6 +2433,22 @@ module Google
               # @return [::Google::Cloud::Asset::V1::BatchGetEffectiveIamPoliciesResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::BatchGetEffectiveIamPoliciesRequest.new
+              #
+              #   # Call the batch_get_effective_iam_policies method.
+              #   result = client.batch_get_effective_iam_policies request
+              #
+              #   # The returned object is of type Google::Cloud::Asset::V1::BatchGetEffectiveIamPoliciesResponse.
+              #   p result
+              #
               def batch_get_effective_iam_policies request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2183,6 +2533,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Asset::V1::AnalyzeOrgPoliciesResponse::OrgPolicyResult>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::AnalyzeOrgPoliciesRequest.new
+              #
+              #   # Call the analyze_org_policies method.
+              #   result = client.analyze_org_policies request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Cloud::Asset::V1::AnalyzeOrgPoliciesResponse::OrgPolicyResult.
+              #     p item
+              #   end
+              #
               def analyze_org_policies request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2270,6 +2640,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Asset::V1::AnalyzeOrgPolicyGovernedContainersResponse::GovernedContainer>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::AnalyzeOrgPolicyGovernedContainersRequest.new
+              #
+              #   # Call the analyze_org_policy_governed_containers method.
+              #   result = client.analyze_org_policy_governed_containers request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Cloud::Asset::V1::AnalyzeOrgPolicyGovernedContainersResponse::GovernedContainer.
+              #     p item
+              #   end
+              #
               def analyze_org_policy_governed_containers request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2379,6 +2769,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Asset::V1::AnalyzeOrgPolicyGovernedAssetsResponse::GovernedAsset>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::AnalyzeOrgPolicyGovernedAssetsRequest.new
+              #
+              #   # Call the analyze_org_policy_governed_assets method.
+              #   result = client.analyze_org_policy_governed_assets request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Cloud::Asset::V1::AnalyzeOrgPolicyGovernedAssetsResponse::GovernedAsset.
+              #     p item
+              #   end
+              #
               def analyze_org_policy_governed_assets request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 

data/lib/google/cloud/asset/v1/asset_service/rest/operations.rb

@@ -136,6 +136,26 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/longrunning"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Longrunning::Operations::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Longrunning::ListOperationsRequest.new
+              #
+              #   # Call the list_operations method.
+              #   result = client.list_operations request
+              #
+              #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+              #   # over elements, and API calls will be issued to fetch pages as needed.
+              #   result.each do |item|
+              #     # Each element is of type ::Google::Longrunning::Operation.
+              #     p item
+              #   end
+              #
               def list_operations request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -201,6 +221,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/longrunning"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Longrunning::Operations::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Longrunning::GetOperationRequest.new
+              #
+              #   # Call the get_operation method.
+              #   result = client.get_operation request
+              #
+              #   # The returned object is of type Gapic::Operation. You can use it to
+              #   # check the status of an operation, cancel it, or wait for results.
+              #   # Here is how to wait for a response.
+              #   result.wait_until_done! timeout: 60
+              #   if result.response?
+              #     p result.response
+              #   else
+              #     puts "No response received."
+              #   end
+              #
               def get_operation request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -267,6 +310,22 @@ module Google
               # @return [::Google::Protobuf::Empty]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/longrunning"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Longrunning::Operations::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Longrunning::DeleteOperationRequest.new
+              #
+              #   # Call the delete_operation method.
+              #   result = client.delete_operation request
+              #
+              #   # The returned object is of type Google::Protobuf::Empty.
+              #   p result
+              #
               def delete_operation request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -338,6 +397,22 @@ module Google
               # @return [::Google::Protobuf::Empty]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/longrunning"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Longrunning::Operations::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Longrunning::CancelOperationRequest.new
+              #
+              #   # Call the cancel_operation method.
+              #   result = client.cancel_operation request
+              #
+              #   # The returned object is of type Google::Protobuf::Empty.
+              #   p result
+              #
               def cancel_operation request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 

data/lib/google/cloud/asset/v1/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Asset
       module V1
-        VERSION = "0.26.0"
+        VERSION = "0.27.0"
       end
     end
   end

data/proto_docs/google/api/field_behavior.rb

@@ -66,6 +66,20 @@ module Google
       # a non-empty value will be returned. The user will not be aware of what
       # non-empty value to expect.
       NON_EMPTY_DEFAULT = 7
+
+      # Denotes that the field in a resource (a message annotated with
+      # google.api.resource) is used in the resource name to uniquely identify the
+      # resource. For AIP-compliant APIs, this should only be applied to the
+      # `name` field on the resource.
+      #
+      # This behavior should not be applied to references to other resources within
+      # the message.
+      #
+      # The identifier field of resources often have different field behavior
+      # depending on the request it is embedded in (e.g. for Create methods name
+      # is optional and unused, while for Update methods it is required). Instead
+      # of method-specific annotations, only `IDENTIFIER` is required.
+      IDENTIFIER = 8
     end
   end
 end

data/proto_docs/google/iam/v1/policy.rb

@@ -40,6 +40,7 @@ module Google
       #
       # **JSON example:**
       #
+      # ```
       #     {
       #       "bindings": [
       #         {
@@ -67,9 +68,11 @@ module Google
       #       "etag": "BwWWja0YfJA=",
       #       "version": 3
       #     }
+      # ```
       #
       # **YAML example:**
       #
+      # ```
       #     bindings:
       #     - members:
       #       - user:mike@example.com
@@ -86,6 +89,7 @@ module Google
       #         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/).
@@ -157,7 +161,7 @@ module Google
       #     For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
       # @!attribute [rw] members
       #   @return [::Array<::String>]
-      #     Specifies the principals requesting access for a Cloud Platform resource.
+      #     Specifies the principals requesting access for a Google Cloud resource.
       #     `members` can have the following values:
       #
       #     * `allUsers`: A special identifier that represents anyone who is
@@ -267,8 +271,8 @@ module Google
       #     }
       #
       # 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.
+      # logging. It also exempts `jose@example.com` from DATA_READ logging, and
+      # `aliya@example.com` from DATA_WRITE logging.
       # @!attribute [rw] service
       #   @return [::String]
       #     Specifies a service that will be enabled for audit logging.
@@ -356,7 +360,7 @@ module Google
       #     Required
       # @!attribute [rw] member
       #   @return [::String]
-      #     A single identity requesting access for a Cloud Platform resource.
+      #     A single identity requesting access for a Google Cloud resource.
       #     Follows the same format of Binding.members.
       #     Required
       # @!attribute [rw] condition

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-asset-v1
 version: !ruby/object:Gem::Version
-  version: 0.26.0
+  version: 0.27.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-06-06 00:00:00.000000000 Z
+date: 2023-09-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.19.1
+        version: 0.20.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.19.1
+        version: 0.20.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -285,7 +285,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.2
+rubygems_version: 3.4.19
 signing_key: 
 specification_version: 4
 summary: The Cloud Asset API manages the history and inventory of Google Cloud resources.