google-cloud-dlp-v2 0.7.2 → 0.8.1

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

@@ -49,13 +49,12 @@ module Google
             # See {::Google::Cloud::Dlp::V2::DlpService::Client::Configuration}
             # for a description of the configuration fields.
             #
-            # ## Example
+            # @example
             #
-            # To modify the configuration for all DlpService clients:
-            #
-            #     ::Google::Cloud::Dlp::V2::DlpService::Client.configure do |config|
-            #       config.timeout = 10.0
-            #     end
+            #   # Modify the configuration for all DlpService clients
+            #   ::Google::Cloud::Dlp::V2::DlpService::Client.configure do |config|
+            #     config.timeout = 10.0
+            #   end
             #
             # @yield [config] Configure the Client client.
             # @yieldparam config [Client::Configuration]
@@ -230,19 +229,15 @@ module Google
             ##
             # Create a new DlpService client object.
             #
-            # ## Examples
-            #
-            # To create a new DlpService client with the default
-            # configuration:
-            #
-            #     client = ::Google::Cloud::Dlp::V2::DlpService::Client.new
+            # @example
             #
-            # To create a new DlpService client with a custom
-            # configuration:
+            #   # Create a client using the default configuration
+            #   client = ::Google::Cloud::Dlp::V2::DlpService::Client.new
             #
-            #     client = ::Google::Cloud::Dlp::V2::DlpService::Client.new do |config|
-            #       config.timeout = 10.0
-            #     end
+            #   # Create a client using a custom configuration
+            #   client = ::Google::Cloud::Dlp::V2::DlpService::Client.new do |config|
+            #     config.timeout = 10.0
+            #   end
             #
             # @yield [config] Configure the DlpService client.
             # @yieldparam config [Client::Configuration]
@@ -262,10 +257,9 @@ module Google
 
               # Create credentials
               credentials = @config.credentials
-              # Use self-signed JWT if the scope and endpoint are unchanged from default,
+              # Use self-signed JWT if the endpoint is unchanged from default,
               # but only if the default endpoint does not have a region prefix.
-              enable_self_signed_jwt = @config.scope == Client.configure.scope &&
-                                       @config.endpoint == Client.configure.endpoint &&
+              enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
                                        !@config.endpoint.split(".").first.include?("-")
               credentials ||= Credentials.default scope: @config.scope,
                                                   enable_self_signed_jwt: enable_self_signed_jwt
@@ -351,6 +345,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/dlp/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Dlp::V2::DlpService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dlp::V2::InspectContentRequest.new
+            #
+            #   # Call the inspect_content method.
+            #   result = client.inspect_content request
+            #
+            #   # The returned object is of type Google::Cloud::Dlp::V2::InspectContentResponse.
+            #   p result
+            #
             def inspect_content request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -368,16 +377,20 @@ module Google
                 gapic_version: ::Google::Cloud::Dlp::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "parent" => request.parent
-              }
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.inspect_content.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.inspect_content.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @dlp_service_stub.call_rpc :inspect_content, request, options: options do |response, operation|
@@ -450,6 +463,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/dlp/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Dlp::V2::DlpService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dlp::V2::RedactImageRequest.new
+            #
+            #   # Call the redact_image method.
+            #   result = client.redact_image request
+            #
+            #   # The returned object is of type Google::Cloud::Dlp::V2::RedactImageResponse.
+            #   p result
+            #
             def redact_image request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -467,16 +495,20 @@ module Google
                 gapic_version: ::Google::Cloud::Dlp::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "parent" => request.parent
-              }
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.redact_image.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.redact_image.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @dlp_service_stub.call_rpc :redact_image, request, options: options do |response, operation|
@@ -562,6 +594,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/dlp/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Dlp::V2::DlpService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dlp::V2::DeidentifyContentRequest.new
+            #
+            #   # Call the deidentify_content method.
+            #   result = client.deidentify_content request
+            #
+            #   # The returned object is of type Google::Cloud::Dlp::V2::DeidentifyContentResponse.
+            #   p result
+            #
             def deidentify_content request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -579,16 +626,20 @@ module Google
                 gapic_version: ::Google::Cloud::Dlp::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "parent" => request.parent
-              }
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.deidentify_content.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.deidentify_content.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @dlp_service_stub.call_rpc :deidentify_content, request, options: options do |response, operation|
@@ -677,6 +728,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/dlp/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Dlp::V2::DlpService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dlp::V2::ReidentifyContentRequest.new
+            #
+            #   # Call the reidentify_content method.
+            #   result = client.reidentify_content request
+            #
+            #   # The returned object is of type Google::Cloud::Dlp::V2::ReidentifyContentResponse.
+            #   p result
+            #
             def reidentify_content request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -694,16 +760,20 @@ module Google
                 gapic_version: ::Google::Cloud::Dlp::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "parent" => request.parent
-              }
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.reidentify_content.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.reidentify_content.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @dlp_service_stub.call_rpc :reidentify_content, request, options: options do |response, operation|
@@ -758,6 +828,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/dlp/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Dlp::V2::DlpService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dlp::V2::ListInfoTypesRequest.new
+            #
+            #   # Call the list_info_types method.
+            #   result = client.list_info_types request
+            #
+            #   # The returned object is of type Google::Cloud::Dlp::V2::ListInfoTypesResponse.
+            #   p result
+            #
             def list_info_types request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -778,7 +863,9 @@ module Google
               options.apply_defaults timeout:      @config.rpcs.list_info_types.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.list_info_types.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @dlp_service_stub.call_rpc :list_info_types, request, options: options do |response, operation|
@@ -848,6 +935,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/dlp/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Dlp::V2::DlpService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dlp::V2::CreateInspectTemplateRequest.new
+            #
+            #   # Call the create_inspect_template method.
+            #   result = client.create_inspect_template request
+            #
+            #   # The returned object is of type Google::Cloud::Dlp::V2::InspectTemplate.
+            #   p result
+            #
             def create_inspect_template request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -865,16 +967,20 @@ module Google
                 gapic_version: ::Google::Cloud::Dlp::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "parent" => request.parent
-              }
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.create_inspect_template.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.create_inspect_template.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @dlp_service_stub.call_rpc :create_inspect_template, request, options: options do |response, operation|
@@ -921,6 +1027,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/dlp/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Dlp::V2::DlpService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dlp::V2::UpdateInspectTemplateRequest.new
+            #
+            #   # Call the update_inspect_template method.
+            #   result = client.update_inspect_template request
+            #
+            #   # The returned object is of type Google::Cloud::Dlp::V2::InspectTemplate.
+            #   p result
+            #
             def update_inspect_template request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -938,16 +1059,20 @@ module Google
                 gapic_version: ::Google::Cloud::Dlp::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.update_inspect_template.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.update_inspect_template.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @dlp_service_stub.call_rpc :update_inspect_template, request, options: options do |response, operation|
@@ -990,6 +1115,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/dlp/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Dlp::V2::DlpService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dlp::V2::GetInspectTemplateRequest.new
+            #
+            #   # Call the get_inspect_template method.
+            #   result = client.get_inspect_template request
+            #
+            #   # The returned object is of type Google::Cloud::Dlp::V2::InspectTemplate.
+            #   p result
+            #
             def get_inspect_template request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1007,16 +1147,20 @@ module Google
                 gapic_version: ::Google::Cloud::Dlp::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.get_inspect_template.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.get_inspect_template.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @dlp_service_stub.call_rpc :get_inspect_template, request, options: options do |response, operation|
@@ -1098,6 +1242,27 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/dlp/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Dlp::V2::DlpService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dlp::V2::ListInspectTemplatesRequest.new
+            #
+            #   # Call the list_inspect_templates method.
+            #   result = client.list_inspect_templates request
+            #
+            #   # The returned object is of type Gapic::PagedEnumerable. You can
+            #   # iterate over all elements by calling #each, and the enumerable
+            #   # will lazily make API calls to fetch subsequent pages. Other
+            #   # methods are also available for managing paging directly.
+            #   result.each do |response|
+            #     # Each element is of type ::Google::Cloud::Dlp::V2::InspectTemplate.
+            #     p response
+            #   end
+            #
             def list_inspect_templates request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1115,16 +1280,20 @@ module Google
                 gapic_version: ::Google::Cloud::Dlp::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "parent" => request.parent
-              }
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.list_inspect_templates.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.list_inspect_templates.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @dlp_service_stub.call_rpc :list_inspect_templates, request, options: options do |response, operation|
@@ -1168,6 +1337,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/dlp/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Dlp::V2::DlpService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dlp::V2::DeleteInspectTemplateRequest.new
+            #
+            #   # Call the delete_inspect_template method.
+            #   result = client.delete_inspect_template request
+            #
+            #   # The returned object is of type Google::Protobuf::Empty.
+            #   p result
+            #
             def delete_inspect_template request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1185,16 +1369,20 @@ module Google
                 gapic_version: ::Google::Cloud::Dlp::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.delete_inspect_template.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.delete_inspect_template.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @dlp_service_stub.call_rpc :delete_inspect_template, request, options: options do |response, operation|
@@ -1265,6 +1453,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/dlp/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Dlp::V2::DlpService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dlp::V2::CreateDeidentifyTemplateRequest.new
+            #
+            #   # Call the create_deidentify_template method.
+            #   result = client.create_deidentify_template request
+            #
+            #   # The returned object is of type Google::Cloud::Dlp::V2::DeidentifyTemplate.
+            #   p result
+            #
             def create_deidentify_template request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1282,16 +1485,20 @@ module Google
                 gapic_version: ::Google::Cloud::Dlp::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "parent" => request.parent
-              }
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.create_deidentify_template.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.create_deidentify_template.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @dlp_service_stub.call_rpc :create_deidentify_template, request, options: options do |response, operation|
@@ -1339,6 +1546,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/dlp/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Dlp::V2::DlpService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dlp::V2::UpdateDeidentifyTemplateRequest.new
+            #
+            #   # Call the update_deidentify_template method.
+            #   result = client.update_deidentify_template request
+            #
+            #   # The returned object is of type Google::Cloud::Dlp::V2::DeidentifyTemplate.
+            #   p result
+            #
             def update_deidentify_template request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1356,16 +1578,20 @@ module Google
                 gapic_version: ::Google::Cloud::Dlp::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.update_deidentify_template.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.update_deidentify_template.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @dlp_service_stub.call_rpc :update_deidentify_template, request, options: options do |response, operation|
@@ -1409,6 +1635,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/dlp/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Dlp::V2::DlpService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dlp::V2::GetDeidentifyTemplateRequest.new
+            #
+            #   # Call the get_deidentify_template method.
+            #   result = client.get_deidentify_template request
+            #
+            #   # The returned object is of type Google::Cloud::Dlp::V2::DeidentifyTemplate.
+            #   p result
+            #
             def get_deidentify_template request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1426,16 +1667,20 @@ module Google
                 gapic_version: ::Google::Cloud::Dlp::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.get_deidentify_template.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.get_deidentify_template.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @dlp_service_stub.call_rpc :get_deidentify_template, request, options: options do |response, operation|
@@ -1518,6 +1763,27 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/dlp/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Dlp::V2::DlpService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dlp::V2::ListDeidentifyTemplatesRequest.new
+            #
+            #   # Call the list_deidentify_templates method.
+            #   result = client.list_deidentify_templates request
+            #
+            #   # The returned object is of type Gapic::PagedEnumerable. You can
+            #   # iterate over all elements by calling #each, and the enumerable
+            #   # will lazily make API calls to fetch subsequent pages. Other
+            #   # methods are also available for managing paging directly.
+            #   result.each do |response|
+            #     # Each element is of type ::Google::Cloud::Dlp::V2::DeidentifyTemplate.
+            #     p response
+            #   end
+            #
             def list_deidentify_templates request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1535,16 +1801,20 @@ module Google
                 gapic_version: ::Google::Cloud::Dlp::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "parent" => request.parent
-              }
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.list_deidentify_templates.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.list_deidentify_templates.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @dlp_service_stub.call_rpc :list_deidentify_templates, request, options: options do |response, operation|
@@ -1589,6 +1859,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/dlp/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Dlp::V2::DlpService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dlp::V2::DeleteDeidentifyTemplateRequest.new
+            #
+            #   # Call the delete_deidentify_template method.
+            #   result = client.delete_deidentify_template request
+            #
+            #   # The returned object is of type Google::Protobuf::Empty.
+            #   p result
+            #
             def delete_deidentify_template request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1606,16 +1891,20 @@ module Google
                 gapic_version: ::Google::Cloud::Dlp::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.delete_deidentify_template.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.delete_deidentify_template.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @dlp_service_stub.call_rpc :delete_deidentify_template, request, options: options do |response, operation|
@@ -1681,6 +1970,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/dlp/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Dlp::V2::DlpService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dlp::V2::CreateJobTriggerRequest.new
+            #
+            #   # Call the create_job_trigger method.
+            #   result = client.create_job_trigger request
+            #
+            #   # The returned object is of type Google::Cloud::Dlp::V2::JobTrigger.
+            #   p result
+            #
             def create_job_trigger request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1698,16 +2002,20 @@ module Google
                 gapic_version: ::Google::Cloud::Dlp::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "parent" => request.parent
-              }
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.create_job_trigger.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.create_job_trigger.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @dlp_service_stub.call_rpc :create_job_trigger, request, options: options do |response, operation|
@@ -1753,6 +2061,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/dlp/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Dlp::V2::DlpService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dlp::V2::UpdateJobTriggerRequest.new
+            #
+            #   # Call the update_job_trigger method.
+            #   result = client.update_job_trigger request
+            #
+            #   # The returned object is of type Google::Cloud::Dlp::V2::JobTrigger.
+            #   p result
+            #
             def update_job_trigger request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1770,16 +2093,20 @@ module Google
                 gapic_version: ::Google::Cloud::Dlp::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.update_job_trigger.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.update_job_trigger.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @dlp_service_stub.call_rpc :update_job_trigger, request, options: options do |response, operation|
@@ -1794,9 +2121,6 @@ module Google
             # Inspect hybrid content and store findings to a trigger. The inspection
             # will be processed asynchronously. To review the findings monitor the
             # jobs within the trigger.
-            # Early access feature is in a pre-release state and might change or have
-            # limited support. For more information, see
-            # https://cloud.google.com/products#product-launch-stages.
             #
             # @overload hybrid_inspect_job_trigger(request, options = nil)
             #   Pass arguments to `hybrid_inspect_job_trigger` via a request object, either of type
@@ -1827,6 +2151,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/dlp/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Dlp::V2::DlpService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dlp::V2::HybridInspectJobTriggerRequest.new
+            #
+            #   # Call the hybrid_inspect_job_trigger method.
+            #   result = client.hybrid_inspect_job_trigger request
+            #
+            #   # The returned object is of type Google::Cloud::Dlp::V2::HybridInspectResponse.
+            #   p result
+            #
             def hybrid_inspect_job_trigger request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1844,16 +2183,20 @@ module Google
                 gapic_version: ::Google::Cloud::Dlp::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.hybrid_inspect_job_trigger.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.hybrid_inspect_job_trigger.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @dlp_service_stub.call_rpc :hybrid_inspect_job_trigger, request, options: options do |response, operation|
@@ -1895,6 +2238,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/dlp/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Dlp::V2::DlpService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dlp::V2::GetJobTriggerRequest.new
+            #
+            #   # Call the get_job_trigger method.
+            #   result = client.get_job_trigger request
+            #
+            #   # The returned object is of type Google::Cloud::Dlp::V2::JobTrigger.
+            #   p result
+            #
             def get_job_trigger request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1912,16 +2270,20 @@ module Google
                 gapic_version: ::Google::Cloud::Dlp::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.get_job_trigger.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.get_job_trigger.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @dlp_service_stub.call_rpc :get_job_trigger, request, options: options do |response, operation|
@@ -1946,7 +2308,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload list_job_triggers(parent: nil, page_token: nil, page_size: nil, order_by: nil, filter: nil, location_id: nil)
+            # @overload list_job_triggers(parent: nil, page_token: nil, page_size: nil, order_by: nil, filter: nil, type: nil, location_id: nil)
             #   Pass arguments to `list_job_triggers` via keyword arguments. Note that at
             #   least one keyword argument is required. To specify no parameters, or to keep all
             #   the default parameter values, pass an empty Hash as a request object (see above).
@@ -1999,7 +2361,7 @@ module Google
             #     * Restrictions can be combined by `AND` or `OR` logical operators. A
             #     sequence of restrictions implicitly uses `AND`.
             #     * A restriction has the form of `{field} {operator} {value}`.
-            #     * Supported fields/values for inspect jobs:
+            #     * Supported fields/values for inspect triggers:
             #         - `status` - HEALTHY|PAUSED|CANCELLED
             #         - `inspected_storage` - DATASTORE|CLOUD_STORAGE|BIGQUERY
             #         - 'last_run_time` - RFC 3339 formatted timestamp, surrounded by
@@ -2015,6 +2377,8 @@ module Google
             #     * last_run_time > \"2017-12-12T00:00:00+00:00\"
             #
             #     The length of this field should be no more than 500 characters.
+            #   @param type [::Google::Cloud::Dlp::V2::DlpJobType]
+            #     The type of jobs. Will use `DlpJobType.INSPECT` if not set.
             #   @param location_id [::String]
             #     Deprecated. This field has no effect.
             #
@@ -2026,6 +2390,27 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/dlp/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Dlp::V2::DlpService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dlp::V2::ListJobTriggersRequest.new
+            #
+            #   # Call the list_job_triggers method.
+            #   result = client.list_job_triggers request
+            #
+            #   # The returned object is of type Gapic::PagedEnumerable. You can
+            #   # iterate over all elements by calling #each, and the enumerable
+            #   # will lazily make API calls to fetch subsequent pages. Other
+            #   # methods are also available for managing paging directly.
+            #   result.each do |response|
+            #     # Each element is of type ::Google::Cloud::Dlp::V2::JobTrigger.
+            #     p response
+            #   end
+            #
             def list_job_triggers request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2043,16 +2428,20 @@ module Google
                 gapic_version: ::Google::Cloud::Dlp::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "parent" => request.parent
-              }
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.list_job_triggers.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.list_job_triggers.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @dlp_service_stub.call_rpc :list_job_triggers, request, options: options do |response, operation|
@@ -2095,6 +2484,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/dlp/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Dlp::V2::DlpService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dlp::V2::DeleteJobTriggerRequest.new
+            #
+            #   # Call the delete_job_trigger method.
+            #   result = client.delete_job_trigger request
+            #
+            #   # The returned object is of type Google::Protobuf::Empty.
+            #   p result
+            #
             def delete_job_trigger request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2112,16 +2516,20 @@ module Google
                 gapic_version: ::Google::Cloud::Dlp::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.delete_job_trigger.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.delete_job_trigger.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @dlp_service_stub.call_rpc :delete_job_trigger, request, options: options do |response, operation|
@@ -2163,6 +2571,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/dlp/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Dlp::V2::DlpService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dlp::V2::ActivateJobTriggerRequest.new
+            #
+            #   # Call the activate_job_trigger method.
+            #   result = client.activate_job_trigger request
+            #
+            #   # The returned object is of type Google::Cloud::Dlp::V2::DlpJob.
+            #   p result
+            #
             def activate_job_trigger request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2180,16 +2603,20 @@ module Google
                 gapic_version: ::Google::Cloud::Dlp::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.activate_job_trigger.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.activate_job_trigger.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @dlp_service_stub.call_rpc :activate_job_trigger, request, options: options do |response, operation|
@@ -2242,9 +2669,10 @@ module Google
             #
             #         parent=projects/example-project/locations/europe-west3
             #   @param inspect_job [::Google::Cloud::Dlp::V2::InspectJobConfig, ::Hash]
-            #     Set to control what and how to inspect.
+            #     An inspection job scans a storage repository for InfoTypes.
             #   @param risk_job [::Google::Cloud::Dlp::V2::RiskAnalysisJobConfig, ::Hash]
-            #     Set to choose what metric to calculate.
+            #     A risk analysis job calculates re-identification risk metrics for a
+            #     BigQuery table.
             #   @param job_id [::String]
             #     The job id can contain uppercase and lowercase letters,
             #     numbers, and hyphens; that is, it must match the regular
@@ -2261,6 +2689,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/dlp/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Dlp::V2::DlpService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dlp::V2::CreateDlpJobRequest.new
+            #
+            #   # Call the create_dlp_job method.
+            #   result = client.create_dlp_job request
+            #
+            #   # The returned object is of type Google::Cloud::Dlp::V2::DlpJob.
+            #   p result
+            #
             def create_dlp_job request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2278,16 +2721,20 @@ module Google
                 gapic_version: ::Google::Cloud::Dlp::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "parent" => request.parent
-              }
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.create_dlp_job.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.create_dlp_job.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @dlp_service_stub.call_rpc :create_dlp_job, request, options: options do |response, operation|
@@ -2395,6 +2842,27 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/dlp/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Dlp::V2::DlpService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dlp::V2::ListDlpJobsRequest.new
+            #
+            #   # Call the list_dlp_jobs method.
+            #   result = client.list_dlp_jobs request
+            #
+            #   # The returned object is of type Gapic::PagedEnumerable. You can
+            #   # iterate over all elements by calling #each, and the enumerable
+            #   # will lazily make API calls to fetch subsequent pages. Other
+            #   # methods are also available for managing paging directly.
+            #   result.each do |response|
+            #     # Each element is of type ::Google::Cloud::Dlp::V2::DlpJob.
+            #     p response
+            #   end
+            #
             def list_dlp_jobs request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2412,16 +2880,20 @@ module Google
                 gapic_version: ::Google::Cloud::Dlp::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "parent" => request.parent
-              }
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.list_dlp_jobs.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.list_dlp_jobs.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @dlp_service_stub.call_rpc :list_dlp_jobs, request, options: options do |response, operation|
@@ -2464,6 +2936,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/dlp/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Dlp::V2::DlpService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dlp::V2::GetDlpJobRequest.new
+            #
+            #   # Call the get_dlp_job method.
+            #   result = client.get_dlp_job request
+            #
+            #   # The returned object is of type Google::Cloud::Dlp::V2::DlpJob.
+            #   p result
+            #
             def get_dlp_job request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2481,16 +2968,20 @@ module Google
                 gapic_version: ::Google::Cloud::Dlp::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.get_dlp_job.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.get_dlp_job.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @dlp_service_stub.call_rpc :get_dlp_job, request, options: options do |response, operation|
@@ -2534,6 +3025,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/dlp/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Dlp::V2::DlpService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dlp::V2::DeleteDlpJobRequest.new
+            #
+            #   # Call the delete_dlp_job method.
+            #   result = client.delete_dlp_job request
+            #
+            #   # The returned object is of type Google::Protobuf::Empty.
+            #   p result
+            #
             def delete_dlp_job request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2551,16 +3057,20 @@ module Google
                 gapic_version: ::Google::Cloud::Dlp::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.delete_dlp_job.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.delete_dlp_job.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @dlp_service_stub.call_rpc :delete_dlp_job, request, options: options do |response, operation|
@@ -2604,6 +3114,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/dlp/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Dlp::V2::DlpService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dlp::V2::CancelDlpJobRequest.new
+            #
+            #   # Call the cancel_dlp_job method.
+            #   result = client.cancel_dlp_job request
+            #
+            #   # The returned object is of type Google::Protobuf::Empty.
+            #   p result
+            #
             def cancel_dlp_job request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2621,16 +3146,20 @@ module Google
                 gapic_version: ::Google::Cloud::Dlp::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.cancel_dlp_job.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.cancel_dlp_job.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @dlp_service_stub.call_rpc :cancel_dlp_job, request, options: options do |response, operation|
@@ -2700,6 +3229,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/dlp/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Dlp::V2::DlpService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dlp::V2::CreateStoredInfoTypeRequest.new
+            #
+            #   # Call the create_stored_info_type method.
+            #   result = client.create_stored_info_type request
+            #
+            #   # The returned object is of type Google::Cloud::Dlp::V2::StoredInfoType.
+            #   p result
+            #
             def create_stored_info_type request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2717,16 +3261,20 @@ module Google
                 gapic_version: ::Google::Cloud::Dlp::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "parent" => request.parent
-              }
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.create_stored_info_type.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.create_stored_info_type.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @dlp_service_stub.call_rpc :create_stored_info_type, request, options: options do |response, operation|
@@ -2777,6 +3325,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/dlp/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Dlp::V2::DlpService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dlp::V2::UpdateStoredInfoTypeRequest.new
+            #
+            #   # Call the update_stored_info_type method.
+            #   result = client.update_stored_info_type request
+            #
+            #   # The returned object is of type Google::Cloud::Dlp::V2::StoredInfoType.
+            #   p result
+            #
             def update_stored_info_type request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2794,16 +3357,20 @@ module Google
                 gapic_version: ::Google::Cloud::Dlp::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.update_stored_info_type.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.update_stored_info_type.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @dlp_service_stub.call_rpc :update_stored_info_type, request, options: options do |response, operation|
@@ -2847,6 +3414,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/dlp/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Dlp::V2::DlpService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dlp::V2::GetStoredInfoTypeRequest.new
+            #
+            #   # Call the get_stored_info_type method.
+            #   result = client.get_stored_info_type request
+            #
+            #   # The returned object is of type Google::Cloud::Dlp::V2::StoredInfoType.
+            #   p result
+            #
             def get_stored_info_type request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2864,16 +3446,20 @@ module Google
                 gapic_version: ::Google::Cloud::Dlp::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.get_stored_info_type.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.get_stored_info_type.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @dlp_service_stub.call_rpc :get_stored_info_type, request, options: options do |response, operation|
@@ -2957,6 +3543,27 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/dlp/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Dlp::V2::DlpService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dlp::V2::ListStoredInfoTypesRequest.new
+            #
+            #   # Call the list_stored_info_types method.
+            #   result = client.list_stored_info_types request
+            #
+            #   # The returned object is of type Gapic::PagedEnumerable. You can
+            #   # iterate over all elements by calling #each, and the enumerable
+            #   # will lazily make API calls to fetch subsequent pages. Other
+            #   # methods are also available for managing paging directly.
+            #   result.each do |response|
+            #     # Each element is of type ::Google::Cloud::Dlp::V2::StoredInfoType.
+            #     p response
+            #   end
+            #
             def list_stored_info_types request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2974,16 +3581,20 @@ module Google
                 gapic_version: ::Google::Cloud::Dlp::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "parent" => request.parent
-              }
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.list_stored_info_types.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.list_stored_info_types.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @dlp_service_stub.call_rpc :list_stored_info_types, request, options: options do |response, operation|
@@ -3028,6 +3639,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/dlp/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Dlp::V2::DlpService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dlp::V2::DeleteStoredInfoTypeRequest.new
+            #
+            #   # Call the delete_stored_info_type method.
+            #   result = client.delete_stored_info_type request
+            #
+            #   # The returned object is of type Google::Protobuf::Empty.
+            #   p result
+            #
             def delete_stored_info_type request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -3045,16 +3671,20 @@ module Google
                 gapic_version: ::Google::Cloud::Dlp::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.delete_stored_info_type.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.delete_stored_info_type.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @dlp_service_stub.call_rpc :delete_stored_info_type, request, options: options do |response, operation|
@@ -3067,11 +3697,8 @@ module Google
 
             ##
             # Inspect hybrid content and store findings to a job.
-            # To review the findings inspect the job. Inspection will occur
+            # To review the findings, inspect the job. Inspection will occur
             # asynchronously.
-            # Early access feature is in a pre-release state and might change or have
-            # limited support. For more information, see
-            # https://cloud.google.com/products#product-launch-stages.
             #
             # @overload hybrid_inspect_dlp_job(request, options = nil)
             #   Pass arguments to `hybrid_inspect_dlp_job` via a request object, either of type
@@ -3102,6 +3729,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/dlp/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Dlp::V2::DlpService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dlp::V2::HybridInspectDlpJobRequest.new
+            #
+            #   # Call the hybrid_inspect_dlp_job method.
+            #   result = client.hybrid_inspect_dlp_job request
+            #
+            #   # The returned object is of type Google::Cloud::Dlp::V2::HybridInspectResponse.
+            #   p result
+            #
             def hybrid_inspect_dlp_job request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -3119,16 +3761,20 @@ module Google
                 gapic_version: ::Google::Cloud::Dlp::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.hybrid_inspect_dlp_job.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.hybrid_inspect_dlp_job.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @dlp_service_stub.call_rpc :hybrid_inspect_dlp_job, request, options: options do |response, operation|
@@ -3142,9 +3788,6 @@ module Google
             ##
             # Finish a running hybrid DlpJob. Triggers the finalization steps and running
             # of any enabled actions that have not yet run.
-            # Early access feature is in a pre-release state and might change or have
-            # limited support. For more information, see
-            # https://cloud.google.com/products#product-launch-stages.
             #
             # @overload finish_dlp_job(request, options = nil)
             #   Pass arguments to `finish_dlp_job` via a request object, either of type
@@ -3172,6 +3815,21 @@ module Google
             #
             # @raise [::Google::Cloud::Error] if the RPC is aborted.
             #
+            # @example Basic example
+            #   require "google/cloud/dlp/v2"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::Dlp::V2::DlpService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::Dlp::V2::FinishDlpJobRequest.new
+            #
+            #   # Call the finish_dlp_job method.
+            #   result = client.finish_dlp_job request
+            #
+            #   # The returned object is of type Google::Protobuf::Empty.
+            #   p result
+            #
             def finish_dlp_job request, options = nil
               raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -3189,16 +3847,20 @@ module Google
                 gapic_version: ::Google::Cloud::Dlp::V2::VERSION
               metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
 
-              header_params = {
-                "name" => request.name
-              }
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
               request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
               metadata[:"x-goog-request-params"] ||= request_params_header
 
               options.apply_defaults timeout:      @config.rpcs.finish_dlp_job.timeout,
                                      metadata:     metadata,
                                      retry_policy: @config.rpcs.finish_dlp_job.retry_policy
-              options.apply_defaults metadata:     @config.metadata,
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
                                      retry_policy: @config.retry_policy
 
               @dlp_service_stub.call_rpc :finish_dlp_job, request, options: options do |response, operation|
@@ -3222,22 +3884,21 @@ module Google
             # Configuration can be applied globally to all clients, or to a single client
             # on construction.
             #
-            # # Examples
-            #
-            # To modify the global config, setting the timeout for inspect_content
-            # to 20 seconds, and all remaining timeouts to 10 seconds:
-            #
-            #     ::Google::Cloud::Dlp::V2::DlpService::Client.configure do |config|
-            #       config.timeout = 10.0
-            #       config.rpcs.inspect_content.timeout = 20.0
-            #     end
-            #
-            # To apply the above configuration only to a new client:
-            #
-            #     client = ::Google::Cloud::Dlp::V2::DlpService::Client.new do |config|
-            #       config.timeout = 10.0
-            #       config.rpcs.inspect_content.timeout = 20.0
-            #     end
+            # @example
+            #
+            #   # Modify the global config, setting the timeout for
+            #   # inspect_content to 20 seconds,
+            #   # and all remaining timeouts to 10 seconds.
+            #   ::Google::Cloud::Dlp::V2::DlpService::Client.configure do |config|
+            #     config.timeout = 10.0
+            #     config.rpcs.inspect_content.timeout = 20.0
+            #   end
+            #
+            #   # Apply the above configuration only to a new client.
+            #   client = ::Google::Cloud::Dlp::V2::DlpService::Client.new do |config|
+            #     config.timeout = 10.0
+            #     config.rpcs.inspect_content.timeout = 20.0
+            #   end
             #
             # @!attribute [rw] endpoint
             #   The hostname or hostname:port of the service endpoint.