google-cloud-vision_ai-v1 0.2.0 → 0.4.0

data/lib/google/cloud/vision_ai/v1/warehouse/client.rb

@@ -196,14 +196,26 @@ module Google
                 universe_domain: @config.universe_domain,
                 channel_args: @config.channel_args,
                 interceptors: @config.interceptors,
-                channel_pool_config: @config.channel_pool
+                channel_pool_config: @config.channel_pool,
+                logger: @config.logger
               )
 
+              @warehouse_stub.stub_logger&.info do |entry|
+                entry.set_system_name
+                entry.set_service
+                entry.message = "Created client for #{entry.service}"
+                entry.set_credentials_fields credentials
+                entry.set "customEndpoint", @config.endpoint if @config.endpoint
+                entry.set "defaultTimeout", @config.timeout if @config.timeout
+                entry.set "quotaProject", @quota_project_id if @quota_project_id
+              end
+
               @location_client = Google::Cloud::Location::Locations::Client.new do |config|
                 config.credentials = credentials
                 config.quota_project = @quota_project_id
                 config.endpoint = @warehouse_stub.endpoint
                 config.universe_domain = @warehouse_stub.universe_domain
+                config.logger = @warehouse_stub.logger if config.respond_to? :logger=
               end
 
               @iam_policy_client = Google::Iam::V1::IAMPolicy::Client.new do |config|
@@ -211,6 +223,7 @@ module Google
                 config.quota_project = @quota_project_id
                 config.endpoint = @warehouse_stub.endpoint
                 config.universe_domain = @warehouse_stub.universe_domain
+                config.logger = @warehouse_stub.logger if config.respond_to? :logger=
               end
             end
 
@@ -235,6 +248,15 @@ module Google
             #
             attr_reader :iam_policy_client
 
+            ##
+            # The logger used for request/response debug logging.
+            #
+            # @return [Logger]
+            #
+            def logger
+              @warehouse_stub.logger
+            end
+
             # Service calls
 
             ##
@@ -329,7 +351,6 @@ module Google
 
               @warehouse_stub.call_rpc :create_asset, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -421,7 +442,6 @@ module Google
 
               @warehouse_stub.call_rpc :update_asset, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -509,7 +529,6 @@ module Google
 
               @warehouse_stub.call_rpc :get_asset, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -618,7 +637,7 @@ module Google
               @warehouse_stub.call_rpc :list_assets, request, options: options do |response, operation|
                 response = ::Gapic::PagedEnumerable.new @warehouse_stub, :list_assets, request, response, operation, options
                 yield response, operation if block_given?
-                return response
+                throw :response, response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -714,7 +733,7 @@ module Google
               @warehouse_stub.call_rpc :delete_asset, request, options: options do |response, operation|
                 response = ::Gapic::Operation.new response, @operations_client, options: options
                 yield response, operation if block_given?
-                return response
+                throw :response, response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -821,7 +840,7 @@ module Google
               @warehouse_stub.call_rpc :upload_asset, request, options: options do |response, operation|
                 response = ::Gapic::Operation.new response, @operations_client, options: options
                 yield response, operation if block_given?
-                return response
+                throw :response, response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -911,7 +930,6 @@ module Google
 
               @warehouse_stub.call_rpc :generate_retrieval_url, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -1007,7 +1025,7 @@ module Google
               @warehouse_stub.call_rpc :analyze_asset, request, options: options do |response, operation|
                 response = ::Gapic::Operation.new response, @operations_client, options: options
                 yield response, operation if block_given?
-                return response
+                throw :response, response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -1108,7 +1126,7 @@ module Google
               @warehouse_stub.call_rpc :index_asset, request, options: options do |response, operation|
                 response = ::Gapic::Operation.new response, @operations_client, options: options
                 yield response, operation if block_given?
-                return response
+                throw :response, response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -1209,7 +1227,7 @@ module Google
               @warehouse_stub.call_rpc :remove_index_asset, request, options: options do |response, operation|
                 response = ::Gapic::Operation.new response, @operations_client, options: options
                 yield response, operation if block_given?
-                return response
+                throw :response, response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -1318,7 +1336,7 @@ module Google
               @warehouse_stub.call_rpc :view_indexed_assets, request, options: options do |response, operation|
                 response = ::Gapic::PagedEnumerable.new @warehouse_stub, :view_indexed_assets, request, response, operation, options
                 yield response, operation if block_given?
-                return response
+                throw :response, response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -1424,7 +1442,7 @@ module Google
               @warehouse_stub.call_rpc :create_index, request, options: options do |response, operation|
                 response = ::Gapic::Operation.new response, @operations_client, options: options
                 yield response, operation if block_given?
-                return response
+                throw :response, response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -1527,7 +1545,7 @@ module Google
               @warehouse_stub.call_rpc :update_index, request, options: options do |response, operation|
                 response = ::Gapic::Operation.new response, @operations_client, options: options
                 yield response, operation if block_given?
-                return response
+                throw :response, response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -1615,7 +1633,6 @@ module Google
 
               @warehouse_stub.call_rpc :get_index, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -1719,7 +1736,7 @@ module Google
               @warehouse_stub.call_rpc :list_indexes, request, options: options do |response, operation|
                 response = ::Gapic::PagedEnumerable.new @warehouse_stub, :list_indexes, request, response, operation, options
                 yield response, operation if block_given?
-                return response
+                throw :response, response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -1816,7 +1833,7 @@ module Google
               @warehouse_stub.call_rpc :delete_index, request, options: options do |response, operation|
                 response = ::Gapic::Operation.new response, @operations_client, options: options
                 yield response, operation if block_given?
-                return response
+                throw :response, response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -1912,7 +1929,7 @@ module Google
               @warehouse_stub.call_rpc :create_corpus, request, options: options do |response, operation|
                 response = ::Gapic::Operation.new response, @operations_client, options: options
                 yield response, operation if block_given?
-                return response
+                throw :response, response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -1998,7 +2015,6 @@ module Google
 
               @warehouse_stub.call_rpc :get_corpus, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -2086,7 +2102,6 @@ module Google
 
               @warehouse_stub.call_rpc :update_corpus, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -2195,7 +2210,7 @@ module Google
               @warehouse_stub.call_rpc :list_corpora, request, options: options do |response, operation|
                 response = ::Gapic::PagedEnumerable.new @warehouse_stub, :list_corpora, request, response, operation, options
                 yield response, operation if block_given?
-                return response
+                throw :response, response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -2282,7 +2297,6 @@ module Google
 
               @warehouse_stub.call_rpc :delete_corpus, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -2378,7 +2392,7 @@ module Google
               @warehouse_stub.call_rpc :analyze_corpus, request, options: options do |response, operation|
                 response = ::Gapic::Operation.new response, @operations_client, options: options
                 yield response, operation if block_given?
-                return response
+                throw :response, response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -2468,7 +2482,6 @@ module Google
 
               @warehouse_stub.call_rpc :create_data_schema, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -2558,7 +2571,6 @@ module Google
 
               @warehouse_stub.call_rpc :update_data_schema, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -2646,7 +2658,6 @@ module Google
 
               @warehouse_stub.call_rpc :get_data_schema, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -2734,7 +2745,6 @@ module Google
 
               @warehouse_stub.call_rpc :delete_data_schema, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -2837,7 +2847,7 @@ module Google
               @warehouse_stub.call_rpc :list_data_schemas, request, options: options do |response, operation|
                 response = ::Gapic::PagedEnumerable.new @warehouse_stub, :list_data_schemas, request, response, operation, options
                 yield response, operation if block_given?
-                return response
+                throw :response, response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -2935,7 +2945,6 @@ module Google
 
               @warehouse_stub.call_rpc :create_annotation, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -3023,7 +3032,6 @@ module Google
 
               @warehouse_stub.call_rpc :get_annotation, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -3142,7 +3150,7 @@ module Google
               @warehouse_stub.call_rpc :list_annotations, request, options: options do |response, operation|
                 response = ::Gapic::PagedEnumerable.new @warehouse_stub, :list_annotations, request, response, operation, options
                 yield response, operation if block_given?
-                return response
+                throw :response, response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -3233,7 +3241,6 @@ module Google
 
               @warehouse_stub.call_rpc :update_annotation, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -3321,7 +3328,6 @@ module Google
 
               @warehouse_stub.call_rpc :delete_annotation, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -3403,7 +3409,6 @@ module Google
 
               @warehouse_stub.call_rpc :ingest_asset, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -3498,7 +3503,6 @@ module Google
 
               @warehouse_stub.call_rpc :clip_asset, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -3594,7 +3598,6 @@ module Google
 
               @warehouse_stub.call_rpc :generate_hls_uri, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -3697,7 +3700,7 @@ module Google
               @warehouse_stub.call_rpc :import_assets, request, options: options do |response, operation|
                 response = ::Gapic::Operation.new response, @operations_client, options: options
                 yield response, operation if block_given?
-                return response
+                throw :response, response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -3806,7 +3809,6 @@ module Google
 
               @warehouse_stub.call_rpc :create_search_config, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -3912,7 +3914,6 @@ module Google
 
               @warehouse_stub.call_rpc :update_search_config, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -4000,7 +4001,6 @@ module Google
 
               @warehouse_stub.call_rpc :get_search_config, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -4091,7 +4091,6 @@ module Google
 
               @warehouse_stub.call_rpc :delete_search_config, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -4195,7 +4194,7 @@ module Google
               @warehouse_stub.call_rpc :list_search_configs, request, options: options do |response, operation|
                 response = ::Gapic::PagedEnumerable.new @warehouse_stub, :list_search_configs, request, response, operation, options
                 yield response, operation if block_given?
-                return response
+                throw :response, response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -4287,7 +4286,6 @@ module Google
 
               @warehouse_stub.call_rpc :create_search_hypernym, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -4379,7 +4377,6 @@ module Google
 
               @warehouse_stub.call_rpc :update_search_hypernym, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -4467,7 +4464,6 @@ module Google
 
               @warehouse_stub.call_rpc :get_search_hypernym, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -4555,7 +4551,6 @@ module Google
 
               @warehouse_stub.call_rpc :delete_search_hypernym, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -4659,7 +4654,7 @@ module Google
               @warehouse_stub.call_rpc :list_search_hypernyms, request, options: options do |response, operation|
                 response = ::Gapic::PagedEnumerable.new @warehouse_stub, :list_search_hypernyms, request, response, operation, options
                 yield response, operation if block_given?
-                return response
+                throw :response, response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -4779,7 +4774,7 @@ module Google
               @warehouse_stub.call_rpc :search_assets, request, options: options do |response, operation|
                 response = ::Gapic::PagedEnumerable.new @warehouse_stub, :search_assets, request, response, operation, options
                 yield response, operation if block_given?
-                return response
+                throw :response, response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -4805,8 +4800,12 @@ module Google
             #
             #   @param image_query [::Google::Cloud::VisionAI::V1::ImageQuery, ::Hash]
             #     An image-only query.
+            #
+            #     Note: The following fields are mutually exclusive: `image_query`, `text_query`. If a field in that set is populated, all other fields in the set will automatically be cleared.
             #   @param text_query [::String]
             #     A text-only query.
+            #
+            #     Note: The following fields are mutually exclusive: `text_query`, `image_query`. If a field in that set is populated, all other fields in the set will automatically be cleared.
             #   @param index_endpoint [::String]
             #     Required. The index endpoint to search.
             #     Format:
@@ -4890,7 +4889,7 @@ module Google
               @warehouse_stub.call_rpc :search_index_endpoint, request, options: options do |response, operation|
                 response = ::Gapic::PagedEnumerable.new @warehouse_stub, :search_index_endpoint, request, response, operation, options
                 yield response, operation if block_given?
-                return response
+                throw :response, response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -4994,7 +4993,7 @@ module Google
               @warehouse_stub.call_rpc :create_index_endpoint, request, options: options do |response, operation|
                 response = ::Gapic::Operation.new response, @operations_client, options: options
                 yield response, operation if block_given?
-                return response
+                throw :response, response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -5080,7 +5079,6 @@ module Google
 
               @warehouse_stub.call_rpc :get_index_endpoint, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -5190,7 +5188,7 @@ module Google
               @warehouse_stub.call_rpc :list_index_endpoints, request, options: options do |response, operation|
                 response = ::Gapic::PagedEnumerable.new @warehouse_stub, :list_index_endpoints, request, response, operation, options
                 yield response, operation if block_given?
-                return response
+                throw :response, response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -5292,7 +5290,7 @@ module Google
               @warehouse_stub.call_rpc :update_index_endpoint, request, options: options do |response, operation|
                 response = ::Gapic::Operation.new response, @operations_client, options: options
                 yield response, operation if block_given?
-                return response
+                throw :response, response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -5386,7 +5384,7 @@ module Google
               @warehouse_stub.call_rpc :delete_index_endpoint, request, options: options do |response, operation|
                 response = ::Gapic::Operation.new response, @operations_client, options: options
                 yield response, operation if block_given?
-                return response
+                throw :response, response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -5484,7 +5482,7 @@ module Google
               @warehouse_stub.call_rpc :deploy_index, request, options: options do |response, operation|
                 response = ::Gapic::Operation.new response, @operations_client, options: options
                 yield response, operation if block_given?
-                return response
+                throw :response, response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -5580,7 +5578,7 @@ module Google
               @warehouse_stub.call_rpc :undeploy_index, request, options: options do |response, operation|
                 response = ::Gapic::Operation.new response, @operations_client, options: options
                 yield response, operation if block_given?
-                return response
+                throw :response, response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -5685,7 +5683,7 @@ module Google
               @warehouse_stub.call_rpc :create_collection, request, options: options do |response, operation|
                 response = ::Gapic::Operation.new response, @operations_client, options: options
                 yield response, operation if block_given?
-                return response
+                throw :response, response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -5780,7 +5778,7 @@ module Google
               @warehouse_stub.call_rpc :delete_collection, request, options: options do |response, operation|
                 response = ::Gapic::Operation.new response, @operations_client, options: options
                 yield response, operation if block_given?
-                return response
+                throw :response, response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -5867,7 +5865,6 @@ module Google
 
               @warehouse_stub.call_rpc :get_collection, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -5965,7 +5962,6 @@ module Google
 
               @warehouse_stub.call_rpc :update_collection, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -6067,7 +6063,7 @@ module Google
               @warehouse_stub.call_rpc :list_collections, request, options: options do |response, operation|
                 response = ::Gapic::PagedEnumerable.new @warehouse_stub, :list_collections, request, response, operation, options
                 yield response, operation if block_given?
-                return response
+                throw :response, response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -6153,7 +6149,6 @@ module Google
 
               @warehouse_stub.call_rpc :add_collection_item, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -6239,7 +6234,6 @@ module Google
 
               @warehouse_stub.call_rpc :remove_collection_item, request, options: options do |response, operation|
                 yield response, operation if block_given?
-                return response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -6342,7 +6336,7 @@ module Google
               @warehouse_stub.call_rpc :view_collection_items, request, options: options do |response, operation|
                 response = ::Gapic::PagedEnumerable.new @warehouse_stub, :view_collection_items, request, response, operation, options
                 yield response, operation if block_given?
-                return response
+                throw :response, response
               end
             rescue ::GRPC::BadStatus => e
               raise ::Google::Cloud::Error.from_error(e)
@@ -6392,6 +6386,13 @@ module Google
             #    *  (`GRPC::Core::Channel`) a gRPC channel with included credentials
             #    *  (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
             #    *  (`nil`) indicating no credentials
+            #
+            #   Warning: If you accept a credential configuration (JSON file or Hash) from an
+            #   external source for authentication to Google Cloud, you must validate it before
+            #   providing it to a Google API client library. Providing an unvalidated credential
+            #   configuration to Google APIs can compromise the security of your systems and data.
+            #   For more information, refer to [Validate credential configurations from external
+            #   sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
             #   @return [::Object]
             # @!attribute [rw] scope
             #   The OAuth scopes
@@ -6431,6 +6432,11 @@ module Google
             #   default endpoint URL. The default value of nil uses the environment
             #   universe (usually the default "googleapis.com" universe).
             #   @return [::String,nil]
+            # @!attribute [rw] logger
+            #   A custom logger to use for request/response debug logging, or the value
+            #   `:default` (the default) to construct a default logger, or `nil` to
+            #   explicitly disable logging.
+            #   @return [::Logger,:default,nil]
             #
             class Configuration
               extend ::Gapic::Config
@@ -6455,6 +6461,7 @@ module Google
               config_attr :retry_policy,  nil, ::Hash, ::Proc, nil
               config_attr :quota_project, nil, ::String, nil
               config_attr :universe_domain, nil, ::String, nil
+              config_attr :logger, :default, ::Logger, nil, :default
 
               # @private
               def initialize parent_config = nil