feat: Added BigQueryDateShardedSpec.latest_shard_resource field (#256)

- [ ] Regenerate this pull request now. PiperOrigin-RevId: 408274419 Source-Link: googleapis/googleapis@cbba92c Source-Link: googleapis/googleapis-gen@64b969f Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiNjRiOTY5ZjEyOTlmNTcyZmJiMjY5NTMwY2JjNDU0OTY2YjE0ODUxZCJ9 feat: Added SearchCatalogResult.display_name field feat: Added SearchCatalogResult.description field
googleapis · Nov 8, 2021 · 36019b6 · 36019b6
1 parent 0dcc0c3
commit 36019b6
Show file tree

Hide file tree

Showing 10 changed files with 62 additions and 15 deletions.
diff --git a/google/cloud/datacatalog_v1/services/data_catalog/async_client.py b/google/cloud/datacatalog_v1/services/data_catalog/async_client.py
@@ -235,7 +235,7 @@ async def search_catalog(
                 Optional. The query string with a minimum of 3
                 characters and specific syntax. For more information,
                 see `Data Catalog search
-                syntax <https://cloud.google.com/data-catalog/docs/how-to/search-reference>`__.
+                syntax </data-catalog/docs/how-to/search-reference>`__.
 
                 An empty query string returns all data assets (in the
                 specified scope) that you have access to.
@@ -1269,6 +1269,10 @@ async def list_entries(
     ) -> pagers.ListEntriesAsyncPager:
         r"""Lists entries.
 
+        Note: Currently, this method can list only custom entries. To
+        get a list of both custom and automatically created entries, use
+        [SearchCatalog][google.cloud.datacatalog.v1.DataCatalog.SearchCatalog].
+
         Args:
             request (Union[google.cloud.datacatalog_v1.types.ListEntriesRequest, dict]):
                 The request object. Request message for
@@ -1570,14 +1574,20 @@ async def update_tag_template(
                 should not be set.
             update_mask (:class:`google.protobuf.field_mask_pb2.FieldMask`):
                 Names of fields whose values to overwrite on a tag
-                template. Currently, only ``display_name`` can be
-                overwritten.
+                template. Currently, only ``display_name`` and
+                ``is_publicly_readable`` can be overwritten.
 
                 If this parameter is absent or empty, all modifiable
                 fields are overwritten. If such fields are non-required
                 and omitted in the request body, their values are
                 emptied.
 
+                Note: Updating the ``is_publicly_readable`` field may
+                require up to 12 hours to take effect in search results.
+                Additionally, it also requires the
+                ``tagTemplates.getIamPolicy`` and
+                ``tagTemplates.setIamPolicy`` permissions.
+
                 This corresponds to the ``update_mask`` field
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.
@@ -1964,7 +1974,7 @@ async def rename_tag_template_field(
                 [RenameTagTemplateField][google.cloud.datacatalog.v1.DataCatalog.RenameTagTemplateField].
             name (:class:`str`):
                 Required. The name of the tag
-                template.
+                template field.
 
                 This corresponds to the ``name`` field
                 on the ``request`` instance; if ``request`` is provided, this

diff --git a/google/cloud/datacatalog_v1/services/data_catalog/client.py b/google/cloud/datacatalog_v1/services/data_catalog/client.py
@@ -505,7 +505,7 @@ def search_catalog(
                 Optional. The query string with a minimum of 3
                 characters and specific syntax. For more information,
                 see `Data Catalog search
-                syntax <https://cloud.google.com/data-catalog/docs/how-to/search-reference>`__.
+                syntax </data-catalog/docs/how-to/search-reference>`__.
 
                 An empty query string returns all data assets (in the
                 specified scope) that you have access to.
@@ -1495,6 +1495,10 @@ def list_entries(
     ) -> pagers.ListEntriesPager:
         r"""Lists entries.
 
+        Note: Currently, this method can list only custom entries. To
+        get a list of both custom and automatically created entries, use
+        [SearchCatalog][google.cloud.datacatalog.v1.DataCatalog.SearchCatalog].
+
         Args:
             request (Union[google.cloud.datacatalog_v1.types.ListEntriesRequest, dict]):
                 The request object. Request message for
@@ -1787,14 +1791,20 @@ def update_tag_template(
                 should not be set.
             update_mask (google.protobuf.field_mask_pb2.FieldMask):
                 Names of fields whose values to overwrite on a tag
-                template. Currently, only ``display_name`` can be
-                overwritten.
+                template. Currently, only ``display_name`` and
+                ``is_publicly_readable`` can be overwritten.
 
                 If this parameter is absent or empty, all modifiable
                 fields are overwritten. If such fields are non-required
                 and omitted in the request body, their values are
                 emptied.
 
+                Note: Updating the ``is_publicly_readable`` field may
+                require up to 12 hours to take effect in search results.
+                Additionally, it also requires the
+                ``tagTemplates.getIamPolicy`` and
+                ``tagTemplates.setIamPolicy`` permissions.
+
                 This corresponds to the ``update_mask`` field
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.
@@ -2185,7 +2195,7 @@ def rename_tag_template_field(
                 [RenameTagTemplateField][google.cloud.datacatalog.v1.DataCatalog.RenameTagTemplateField].
             name (str):
                 Required. The name of the tag
-                template.
+                template field.
 
                 This corresponds to the ``name`` field
                 on the ``request`` instance; if ``request`` is provided, this

diff --git a/google/cloud/datacatalog_v1/services/data_catalog/transports/grpc.py b/google/cloud/datacatalog_v1/services/data_catalog/transports/grpc.py
@@ -608,6 +608,10 @@ def list_entries(
 
         Lists entries.
 
+        Note: Currently, this method can list only custom entries. To
+        get a list of both custom and automatically created entries, use
+        [SearchCatalog][google.cloud.datacatalog.v1.DataCatalog.SearchCatalog].
+
         Returns:
             Callable[[~.ListEntriesRequest],
                     ~.ListEntriesResponse]:

diff --git a/google/cloud/datacatalog_v1/services/data_catalog/transports/grpc_asyncio.py b/google/cloud/datacatalog_v1/services/data_catalog/transports/grpc_asyncio.py
@@ -621,6 +621,10 @@ def list_entries(
 
         Lists entries.
 
+        Note: Currently, this method can list only custom entries. To
+        get a list of both custom and automatically created entries, use
+        [SearchCatalog][google.cloud.datacatalog.v1.DataCatalog.SearchCatalog].
+
         Returns:
             Callable[[~.ListEntriesRequest],
                     Awaitable[~.ListEntriesResponse]]:

diff --git a/google/cloud/datacatalog_v1/services/policy_tag_manager/async_client.py b/google/cloud/datacatalog_v1/services/policy_tag_manager/async_client.py
@@ -600,7 +600,7 @@ async def create_policy_tag(
             parent (:class:`str`):
                 Required. Resource name of the
                 taxonomy that the policy tag will belong
-                to.<br /><br />
+                to.
 
                 This corresponds to the ``parent`` field
                 on the ``request`` instance; if ``request`` is provided, this

diff --git a/google/cloud/datacatalog_v1/services/policy_tag_manager/client.py b/google/cloud/datacatalog_v1/services/policy_tag_manager/client.py
@@ -805,7 +805,7 @@ def create_policy_tag(
             parent (str):
                 Required. Resource name of the
                 taxonomy that the policy tag will belong
-                to.<br /><br />
+                to.
 
                 This corresponds to the ``parent`` field
                 on the ``request`` instance; if ``request`` is provided, this

diff --git a/google/cloud/datacatalog_v1/types/datacatalog.py b/google/cloud/datacatalog_v1/types/datacatalog.py
@@ -102,7 +102,7 @@ class SearchCatalogRequest(proto.Message):
             Optional. The query string with a minimum of 3 characters
             and specific syntax. For more information, see `Data Catalog
             search
-            syntax <https://cloud.google.com/data-catalog/docs/how-to/search-reference>`__.
+            syntax </data-catalog/docs/how-to/search-reference>`__.
 
             An empty query string returns all data assets (in the
             specified scope) that you have access to.
@@ -950,11 +950,18 @@ class UpdateTagTemplateRequest(proto.Message):
             set.
         update_mask (google.protobuf.field_mask_pb2.FieldMask):
             Names of fields whose values to overwrite on a tag template.
-            Currently, only ``display_name`` can be overwritten.
+            Currently, only ``display_name`` and
+            ``is_publicly_readable`` can be overwritten.
 
             If this parameter is absent or empty, all modifiable fields
             are overwritten. If such fields are non-required and omitted
             in the request body, their values are emptied.
+
+            Note: Updating the ``is_publicly_readable`` field may
+            require up to 12 hours to take effect in search results.
+            Additionally, it also requires the
+            ``tagTemplates.getIamPolicy`` and
+            ``tagTemplates.setIamPolicy`` permissions.
     """
 
     tag_template = proto.Field(proto.MESSAGE, number=1, message=gcd_tags.TagTemplate,)
@@ -1114,7 +1121,7 @@ class RenameTagTemplateFieldRequest(proto.Message):
 
     Attributes:
         name (str):
-            Required. The name of the tag template.
+            Required. The name of the tag template field.
         new_tag_template_field_id (str):
             Required. The new ID of this tag template field. For
             example, ``my_new_field``.

diff --git a/google/cloud/datacatalog_v1/types/policytagmanager.py b/google/cloud/datacatalog_v1/types/policytagmanager.py
@@ -131,7 +131,7 @@ class PolicyTag(proto.Message):
             Output only. Resource name of this policy tag
             in the URL format.
             The policy tag manager generates unique taxonomy
-            IDs and policy tag IDs.<br /><br />
+            IDs and policy tag IDs.
         display_name (str):
             Required. User-defined name of this policy
             tag.
@@ -285,7 +285,7 @@ class CreatePolicyTagRequest(proto.Message):
     Attributes:
         parent (str):
             Required. Resource name of the taxonomy that
-            the policy tag will belong to.<br /><br />
+            the policy tag will belong to.
         policy_tag (google.cloud.datacatalog_v1.types.PolicyTag):
             The policy tag to create.
     """

diff --git a/google/cloud/datacatalog_v1/types/search.py b/google/cloud/datacatalog_v1/types/search.py
@@ -105,6 +105,12 @@ class SearchCatalogResult(proto.Message):
             Example for a DPMS table:
 
             ``dataproc_metastore:PROJECT_ID.LOCATION_ID.INSTANCE_ID.DATABASE_ID.TABLE_ID``
+        display_name (str):
+            The display name of the result.
+        description (str):
+            Entry description that can consist of several
+            sentences or paragraphs that describe entry
+            contents.
     """
 
     search_result_type = proto.Field(proto.ENUM, number=1, enum="SearchResultType",)
@@ -117,6 +123,8 @@ class SearchCatalogResult(proto.Message):
     )
     user_specified_system = proto.Field(proto.STRING, number=9, oneof="system",)
     fully_qualified_name = proto.Field(proto.STRING, number=10,)
+    display_name = proto.Field(proto.STRING, number=12,)
+    description = proto.Field(proto.STRING, number=13,)
 
 
 __all__ = tuple(sorted(__protobuf__.manifest))
diff --git a/google/cloud/datacatalog_v1/types/table_spec.py b/google/cloud/datacatalog_v1/types/table_spec.py
@@ -121,11 +121,15 @@ class BigQueryDateShardedSpec(proto.Message):
             ``table_prefix`` is ``MyTable``.
         shard_count (int):
             Output only. Total number of shards.
+        latest_shard_resource (str):
+            Output only. BigQuery resource name of the
+            latest shard.
     """
 
     dataset = proto.Field(proto.STRING, number=1,)
     table_prefix = proto.Field(proto.STRING, number=2,)
     shard_count = proto.Field(proto.INT64, number=3,)
+    latest_shard_resource = proto.Field(proto.STRING, number=4,)
 
 
 __all__ = tuple(sorted(__protobuf__.manifest))