google-cloud-dlp-v2 0.3.2 → 0.4.3

data/lib/google/cloud/dlp/v2/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Dlp
       module V2
-        VERSION = "0.3.2"
+        VERSION = "0.4.3"
       end
     end
   end

data/lib/google/privacy/dlp/v2/dlp_pb.rb

@@ -3,7 +3,6 @@
 
 require 'google/protobuf'
 
-require 'google/api/annotations_pb'
 require 'google/api/client_pb'
 require 'google/api/field_behavior_pb'
 require 'google/api/resource_pb'
@@ -16,6 +15,7 @@ require 'google/rpc/status_pb'
 require 'google/type/date_pb'
 require 'google/type/dayofweek_pb'
 require 'google/type/timeofday_pb'
+require 'google/api/annotations_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/privacy/dlp/v2/dlp.proto", :syntax => :proto3) do
     add_message "google.privacy.dlp.v2.ExcludeInfoTypes" do
@@ -73,6 +73,8 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :WORD_DOCUMENT, 7
       value :PDF, 8
       value :AVRO, 11
+      value :CSV, 12
+      value :TSV, 13
     end
     add_message "google.privacy.dlp.v2.ContentItem" do
       oneof :data_item do

data/lib/google/privacy/dlp/v2/storage_pb.rb

@@ -5,6 +5,7 @@ require 'google/protobuf'
 
 require 'google/api/resource_pb'
 require 'google/protobuf/timestamp_pb'
+require 'google/api/annotations_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/privacy/dlp/v2/storage.proto", :syntax => :proto3) do
     add_message "google.privacy.dlp.v2.InfoType" do
@@ -197,6 +198,8 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :WORD, 5
       value :PDF, 6
       value :AVRO, 7
+      value :CSV, 8
+      value :TSV, 9
     end
   end
 end

data/proto_docs/google/privacy/dlp/v2/dlp.rb

@@ -209,6 +209,12 @@ module Google
 
             # avro
             AVRO = 11
+
+            # csv
+            CSV = 12
+
+            # tsv
+            TSV = 13
           end
         end
 
@@ -273,8 +279,8 @@ module Google
         # @!attribute [rw] name
         #   @return [::String]
         #     Resource name in format
-        #     projects/\\{project}/locations/\\{location}/findings/\\{finding}
-        #     Populated only when viewing persisted findings.
+        #     projects/\\{project}/locations/\\{location}/findings/\\{finding} Populated only
+        #     when viewing persisted findings.
         # @!attribute [rw] quote
         #   @return [::String]
         #     The content that was found. Even if the content is not textual, it
@@ -555,8 +561,21 @@ module Google
         # by covering it with a colored rectangle.
         # @!attribute [rw] parent
         #   @return [::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
         # @!attribute [rw] location_id
         #   @return [::String]
         #     Deprecated. This field has no effect.
@@ -633,8 +652,21 @@ module Google
         # Request to de-identify a list of items.
         # @!attribute [rw] parent
         #   @return [::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
         # @!attribute [rw] deidentify_config
         #   @return [::Google::Cloud::Dlp::V2::DeidentifyConfig]
         #     Configuration for the de-identification of the content item.
@@ -685,7 +717,21 @@ module Google
         # Request to re-identify an item.
         # @!attribute [rw] parent
         #   @return [::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
         # @!attribute [rw] reidentify_config
         #   @return [::Google::Cloud::Dlp::V2::DeidentifyConfig]
         #     Configuration for the re-identification of the content item.
@@ -715,10 +761,11 @@ module Google
         #   @return [::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.
         # @!attribute [rw] location_id
         #   @return [::String]
         #     Deprecated. This field has no effect.
@@ -742,8 +789,21 @@ module Google
         # Request to search for potentially sensitive info in a ContentItem.
         # @!attribute [rw] parent
         #   @return [::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
         # @!attribute [rw] inspect_config
         #   @return [::Google::Cloud::Dlp::V2::InspectConfig]
         #     Configuration for the inspector. What specified here will override
@@ -891,7 +951,7 @@ module Google
           end
         end
 
-        # Statistics related to processing hybrid inspect requests.s
+        # Statistics related to processing hybrid inspect requests.
         # @!attribute [rw] processed_count
         #   @return [::Integer]
         #     The number of hybrid inspection requests processed within this job.
@@ -933,7 +993,11 @@ module Google
         # Request for the list of infoTypes.
         # @!attribute [rw] parent
         #   @return [::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>
         # @!attribute [rw] language_code
         #   @return [::String]
         #     BCP-47 language code for localized infoType friendly
@@ -1017,8 +1081,8 @@ module Google
         #     Required. Quasi-identifier columns.
         # @!attribute [rw] relative_frequency
         #   @return [::Google::Cloud::Dlp::V2::FieldId]
-        #     Required. The relative frequency column must contain a floating-point
-        #     number between 0 and 1 (inclusive). Null values are assumed to be zero.
+        #     Required. The relative frequency column must contain a floating-point number
+        #     between 0 and 1 (inclusive). Null values are assumed to be zero.
         class StatisticalTable
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1133,8 +1197,8 @@ module Google
           # extrapolating from the distribution of values in the input dataset.
           # @!attribute [rw] quasi_ids
           #   @return [::Array<::Google::Cloud::Dlp::V2::PrivacyMetric::KMapEstimationConfig::TaggedField>]
-          #     Required. Fields considered to be quasi-identifiers. No two columns can
-          #     have the same tag.
+          #     Required. Fields considered to be quasi-identifiers. No two columns can have the
+          #     same tag.
           # @!attribute [rw] region_code
           #   @return [::String]
           #     ISO 3166-1 alpha-2 region code to use in the statistical modeling.
@@ -1189,8 +1253,8 @@ module Google
             #     Required. Quasi-identifier columns.
             # @!attribute [rw] relative_frequency
             #   @return [::Google::Cloud::Dlp::V2::FieldId]
-            #     Required. The relative frequency column must contain a floating-point
-            #     number between 0 and 1 (inclusive). Null values are assumed to be zero.
+            #     Required. The relative frequency column must contain a floating-point number
+            #     between 0 and 1 (inclusive). Null values are assumed to be zero.
             class AuxiliaryTable
               include ::Google::Protobuf::MessageExts
               extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1216,8 +1280,8 @@ module Google
           # knowing the attack dataset, so we use a statistical model instead.
           # @!attribute [rw] quasi_ids
           #   @return [::Array<::Google::Cloud::Dlp::V2::QuasiId>]
-          #     Required. Fields considered to be quasi-identifiers. No two fields can
-          #     have the same tag.
+          #     Required. Fields considered to be quasi-identifiers. No two fields can have the
+          #     same tag.
           # @!attribute [rw] region_code
           #   @return [::String]
           #     ISO 3166-1 alpha-2 region code to use in the statistical modeling.
@@ -1935,18 +1999,18 @@ module Google
         # See https://cloud.google.com/dlp/docs/concepts-bucketing to learn more.
         # @!attribute [rw] lower_bound
         #   @return [::Google::Cloud::Dlp::V2::Value]
-        #     Required. Lower bound value of buckets. All values less than `lower_bound`
-        #     are grouped together into a single bucket; for example if `lower_bound` =
-        #     10, then all values less than 10 are replaced with the value “-10”.
+        #     Required. Lower bound value of buckets. All values less than `lower_bound` are
+        #     grouped together into a single bucket; for example if `lower_bound` = 10,
+        #     then all values less than 10 are replaced with the value "-10".
         # @!attribute [rw] upper_bound
         #   @return [::Google::Cloud::Dlp::V2::Value]
-        #     Required. Upper bound value of buckets. All values greater than upper_bound
-        #     are grouped together into a single bucket; for example if `upper_bound` =
-        #     89, then all values greater than 89 are replaced with the value “89+”.
+        #     Required. Upper bound value of buckets. All values greater than upper_bound are
+        #     grouped together into a single bucket; for example if `upper_bound` = 89,
+        #     then all values greater than 89 are replaced with the value "89+".
         # @!attribute [rw] bucket_size
         #   @return [::Float]
-        #     Required. Size of each bucket (except for minimum and maximum buckets). So
-        #     if `lower_bound` = 10, `upper_bound` = 89, and `bucket_size` = 10, then the
+        #     Required. Size of each bucket (except for minimum and maximum buckets). So if
+        #     `lower_bound` = 10, `upper_bound` = 89, and `bucket_size` = 10, then the
         #     following buckets would be used: -10, 10-20, 20-30, 30-40, 40-50, 50-60,
         #     60-70, 70-80, 80-89, 89+. Precision up to 2 decimals works.
         class FixedSizeBucketingConfig
@@ -1980,8 +2044,7 @@ module Google
           #     Upper bound of the range, exclusive; type must match min.
           # @!attribute [rw] replacement_value
           #   @return [::Google::Cloud::Dlp::V2::Value]
-          #     Replacement value for this bucket. If not provided
-          #     the default behavior will be to hyphenate the min-max range.
+          #     Required. Replacement value for this bucket.
           class Bucket
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -2038,6 +2101,9 @@ module Google
         #     Number of characters must be in the range [2, 95].
         #     This must be encoded as ASCII.
         #     The order of characters does not matter.
+        #     The full list of allowed characters is:
+        #     <code>0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz
+        #     ~`!@#$%^&*()_-+={[}]|\:;"'<,>.?/</code>
         # @!attribute [rw] radix
         #   @return [::Integer]
         #     The native way to select the alphabet. Must be in the range [2, 95].
@@ -2158,15 +2224,14 @@ module Google
         # to learn more.
         # @!attribute [rw] upper_bound_days
         #   @return [::Integer]
-        #     Required. Range of shift in days. Actual shift will be selected at random
-        #     within this range (inclusive ends). Negative means shift to earlier in
-        #     time. Must not be more than 365250 days (1000 years) each direction.
+        #     Required. Range of shift in days. Actual shift will be selected at random within this
+        #     range (inclusive ends). Negative means shift to earlier in time. Must not
+        #     be more than 365250 days (1000 years) each direction.
         #
         #     For example, 3 means shift date to at most 3 days into the future.
         # @!attribute [rw] lower_bound_days
         #   @return [::Integer]
-        #     Required. For example, -5 means shift date to at most 5 days back in the
-        #     past.
+        #     Required. For example, -5 means shift date to at most 5 days back in the past.
         # @!attribute [rw] context
         #   @return [::Google::Cloud::Dlp::V2::FieldId]
         #     Points to the field that contains the context, for example, an entity id.
@@ -2684,8 +2749,26 @@ module Google
         # Request message for CreateInspectTemplate.
         # @!attribute [rw] parent
         #   @return [::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
         # @!attribute [rw] inspect_template
         #   @return [::Google::Cloud::Dlp::V2::InspectTemplate]
         #     Required. The InspectTemplate to create.
@@ -2706,8 +2789,8 @@ module Google
         # Request message for UpdateInspectTemplate.
         # @!attribute [rw] name
         #   @return [::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.
         # @!attribute [rw] inspect_template
         #   @return [::Google::Cloud::Dlp::V2::InspectTemplate]
@@ -2723,8 +2806,8 @@ module Google
         # Request message for GetInspectTemplate.
         # @!attribute [rw] name
         #   @return [::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.
         class GetInspectTemplateRequest
           include ::Google::Protobuf::MessageExts
@@ -2734,8 +2817,26 @@ module Google
         # Request message for ListInspectTemplates.
         # @!attribute [rw] parent
         #   @return [::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
         # @!attribute [rw] page_token
         #   @return [::String]
         #     Page token to continue retrieval. Comes from previous call
@@ -2783,9 +2884,9 @@ module Google
         # Request message for DeleteInspectTemplate.
         # @!attribute [rw] name
         #   @return [::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.
         class DeleteInspectTemplateRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -2794,8 +2895,21 @@ module Google
         # Request message for CreateJobTrigger.
         # @!attribute [rw] parent
         #   @return [::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
         # @!attribute [rw] job_trigger
         #   @return [::Google::Cloud::Dlp::V2::JobTrigger]
         #     Required. The JobTrigger to create.
@@ -2854,8 +2968,21 @@ module Google
         # Storage.
         # @!attribute [rw] parent
         #   @return [::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
         # @!attribute [rw] inspect_job
         #   @return [::Google::Cloud::Dlp::V2::InspectJobConfig]
         #     Set to control what and how to inspect.
@@ -2879,8 +3006,21 @@ module Google
         # Request message for ListJobTriggers.
         # @!attribute [rw] parent
         #   @return [::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
         # @!attribute [rw] page_token
         #   @return [::String]
         #     Page token to continue retrieval. Comes from previous call
@@ -3060,8 +3200,21 @@ module Google
         # The request message for listing DLP jobs.
         # @!attribute [rw] parent
         #   @return [::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
         # @!attribute [rw] filter
         #   @return [::String]
         #     Allows filtering.
@@ -3166,8 +3319,26 @@ module Google
         # Request message for CreateDeidentifyTemplate.
         # @!attribute [rw] parent
         #   @return [::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
         # @!attribute [rw] deidentify_template
         #   @return [::Google::Cloud::Dlp::V2::DeidentifyTemplate]
         #     Required. The DeidentifyTemplate to create.
@@ -3188,9 +3359,8 @@ module Google
         # Request message for UpdateDeidentifyTemplate.
         # @!attribute [rw] name
         #   @return [::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.
         # @!attribute [rw] deidentify_template
         #   @return [::Google::Cloud::Dlp::V2::DeidentifyTemplate]
@@ -3206,9 +3376,9 @@ module Google
         # Request message for GetDeidentifyTemplate.
         # @!attribute [rw] name
         #   @return [::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.
         class GetDeidentifyTemplateRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -3217,8 +3387,26 @@ module Google
         # Request message for ListDeidentifyTemplates.
         # @!attribute [rw] parent
         #   @return [::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
         # @!attribute [rw] page_token
         #   @return [::String]
         #     Page token to continue retrieval. Comes from previous call
@@ -3267,9 +3455,8 @@ module Google
         # Request message for DeleteDeidentifyTemplate.
         # @!attribute [rw] name
         #   @return [::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.
         class DeleteDeidentifyTemplateRequest
           include ::Google::Protobuf::MessageExts
@@ -3396,8 +3583,26 @@ module Google
         # Request message for CreateStoredInfoType.
         # @!attribute [rw] parent
         #   @return [::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
         # @!attribute [rw] config
         #   @return [::Google::Cloud::Dlp::V2::StoredInfoTypeConfig]
         #     Required. Configuration of the storedInfoType to create.
@@ -3437,8 +3642,8 @@ module Google
         # Request message for GetStoredInfoType.
         # @!attribute [rw] name
         #   @return [::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.
         class GetStoredInfoTypeRequest
           include ::Google::Protobuf::MessageExts
@@ -3448,8 +3653,26 @@ module Google
         # Request message for ListStoredInfoTypes.
         # @!attribute [rw] parent
         #   @return [::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
         # @!attribute [rw] page_token
         #   @return [::String]
         #     Page token to continue retrieval. Comes from previous call
@@ -3498,8 +3721,8 @@ module Google
         # Request message for DeleteStoredInfoType.
         # @!attribute [rw] name
         #   @return [::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.
         class DeleteStoredInfoTypeRequest
           include ::Google::Protobuf::MessageExts
@@ -3509,8 +3732,8 @@ module Google
         # Request to search for potentially sensitive info in a custom location.
         # @!attribute [rw] name
         #   @return [::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`.
         # @!attribute [rw] hybrid_item
         #   @return [::Google::Cloud::Dlp::V2::HybridContentItem]
         #     The item to inspect.
@@ -3522,8 +3745,8 @@ module Google
         # Request to search for potentially sensitive info in a custom location.
         # @!attribute [rw] name
         #   @return [::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`.
         # @!attribute [rw] hybrid_item
         #   @return [::Google::Cloud::Dlp::V2::HybridContentItem]
         #     The item to inspect.
@@ -3678,7 +3901,7 @@ module Google
           # Unused
           METADATATYPE_UNSPECIFIED = 0
 
-          # General file metadata provided by GCS.
+          # General file metadata provided by Cloud Storage.
           STORAGE_METADATA = 2
         end