RubyGems - google-cloud-dlp - Versions diffs - 0.4.0 → 0.5.0 - Mend

google-cloud-dlp 0.4.0 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (14) hide show

checksums.yaml +4 -4
data/README.md +33 -0
data/lib/google/cloud/dlp.rb +36 -0
data/lib/google/cloud/dlp/v2.rb +37 -0
data/lib/google/cloud/dlp/v2/credentials.rb +40 -0
data/lib/google/cloud/dlp/v2/dlp_service_client.rb +340 -144
data/lib/google/cloud/dlp/v2/doc/google/privacy/dlp/v2/dlp.rb +204 -38
data/lib/google/cloud/dlp/v2/doc/google/privacy/dlp/v2/storage.rb +56 -16
data/lib/google/cloud/dlp/v2/doc/overview.rb +25 -0
data/lib/google/privacy/dlp/v2/dlp_pb.rb +47 -0
data/lib/google/privacy/dlp/v2/dlp_services_pb.rb +61 -7
data/lib/google/privacy/dlp/v2/storage_pb.rb +15 -0
metadata +6 -6
data/lib/google/cloud/dlp/credentials.rb +0 -30

data/lib/google/cloud/dlp/v2/doc/google/privacy/dlp/v2/storage.rb CHANGED Viewed

@@ -19,34 +19,38 @@ module Google
         # Type of information detected by the API.
         # @!attribute [rw] name
         #   @return [String]
-        #     Name of the information type.
+        #     Name of the information type. Either a name of your choosing when
+        #     creating a CustomInfoType, or one of the names listed
+        #     at https://cloud.google.com/dlp/docs/infotypes-reference when specifying
+        #     a built-in type.
         class InfoType; end
         # Custom information type provided by the user. Used to find domain-specific
         # sensitive information configurable to the data in question.
         # @!attribute [rw] info_type
         #   @return [Google::Privacy::Dlp::V2::InfoType]
-        #     Info type configuration. All custom info types must have configurations
-        #     that do not conflict with built-in info types or other custom info types.
+        #     All CustomInfoTypes must have a name
+        #     that does not conflict with built-in InfoTypes or other CustomInfoTypes.
         # @!attribute [rw] likelihood
         #   @return [Google::Privacy::Dlp::V2::Likelihood]
-        #     Likelihood to return for this custom info type. This base value can be
+        #     Likelihood to return for this CustomInfoType. This base value can be
         #     altered by a detection rule if the finding meets the criteria specified by
         #     the rule. Defaults to +VERY_LIKELY+ if not specified.
         # @!attribute [rw] dictionary
         #   @return [Google::Privacy::Dlp::V2::CustomInfoType::Dictionary]
-        #     Dictionary-based custom info type.
+        #     A list of phrases to detect as a CustomInfoType.
         # @!attribute [rw] regex
         #   @return [Google::Privacy::Dlp::V2::CustomInfoType::Regex]
-        #     Regex-based custom info type.
+        #     Regular expression based CustomInfoType.
         # @!attribute [rw] surrogate_type
         #   @return [Google::Privacy::Dlp::V2::CustomInfoType::SurrogateType]
-        #     Surrogate info type.
+        #     Message for detecting output from deidentification transformations that
+        #     support reversing.
         # @!attribute [rw] detection_rules
         #   @return [Array<Google::Privacy::Dlp::V2::CustomInfoType::DetectionRule>]
-        #     Set of detection rules to apply to all findings of this custom info type.
+        #     Set of detection rules to apply to all findings of this CustomInfoType.
         #     Rules are applied in order that they are specified. Not supported for the
-        #     +surrogate_type+ custom info type.
+        #     +surrogate_type+ CustomInfoType.
         class CustomInfoType
           # Custom information type based on a dictionary of words or phrases. This can
           # be used to match sensitive information specific to the data, such as a list
@@ -96,11 +100,11 @@ module Google
           # These types of transformations are
           # those that perform pseudonymization, thereby producing a "surrogate" as
           # output. This should be used in conjunction with a field on the
-          # transformation such as +surrogate_info_type+. This custom info type does
+          # transformation such as +surrogate_info_type+. This CustomInfoType does
           # not support the use of +detection_rules+.
           class SurrogateType; end
-          # Rule for modifying a custom info type to alter behavior under certain
+          # Rule for modifying a CustomInfoType to alter behavior under certain
           # circumstances, depending on the specific details of the rule. Not supported
           # for the +surrogate_type+ custom info type.
           # @!attribute [rw] hotword_rule
@@ -134,11 +138,11 @@ module Google
             #     a final likelihood of +LIKELY+.
             class LikelihoodAdjustment; end
-            # Detection rule that adjusts the likelihood of findings within a certain
+            # The rule that adjusts the likelihood of findings within a certain
             # proximity of hotwords.
             # @!attribute [rw] hotword_regex
             #   @return [Google::Privacy::Dlp::V2::CustomInfoType::Regex]
-            #     Regex pattern defining what qualifies as a hotword.
+            #     Regular expression pattern defining what qualifies as a hotword.
             # @!attribute [rw] proximity
             #   @return [Google::Privacy::Dlp::V2::CustomInfoType::DetectionRule::Proximity]
             #     Proximity of the finding within which the entire hotword must reside.
@@ -205,6 +209,13 @@ module Google
         #     List of file type groups to include in the scan.
         #     If empty, all files are scanned and available data format processors
         #     are applied.
+        # @!attribute [rw] sample_method
+        #   @return [Google::Privacy::Dlp::V2::CloudStorageOptions::SampleMethod]
+        # @!attribute [rw] files_limit_percent
+        #   @return [Integer]
+        #     Limits the number of files to scan to this percentage of the input FileSet.
+        #     Number of files scanned is rounded down. Must be between 0 and 100,
+        #     inclusively. Both 0 and 100 means no limit. Defaults to 0.
         class CloudStorageOptions
           # Set of files to scan.
           # @!attribute [rw] url
@@ -212,9 +223,23 @@ module Google
           #     The url, in the format +gs://<bucket>/<path>+. Trailing wildcard in the
           #     path is allowed.
           class FileSet; end
+          # How to sample bytes if not all bytes are scanned. Meaningful only when used
+          # in conjunction with bytes_limit_per_file. If not specified, scanning would
+          # start from the top.
+          module SampleMethod
+            SAMPLE_METHOD_UNSPECIFIED = 0
+            # Scan from the top (default).
+            TOP = 1
+            # For each file larger than bytes_limit_per_file, randomly pick the offset
+            # to start scanning. The scanned bytes are contiguous.
+            RANDOM_START = 2
+          end
         end
-        # Message representing a path in Cloud Storage.
+        # Message representing a single file or path in Cloud Storage.
         # @!attribute [rw] path
         #   @return [String]
         #     A url representing a file or path (no wildcards) in Cloud Storage.
@@ -234,7 +259,22 @@ module Google
         #     Max number of rows to scan. If the table has more rows than this value, the
         #     rest of the rows are omitted. If not set, or if set to 0, all rows will be
         #     scanned. Cannot be used in conjunction with TimespanConfig.
-        class BigQueryOptions; end
+        # @!attribute [rw] sample_method
+        #   @return [Google::Privacy::Dlp::V2::BigQueryOptions::SampleMethod]
+        class BigQueryOptions
+          # How to sample rows if not all rows are scanned. Meaningful only when used
+          # in conjunction with rows_limit. If not specified, scanning would start
+          # from the top.
+          module SampleMethod
+            SAMPLE_METHOD_UNSPECIFIED = 0
+            # Scan from the top (default).
+            TOP = 1
+            # Randomly pick the row to start scanning. The scanned rows are contiguous.
+            RANDOM_START = 2
+          end
+        end
         # Shared message indicating Cloud storage type.
         # @!attribute [rw] datastore_options
@@ -374,7 +414,7 @@ module Google
         # Categorization of results based on how likely they are to represent a match,
         # based on the number of elements they contain which imply a match.
         module Likelihood
-          # Default value; information with all likelihoods is included.
+          # Default value; same as POSSIBLE.
           LIKELIHOOD_UNSPECIFIED = 0
           # Few matching elements.

data/lib/google/cloud/dlp/v2/doc/overview.rb CHANGED Viewed

@@ -47,6 +47,31 @@ module Google
     #
     # [Product Documentation]: https://cloud.google.com/dlp
     #
+    # ## Enabling Logging
+    #
+    # To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
+    # The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib-2.5.0/libdoc/logger/rdoc/Logger.html) as shown below,
+    # or a [`Google::Cloud::Logging::Logger`](https://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/cloud/logging/logger)
+    # that will write logs to [Stackdriver Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
+    # and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
+    #
+    # Configuring a Ruby stdlib logger:
+    #
+    # ```ruby
+    # require "logger"
+    #
+    # module MyLogger
+    #   LOGGER = Logger.new $stderr, level: Logger::WARN
+    #   def logger
+    #     LOGGER
+    #   end
+    # end
+    #
+    # # Define a gRPC module-level logger method before grpc/logconfig.rb loads.
+    # module GRPC
+    #   extend MyLogger
+    # end
+    # ```
     #
     module Dlp
       module V2

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

@@ -114,6 +114,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     optional :parent, :string, 1
     optional :inspect_config, :message, 2, "google.privacy.dlp.v2.InspectConfig"
     repeated :image_redaction_configs, :message, 5, "google.privacy.dlp.v2.RedactImageRequest.ImageRedactionConfig"
+    optional :include_findings, :bool, 6
     optional :byte_item, :message, 7, "google.privacy.dlp.v2.ByteContentItem"
   end
   add_message "google.privacy.dlp.v2.RedactImageRequest.ImageRedactionConfig" do
@@ -131,6 +132,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.privacy.dlp.v2.RedactImageResponse" do
     optional :redacted_image, :bytes, 1
     optional :extracted_text, :string, 2
+    optional :inspect_result, :message, 3, "google.privacy.dlp.v2.InspectResult"
   end
   add_message "google.privacy.dlp.v2.DeidentifyContentRequest" do
     optional :parent, :string, 1
@@ -213,6 +215,23 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     optional :source_table, :message, 2, "google.privacy.dlp.v2.BigQueryTable"
     repeated :actions, :message, 3, "google.privacy.dlp.v2.Action"
   end
+  add_message "google.privacy.dlp.v2.QuasiId" do
+    optional :field, :message, 1, "google.privacy.dlp.v2.FieldId"
+    oneof :tag do
+      optional :info_type, :message, 2, "google.privacy.dlp.v2.InfoType"
+      optional :custom_tag, :string, 3
+      optional :inferred, :message, 4, "google.protobuf.Empty"
+    end
+  end
+  add_message "google.privacy.dlp.v2.StatisticalTable" do
+    optional :table, :message, 3, "google.privacy.dlp.v2.BigQueryTable"
+    repeated :quasi_ids, :message, 1, "google.privacy.dlp.v2.StatisticalTable.QuasiIdentifierField"
+    optional :relative_frequency, :message, 2, "google.privacy.dlp.v2.FieldId"
+  end
+  add_message "google.privacy.dlp.v2.StatisticalTable.QuasiIdentifierField" do
+    optional :field, :message, 1, "google.privacy.dlp.v2.FieldId"
+    optional :custom_tag, :string, 2
+  end
   add_message "google.privacy.dlp.v2.PrivacyMetric" do
     oneof :type do
       optional :numerical_stats_config, :message, 1, "google.privacy.dlp.v2.PrivacyMetric.NumericalStatsConfig"
@@ -220,6 +239,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :k_anonymity_config, :message, 3, "google.privacy.dlp.v2.PrivacyMetric.KAnonymityConfig"
       optional :l_diversity_config, :message, 4, "google.privacy.dlp.v2.PrivacyMetric.LDiversityConfig"
       optional :k_map_estimation_config, :message, 5, "google.privacy.dlp.v2.PrivacyMetric.KMapEstimationConfig"
+      optional :delta_presence_estimation_config, :message, 6, "google.privacy.dlp.v2.PrivacyMetric.DeltaPresenceEstimationConfig"
     end
   end
   add_message "google.privacy.dlp.v2.PrivacyMetric.NumericalStatsConfig" do
@@ -258,6 +278,11 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     optional :field, :message, 1, "google.privacy.dlp.v2.FieldId"
     optional :custom_tag, :string, 2
   end
+  add_message "google.privacy.dlp.v2.PrivacyMetric.DeltaPresenceEstimationConfig" do
+    repeated :quasi_ids, :message, 1, "google.privacy.dlp.v2.QuasiId"
+    optional :region_code, :string, 2
+    repeated :auxiliary_tables, :message, 3, "google.privacy.dlp.v2.StatisticalTable"
+  end
   add_message "google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails" do
     optional :requested_privacy_metric, :message, 1, "google.privacy.dlp.v2.PrivacyMetric"
     optional :requested_source_table, :message, 2, "google.privacy.dlp.v2.BigQueryTable"
@@ -267,6 +292,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :k_anonymity_result, :message, 5, "google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.KAnonymityResult"
       optional :l_diversity_result, :message, 6, "google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.LDiversityResult"
       optional :k_map_estimation_result, :message, 7, "google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.KMapEstimationResult"
+      optional :delta_presence_estimation_result, :message, 9, "google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.DeltaPresenceEstimationResult"
     end
   end
   add_message "google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.NumericalStatsResult" do
@@ -328,6 +354,20 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     repeated :bucket_values, :message, 6, "google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.KMapEstimationResult.KMapEstimationQuasiIdValues"
     optional :bucket_value_count, :int64, 7
   end
+  add_message "google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.DeltaPresenceEstimationResult" do
+    repeated :delta_presence_estimation_histogram, :message, 1, "google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.DeltaPresenceEstimationResult.DeltaPresenceEstimationHistogramBucket"
+  end
+  add_message "google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.DeltaPresenceEstimationResult.DeltaPresenceEstimationQuasiIdValues" do
+    repeated :quasi_ids_values, :message, 1, "google.privacy.dlp.v2.Value"
+    optional :estimated_probability, :double, 2
+  end
+  add_message "google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.DeltaPresenceEstimationResult.DeltaPresenceEstimationHistogramBucket" do
+    optional :min_probability, :double, 1
+    optional :max_probability, :double, 2
+    optional :bucket_size, :int64, 5
+    repeated :bucket_values, :message, 6, "google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.DeltaPresenceEstimationResult.DeltaPresenceEstimationQuasiIdValues"
+    optional :bucket_value_count, :int64, 7
+  end
   add_message "google.privacy.dlp.v2.ValueFrequency" do
     optional :value, :message, 1, "google.privacy.dlp.v2.Value"
     optional :count, :int64, 2
@@ -807,6 +847,9 @@ module Google
         ListInfoTypesRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.privacy.dlp.v2.ListInfoTypesRequest").msgclass
         ListInfoTypesResponse = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.privacy.dlp.v2.ListInfoTypesResponse").msgclass
         RiskAnalysisJobConfig = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.privacy.dlp.v2.RiskAnalysisJobConfig").msgclass
+        QuasiId = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.privacy.dlp.v2.QuasiId").msgclass
+        StatisticalTable = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.privacy.dlp.v2.StatisticalTable").msgclass
+        StatisticalTable::QuasiIdentifierField = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.privacy.dlp.v2.StatisticalTable.QuasiIdentifierField").msgclass
         PrivacyMetric = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.privacy.dlp.v2.PrivacyMetric").msgclass
         PrivacyMetric::NumericalStatsConfig = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.privacy.dlp.v2.PrivacyMetric.NumericalStatsConfig").msgclass
         PrivacyMetric::CategoricalStatsConfig = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.privacy.dlp.v2.PrivacyMetric.CategoricalStatsConfig").msgclass
@@ -816,6 +859,7 @@ module Google
         PrivacyMetric::KMapEstimationConfig::TaggedField = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.privacy.dlp.v2.PrivacyMetric.KMapEstimationConfig.TaggedField").msgclass
         PrivacyMetric::KMapEstimationConfig::AuxiliaryTable = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.privacy.dlp.v2.PrivacyMetric.KMapEstimationConfig.AuxiliaryTable").msgclass
         PrivacyMetric::KMapEstimationConfig::AuxiliaryTable::QuasiIdField = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.privacy.dlp.v2.PrivacyMetric.KMapEstimationConfig.AuxiliaryTable.QuasiIdField").msgclass
+        PrivacyMetric::DeltaPresenceEstimationConfig = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.privacy.dlp.v2.PrivacyMetric.DeltaPresenceEstimationConfig").msgclass
         AnalyzeDataSourceRiskDetails = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails").msgclass
         AnalyzeDataSourceRiskDetails::NumericalStatsResult = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.NumericalStatsResult").msgclass
         AnalyzeDataSourceRiskDetails::CategoricalStatsResult = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.CategoricalStatsResult").msgclass
@@ -829,6 +873,9 @@ module Google
         AnalyzeDataSourceRiskDetails::KMapEstimationResult = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.KMapEstimationResult").msgclass
         AnalyzeDataSourceRiskDetails::KMapEstimationResult::KMapEstimationQuasiIdValues = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.KMapEstimationResult.KMapEstimationQuasiIdValues").msgclass
         AnalyzeDataSourceRiskDetails::KMapEstimationResult::KMapEstimationHistogramBucket = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.KMapEstimationResult.KMapEstimationHistogramBucket").msgclass
+        AnalyzeDataSourceRiskDetails::DeltaPresenceEstimationResult = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.DeltaPresenceEstimationResult").msgclass
+        AnalyzeDataSourceRiskDetails::DeltaPresenceEstimationResult::DeltaPresenceEstimationQuasiIdValues = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.DeltaPresenceEstimationResult.DeltaPresenceEstimationQuasiIdValues").msgclass
+        AnalyzeDataSourceRiskDetails::DeltaPresenceEstimationResult::DeltaPresenceEstimationHistogramBucket = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.privacy.dlp.v2.AnalyzeDataSourceRiskDetails.DeltaPresenceEstimationResult.DeltaPresenceEstimationHistogramBucket").msgclass
         ValueFrequency = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.privacy.dlp.v2.ValueFrequency").msgclass
         Value = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.privacy.dlp.v2.Value").msgclass
         QuoteInfo = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.privacy.dlp.v2.QuoteInfo").msgclass

data/lib/google/privacy/dlp/v2/dlp_services_pb.rb CHANGED Viewed

@@ -30,6 +30,9 @@ module Google
           # blocks or images.
           # The service also includes methods for sensitive data redaction and
           # scheduling of data scans on Google Cloud Platform based data sets.
+          #
+          # To learn more about concepts and find how-to guides see
+          # https://cloud.google.com/dlp/docs/.
           class Service
             include GRPC::GenericService
@@ -40,70 +43,121 @@ module Google
             # Finds potentially sensitive info in content.
             # This method has limits on input size, processing time, and output size.
-            # [How-to guide for text](/dlp/docs/inspecting-text), [How-to guide for
-            # images](/dlp/docs/inspecting-images)
+            #
+            # When no InfoTypes or CustomInfoTypes are specified in this request, the
+            # system will automatically choose what detectors to run. By default this may
+            # be all types, but may change over time as detectors are updated.
+            #
+            # For how to guides, see https://cloud.google.com/dlp/docs/inspecting-images
+            # and https://cloud.google.com/dlp/docs/inspecting-text,
             rpc :InspectContent, InspectContentRequest, InspectContentResponse
             # Redacts potentially sensitive info from an image.
             # This method has limits on input size, processing time, and output size.
-            # [How-to guide](/dlp/docs/redacting-sensitive-data-images)
+            # See https://cloud.google.com/dlp/docs/redacting-sensitive-data-images to
+            # learn more.
+            #
+            # When no InfoTypes or CustomInfoTypes are specified in this request, the
+            # system will automatically choose what detectors to run. By default this may
+            # be all types, but may change over time as detectors are updated.
             rpc :RedactImage, RedactImageRequest, RedactImageResponse
             # De-identifies potentially sensitive info from a ContentItem.
             # This method has limits on input size and output size.
-            # [How-to guide](/dlp/docs/deidentify-sensitive-data)
+            # See https://cloud.google.com/dlp/docs/deidentify-sensitive-data to
+            # learn more.
+            #
+            # When no InfoTypes or CustomInfoTypes are specified in this request, the
+            # system will automatically choose what detectors to run. By default this may
+            # be all types, but may change over time as detectors are updated.
             rpc :DeidentifyContent, DeidentifyContentRequest, DeidentifyContentResponse
             # Re-identifies content that has been de-identified.
+            # See
+            # https://cloud.google.com/dlp/docs/pseudonymization#re-identification_in_free_text_code_example
+            # to learn more.
             rpc :ReidentifyContent, ReidentifyContentRequest, ReidentifyContentResponse
             # Returns a list of the sensitive information types that the DLP API
-            # supports. For more information, see [Listing supported predefined
-            # infoTypes](/dlp/docs/listing-infotypes).
+            # supports. See https://cloud.google.com/dlp/docs/infotypes-reference to
+            # learn more.
             rpc :ListInfoTypes, ListInfoTypesRequest, ListInfoTypesResponse
             # Creates an InspectTemplate for re-using frequently used configuration
             # for inspecting content, images, and storage.
+            # See https://cloud.google.com/dlp/docs/creating-templates to learn more.
             rpc :CreateInspectTemplate, CreateInspectTemplateRequest, InspectTemplate
             # Updates the InspectTemplate.
+            # See https://cloud.google.com/dlp/docs/creating-templates to learn more.
             rpc :UpdateInspectTemplate, UpdateInspectTemplateRequest, InspectTemplate
             # Gets an InspectTemplate.
+            # See https://cloud.google.com/dlp/docs/creating-templates to learn more.
             rpc :GetInspectTemplate, GetInspectTemplateRequest, InspectTemplate
             # Lists InspectTemplates.
+            # See https://cloud.google.com/dlp/docs/creating-templates to learn more.
             rpc :ListInspectTemplates, ListInspectTemplatesRequest, ListInspectTemplatesResponse
             # Deletes an InspectTemplate.
+            # See https://cloud.google.com/dlp/docs/creating-templates to learn more.
             rpc :DeleteInspectTemplate, DeleteInspectTemplateRequest, Google::Protobuf::Empty
             # Creates a DeidentifyTemplate for re-using frequently used configuration
             # for de-identifying content, images, and storage.
+            # See https://cloud.google.com/dlp/docs/creating-templates-deid to learn
+            # more.
             rpc :CreateDeidentifyTemplate, CreateDeidentifyTemplateRequest, DeidentifyTemplate
             # Updates the DeidentifyTemplate.
+            # See https://cloud.google.com/dlp/docs/creating-templates-deid to learn
+            # more.
             rpc :UpdateDeidentifyTemplate, UpdateDeidentifyTemplateRequest, DeidentifyTemplate
             # Gets a DeidentifyTemplate.
+            # See https://cloud.google.com/dlp/docs/creating-templates-deid to learn
+            # more.
             rpc :GetDeidentifyTemplate, GetDeidentifyTemplateRequest, DeidentifyTemplate
             # Lists DeidentifyTemplates.
+            # See https://cloud.google.com/dlp/docs/creating-templates-deid to learn
+            # more.
             rpc :ListDeidentifyTemplates, ListDeidentifyTemplatesRequest, ListDeidentifyTemplatesResponse
             # Deletes a DeidentifyTemplate.
+            # See https://cloud.google.com/dlp/docs/creating-templates-deid to learn
+            # more.
             rpc :DeleteDeidentifyTemplate, DeleteDeidentifyTemplateRequest, Google::Protobuf::Empty
             # Creates a job trigger to run DLP actions such as scanning storage for
             # sensitive information on a set schedule.
+            # See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more.
             rpc :CreateJobTrigger, CreateJobTriggerRequest, JobTrigger
             # Updates a job trigger.
+            # See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more.
             rpc :UpdateJobTrigger, UpdateJobTriggerRequest, JobTrigger
             # Gets a job trigger.
+            # See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more.
             rpc :GetJobTrigger, GetJobTriggerRequest, JobTrigger
             # Lists job triggers.
+            # See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more.
             rpc :ListJobTriggers, ListJobTriggersRequest, ListJobTriggersResponse
             # Deletes a job trigger.
+            # See https://cloud.google.com/dlp/docs/creating-job-triggers to learn more.
             rpc :DeleteJobTrigger, DeleteJobTriggerRequest, Google::Protobuf::Empty
             # Creates a new job to inspect storage or calculate risk metrics.
-            # [How-to guide](/dlp/docs/compute-risk-analysis).
+            # See https://cloud.google.com/dlp/docs/inspecting-storage and
+            # https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more.
+            #
+            # When no InfoTypes or CustomInfoTypes are specified in inspect jobs, the
+            # system will automatically choose what detectors to run. By default this may
+            # be all types, but may change over time as detectors are updated.
             rpc :CreateDlpJob, CreateDlpJobRequest, DlpJob
             # Lists DlpJobs that match the specified filter in the request.
+            # See https://cloud.google.com/dlp/docs/inspecting-storage and
+            # https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more.
             rpc :ListDlpJobs, ListDlpJobsRequest, ListDlpJobsResponse
             # Gets the latest state of a long-running DlpJob.
+            # See https://cloud.google.com/dlp/docs/inspecting-storage and
+            # https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more.
             rpc :GetDlpJob, GetDlpJobRequest, DlpJob
             # Deletes a long-running DlpJob. This method indicates that the client is
             # no longer interested in the DlpJob result. The job will be cancelled if
             # possible.
+            # See https://cloud.google.com/dlp/docs/inspecting-storage and
+            # https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more.
             rpc :DeleteDlpJob, DeleteDlpJobRequest, Google::Protobuf::Empty
             # Starts asynchronous cancellation on a long-running DlpJob. The server
             # makes a best effort to cancel the DlpJob, but success is not
             # guaranteed.
+            # See https://cloud.google.com/dlp/docs/inspecting-storage and
+            # https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more.
             rpc :CancelDlpJob, CancelDlpJobRequest, Google::Protobuf::Empty
           end

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

@@ -71,10 +71,17 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     optional :file_set, :message, 1, "google.privacy.dlp.v2.CloudStorageOptions.FileSet"
     optional :bytes_limit_per_file, :int64, 4
     repeated :file_types, :enum, 5, "google.privacy.dlp.v2.FileType"
+    optional :sample_method, :enum, 6, "google.privacy.dlp.v2.CloudStorageOptions.SampleMethod"
+    optional :files_limit_percent, :int32, 7
   end
   add_message "google.privacy.dlp.v2.CloudStorageOptions.FileSet" do
     optional :url, :string, 1
   end
+  add_enum "google.privacy.dlp.v2.CloudStorageOptions.SampleMethod" do
+    value :SAMPLE_METHOD_UNSPECIFIED, 0
+    value :TOP, 1
+    value :RANDOM_START, 2
+  end
   add_message "google.privacy.dlp.v2.CloudStoragePath" do
     optional :path, :string, 1
   end
@@ -82,6 +89,12 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     optional :table_reference, :message, 1, "google.privacy.dlp.v2.BigQueryTable"
     repeated :identifying_fields, :message, 2, "google.privacy.dlp.v2.FieldId"
     optional :rows_limit, :int64, 3
+    optional :sample_method, :enum, 4, "google.privacy.dlp.v2.BigQueryOptions.SampleMethod"
+  end
+  add_enum "google.privacy.dlp.v2.BigQueryOptions.SampleMethod" do
+    value :SAMPLE_METHOD_UNSPECIFIED, 0
+    value :TOP, 1
+    value :RANDOM_START, 2
   end
   add_message "google.privacy.dlp.v2.StorageConfig" do
     optional :timespan_config, :message, 6, "google.privacy.dlp.v2.StorageConfig.TimespanConfig"
@@ -164,8 +177,10 @@ module Google
         DatastoreOptions = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.privacy.dlp.v2.DatastoreOptions").msgclass
         CloudStorageOptions = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.privacy.dlp.v2.CloudStorageOptions").msgclass
         CloudStorageOptions::FileSet = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.privacy.dlp.v2.CloudStorageOptions.FileSet").msgclass
+        CloudStorageOptions::SampleMethod = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.privacy.dlp.v2.CloudStorageOptions.SampleMethod").enummodule
         CloudStoragePath = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.privacy.dlp.v2.CloudStoragePath").msgclass
         BigQueryOptions = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.privacy.dlp.v2.BigQueryOptions").msgclass
+        BigQueryOptions::SampleMethod = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.privacy.dlp.v2.BigQueryOptions.SampleMethod").enummodule
         StorageConfig = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.privacy.dlp.v2.StorageConfig").msgclass
         StorageConfig::TimespanConfig = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.privacy.dlp.v2.StorageConfig.TimespanConfig").msgclass
         BigQueryKey = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.privacy.dlp.v2.BigQueryKey").msgclass