docs: documentation updates

Google APIs · copybara-github · commit a6efcc9b7add · 2022-11-07T03:10:55.000-08:00
chore: cleanup; annotations updates; adding missing imports

PiperOrigin-RevId: 486612860
diff --git a/google/cloud/datacatalog/v1/bigquery.proto b/google/cloud/datacatalog/v1/bigquery.proto
@@ -16,6 +16,7 @@ syntax = "proto3";
 
 package google.cloud.datacatalog.v1;
 
+import "google/api/field_behavior.proto";
 
 option cc_enable_arenas = true;
 option csharp_namespace = "Google.Cloud.DataCatalog.V1";
diff --git a/google/cloud/datacatalog/v1/datacatalog.proto b/google/cloud/datacatalog/v1/datacatalog.proto
@@ -1035,16 +1035,16 @@ message Entry {
     // for entries with the `FILESET` type.
     GcsFilesetSpec gcs_fileset_spec = 6;
 
-    // Specification that applies to a BigQuery table. Valid only for
-    // entries with the `TABLE` type.
-    BigQueryTableSpec bigquery_table_spec = 12;
+    // Output only. Specification that applies to a BigQuery table. Valid only
+    // for entries with the `TABLE` type.
+    BigQueryTableSpec bigquery_table_spec = 12 [(google.api.field_behavior) = OUTPUT_ONLY];
 
-    // Specification for a group of BigQuery tables with the `[prefix]YYYYMMDD`
-    // name pattern.
+    // Output only. Specification for a group of BigQuery tables with
+    // the `[prefix]YYYYMMDD` name pattern.
     //
     // For more information, see [Introduction to partitioned tables]
     // (https://cloud.google.com/bigquery/docs/partitioned-tables#partitioning_versus_sharding).
-    BigQueryDateShardedSpec bigquery_date_sharded_spec = 15;
+    BigQueryDateShardedSpec bigquery_date_sharded_spec = 15 [(google.api.field_behavior) = OUTPUT_ONLY];
   }
 
   // Type- and system-specific information. Specifications for types contain
@@ -1098,13 +1098,13 @@ message Entry {
   // Timestamps from the underlying resource, not from the Data Catalog
   // entry.
   //
-  // Output only when the entry has a type listed in the `EntryType` enum.
-  // For entries with `user_specified_type`, this field is optional and defaults
-  // to an empty timestamp.
+  // Output only when the entry has a system listed in the `IntegratedSystem`
+  // enum. For entries with `user_specified_system`, this field is optional
+  // and defaults to an empty timestamp.
   SystemTimestamps source_system_timestamps = 7;
 
-  // Output only. Resource usage statistics.
-  UsageSignal usage_signal = 13 [(google.api.field_behavior) = OUTPUT_ONLY];
+  // Resource usage statistics.
+  UsageSignal usage_signal = 13;
 
   // Cloud labels attached to the entry.
   //
@@ -1138,9 +1138,9 @@ message DatabaseTableSpec {
   // Type of this table.
   TableType type = 1;
 
-  // Fields specific to a Dataplex table and present only in the Dataplex table
-  // entries.
-  DataplexTableSpec dataplex_table = 2;
+  // Output only. Fields specific to a Dataplex table and present only in the
+  // Dataplex table entries.
+  DataplexTableSpec dataplex_table = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // Specification that applies to a fileset. Valid only for entries with the
@@ -1153,8 +1153,10 @@ message FilesetSpec {
 
 // Specification that applies to a data source connection. Valid only for
 // entries with the `DATA_SOURCE_CONNECTION` type.
+// Only one of internal specs can be set at the time, and cannot
+// be changed later.
 message DataSourceConnectionSpec {
-  // Fields specific to BigQuery connections.
+  // Output only. Fields specific to BigQuery connections.
   BigQueryConnectionSpec bigquery_connection_spec = 1;
 }
 
@@ -1667,7 +1669,7 @@ enum EntryType {
   // Default unknown type.
   ENTRY_TYPE_UNSPECIFIED = 0;
 
-  // Output only. The entry type that has a GoogleSQL schema, including
+  // The entry type that has a GoogleSQL schema, including
   // logical views.
   TABLE = 2;
 
diff --git a/google/cloud/datacatalog/v1/datacatalog_v1.yaml b/google/cloud/datacatalog/v1/datacatalog_v1.yaml
@@ -7,6 +7,8 @@ apis:
 - name: google.cloud.datacatalog.v1.DataCatalog
 - name: google.cloud.datacatalog.v1.PolicyTagManager
 - name: google.cloud.datacatalog.v1.PolicyTagManagerSerialization
+- name: google.iam.v1.IAMPolicy
+- name: google.longrunning.Operations
 
 documentation:
   summary: |-
diff --git a/google/cloud/datacatalog/v1/usage.proto b/google/cloud/datacatalog/v1/usage.proto
@@ -16,6 +16,7 @@ syntax = "proto3";
 
 package google.cloud.datacatalog.v1;
 
+import "google/api/field_behavior.proto";
 import "google/protobuf/timestamp.proto";
 
 option cc_enable_arenas = true;
@@ -58,8 +59,8 @@ message UsageSignal {
   // The end timestamp of the duration of usage statistics.
   google.protobuf.Timestamp update_time = 1;
 
-  // Usage statistics over each of the predefined time ranges.
+  // Output only. BigQuery usage statistics over each of the predefined time ranges.
   //
   // Supported time ranges are `{"24H", "7D", "30D"}`.
-  map<string, UsageStats> usage_within_time_range = 2;
+  map<string, UsageStats> usage_within_time_range = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
