Update docstrings (via synth). (#8299)

Author: yoshi-automation

datacatalog/google/cloud/datacatalog_v1beta1/gapic/data_catalog_client.py

@@ -254,8 +254,14 @@ def search_catalog(
         return the complete resource, only the resource identifier and high
         level fields. Clients can subsequentally call Get methods.
 
+        Note that searches do not have full recall. There may be results that
+        match your query but are not returned, even in subsequent pages of
+        results. These missing results may vary across repeated calls to search.
+        Do not rely on this method if you need to guarantee full recall.
+
         See `Data Catalog Search
         Syntax <https://cloud.google.com/data-catalog/docs/how-to/search-reference>`__
+        for more information.
 
         Example:
             >>> from google.cloud import datacatalog_v1beta1
@@ -315,8 +321,7 @@ def search_catalog(
                       <li> last_access_timestamp [asc|desc], defaults to descending if not
                       specified, </li>
                       <li> last_modified_timestamp [asc|desc], defaults to descending if not
-                      specified, </li>
-                      <li> title [asc|desc], defaults to ascending if not specified. </li>
+                      specified. </li>
                     </ul>
             retry (Optional[google.api_core.retry.Retry]):  A retry object used
                 to retry requests. If ``None`` is specified, requests will not
@@ -645,7 +650,9 @@ def create_tag_template(
 
         Args:
             parent (str): Required. The name of the project and the location this template is in.
-                Example: "projects/{project\_id}/locations/{location}".
+                Example: "projects/{project\_id}/locations/{location}". Note that this
+                TagTemplate and its child resources may not actually be stored in the
+                location in this name.
             tag_template_id (str): Required. The id of the tag template to create.
             tag_template (Union[dict, ~google.cloud.datacatalog_v1beta1.types.TagTemplate]): Required. The tag template to create.
 
@@ -965,6 +972,8 @@ def create_tag_template_field(
         Args:
             parent (str): Required. The name of the project this template is in. Example:
                 "projects/{project\_id}/locations/{location}/tagTemplates/{tag\_template\_id}".
+                Note that this TagTemplateField may not actually be stored in the
+                location in this name.
             tag_template_field_id (str): Required. The id of the tag template field to create. Field ids can
                 contain letters (both uppercase and lowercase), numbers (0-9),
                 underscores (\_) and dashes (-). Field ids must be at least 1 character
@@ -1302,6 +1311,8 @@ def create_tag(
             parent (str): Required. The name of the resource to attach this tag to. Tags can be
                 attached to Entries. (example:
                 "projects/{project\_id}/locations/{location}/entryGroups/{entry\_group\_id}/entries/{entry\_id}").
+                Note that this Tag and its child resources may not actually be stored in
+                the location in this name.
             tag (Union[dict, ~google.cloud.datacatalog_v1beta1.types.Tag]): Required. The tag to create.
 
                 If a dict is provided, it must be of the same form as the protobuf

datacatalog/google/cloud/datacatalog_v1beta1/gapic/transports/data_catalog_grpc_transport.py

@@ -108,8 +108,14 @@ def search_catalog(self):
         return the complete resource, only the resource identifier and high
         level fields. Clients can subsequentally call Get methods.
 
+        Note that searches do not have full recall. There may be results that
+        match your query but are not returned, even in subsequent pages of
+        results. These missing results may vary across repeated calls to search.
+        Do not rely on this method if you need to guarantee full recall.
+
         See `Data Catalog Search
         Syntax <https://cloud.google.com/data-catalog/docs/how-to/search-reference>`__
+        for more information.
 
         Returns:
             Callable: A callable which accepts the appropriate

datacatalog/google/cloud/datacatalog_v1beta1/proto/datacatalog.proto

@@ -48,8 +48,13 @@ service DataCatalog {
   // the complete resource, only the resource identifier and high level
   // fields. Clients can subsequentally call Get methods.
   //
+  // Note that searches do not have full recall. There may be results that match
+  // your query but are not returned, even in subsequent pages of results. These
+  // missing results may vary across repeated calls to search. Do not rely on
+  // this method if you need to guarantee full recall.
+  //
   // See [Data Catalog Search
-  // Syntax](/data-catalog/docs/how-to/search-reference)
+  // Syntax](/data-catalog/docs/how-to/search-reference) for more information.
   rpc SearchCatalog(SearchCatalogRequest) returns (SearchCatalogResponse) {
     option (google.api.http) = {
       post: "/v1beta1/catalog:search"
@@ -294,8 +299,7 @@ message SearchCatalogRequest {
   //   <li> last_access_timestamp [asc|desc], defaults to descending if not
   //   specified, </li>
   //   <li> last_modified_timestamp [asc|desc], defaults to descending if not
-  //   specified, </li>
-  //   <li> title [asc|desc], defaults to ascending if not specified. </li>
+  //   specified. </li>
   // </ul>
   string order_by = 5;
 }
@@ -384,6 +388,8 @@ message Entry {
   // [UpdateEntryRequest][google.cloud.datacatalog.v1beta1.UpdateEntryRequest].
   // The Data Catalog resource name of the entry in URL format. For example,
   // "projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id}".
+  // Note that this Entry and its child resources may not actually be stored in
+  // the location in this name.
   string name = 1;
 
   // Output only. The full name of the cloud resource the entry belongs to. See:
@@ -433,7 +439,9 @@ message Entry {
 // [CreateTagTemplate][google.cloud.datacatalog.v1beta1.DataCatalog.CreateTagTemplate].
 message CreateTagTemplateRequest {
   // Required. The name of the project and the location this template is in.
-  // Example: "projects/{project_id}/locations/{location}".
+  // Example: "projects/{project_id}/locations/{location}". Note that this
+  // TagTemplate and its child resources may not actually be stored in the
+  // location in this name.
   string parent = 1;
 
   // Required. The id of the tag template to create.
@@ -487,6 +495,8 @@ message CreateTagRequest {
   // The name of the resource to attach this tag to. Tags can be attached to
   // Entries. (example:
   // "projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id}").
+  // Note that this Tag and its child resources may not actually be stored in
+  // the location in this name.
   string parent = 1;
 
   // Required. The tag to create.
@@ -518,6 +528,8 @@ message DeleteTagRequest {
 message CreateTagTemplateFieldRequest {
   // Required. The name of the project this template is in. Example:
   // "projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id}".
+  // Note that this TagTemplateField may not actually be stored in the location
+  // in this name.
   string parent = 1;
 
   // Required. The id of the tag template field to create.

datacatalog/google/cloud/datacatalog_v1beta1/proto/datacatalog_pb2.py

@@ -134,8 +134,13 @@ def SearchCatalog(self, request, context):
     the complete resource, only the resource identifier and high level
     fields. Clients can subsequentally call Get methods.
 
+    Note that searches do not have full recall. There may be results that match
+    your query but are not returned, even in subsequent pages of results. These
+    missing results may vary across repeated calls to search. Do not rely on
+    this method if you need to guarantee full recall.
+
     See [Data Catalog Search
-    Syntax](/data-catalog/docs/how-to/search-reference)
+    Syntax](/data-catalog/docs/how-to/search-reference) for more information.
     """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details("Method not implemented!")

datacatalog/google/cloud/datacatalog_v1beta1/proto/datacatalog_pb2_grpc.py

@@ -31,7 +31,8 @@ message Tag {
   // [UpdateTagRequest][google.cloud.datacatalog.v1beta1.UpdateTagRequest]. The
   // resource name of the tag in URL format. For example,
   // projects/{project_id}/locations/{location}/entrygroups/{entry_group_id}/entries/{entry_id}/tags/{tag_id}",
-  // where tag_id is a system-generated identifier.
+  // where tag_id is a system-generated identifier. Note that this Tag may not
+  // actually be stored in the location in this name.
   string name = 1;
 
   // Required. The resource name of the tag template that this tag uses. For
@@ -102,6 +103,8 @@ message TagTemplate {
   // [UpdateTagTemplateRequest][google.cloud.datacatalog.v1beta1.UpdateTagTemplateRequest].
   // The resource name of the tag template in URL format. For example,
   // projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id}.
+  // Note that this TagTemplate and its child resources may not actually be
+  // stored in the location in this name.
   string name = 1;
 
   // Optional. The display name for this template. Default value is an empty

datacatalog/google/cloud/datacatalog_v1beta1/proto/tags.proto

@@ -1,19 +1,19 @@
 {
-  "updateTime": "2019-06-10T17:48:19.192741Z",
+  "updateTime": "2019-06-13T12:14:41.123707Z",
   "sources": [
     {
       "generator": {
         "name": "artman",
-        "version": "0.24.0",
-        "dockerImage": "googleapis/artman@sha256:ce425884865f57f18307e597bca1a74a3619b7098688d4995261f3ffb3488681"
+        "version": "0.24.1",
+        "dockerImage": "googleapis/artman@sha256:6018498e15310260dc9b03c9d576608908ed9fbabe42e1494ff3d827fea27b19"
       }
     },
     {
       "git": {
         "name": "googleapis",
         "remote": "https://github.com/googleapis/googleapis.git",
-        "sha": "a12347ec47a7f3d18e35f2effc4295c0b0983213",
-        "internalRef": "252108410"
+        "sha": "46bfd341116c385fd1671675f918da7d513b20c4",
+        "internalRef": "252913906"
       }
     },
     {