feat: add LocationSupport,Domain,DocumentFallbackLocation

Google APIs · copybara-github · commit 2585041b27d4 · 2025-09-08T18:33:02.000-07:00
docs: minor doc revision

PiperOrigin-RevId: 804670680
diff --git a/google/privacy/dlp/v2/dlp.proto b/google/privacy/dlp/v2/dlp.proto
@@ -1917,7 +1917,7 @@ message InspectDataSourceDetails {
     InspectJobConfig job_config = 3;
   }
 
-  // All result fields mentioned below are updated while the job is processing.
+  // All Result fields are updated while the job is processing.
   message Result {
     // Total size in bytes that were processed.
     int64 processed_bytes = 1;
@@ -2024,6 +2024,29 @@ message DeidentifyDataSourceDetails {
   DeidentifyDataSourceStats deidentify_stats = 2;
 }
 
+// Locations at which a feature can be used.
+message LocationSupport {
+  // The location scope for a feature.
+  enum RegionalizationScope {
+    // Invalid.
+    REGIONALIZATION_SCOPE_UNSPECIFIED = 0;
+
+    // Feature may be used with one or more regions. See locations for details.
+    REGIONAL = 1;
+
+    // Feature may be used anywhere. Default value.
+    ANY_LOCATION = 2;
+  }
+
+  // The current scope for location on this feature. This may expand over time.
+  RegionalizationScope regionalization_scope = 1;
+
+  // Specific locations where the feature may be used.
+  // Examples: us-central1, us, asia, global
+  // If scope is ANY_LOCATION, no regions will be listed.
+  repeated string locations = 2;
+}
+
 // InfoType description.
 message InfoTypeDescription {
   // Internal name of the infoType.
@@ -2039,6 +2062,9 @@ message InfoTypeDescription {
   // request.
   string description = 4;
 
+  // Locations at which this feature can be used. May change over time.
+  LocationSupport location_support = 6;
+
   // A sample that is a true positive for this infoType.
   string example = 8;
 
@@ -2081,6 +2107,9 @@ message InfoTypeCategory {
     // The infoType is typically used in Australia.
     AUSTRALIA = 3;
 
+    // The infoType is typically used in Austria.
+    AUSTRIA = 53;
+
     // The infoType is typically used in Azerbaijan.
     AZERBAIJAN = 48;
 
@@ -2358,7 +2387,7 @@ message QuasiId {
 
     // A column can be tagged with a custom tag. In this case, the user must
     // indicate an auxiliary table that contains statistical information on
-    // the possible values of this column (below).
+    // the possible values of this column.
     string custom_tag = 3;
 
     // If no semantic tag is indicated, we infer the statistical model from
@@ -2383,7 +2412,7 @@ message StatisticalTable {
 
     // A column can be tagged with a custom tag. In this case, the user must
     // indicate an auxiliary table that contains statistical information on
-    // the possible values of this column (below).
+    // the possible values of this column.
     string custom_tag = 2;
   }
 
@@ -2477,7 +2506,7 @@ message PrivacyMetric {
 
         // A column can be tagged with a custom tag. In this case, the user must
         // indicate an auxiliary table that contains statistical information on
-        // the possible values of this column (below).
+        // the possible values of this column.
         string custom_tag = 3;
 
         // If no semantic tag is indicated, we infer the statistical model from
@@ -4287,12 +4316,12 @@ message Action {
     }
 
     // List of user-specified file type groups to transform. If specified, only
-    // the files with these file types will be transformed. If empty, all
-    // supported files will be transformed. Supported types may be automatically
-    // added over time. If a file type is set in this field that isn't supported
-    // by the Deidentify action then the job will fail and will not be
-    // successfully created/started. Currently the only file types supported
-    // are: IMAGES, TEXT_FILES, CSV, TSV.
+    // the files with these file types are transformed. If empty, all
+    // supported files are transformed. Supported types may be automatically
+    // added over time. Any unsupported file types that are set in this field
+    // are excluded from de-identification. An error is recorded for each
+    // unsupported file in the TransformationDetails output table. Currently the
+    // only file types supported are: IMAGES, TEXT_FILES, CSV, TSV.
     repeated FileType file_types_to_transform = 8;
   }
 
@@ -7363,6 +7392,7 @@ message ListTableDataProfilesRequest {
   //     - `resource_visibility`: PUBLIC|RESTRICTED
   //     - `status_code` - an RPC status code as defined in
   //     https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto
+  //
   // * The operator must be `=` or `!=`.
   //
   // Examples:
@@ -7628,7 +7658,8 @@ message TableDataProfile {
   // May be empty if the profile is still being generated.
   ProfileStatus profile_status = 21;
 
-  // State of a profile.
+  // State of a profile. This will always be set to DONE when the table data
+  // profile is written to another service like BigQuery or Pub/Sub.
   State state = 22;
 
   // The sensitivity score of this table.
@@ -7690,6 +7721,9 @@ message TableDataProfile {
 
   // Resources related to this profile.
   repeated RelatedResource related_resources = 41;
+
+  // Domains associated with the profile.
+  repeated Domain domains = 47;
 }
 
 // Success or errors for the profile generation.
@@ -8069,6 +8103,9 @@ message FileStoreDataProfile {
 
   // Resources related to this profile.
   repeated RelatedResource related_resources = 26;
+
+  // Domains associated with the profile.
+  repeated Domain domains = 27;
 }
 
 // A tag associated with a resource.
@@ -8234,6 +8271,7 @@ message ListFileStoreDataProfilesRequest {
   //     - `resource_visibility`: PUBLIC|RESTRICTED
   //     - `status_code` - an RPC status code as defined in
   //     https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto
+  //
   // * The operator must be `=` or `!=`.
   //
   // Examples:
@@ -8679,32 +8717,102 @@ message FileClusterType {
 // image OCR is only provided in limited regions but configuring
 // ProcessingLocation will redirect OCR to a location where OCR is provided.
 message ProcessingLocation {
-  // Processing will happen in a multi-region that contains the current region
+  // Processing occurs in a multi-region that contains the current region
   // if available.
   message MultiRegionProcessing {}
 
-  // Processing will happen in the global region.
+  // Processing occurs in the global region.
   message GlobalProcessing {}
 
-  // Configure image processing to fall back to the configured processing option
-  // below if unavailable in the request location.
+  // Configure image processing to fall back to any of the following processing
+  // options if image processing is unavailable in the original request
+  // location.
   message ImageFallbackLocation {
-    // Processing will happen in a multi-region that contains the current region
+    // Processing occurs in a multi-region that contains the current region
     // if available.
     MultiRegionProcessing multi_region_processing = 100;
 
-    // Processing will happen in the global region.
+    // Processing occurs in the global region.
     GlobalProcessing global_processing = 200;
   }
 
-  // Image processing will fall back using this configuration.
+  // Configure document processing to fall back to any of the following
+  // processing options if document processing is unavailable in the original
+  // request location.
+  message DocumentFallbackLocation {
+    // Processing occurs in a multi-region that contains the current region
+    // if available.
+    MultiRegionProcessing multi_region_processing = 100;
+
+    // Processing occurs in the global region.
+    GlobalProcessing global_processing = 200;
+  }
+
+  // Image processing falls back using this configuration.
   ImageFallbackLocation image_fallback_location = 1;
+
+  // Document processing falls back using this configuration.
+  DocumentFallbackLocation document_fallback_location = 2;
 }
 
 // Collection of findings saved to a Cloud Storage bucket. This is used as the
 // proto schema for textproto files created when specifying a cloud storage
-// path to save inspection findings.
+// path to save Inspect findings.
 message SaveToGcsFindingsOutput {
   // List of findings.
   repeated Finding findings = 1;
 }
+
+// A domain represents a thematic category that a data profile can fall under.
+message Domain {
+  // This enum defines the various domain categories a data profile can fall
+  // under.
+  enum Category {
+    // Category unspecified.
+    CATEGORY_UNSPECIFIED = 0;
+
+    // Indicates that the data profile is related to artificial intelligence.
+    // When set, all findings stored to Security Command Center will set the
+    // corresponding AI domain field of `Finding` objects.
+    AI = 1;
+
+    // Indicates that the data profile is related to code.
+    CODE = 2;
+  }
+
+  // The signal used to determine the category.
+  // This list may increase over time.
+  enum Signal {
+    // Unused.
+    SIGNAL_UNSPECIFIED = 0;
+
+    // One or more machine learning models are present.
+    MODEL = 1;
+
+    // A table appears to be a text embedding.
+    TEXT_EMBEDDING = 2;
+
+    // The [Cloud SQL Vertex
+    // AI](https://cloud.google.com/sql/docs/postgres/integrate-cloud-sql-with-vertex-ai)
+    // plugin is installed on the database.
+    VERTEX_PLUGIN = 3;
+
+    // Support for [Cloud SQL vector
+    // embeddings](https://cloud.google.com/sql/docs/mysql/enable-vector-search)
+    // is enabled on the database.
+    VECTOR_PLUGIN = 4;
+
+    // Source code is present.
+    SOURCE_CODE = 5;
+
+    // If the service determines the category type. For example, Vertex AI
+    // assets would always have a `Category` of `AI`.
+    SERVICE = 6;
+  }
+
+  // A domain category that this profile is related to.
+  Category category = 1;
+
+  // The collection of signals that influenced selection of the category.
+  repeated Signal signals = 2;
+}
