feat: [google-cloud-dlp] discovery of BigQuery snapshots (#13172)

- [ ] Regenerate this pull request now.

docs: documentation revisions for data profiles
PiperOrigin-RevId: 686533927

Source-Link:
googleapis/googleapis@4c44b30

Source-Link:
googleapis/googleapis-gen@51494a6
Copy-Tag:
eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWRscC8uT3dsQm90LnlhbWwiLCJoIjoiNTE0OTRhNjA0ZTY2NTY0MDYxMThhMjkxMWJkNDg0YWExNDM4MmRmNyJ9

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
Co-authored-by: Victor Chudnovsky <vchudnov@google.com>

Author: gcf-owl-bot[bot]

packages/google-cloud-dlp/google/cloud/dlp_v2/services/dlp_service/async_client.py

@@ -55,16 +55,11 @@
 
 
 class DlpServiceAsyncClient:
-    """The Cloud Data Loss Prevention (DLP) API is a service that
-    allows clients to detect the presence of Personally Identifiable
-    Information (PII) and other privacy-sensitive data in
-    user-supplied, unstructured data streams, like text 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
+    """Sensitive Data Protection provides access to a powerful
+    sensitive data inspection, classification, and de-identification
+    platform that works on text, images, and Google Cloud storage
+    repositories. To learn more about concepts and find how-to
+    guides see
     https://cloud.google.com/sensitive-data-protection/docs/.
     """
 

packages/google-cloud-dlp/google/cloud/dlp_v2/services/dlp_service/client.py

@@ -97,16 +97,11 @@ def get_transport_class(
 
 
 class DlpServiceClient(metaclass=DlpServiceClientMeta):
-    """The Cloud Data Loss Prevention (DLP) API is a service that
-    allows clients to detect the presence of Personally Identifiable
-    Information (PII) and other privacy-sensitive data in
-    user-supplied, unstructured data streams, like text 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
+    """Sensitive Data Protection provides access to a powerful
+    sensitive data inspection, classification, and de-identification
+    platform that works on text, images, and Google Cloud storage
+    repositories. To learn more about concepts and find how-to
+    guides see
     https://cloud.google.com/sensitive-data-protection/docs/.
     """
 

packages/google-cloud-dlp/google/cloud/dlp_v2/services/dlp_service/transports/grpc.py

@@ -32,16 +32,11 @@
 class DlpServiceGrpcTransport(DlpServiceTransport):
     """gRPC backend transport for DlpService.
 
-    The Cloud Data Loss Prevention (DLP) API is a service that
-    allows clients to detect the presence of Personally Identifiable
-    Information (PII) and other privacy-sensitive data in
-    user-supplied, unstructured data streams, like text 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
+    Sensitive Data Protection provides access to a powerful
+    sensitive data inspection, classification, and de-identification
+    platform that works on text, images, and Google Cloud storage
+    repositories. To learn more about concepts and find how-to
+    guides see
     https://cloud.google.com/sensitive-data-protection/docs/.
 
     This class defines the same methods as the primary client, so the

packages/google-cloud-dlp/google/cloud/dlp_v2/services/dlp_service/transports/grpc_asyncio.py

@@ -36,16 +36,11 @@
 class DlpServiceGrpcAsyncIOTransport(DlpServiceTransport):
     """gRPC AsyncIO backend transport for DlpService.
 
-    The Cloud Data Loss Prevention (DLP) API is a service that
-    allows clients to detect the presence of Personally Identifiable
-    Information (PII) and other privacy-sensitive data in
-    user-supplied, unstructured data streams, like text 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
+    Sensitive Data Protection provides access to a powerful
+    sensitive data inspection, classification, and de-identification
+    platform that works on text, images, and Google Cloud storage
+    repositories. To learn more about concepts and find how-to
+    guides see
     https://cloud.google.com/sensitive-data-protection/docs/.
 
     This class defines the same methods as the primary client, so the

packages/google-cloud-dlp/google/cloud/dlp_v2/services/dlp_service/transports/rest.py

@@ -1555,16 +1555,11 @@ class DlpServiceRestStub:
 class DlpServiceRestTransport(_BaseDlpServiceRestTransport):
     """REST backend synchronous transport for DlpService.
 
-    The Cloud Data Loss Prevention (DLP) API is a service that
-    allows clients to detect the presence of Personally Identifiable
-    Information (PII) and other privacy-sensitive data in
-    user-supplied, unstructured data streams, like text 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
+    Sensitive Data Protection provides access to a powerful
+    sensitive data inspection, classification, and de-identification
+    platform that works on text, images, and Google Cloud storage
+    repositories. To learn more about concepts and find how-to
+    guides see
     https://cloud.google.com/sensitive-data-protection/docs/.
 
     This class defines the same methods as the primary client, so the

packages/google-cloud-dlp/google/cloud/dlp_v2/types/dlp.py

@@ -426,7 +426,7 @@ class ProfileGeneration(proto.Enum):
 
 class BigQueryTableTypeCollection(proto.Enum):
     r"""Over time new types may be added. Currently VIEW, MATERIALIZED_VIEW,
-    and SNAPSHOT are not supported.
+    and non-BigLake external tables are not supported.
 
     Values:
         BIG_QUERY_COLLECTION_UNSPECIFIED (0):
@@ -453,7 +453,7 @@ class BigQueryTableTypeCollection(proto.Enum):
 
 class BigQueryTableType(proto.Enum):
     r"""Over time new types may be added. Currently VIEW, MATERIALIZED_VIEW,
-    SNAPSHOT, and non-BigLake external tables are not supported.
+    and non-BigLake external tables are not supported.
 
     Values:
         BIG_QUERY_TABLE_TYPE_UNSPECIFIED (0):
@@ -463,10 +463,13 @@ class BigQueryTableType(proto.Enum):
         BIG_QUERY_TABLE_TYPE_EXTERNAL_BIG_LAKE (2):
             A table that references data stored in Cloud
             Storage.
+        BIG_QUERY_TABLE_TYPE_SNAPSHOT (3):
+            A snapshot of a BigQuery table.
     """
     BIG_QUERY_TABLE_TYPE_UNSPECIFIED = 0
     BIG_QUERY_TABLE_TYPE_TABLE = 1
     BIG_QUERY_TABLE_TYPE_EXTERNAL_BIG_LAKE = 2
+    BIG_QUERY_TABLE_TYPE_SNAPSHOT = 3
 
 
 class DataProfileUpdateFrequency(proto.Enum):
@@ -11928,12 +11931,12 @@ class TableDataProfile(proto.Message):
             https://cloud.google.com/bigquery/docs/locations
             for supported locations.
         dataset_id (str):
-            If the resource is BigQuery, the  dataset ID.
+            If the resource is BigQuery, the dataset ID.
         table_id (str):
-            If the resource is BigQuery, the BigQuery
-            table ID.
+            The table ID.
         full_resource (str):
-            The resource name of the resource profiled.
+            The Cloud Asset Inventory resource that was profiled in
+            order to generate this TableDataProfile.
             https://cloud.google.com/apis/design/resource_names#full_resource_name
         profile_status (google.cloud.dlp_v2.types.ProfileStatus):
             Success or error status from the most recent
@@ -12219,14 +12222,15 @@ class ColumnDataProfile(proto.Message):
             The Google Cloud project ID that owns the
             profiled resource.
         dataset_location (str):
-            The BigQuery location where the dataset's
-            data is stored. See
+            If supported, the location where the
+            dataset's data is stored. See
             https://cloud.google.com/bigquery/docs/locations
-            for supported locations.
+            for supported BigQuery locations.
         dataset_id (str):
-            The BigQuery dataset ID.
+            The BigQuery dataset ID, if the resource
+            profiled is a BigQuery table.
         table_id (str):
-            The BigQuery table ID.
+            The table ID.
         column (str):
             The name of the column.
         sensitivity_score (google.cloud.dlp_v2.types.SensitivityScore):