google-cloud-dlp-v2 0.3.2 → 0.4.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2db8c83f4bf98f27140c3a66ef2171c510f7b45aae0b2c83e2885a8824447689
-  data.tar.gz: 6a59daa8d3b6408a243e41dedf7cab3cd4b8dbdd76bc7e965f927afe3e743d55
+  metadata.gz: c442dfa4c79234288f3a3a5dea9eedeb9c2ae129a0cf0f38b9e32091a234e66b
+  data.tar.gz: 48a3361f8b5ee95b6818261c11490c85b21e602ce4a3956861aa893121df5be5
 SHA512:
-  metadata.gz: 59ac111e738f1fde9c0f2555de4abd98c645edb1b7a7d8872634a6307552e1e068e8e3a168d324718783ab4685ff49284663ac008fbb875b426292dc577694c9
-  data.tar.gz: 7d097245d8cb2219709e8ef0599479468617c3b624d5fd791fd3d775d0a79a624bc63c71c77ef710b940b7aa4c971ab6fd479e8087c5058994267a41679fef5f
+  metadata.gz: 5c9eecb41e377b9b6740ec13a22b5c671594e050aeaf12c9ded0532191d9e47885e76492ca40b28db437898b5a2b0e94a8987d61d526fbe819c70ae92be40e51
+  data.tar.gz: f61f24f342f8bb89be2497716b46fbfb6cd385b197c1eb47b3218d29ecf0f8e838e8123921d911c93e031ee75454b6e4492d767455ed8e94b9a2d392276c329f

data/README.md

@@ -18,6 +18,7 @@ In order to use this library, you first need to go through the following steps:
 
 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
 1. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
+1. [Enable the API.](https://console.cloud.google.com/apis/library/dlp.googleapis.com)
 1. {file:AUTHENTICATION.md Set up authentication.}
 
 ## Quick Start
@@ -33,6 +34,9 @@ response = client.inspect_content request
 View the [Client Library Documentation](https://googleapis.dev/ruby/google-cloud-dlp-v2/latest)
 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.

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

@@ -78,7 +78,7 @@ module Google
                   initial_delay: 0.1,
                   max_delay:     60.0,
                   multiplier:    1.3,
-                  retry_codes:   ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
+                  retry_codes:   [14, 4]
                 }
 
                 default_config.rpcs.redact_image.timeout = 300.0
@@ -86,7 +86,7 @@ module Google
                   initial_delay: 0.1,
                   max_delay:     60.0,
                   multiplier:    1.3,
-                  retry_codes:   ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
+                  retry_codes:   [14, 4]
                 }
 
                 default_config.rpcs.deidentify_content.timeout = 300.0
@@ -94,7 +94,7 @@ module Google
                   initial_delay: 0.1,
                   max_delay:     60.0,
                   multiplier:    1.3,
-                  retry_codes:   ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
+                  retry_codes:   [14, 4]
                 }
 
                 default_config.rpcs.reidentify_content.timeout = 300.0
@@ -102,7 +102,7 @@ module Google
                   initial_delay: 0.1,
                   max_delay:     60.0,
                   multiplier:    1.3,
-                  retry_codes:   ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
+                  retry_codes:   [14, 4]
                 }
 
                 default_config.rpcs.list_info_types.timeout = 300.0
@@ -110,7 +110,7 @@ module Google
                   initial_delay: 0.1,
                   max_delay:     60.0,
                   multiplier:    1.3,
-                  retry_codes:   ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
+                  retry_codes:   [14, 4]
                 }
 
                 default_config.rpcs.create_inspect_template.timeout = 300.0
@@ -122,7 +122,7 @@ module Google
                   initial_delay: 0.1,
                   max_delay:     60.0,
                   multiplier:    1.3,
-                  retry_codes:   ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
+                  retry_codes:   [14, 4]
                 }
 
                 default_config.rpcs.list_inspect_templates.timeout = 300.0
@@ -130,7 +130,7 @@ module Google
                   initial_delay: 0.1,
                   max_delay:     60.0,
                   multiplier:    1.3,
-                  retry_codes:   ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
+                  retry_codes:   [14, 4]
                 }
 
                 default_config.rpcs.delete_inspect_template.timeout = 300.0
@@ -138,7 +138,7 @@ module Google
                   initial_delay: 0.1,
                   max_delay:     60.0,
                   multiplier:    1.3,
-                  retry_codes:   ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
+                  retry_codes:   [14, 4]
                 }
 
                 default_config.rpcs.create_deidentify_template.timeout = 300.0
@@ -150,7 +150,7 @@ module Google
                   initial_delay: 0.1,
                   max_delay:     60.0,
                   multiplier:    1.3,
-                  retry_codes:   ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
+                  retry_codes:   [14, 4]
                 }
 
                 default_config.rpcs.list_deidentify_templates.timeout = 300.0
@@ -158,7 +158,7 @@ module Google
                   initial_delay: 0.1,
                   max_delay:     60.0,
                   multiplier:    1.3,
-                  retry_codes:   ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
+                  retry_codes:   [14, 4]
                 }
 
                 default_config.rpcs.delete_deidentify_template.timeout = 300.0
@@ -166,7 +166,7 @@ module Google
                   initial_delay: 0.1,
                   max_delay:     60.0,
                   multiplier:    1.3,
-                  retry_codes:   ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
+                  retry_codes:   [14, 4]
                 }
 
                 default_config.rpcs.create_job_trigger.timeout = 300.0
@@ -174,19 +174,13 @@ module Google
                 default_config.rpcs.update_job_trigger.timeout = 300.0
 
                 default_config.rpcs.hybrid_inspect_job_trigger.timeout = 300.0
-                default_config.rpcs.hybrid_inspect_job_trigger.retry_policy = {
-                  initial_delay: 0.1,
-                  max_delay:     60.0,
-                  multiplier:    1.3,
-                  retry_codes:   ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
-                }
 
                 default_config.rpcs.get_job_trigger.timeout = 300.0
                 default_config.rpcs.get_job_trigger.retry_policy = {
                   initial_delay: 0.1,
                   max_delay:     60.0,
                   multiplier:    1.3,
-                  retry_codes:   ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
+                  retry_codes:   [14, 4]
                 }
 
                 default_config.rpcs.list_job_triggers.timeout = 300.0
@@ -194,7 +188,7 @@ module Google
                   initial_delay: 0.1,
                   max_delay:     60.0,
                   multiplier:    1.3,
-                  retry_codes:   ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
+                  retry_codes:   [14, 4]
                 }
 
                 default_config.rpcs.delete_job_trigger.timeout = 300.0
@@ -202,7 +196,7 @@ module Google
                   initial_delay: 0.1,
                   max_delay:     60.0,
                   multiplier:    1.3,
-                  retry_codes:   ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
+                  retry_codes:   [14, 4]
                 }
 
                 default_config.rpcs.activate_job_trigger.timeout = 300.0
@@ -214,7 +208,7 @@ module Google
                   initial_delay: 0.1,
                   max_delay:     60.0,
                   multiplier:    1.3,
-                  retry_codes:   ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
+                  retry_codes:   [14, 4]
                 }
 
                 default_config.rpcs.get_dlp_job.timeout = 300.0
@@ -222,7 +216,7 @@ module Google
                   initial_delay: 0.1,
                   max_delay:     60.0,
                   multiplier:    1.3,
-                  retry_codes:   ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
+                  retry_codes:   [14, 4]
                 }
 
                 default_config.rpcs.delete_dlp_job.timeout = 300.0
@@ -230,7 +224,7 @@ module Google
                   initial_delay: 0.1,
                   max_delay:     60.0,
                   multiplier:    1.3,
-                  retry_codes:   ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
+                  retry_codes:   [14, 4]
                 }
 
                 default_config.rpcs.cancel_dlp_job.timeout = 300.0
@@ -244,7 +238,7 @@ module Google
                   initial_delay: 0.1,
                   max_delay:     60.0,
                   multiplier:    1.3,
-                  retry_codes:   ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
+                  retry_codes:   [14, 4]
                 }
 
                 default_config.rpcs.list_stored_info_types.timeout = 300.0
@@ -252,7 +246,7 @@ module Google
                   initial_delay: 0.1,
                   max_delay:     60.0,
                   multiplier:    1.3,
-                  retry_codes:   ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
+                  retry_codes:   [14, 4]
                 }
 
                 default_config.rpcs.delete_stored_info_type.timeout = 300.0
@@ -260,24 +254,12 @@ module Google
                   initial_delay: 0.1,
                   max_delay:     60.0,
                   multiplier:    1.3,
-                  retry_codes:   ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
+                  retry_codes:   [14, 4]
                 }
 
                 default_config.rpcs.hybrid_inspect_dlp_job.timeout = 300.0
-                default_config.rpcs.hybrid_inspect_dlp_job.retry_policy = {
-                  initial_delay: 0.1,
-                  max_delay:     60.0,
-                  multiplier:    1.3,
-                  retry_codes:   ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
-                }
 
                 default_config.rpcs.finish_dlp_job.timeout = 300.0
-                default_config.rpcs.finish_dlp_job.retry_policy = {
-                  initial_delay: 0.1,
-                  max_delay:     60.0,
-                  multiplier:    1.3,
-                  retry_codes:   ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
-                }
 
                 default_config
               end
@@ -385,8 +367,21 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     The parent resource name, for example projects/my-project-id
-            #     or projects/my-project-id/locations/\\{location_id}
+            #     Parent resource name.
+            #
+            #     The format of this value varies depending on whether you have [specified a
+            #     processing location](/dlp/docs/specifying-location):
+            #
+            #     + Projects scope, location specified:<br/>
+            #       `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
+            #     + Projects scope, no location specified (defaults to global):<br/>
+            #       `projects/`<var>PROJECT_ID</var>
+            #
+            #     The following example `parent` string specifies a parent project with the
+            #     identifier `example-project`, and specifies the `europe-west3` location
+            #     for processing data:
+            #
+            #         parent=projects/example-project/locations/europe-west3
             #   @param inspect_config [::Google::Cloud::Dlp::V2::InspectConfig, ::Hash]
             #     Configuration for the inspector. What specified here will override
             #     the template referenced by the inspect_template_name argument.
@@ -472,8 +467,21 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     The parent resource name, for example projects/my-project-id
-            #     or projects/my-project-id/locations/\\{location_id}.
+            #     Parent resource name.
+            #
+            #     The format of this value varies depending on whether you have [specified a
+            #     processing location](/dlp/docs/specifying-location):
+            #
+            #     + Projects scope, location specified:<br/>
+            #       `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
+            #     + Projects scope, no location specified (defaults to global):<br/>
+            #       `projects/`<var>PROJECT_ID</var>
+            #
+            #     The following example `parent` string specifies a parent project with the
+            #     identifier `example-project`, and specifies the `europe-west3` location
+            #     for processing data:
+            #
+            #         parent=projects/example-project/locations/europe-west3
             #   @param location_id [::String]
             #     Deprecated. This field has no effect.
             #   @param inspect_config [::Google::Cloud::Dlp::V2::InspectConfig, ::Hash]
@@ -557,8 +565,21 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     The parent resource name, for example projects/my-project-id
-            #     or projects/my-project-id/locations/\\{location_id}.
+            #     Parent resource name.
+            #
+            #     The format of this value varies depending on whether you have [specified a
+            #     processing location](/dlp/docs/specifying-location):
+            #
+            #     + Projects scope, location specified:<br/>
+            #       `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
+            #     + Projects scope, no location specified (defaults to global):<br/>
+            #       `projects/`<var>PROJECT_ID</var>
+            #
+            #     The following example `parent` string specifies a parent project with the
+            #     identifier `example-project`, and specifies the `europe-west3` location
+            #     for processing data:
+            #
+            #         parent=projects/example-project/locations/europe-west3
             #   @param deidentify_config [::Google::Cloud::Dlp::V2::DeidentifyConfig, ::Hash]
             #     Configuration for the de-identification of the content item.
             #     Items specified here will override the template referenced by the
@@ -651,7 +672,21 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The parent resource name.
+            #     Required. Parent resource name.
+            #
+            #     The format of this value varies depending on whether you have [specified a
+            #     processing location](/dlp/docs/specifying-location):
+            #
+            #     + Projects scope, location specified:<br/>
+            #       `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
+            #     + Projects scope, no location specified (defaults to global):<br/>
+            #       `projects/`<var>PROJECT_ID</var>
+            #
+            #     The following example `parent` string specifies a parent project with the
+            #     identifier `example-project`, and specifies the `europe-west3` location
+            #     for processing data:
+            #
+            #         parent=projects/example-project/locations/europe-west3
             #   @param reidentify_config [::Google::Cloud::Dlp::V2::DeidentifyConfig, ::Hash]
             #     Configuration for the re-identification of the content item.
             #     This field shares the same proto message type that is used for
@@ -676,10 +711,11 @@ module Google
             #   @param reidentify_template_name [::String]
             #     Template to use. References an instance of `DeidentifyTemplate`.
             #     Any configuration directly specified in `reidentify_config` or
-            #     `inspect_config` will override those set in the template. Singular fields
-            #     that are set in this request will replace their corresponding fields in the
-            #     template. Repeated fields are appended. Singular sub-messages and groups
-            #     are recursively merged.
+            #     `inspect_config` will override those set in the template. The
+            #     `DeidentifyTemplate` used must include only reversible transformations.
+            #     Singular fields that are set in this request will replace their
+            #     corresponding fields in the template. Repeated fields are appended.
+            #     Singular sub-messages and groups are recursively merged.
             #   @param location_id [::String]
             #     Deprecated. This field has no effect.
             #
@@ -749,7 +785,11 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     The parent resource name, for example locations/\\{location_id}
+            #     The parent resource name.
+            #
+            #     The format of this value is as follows:
+            #
+            #         locations/<var>LOCATION_ID</var>
             #   @param language_code [::String]
             #     BCP-47 language code for localized infoType friendly
             #     names. If omitted, or if localized strings are not available,
@@ -820,8 +860,26 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The parent resource name, for example projects/my-project-id or
-            #     organizations/my-org-id or projects/my-project-id/locations/\\{location-id}.
+            #     Required. Parent resource name.
+            #
+            #     The format of this value varies depending on the scope of the request
+            #     (project or organization) and whether you have [specified a processing
+            #     location](/dlp/docs/specifying-location):
+            #
+            #     + Projects scope, location specified:<br/>
+            #       `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
+            #     + Projects scope, no location specified (defaults to global):<br/>
+            #       `projects/`<var>PROJECT_ID</var>
+            #     + Organizations scope, location specified:<br/>
+            #       `organizations/`<var>ORG_ID</var>`/locations/`<var>LOCATION_ID</var>
+            #     + Organizations scope, no location specified (defaults to global):<br/>
+            #       `organizations/`<var>ORG_ID</var>
+            #
+            #     The following example `parent` string specifies a parent project with the
+            #     identifier `example-project`, and specifies the `europe-west3` location
+            #     for processing data:
+            #
+            #         parent=projects/example-project/locations/europe-west3
             #   @param inspect_template [::Google::Cloud::Dlp::V2::InspectTemplate, ::Hash]
             #     Required. The InspectTemplate to create.
             #   @param template_id [::String]
@@ -897,8 +955,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. Resource name of organization and inspectTemplate to be updated,
-            #     for example `organizations/433245324/inspectTemplates/432452342` or
+            #     Required. Resource name of organization and inspectTemplate to be updated, for
+            #     example `organizations/433245324/inspectTemplates/432452342` or
             #     projects/project-id/inspectTemplates/432452342.
             #   @param inspect_template [::Google::Cloud::Dlp::V2::InspectTemplate, ::Hash]
             #     New InspectTemplate value.
@@ -970,8 +1028,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. Resource name of the organization and inspectTemplate to be read,
-            #     for example `organizations/433245324/inspectTemplates/432452342` or
+            #     Required. Resource name of the organization and inspectTemplate to be read, for
+            #     example `organizations/433245324/inspectTemplates/432452342` or
             #     projects/project-id/inspectTemplates/432452342.
             #
             # @yield [response, operation] Access the result along with the RPC operation
@@ -1039,8 +1097,26 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The parent resource name, for example projects/my-project-id or
-            #     organizations/my-org-id or projects/my-project-id/locations/\\{location_id}.
+            #     Required. Parent resource name.
+            #
+            #     The format of this value varies depending on the scope of the request
+            #     (project or organization) and whether you have [specified a processing
+            #     location](/dlp/docs/specifying-location):
+            #
+            #     + Projects scope, location specified:<br/>
+            #       `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
+            #     + Projects scope, no location specified (defaults to global):<br/>
+            #       `projects/`<var>PROJECT_ID</var>
+            #     + Organizations scope, location specified:<br/>
+            #       `organizations/`<var>ORG_ID</var>`/locations/`<var>LOCATION_ID</var>
+            #     + Organizations scope, no location specified (defaults to global):<br/>
+            #       `organizations/`<var>ORG_ID</var>
+            #
+            #     The following example `parent` string specifies a parent project with the
+            #     identifier `example-project`, and specifies the `europe-west3` location
+            #     for processing data:
+            #
+            #         parent=projects/example-project/locations/europe-west3
             #   @param page_token [::String]
             #     Page token to continue retrieval. Comes from previous call
             #     to `ListInspectTemplates`.
@@ -1130,9 +1206,9 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. Resource name of the organization and inspectTemplate to be
-            #     deleted, for example `organizations/433245324/inspectTemplates/432452342`
-            #     or projects/project-id/inspectTemplates/432452342.
+            #     Required. Resource name of the organization and inspectTemplate to be deleted, for
+            #     example `organizations/433245324/inspectTemplates/432452342` or
+            #     projects/project-id/inspectTemplates/432452342.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Protobuf::Empty]
@@ -1201,8 +1277,26 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The parent resource name, for example projects/my-project-id or
-            #     organizations/my-org-id or projects/my-project-id/locations/\\{location_id}.
+            #     Required. Parent resource name.
+            #
+            #     The format of this value varies depending on the scope of the request
+            #     (project or organization) and whether you have [specified a processing
+            #     location](/dlp/docs/specifying-location):
+            #
+            #     + Projects scope, location specified:<br/>
+            #       `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
+            #     + Projects scope, no location specified (defaults to global):<br/>
+            #       `projects/`<var>PROJECT_ID</var>
+            #     + Organizations scope, location specified:<br/>
+            #       `organizations/`<var>ORG_ID</var>`/locations/`<var>LOCATION_ID</var>
+            #     + Organizations scope, no location specified (defaults to global):<br/>
+            #       `organizations/`<var>ORG_ID</var>
+            #
+            #     The following example `parent` string specifies a parent project with the
+            #     identifier `example-project`, and specifies the `europe-west3` location
+            #     for processing data:
+            #
+            #         parent=projects/example-project/locations/europe-west3
             #   @param deidentify_template [::Google::Cloud::Dlp::V2::DeidentifyTemplate, ::Hash]
             #     Required. The DeidentifyTemplate to create.
             #   @param template_id [::String]
@@ -1279,9 +1373,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. Resource name of organization and deidentify template to be
-            #     updated, for example
-            #     `organizations/433245324/deidentifyTemplates/432452342` or
+            #     Required. Resource name of organization and deidentify template to be updated, for
+            #     example `organizations/433245324/deidentifyTemplates/432452342` or
             #     projects/project-id/deidentifyTemplates/432452342.
             #   @param deidentify_template [::Google::Cloud::Dlp::V2::DeidentifyTemplate, ::Hash]
             #     New DeidentifyTemplate value.
@@ -1354,9 +1447,9 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. Resource name of the organization and deidentify template to be
-            #     read, for example `organizations/433245324/deidentifyTemplates/432452342`
-            #     or projects/project-id/deidentifyTemplates/432452342.
+            #     Required. Resource name of the organization and deidentify template to be read, for
+            #     example `organizations/433245324/deidentifyTemplates/432452342` or
+            #     projects/project-id/deidentifyTemplates/432452342.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::Dlp::V2::DeidentifyTemplate]
@@ -1424,8 +1517,26 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The parent resource name, for example projects/my-project-id or
-            #     organizations/my-org-id or projects/my-project-id/locations/\\{location_id}.
+            #     Required. Parent resource name.
+            #
+            #     The format of this value varies depending on the scope of the request
+            #     (project or organization) and whether you have [specified a processing
+            #     location](/dlp/docs/specifying-location):
+            #
+            #     + Projects scope, location specified:<br/>
+            #       `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
+            #     + Projects scope, no location specified (defaults to global):<br/>
+            #       `projects/`<var>PROJECT_ID</var>
+            #     + Organizations scope, location specified:<br/>
+            #       `organizations/`<var>ORG_ID</var>`/locations/`<var>LOCATION_ID</var>
+            #     + Organizations scope, no location specified (defaults to global):<br/>
+            #       `organizations/`<var>ORG_ID</var>
+            #
+            #     The following example `parent` string specifies a parent project with the
+            #     identifier `example-project`, and specifies the `europe-west3` location
+            #     for processing data:
+            #
+            #         parent=projects/example-project/locations/europe-west3
             #   @param page_token [::String]
             #     Page token to continue retrieval. Comes from previous call
             #     to `ListDeidentifyTemplates`.
@@ -1516,9 +1627,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. Resource name of the organization and deidentify template to be
-            #     deleted, for example
-            #     `organizations/433245324/deidentifyTemplates/432452342` or
+            #     Required. Resource name of the organization and deidentify template to be deleted,
+            #     for example `organizations/433245324/deidentifyTemplates/432452342` or
             #     projects/project-id/deidentifyTemplates/432452342.
             #
             # @yield [response, operation] Access the result along with the RPC operation
@@ -1587,8 +1697,21 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The parent resource name, for example projects/my-project-id
-            #     or projects/my-project-id/locations/\\{location_id}.
+            #     Required. Parent resource name.
+            #
+            #     The format of this value varies depending on whether you have [specified a
+            #     processing location](/dlp/docs/specifying-location):
+            #
+            #     + Projects scope, location specified:<br/>
+            #       `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
+            #     + Projects scope, no location specified (defaults to global):<br/>
+            #       `projects/`<var>PROJECT_ID</var>
+            #
+            #     The following example `parent` string specifies a parent project with the
+            #     identifier `example-project`, and specifies the `europe-west3` location
+            #     for processing data:
+            #
+            #         parent=projects/example-project/locations/europe-west3
             #   @param job_trigger [::Google::Cloud::Dlp::V2::JobTrigger, ::Hash]
             #     Required. The JobTrigger to create.
             #   @param trigger_id [::String]
@@ -1740,8 +1863,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. Resource name of the trigger to execute a hybrid inspect on, for
-            #     example `projects/dlp-test-project/jobTriggers/53234423`.
+            #     Required. Resource name of the trigger to execute a hybrid inspect on, for example
+            #     `projects/dlp-test-project/jobTriggers/53234423`.
             #   @param hybrid_item [::Google::Cloud::Dlp::V2::HybridContentItem, ::Hash]
             #     The item to inspect.
             #
@@ -1878,8 +2001,21 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The parent resource name, for example `projects/my-project-id`
-            #     or projects/my-project-id/locations/\\{location_id}.
+            #     Required. Parent resource name.
+            #
+            #     The format of this value varies depending on whether you have [specified a
+            #     processing location](/dlp/docs/specifying-location):
+            #
+            #     + Projects scope, location specified:<br/>
+            #       `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
+            #     + Projects scope, no location specified (defaults to global):<br/>
+            #       `projects/`<var>PROJECT_ID</var>
+            #
+            #     The following example `parent` string specifies a parent project with the
+            #     identifier `example-project`, and specifies the `europe-west3` location
+            #     for processing data:
+            #
+            #         parent=projects/example-project/locations/europe-west3
             #   @param page_token [::String]
             #     Page token to continue retrieval. Comes from previous call
             #     to ListJobTriggers. `order_by` field must not
@@ -2137,8 +2273,21 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The parent resource name, for example projects/my-project-id
-            #     or projects/my-project-id/locations/\\{location_id}.
+            #     Required. Parent resource name.
+            #
+            #     The format of this value varies depending on whether you have [specified a
+            #     processing location](/dlp/docs/specifying-location):
+            #
+            #     + Projects scope, location specified:<br/>
+            #       `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
+            #     + Projects scope, no location specified (defaults to global):<br/>
+            #       `projects/`<var>PROJECT_ID</var>
+            #
+            #     The following example `parent` string specifies a parent project with the
+            #     identifier `example-project`, and specifies the `europe-west3` location
+            #     for processing data:
+            #
+            #         parent=projects/example-project/locations/europe-west3
             #   @param inspect_job [::Google::Cloud::Dlp::V2::InspectJobConfig, ::Hash]
             #     Set to control what and how to inspect.
             #   @param risk_job [::Google::Cloud::Dlp::V2::RiskAnalysisJobConfig, ::Hash]
@@ -2217,8 +2366,21 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The parent resource name, for example projects/my-project-id
-            #     or projects/my-project-id/locations/\\{location_id}.
+            #     Required. Parent resource name.
+            #
+            #     The format of this value varies depending on whether you have [specified a
+            #     processing location](/dlp/docs/specifying-location):
+            #
+            #     + Projects scope, location specified:<br/>
+            #       `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
+            #     + Projects scope, no location specified (defaults to global):<br/>
+            #       `projects/`<var>PROJECT_ID</var>
+            #
+            #     The following example `parent` string specifies a parent project with the
+            #     identifier `example-project`, and specifies the `europe-west3` location
+            #     for processing data:
+            #
+            #         parent=projects/example-project/locations/europe-west3
             #   @param filter [::String]
             #     Allows filtering.
             #
@@ -2546,8 +2708,26 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The parent resource name, for example projects/my-project-id or
-            #     organizations/my-org-id or projects/my-project-id/locations/\\{location_id}
+            #     Required. Parent resource name.
+            #
+            #     The format of this value varies depending on the scope of the request
+            #     (project or organization) and whether you have [specified a processing
+            #     location](/dlp/docs/specifying-location):
+            #
+            #     + Projects scope, location specified:<br/>
+            #       `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
+            #     + Projects scope, no location specified (defaults to global):<br/>
+            #       `projects/`<var>PROJECT_ID</var>
+            #     + Organizations scope, location specified:<br/>
+            #       `organizations/`<var>ORG_ID</var>`/locations/`<var>LOCATION_ID</var>
+            #     + Organizations scope, no location specified (defaults to global):<br/>
+            #       `organizations/`<var>ORG_ID</var>
+            #
+            #     The following example `parent` string specifies a parent project with the
+            #     identifier `example-project`, and specifies the `europe-west3` location
+            #     for processing data:
+            #
+            #         parent=projects/example-project/locations/europe-west3
             #   @param config [::Google::Cloud::Dlp::V2::StoredInfoTypeConfig, ::Hash]
             #     Required. Configuration of the storedInfoType to create.
             #   @param stored_info_type_id [::String]
@@ -2701,8 +2881,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. Resource name of the organization and storedInfoType to be read,
-            #     for example `organizations/433245324/storedInfoTypes/432452342` or
+            #     Required. Resource name of the organization and storedInfoType to be read, for
+            #     example `organizations/433245324/storedInfoTypes/432452342` or
             #     projects/project-id/storedInfoTypes/432452342.
             #
             # @yield [response, operation] Access the result along with the RPC operation
@@ -2771,8 +2951,26 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The parent resource name, for example projects/my-project-id or
-            #     organizations/my-org-id or projects/my-project-id/locations/\\{location_id}.
+            #     Required. Parent resource name.
+            #
+            #     The format of this value varies depending on the scope of the request
+            #     (project or organization) and whether you have [specified a processing
+            #     location](/dlp/docs/specifying-location):
+            #
+            #     + Projects scope, location specified:<br/>
+            #       `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
+            #     + Projects scope, no location specified (defaults to global):<br/>
+            #       `projects/`<var>PROJECT_ID</var>
+            #     + Organizations scope, location specified:<br/>
+            #       `organizations/`<var>ORG_ID</var>`/locations/`<var>LOCATION_ID</var>
+            #     + Organizations scope, no location specified (defaults to global):<br/>
+            #       `organizations/`<var>ORG_ID</var>
+            #
+            #     The following example `parent` string specifies a parent project with the
+            #     identifier `example-project`, and specifies the `europe-west3` location
+            #     for processing data:
+            #
+            #         parent=projects/example-project/locations/europe-west3
             #   @param page_token [::String]
             #     Page token to continue retrieval. Comes from previous call
             #     to `ListStoredInfoTypes`.
@@ -2864,8 +3062,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. Resource name of the organization and storedInfoType to be
-            #     deleted, for example `organizations/433245324/storedInfoTypes/432452342` or
+            #     Required. Resource name of the organization and storedInfoType to be deleted, for
+            #     example `organizations/433245324/storedInfoTypes/432452342` or
             #     projects/project-id/storedInfoTypes/432452342.
             #
             # @yield [response, operation] Access the result along with the RPC operation
@@ -2937,8 +3135,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. Resource name of the job to execute a hybrid inspect on, for
-            #     example `projects/dlp-test-project/dlpJob/53234423`.
+            #     Required. Resource name of the job to execute a hybrid inspect on, for example
+            #     `projects/dlp-test-project/dlpJob/53234423`.
             #   @param hybrid_item [::Google::Cloud::Dlp::V2::HybridContentItem, ::Hash]
             #     The item to inspect.
             #
@@ -3142,7 +3340,7 @@ module Google
 
               config_attr :endpoint,      "dlp.googleapis.com", ::String
               config_attr :credentials,   nil do |value|
-                allowed = [::String, ::Hash, ::Proc, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
+                allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
                 allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
                 allowed.any? { |klass| klass === value }
               end