feat: add restricted_locations to v1; add order to TagField and TagTemplateField in v1beta1; rename field_path to tag_template_field_path in v1beta1; add pagination support to list_taxonomies in v1beta1

.kokoro/publish-docs.sh

@@ -13,8 +13,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-#!/bin/bash
-
 set -eo pipefail
 
 # Disable buffering, so that the logs stream through.

docs/index.rst

@@ -1,6 +1,6 @@
 .. include:: README.rst
 
-
+.. include:: multiprocessing.rst
 
 v1
 -------------

docs/multiprocessing.rst

@@ -0,0 +1,7 @@
+.. note::
+
+   Because this client uses :mod:`grpcio` library, it is safe to
+   share instances across threads. In multiprocessing scenarios, the best
+   practice is to create client instances *after* the invocation of
+   :func:`os.fork` by :class:`multiprocessing.Pool` or
+   :class:`multiprocessing.Process`.

google/cloud/datacatalog_v1/gapic/enums.py

@@ -21,7 +21,9 @@
 
 class EntryType(enum.IntEnum):
     """
-    Request message for ``DeleteTag``.
+    Entry resources in Data Catalog can be of different types e.g. a
+    BigQuery Table entry is of type ``TABLE``. This enum describes all the
+    possible types Data Catalog contains.
 
     Attributes:
       ENTRY_TYPE_UNSPECIFIED (int): Default unknown type.
@@ -64,16 +66,9 @@ class SearchResultType(enum.IntEnum):
 
     Attributes:
       SEARCH_RESULT_TYPE_UNSPECIFIED (int): Default unknown type.
-      ENTRY (int): Request message for ``GetEntryGroup``.
-      TAG_TEMPLATE (int): An indicator of the behavior of a given field (for example, that a
-      field is required in requests, or given as output but ignored as input).
-      This **does not** change the behavior in protocol buffers itself; it
-      only denotes the behavior and may affect how API tooling handles the
-      field.
-
-      Note: This enum **may** receive new values in the future.
-      ENTRY_GROUP (int): Required. The name of the entry group. For example,
-      ``projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}``.
+      ENTRY (int): An ``Entry``.
+      TAG_TEMPLATE (int): A ``TagTemplate``.
+      ENTRY_GROUP (int): An ``EntryGroup``.
     """
 
     SEARCH_RESULT_TYPE_UNSPECIFIED = 0

google/cloud/datacatalog_v1/proto/datacatalog_pb2_grpc.py

@@ -180,7 +180,8 @@ def SearchCatalog(self, request, context):
     across repeated search queries.
 
     See [Data Catalog Search
-    Syntax](/data-catalog/docs/how-to/search-reference) for more information.
+    Syntax](https://cloud.google.com/data-catalog/docs/how-to/search-reference)
+    for more information.
     """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details("Method not implemented!")
@@ -204,7 +205,8 @@ def CreateEntryGroup(self, request, context):
 
     Users should enable the Data Catalog API in the project identified by
     the `parent` parameter (see [Data Catalog Resource Project]
-    (/data-catalog/docs/concepts/resource-project) for more information).
+    (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for
+    more information).
     """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details("Method not implemented!")
@@ -220,8 +222,9 @@ def GetEntryGroup(self, request, context):
     def UpdateEntryGroup(self, request, context):
         """Updates an EntryGroup. The user should enable the Data Catalog API in the
     project identified by the `entry_group.name` parameter (see [Data Catalog
-    Resource Project] (/data-catalog/docs/concepts/resource-project) for more
-    information).
+    Resource Project]
+    (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for
+    more information).
     """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details("Method not implemented!")
@@ -231,7 +234,8 @@ def DeleteEntryGroup(self, request, context):
         """Deletes an EntryGroup. Only entry groups that do not contain entries can be
     deleted. Users should enable the Data Catalog API in the project
     identified by the `name` parameter (see [Data Catalog Resource Project]
-    (/data-catalog/docs/concepts/resource-project) for more information).
+    (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for
+    more information).
     """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details("Method not implemented!")
@@ -250,7 +254,8 @@ def CreateEntry(self, request, context):
 
     Users should enable the Data Catalog API in the project identified by
     the `parent` parameter (see [Data Catalog Resource Project]
-    (/data-catalog/docs/concepts/resource-project) for more information).
+    (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for
+    more information).
 
     A maximum of 100,000 entries may be created per entry group.
     """
@@ -262,7 +267,8 @@ def UpdateEntry(self, request, context):
         """Updates an existing entry.
     Users should enable the Data Catalog API in the project identified by
     the `entry.name` parameter (see [Data Catalog Resource Project]
-    (/data-catalog/docs/concepts/resource-project) for more information).
+    (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for
+    more information).
     """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details("Method not implemented!")
@@ -274,7 +280,8 @@ def DeleteEntry(self, request, context):
     method can be deleted.
     Users should enable the Data Catalog API in the project identified by
     the `name` parameter (see [Data Catalog Resource Project]
-    (/data-catalog/docs/concepts/resource-project) for more information).
+    (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for
+    more information).
     """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details("Method not implemented!")
@@ -306,8 +313,9 @@ def ListEntries(self, request, context):
     def CreateTagTemplate(self, request, context):
         """Creates a tag template. The user should enable the Data Catalog API in
     the project identified by the `parent` parameter (see [Data Catalog
-    Resource Project](/data-catalog/docs/concepts/resource-project) for more
-    information).
+    Resource
+    Project](https://cloud.google.com/data-catalog/docs/concepts/resource-project)
+    for more information).
     """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details("Method not implemented!")
@@ -326,7 +334,8 @@ def UpdateTagTemplate(self, request, context):
     and should be updated using their own create/update/delete methods.
     Users should enable the Data Catalog API in the project identified by
     the `tag_template.name` parameter (see [Data Catalog Resource Project]
-    (/data-catalog/docs/concepts/resource-project) for more information).
+    (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for
+    more information).
     """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details("Method not implemented!")
@@ -336,7 +345,8 @@ def DeleteTagTemplate(self, request, context):
         """Deletes a tag template and all tags using the template.
     Users should enable the Data Catalog API in the project identified by
     the `name` parameter (see [Data Catalog Resource Project]
-    (/data-catalog/docs/concepts/resource-project) for more information).
+    (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for
+    more information).
     """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details("Method not implemented!")
@@ -346,8 +356,8 @@ def CreateTagTemplateField(self, request, context):
         """Creates a field in a tag template. The user should enable the Data Catalog
     API in the project identified by the `parent` parameter (see
     [Data Catalog Resource
-    Project](/data-catalog/docs/concepts/resource-project) for more
-    information).
+    Project](https://cloud.google.com/data-catalog/docs/concepts/resource-project)
+    for more information).
     """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details("Method not implemented!")
@@ -357,7 +367,8 @@ def UpdateTagTemplateField(self, request, context):
         """Updates a field in a tag template. This method cannot be used to update the
     field type. Users should enable the Data Catalog API in the project
     identified by the `name` parameter (see [Data Catalog Resource Project]
-    (/data-catalog/docs/concepts/resource-project) for more information).
+    (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for
+    more information).
     """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details("Method not implemented!")
@@ -366,8 +377,9 @@ def UpdateTagTemplateField(self, request, context):
     def RenameTagTemplateField(self, request, context):
         """Renames a field in a tag template. The user should enable the Data Catalog
     API in the project identified by the `name` parameter (see [Data Catalog
-    Resource Project](/data-catalog/docs/concepts/resource-project) for more
-    information).
+    Resource
+    Project](https://cloud.google.com/data-catalog/docs/concepts/resource-project)
+    for more information).
     """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details("Method not implemented!")
@@ -377,7 +389,8 @@ def DeleteTagTemplateField(self, request, context):
         """Deletes a field in a tag template and all uses of that field.
     Users should enable the Data Catalog API in the project identified by
     the `name` parameter (see [Data Catalog Resource Project]
-    (/data-catalog/docs/concepts/resource-project) for more information).
+    (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for
+    more information).
     """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details("Method not implemented!")
@@ -386,10 +399,10 @@ def DeleteTagTemplateField(self, request, context):
     def CreateTag(self, request, context):
         """Creates a tag on an [Entry][google.cloud.datacatalog.v1.Entry].
     Note: The project identified by the `parent` parameter for the
-    [tag](/data-catalog/docs/reference/rest/v1/projects.locations.entryGroups.entries.tags/create#path-parameters)
+    [tag](https://cloud.google.com/data-catalog/docs/reference/rest/v1/projects.locations.entryGroups.entries.tags/create#path-parameters)
     and the
     [tag
-    template](/data-catalog/docs/reference/rest/v1/projects.locations.tagTemplates/create#path-parameters)
+    template](https://cloud.google.com/data-catalog/docs/reference/rest/v1/projects.locations.tagTemplates/create#path-parameters)
     used to create the tag must be from the same organization.
     """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)