feat: Added BigQueryDateShardedSpec.latest_shard_resource field

Google APIs · copybara-github · commit cbba92c063e7 · 2021-11-08T01:20:06.000-08:00
feat: Added SearchCatalogResult.display_name field
feat: Added SearchCatalogResult.description field

PiperOrigin-RevId: 408274419
diff --git a/google/cloud/datacatalog/v1/common.proto b/google/cloud/datacatalog/v1/common.proto
@@ -16,6 +16,8 @@ syntax = "proto3";
 
 package google.cloud.datacatalog.v1;
 
+import "google/protobuf/timestamp.proto";
+
 option cc_enable_arenas = true;
 option csharp_namespace = "Google.Cloud.DataCatalog.V1";
 option go_package = "google.golang.org/genproto/googleapis/cloud/datacatalog/v1;datacatalog";
diff --git a/google/cloud/datacatalog/v1/datacatalog.proto b/google/cloud/datacatalog/v1/datacatalog.proto
@@ -226,6 +226,10 @@ service DataCatalog {
   }
 
   // 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].
   rpc ListEntries(ListEntriesRequest) returns (ListEntriesResponse) {
     option (google.api.http) = {
       get: "/v1/{parent=projects/*/locations/*/entryGroups/*}/entries"
@@ -566,7 +570,7 @@ message SearchCatalogRequest {
 
   // 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).
+  // [Data Catalog search 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.
@@ -1224,11 +1228,16 @@ message UpdateTagTemplateRequest {
   TagTemplate tag_template = 1 [(google.api.field_behavior) = REQUIRED];
 
   // Names of fields whose values to overwrite on a tag template. Currently,
-  // only `display_name` can be overwritten.
+  // 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.
   google.protobuf.FieldMask update_mask = 2;
 }
 
@@ -1359,7 +1368,7 @@ message UpdateTagTemplateFieldRequest {
 // Request message for
 // [RenameTagTemplateField][google.cloud.datacatalog.v1.DataCatalog.RenameTagTemplateField].
 message RenameTagTemplateFieldRequest {
-  // Required. The name of the tag template.
+  // Required. The name of the tag template field.
   string name = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
diff --git a/google/cloud/datacatalog/v1/policytagmanager.proto b/google/cloud/datacatalog/v1/policytagmanager.proto
@@ -269,8 +269,7 @@ message PolicyTag {
 
   // 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 />
+  // The policy tag manager generates unique taxonomy IDs and policy tag IDs.
   string name = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
 
   // Required. User-defined name of this policy tag.
@@ -391,8 +390,7 @@ message GetTaxonomyRequest {
 // Request message for
 // [CreatePolicyTag][google.cloud.datacatalog.v1.PolicyTagManager.CreatePolicyTag].
 message CreatePolicyTagRequest {
-  // Required. Resource name of the taxonomy that the policy tag will belong to.<br /><br
-  // />
+  // Required. Resource name of the taxonomy that the policy tag will belong to.
   string parent = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
diff --git a/google/cloud/datacatalog/v1/search.proto b/google/cloud/datacatalog/v1/search.proto
@@ -94,6 +94,13 @@ message SearchCatalogResult {
   //
   // `dataproc_metastore:PROJECT_ID.LOCATION_ID.INSTANCE_ID.DATABASE_ID.TABLE_ID`
   string fully_qualified_name = 10;
+
+  // The display name of the result.
+  string display_name = 12;
+
+  // Entry description that can consist of several sentences or paragraphs that
+  // describe entry contents.
+  string description = 13;
 }
 
 // The resource types that can be returned in search results.
diff --git a/google/cloud/datacatalog/v1/table_spec.proto b/google/cloud/datacatalog/v1/table_spec.proto
@@ -108,4 +108,7 @@ message BigQueryDateShardedSpec {
 
   // Output only. Total number of shards.
   int64 shard_count = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. BigQuery resource name of the latest shard.
+  string latest_shard_resource = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
 }

Original file line number	Diff line number	Diff line change
`@@ -108,4 +108,7 @@ message BigQueryDateShardedSpec {`
`108`	`108`
`109`	`109`	`// Output only. Total number of shards.`
`110`	`110`	`int64 shard_count = 3 [(google.api.field_behavior) = OUTPUT_ONLY];`
	`111`	`+`
	`112`	`+ // Output only. BigQuery resource name of the latest shard.`
	`113`	`+ string latest_shard_resource = 4 [(google.api.field_behavior) = OUTPUT_ONLY];`
`111`	`114`	`}`