google-cloud-dlp-v2 1.5.0 → 1.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '002697af1dcbec1deb02d938b056306dee0297f98b101a63cc32508ee23cb03b'
-  data.tar.gz: bd58af69432ff4732c51d5d512182f12bd6e5ea34889e518c569c9e5947c4c19
+  metadata.gz: 156f5c64115fac0a5436276d2bfca9ad3cfe7aa31359a7b35782aeeebe6b6359
+  data.tar.gz: 5549d08e880d5730235385210f69340581fcbd3dc3eea4a5a53843c8e1fe5b41
 SHA512:
-  metadata.gz: 500fd813948d8e9bfa9300b7c3c83f713cfa3f5e97e34e76800ecad77874443c0701fc330633f8ce0f83929f276ead6c7053af55c8dda348fee144f90a41f276
-  data.tar.gz: dcaa8331d6261e858f8353a99d41beb99afad1a4eb4f6c41a0b435f7a79c0fa7a967b10ffd645f2de6f37797d99576a547d740aad2fd832eb6d5516c15da85c8
+  metadata.gz: 052602ba54bc335eed991f7c50b6d134b1d451eaeb561dd0e2f53219b9f50cfb74aef273f857eb4f79888181f973b1db72c5fdf482557aa1e520f4aecd61a6e2
+  data.tar.gz: e3d2f5518ec787576f3cad9920b99c08ad23e338569acdaa1edb017650bb82322d3d529c744e6fcabd63e3a66dc74ffa0d0d746a7a4e67442f11b4204b4f07f1

data/README.md

@@ -43,40 +43,50 @@ for class and method documentation.
 See also the [Product Documentation](https://cloud.google.com/dlp)
 for general usage information.
 
-## Enabling Logging
-
-To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
-The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/current/stdlibs/logger/Logger.html) as shown below,
-or a [`Google::Cloud::Logging::Logger`](https://cloud.google.com/ruby/docs/reference/google-cloud-logging/latest)
-that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
-and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
-
-Configuring a Ruby stdlib logger:
+## Debug Logging
+
+This library comes with opt-in Debug Logging that can help you troubleshoot
+your application's integration with the API. When logging is activated, key
+events such as requests and responses, along with data payloads and metadata
+such as headers and client configuration, are logged to the standard error
+stream.
+
+**WARNING:** Client Library Debug Logging includes your data payloads in
+plaintext, which could include sensitive data such as PII for yourself or your
+customers, private keys, or other security data that could be compromising if
+leaked. Always practice good data hygiene with your application logs, and follow
+the principle of least access. Google also recommends that Client Library Debug
+Logging be enabled only temporarily during active debugging, and not used
+permanently in production.
+
+To enable logging, set the environment variable `GOOGLE_SDK_RUBY_LOGGING_GEMS`
+to the value `all`. Alternatively, you can set the value to a comma-delimited
+list of client library gem names. This will select the default logging behavior,
+which writes logs to the standard error stream. On a local workstation, this may
+result in logs appearing on the console. When running on a Google Cloud hosting
+service such as [Google Cloud Run](https://cloud.google.com/run), this generally
+results in logs appearing alongside your application logs in the
+[Google Cloud Logging](https://cloud.google.com/logging/) service.
+
+You can customize logging by modifying the `logger` configuration when
+constructing a client object. For example:
 
 ```ruby
+require "google/cloud/dlp/v2"
 require "logger"
 
-module MyLogger
-  LOGGER = Logger.new $stderr, level: Logger::WARN
-  def logger
-    LOGGER
-  end
-end
-
-# Define a gRPC module-level logger method before grpc/logconfig.rb loads.
-module GRPC
-  extend MyLogger
+client = ::Google::Cloud::Dlp::V2::DlpService::Client.new do |config|
+  config.logger = Logger.new "my-app.log"
 end
 ```
 
-
 ## Google Cloud Samples
 
 To browse ready to use code samples check [Google Cloud Samples](https://cloud.google.com/docs/samples).
 
 ## Supported Ruby Versions
 
-This library is supported on Ruby 2.7+.
+This library is supported on Ruby 3.0+.
 
 Google provides official support for Ruby versions that are actively supported
 by Ruby Core—that is, Ruby versions that are either in normal maintenance or

data/lib/google/cloud/dlp/v2/dlp_service/client.rb

@@ -354,14 +354,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
               )
 
+              @dlp_service_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 = @dlp_service_stub.endpoint
                 config.universe_domain = @dlp_service_stub.universe_domain
+                config.logger = @dlp_service_stub.logger if config.respond_to? :logger=
               end
             end
 
@@ -372,6 +384,15 @@ module Google
             #
             attr_reader :location_client
 
+            ##
+            # The logger used for request/response debug logging.
+            #
+            # @return [Logger]
+            #
+            def logger
+              @dlp_service_stub.logger
+            end
+
             # Service calls
 
             ##
@@ -492,7 +513,6 @@ module Google
 
               @dlp_service_stub.call_rpc :inspect_content, 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)
@@ -612,7 +632,6 @@ module Google
 
               @dlp_service_stub.call_rpc :redact_image, 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)
@@ -752,7 +771,6 @@ module Google
 
               @dlp_service_stub.call_rpc :deidentify_content, 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)
@@ -887,7 +905,6 @@ module Google
 
               @dlp_service_stub.call_rpc :reidentify_content, 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)
@@ -981,7 +998,6 @@ module Google
 
               @dlp_service_stub.call_rpc :list_info_types, 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)
@@ -1099,7 +1115,6 @@ module Google
 
               @dlp_service_stub.call_rpc :create_inspect_template, 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)
@@ -1194,7 +1209,6 @@ module Google
 
               @dlp_service_stub.call_rpc :update_inspect_template, 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)
@@ -1285,7 +1299,6 @@ module Google
 
               @dlp_service_stub.call_rpc :get_inspect_template, 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)
@@ -1420,7 +1433,7 @@ module Google
               @dlp_service_stub.call_rpc :list_inspect_templates, request, options: options do |response, operation|
                 response = ::Gapic::PagedEnumerable.new @dlp_service_stub, :list_inspect_templates, 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)
@@ -1511,7 +1524,6 @@ module Google
 
               @dlp_service_stub.call_rpc :delete_inspect_template, 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)
@@ -1629,7 +1641,6 @@ module Google
 
               @dlp_service_stub.call_rpc :create_deidentify_template, 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)
@@ -1725,7 +1736,6 @@ module Google
 
               @dlp_service_stub.call_rpc :update_deidentify_template, 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)
@@ -1816,7 +1826,6 @@ module Google
 
               @dlp_service_stub.call_rpc :get_deidentify_template, 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)
@@ -1951,7 +1960,7 @@ module Google
               @dlp_service_stub.call_rpc :list_deidentify_templates, request, options: options do |response, operation|
                 response = ::Gapic::PagedEnumerable.new @dlp_service_stub, :list_deidentify_templates, 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)
@@ -2043,7 +2052,6 @@ module Google
 
               @dlp_service_stub.call_rpc :delete_deidentify_template, 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)
@@ -2157,7 +2165,6 @@ module Google
 
               @dlp_service_stub.call_rpc :create_job_trigger, 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)
@@ -2251,7 +2258,6 @@ module Google
 
               @dlp_service_stub.call_rpc :update_job_trigger, 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)
@@ -2342,7 +2348,6 @@ module Google
 
               @dlp_service_stub.call_rpc :hybrid_inspect_job_trigger, 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)
@@ -2432,7 +2437,6 @@ module Google
 
               @dlp_service_stub.call_rpc :get_job_trigger, 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)
@@ -2592,7 +2596,7 @@ module Google
               @dlp_service_stub.call_rpc :list_job_triggers, request, options: options do |response, operation|
                 response = ::Gapic::PagedEnumerable.new @dlp_service_stub, :list_job_triggers, 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)
@@ -2682,7 +2686,6 @@ module Google
 
               @dlp_service_stub.call_rpc :delete_job_trigger, 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)
@@ -2770,7 +2773,6 @@ module Google
 
               @dlp_service_stub.call_rpc :activate_job_trigger, 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)
@@ -2877,7 +2879,6 @@ module Google
 
               @dlp_service_stub.call_rpc :create_discovery_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)
@@ -2968,7 +2969,6 @@ module Google
 
               @dlp_service_stub.call_rpc :update_discovery_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)
@@ -3055,7 +3055,6 @@ module Google
 
               @dlp_service_stub.call_rpc :get_discovery_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)
@@ -3174,7 +3173,7 @@ module Google
               @dlp_service_stub.call_rpc :list_discovery_configs, request, options: options do |response, operation|
                 response = ::Gapic::PagedEnumerable.new @dlp_service_stub, :list_discovery_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)
@@ -3261,7 +3260,6 @@ module Google
 
               @dlp_service_stub.call_rpc :delete_discovery_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)
@@ -3313,9 +3311,13 @@ module Google
             #         parent=projects/example-project/locations/europe-west3
             #   @param inspect_job [::Google::Cloud::Dlp::V2::InspectJobConfig, ::Hash]
             #     An inspection job scans a storage repository for InfoTypes.
+            #
+            #     Note: The following fields are mutually exclusive: `inspect_job`, `risk_job`. If a field in that set is populated, all other fields in the set will automatically be cleared.
             #   @param risk_job [::Google::Cloud::Dlp::V2::RiskAnalysisJobConfig, ::Hash]
             #     A risk analysis job calculates re-identification risk metrics for a
             #     BigQuery table.
+            #
+            #     Note: The following fields are mutually exclusive: `risk_job`, `inspect_job`. If a field in that set is populated, all other fields in the set will automatically be cleared.
             #   @param job_id [::String]
             #     The job id can contain uppercase and lowercase letters,
             #     numbers, and hyphens; that is, it must match the regular
@@ -3383,7 +3385,6 @@ module Google
 
               @dlp_service_stub.call_rpc :create_dlp_job, 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)
@@ -3545,7 +3546,7 @@ module Google
               @dlp_service_stub.call_rpc :list_dlp_jobs, request, options: options do |response, operation|
                 response = ::Gapic::PagedEnumerable.new @dlp_service_stub, :list_dlp_jobs, 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)
@@ -3636,7 +3637,6 @@ module Google
 
               @dlp_service_stub.call_rpc :get_dlp_job, 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)
@@ -3729,7 +3729,6 @@ module Google
 
               @dlp_service_stub.call_rpc :delete_dlp_job, 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)
@@ -3822,7 +3821,6 @@ module Google
 
               @dlp_service_stub.call_rpc :cancel_dlp_job, 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)
@@ -3939,7 +3937,6 @@ module Google
 
               @dlp_service_stub.call_rpc :create_stored_info_type, 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)
@@ -4037,7 +4034,6 @@ module Google
 
               @dlp_service_stub.call_rpc :update_stored_info_type, 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)
@@ -4128,7 +4124,6 @@ module Google
 
               @dlp_service_stub.call_rpc :get_stored_info_type, 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)
@@ -4260,7 +4255,7 @@ module Google
               @dlp_service_stub.call_rpc :list_stored_info_types, request, options: options do |response, operation|
                 response = ::Gapic::PagedEnumerable.new @dlp_service_stub, :list_stored_info_types, 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)
@@ -4351,7 +4346,6 @@ module Google
 
               @dlp_service_stub.call_rpc :delete_stored_info_type, 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)
@@ -4486,7 +4480,7 @@ module Google
               @dlp_service_stub.call_rpc :list_project_data_profiles, request, options: options do |response, operation|
                 response = ::Gapic::PagedEnumerable.new @dlp_service_stub, :list_project_data_profiles, 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)
@@ -4634,7 +4628,7 @@ module Google
               @dlp_service_stub.call_rpc :list_table_data_profiles, request, options: options do |response, operation|
                 response = ::Gapic::PagedEnumerable.new @dlp_service_stub, :list_table_data_profiles, 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)
@@ -4784,7 +4778,7 @@ module Google
               @dlp_service_stub.call_rpc :list_column_data_profiles, request, options: options do |response, operation|
                 response = ::Gapic::PagedEnumerable.new @dlp_service_stub, :list_column_data_profiles, 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)
@@ -4871,7 +4865,6 @@ module Google
 
               @dlp_service_stub.call_rpc :get_project_data_profile, 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)
@@ -5024,7 +5017,7 @@ module Google
               @dlp_service_stub.call_rpc :list_file_store_data_profiles, request, options: options do |response, operation|
                 response = ::Gapic::PagedEnumerable.new @dlp_service_stub, :list_file_store_data_profiles, 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)
@@ -5111,7 +5104,6 @@ module Google
 
               @dlp_service_stub.call_rpc :get_file_store_data_profile, 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)
@@ -5198,7 +5190,6 @@ module Google
 
               @dlp_service_stub.call_rpc :delete_file_store_data_profile, 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)
@@ -5285,7 +5276,6 @@ module Google
 
               @dlp_service_stub.call_rpc :get_table_data_profile, 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)
@@ -5372,7 +5362,6 @@ module Google
 
               @dlp_service_stub.call_rpc :get_column_data_profile, 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)
@@ -5459,7 +5448,6 @@ module Google
 
               @dlp_service_stub.call_rpc :delete_table_data_profile, 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)
@@ -5550,7 +5538,6 @@ module Google
 
               @dlp_service_stub.call_rpc :hybrid_inspect_dlp_job, 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)
@@ -5637,7 +5624,6 @@ module Google
 
               @dlp_service_stub.call_rpc :finish_dlp_job, 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)
@@ -5733,7 +5719,6 @@ module Google
 
               @dlp_service_stub.call_rpc :create_connection, 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)
@@ -5820,7 +5805,6 @@ module Google
 
               @dlp_service_stub.call_rpc :get_connection, 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)
@@ -5921,7 +5905,7 @@ module Google
               @dlp_service_stub.call_rpc :list_connections, request, options: options do |response, operation|
                 response = ::Gapic::PagedEnumerable.new @dlp_service_stub, :list_connections, 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)
@@ -6021,7 +6005,7 @@ module Google
               @dlp_service_stub.call_rpc :search_connections, request, options: options do |response, operation|
                 response = ::Gapic::PagedEnumerable.new @dlp_service_stub, :search_connections, 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)
@@ -6108,7 +6092,6 @@ module Google
 
               @dlp_service_stub.call_rpc :delete_connection, 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)
@@ -6199,7 +6182,6 @@ module Google
 
               @dlp_service_stub.call_rpc :update_connection, 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)
@@ -6249,6 +6231,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
@@ -6288,6 +6277,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
@@ -6312,6 +6306,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