feat: add order field to TagField and TagTemplateField (#157)

* remove unneeded doc links fix * rerun synthtool
googleapis · Apr 21, 2020 · eec6e40 · eec6e40
1 parent 2c587a0
commit eec6e40
Show file tree

Hide file tree

Showing 17 changed files with 403 additions and 313 deletions.
diff --git a/packages/google-cloud-datacatalog/protos/google/cloud/datacatalog/v1beta1/common.proto b/packages/google-cloud-datacatalog/protos/google/cloud/datacatalog/v1beta1/common.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,16 +11,18 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
 package google.cloud.datacatalog.v1beta1;
 
 option cc_enable_arenas = true;
+option csharp_namespace = "Google.Cloud.DataCatalog.V1Beta1";
 option go_package = "google.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog";
 option java_multiple_files = true;
 option java_package = "com.google.cloud.datacatalog.v1beta1";
+option php_namespace = "Google\\Cloud\\DataCatalog\\V1beta1";
+option ruby_package = "Google::Cloud::DataCatalog::V1beta1";
 
 // This enum describes all the possible systems that Data Catalog integrates
 // with.

diff --git a/packages/google-cloud-datacatalog/protos/google/cloud/datacatalog/v1beta1/datacatalog.proto b/packages/google-cloud-datacatalog/protos/google/cloud/datacatalog/v1beta1/datacatalog.proto
diff --git a/...s/google-cloud-datacatalog/protos/google/cloud/datacatalog/v1beta1/gcs_fileset_spec.proto b/...s/google-cloud-datacatalog/protos/google/cloud/datacatalog/v1beta1/gcs_fileset_spec.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,7 +11,6 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
@@ -21,9 +20,12 @@ import "google/api/field_behavior.proto";
 import "google/cloud/datacatalog/v1beta1/timestamps.proto";
 
 option cc_enable_arenas = true;
+option csharp_namespace = "Google.Cloud.DataCatalog.V1Beta1";
 option go_package = "google.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog";
 option java_multiple_files = true;
 option java_package = "com.google.cloud.datacatalog.v1beta1";
+option php_namespace = "Google\\Cloud\\DataCatalog\\V1beta1";
+option ruby_package = "Google::Cloud::DataCatalog::V1beta1";
 
 // Describes a Cloud Storage fileset entry.
 message GcsFilesetSpec {

diff --git a/...s/google-cloud-datacatalog/protos/google/cloud/datacatalog/v1beta1/policytagmanager.proto b/...s/google-cloud-datacatalog/protos/google/cloud/datacatalog/v1beta1/policytagmanager.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,7 +11,6 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
@@ -28,10 +27,13 @@ import "google/protobuf/empty.proto";
 import "google/protobuf/field_mask.proto";
 
 option cc_enable_arenas = true;
+option csharp_namespace = "Google.Cloud.DataCatalog.V1Beta1";
 option go_package = "google.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog";
 option java_multiple_files = true;
 option java_outer_classname = "PolicyTagManagerProto";
 option java_package = "com.google.cloud.datacatalog.v1beta1";
+option php_namespace = "Google\\Cloud\\DataCatalog\\V1beta1";
+option ruby_package = "Google::Cloud::DataCatalog::V1beta1";
 
 // The policy tag manager API service allows clients to manage their taxonomies
 // and policy tags.

diff --git a/...d-datacatalog/protos/google/cloud/datacatalog/v1beta1/policytagmanagerserialization.proto b/...d-datacatalog/protos/google/cloud/datacatalog/v1beta1/policytagmanagerserialization.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,7 +11,6 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
@@ -25,10 +24,13 @@ import "google/iam/v1/policy.proto";
 import "google/api/client.proto";
 
 option cc_enable_arenas = true;
+option csharp_namespace = "Google.Cloud.DataCatalog.V1Beta1";
 option go_package = "google.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog";
 option java_multiple_files = true;
 option java_outer_classname = "PolicyTagManagerSerializationProto";
 option java_package = "com.google.cloud.datacatalog.v1beta1";
+option php_namespace = "Google\\Cloud\\DataCatalog\\V1beta1";
+option ruby_package = "Google::Cloud::DataCatalog::V1beta1";
 
 // Policy tag manager serialization API service allows clients to manipulate
 // their taxonomies and policy tags data with serialized format.

diff --git a/packages/google-cloud-datacatalog/protos/google/cloud/datacatalog/v1beta1/schema.proto b/packages/google-cloud-datacatalog/protos/google/cloud/datacatalog/v1beta1/schema.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,7 +11,6 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
@@ -20,9 +19,12 @@ package google.cloud.datacatalog.v1beta1;
 import "google/api/field_behavior.proto";
 
 option cc_enable_arenas = true;
+option csharp_namespace = "Google.Cloud.DataCatalog.V1Beta1";
 option go_package = "google.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog";
 option java_multiple_files = true;
 option java_package = "com.google.cloud.datacatalog.v1beta1";
+option php_namespace = "Google\\Cloud\\DataCatalog\\V1beta1";
+option ruby_package = "Google::Cloud::DataCatalog::V1beta1";
 
 // Represents a schema (e.g. BigQuery, GoogleSQL, Avro schema).
 message Schema {

diff --git a/packages/google-cloud-datacatalog/protos/google/cloud/datacatalog/v1beta1/search.proto b/packages/google-cloud-datacatalog/protos/google/cloud/datacatalog/v1beta1/search.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,7 +11,6 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
@@ -22,9 +21,12 @@ import "google/cloud/datacatalog/v1beta1/common.proto";
 import "google/protobuf/timestamp.proto";
 
 option cc_enable_arenas = true;
+option csharp_namespace = "Google.Cloud.DataCatalog.V1Beta1";
 option go_package = "google.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog";
 option java_multiple_files = true;
 option java_package = "com.google.cloud.datacatalog.v1beta1";
+option php_namespace = "Google\\Cloud\\DataCatalog\\V1beta1";
+option ruby_package = "Google::Cloud::DataCatalog::V1beta1";
 
 // A result that appears in the response of a search request. Each result
 // captures details of one entry that matches the search.

diff --git a/packages/google-cloud-datacatalog/protos/google/cloud/datacatalog/v1beta1/table_spec.proto b/packages/google-cloud-datacatalog/protos/google/cloud/datacatalog/v1beta1/table_spec.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,7 +11,6 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
@@ -21,9 +20,12 @@ import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
 
 option cc_enable_arenas = true;
+option csharp_namespace = "Google.Cloud.DataCatalog.V1Beta1";
 option go_package = "google.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog";
 option java_multiple_files = true;
 option java_package = "com.google.cloud.datacatalog.v1beta1";
+option php_namespace = "Google\\Cloud\\DataCatalog\\V1beta1";
+option ruby_package = "Google::Cloud::DataCatalog::V1beta1";
 
 // Describes a BigQuery table.
 message BigQueryTableSpec {

diff --git a/packages/google-cloud-datacatalog/protos/google/cloud/datacatalog/v1beta1/tags.proto b/packages/google-cloud-datacatalog/protos/google/cloud/datacatalog/v1beta1/tags.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,7 +11,6 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
@@ -22,15 +21,19 @@ import "google/api/resource.proto";
 import "google/protobuf/timestamp.proto";
 
 option cc_enable_arenas = true;
+option csharp_namespace = "Google.Cloud.DataCatalog.V1Beta1";
 option go_package = "google.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog";
 option java_multiple_files = true;
 option java_package = "com.google.cloud.datacatalog.v1beta1";
+option php_namespace = "Google\\Cloud\\DataCatalog\\V1beta1";
+option ruby_package = "Google::Cloud::DataCatalog::V1beta1";
 
 // Tags are used to attach custom metadata to Data Catalog resources. Tags
 // conform to the specifications within their tag template.
 //
-// See [Data Catalog IAM](/data-catalog/docs/concepts/iam) for information on
-// the permissions needed to create or view tags.
+// See [Data Catalog
+// IAM](https://cloud.google.com/data-catalog/docs/concepts/iam) for information
+// on the permissions needed to create or view tags.
 message Tag {
   option (google.api.resource) = {
     type: "datacatalog.googleapis.com/Tag"
@@ -106,14 +109,23 @@ message TagField {
     // one of the allowed values in the definition of this enum.
     EnumValue enum_value = 6;
   }
+
+  // Output only. The order of this field with respect to other fields in this tag. It can be
+  // set in [Tag][google.cloud.datacatalog.v1beta1.TagTemplateField.order]. For
+  // example, a higher value can indicate a more important field. The value can
+  // be negative. Multiple fields can have the same order, and field orders
+  // within a tag do not have to be sequential.
+  int32 order = 7 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // A tag template defines a tag, which can have one or more typed fields.
 // The template is used to create and attach the tag to GCP resources.
-// [Tag template roles](/iam/docs/understanding-roles#data-catalog-roles)
-// provide permissions to create, edit, and use the template (see, for example,
-// the [TagTemplate User](/data-catalog/docs/how-to/template-user) role, which
-// includes permission to use the tag template to tag resources.
+// [Tag template
+// roles](https://cloud.google.com/iam/docs/understanding-roles#data-catalog-roles)
+// provide permissions to create, edit, and use the template. See, for example,
+// the [TagTemplate
+// User](https://cloud.google.com/data-catalog/docs/how-to/template-user) role,
+// which includes permission to use the tag template to tag resources.
 message TagTemplate {
   option (google.api.resource) = {
     type: "datacatalog.googleapis.com/TagTemplate"
@@ -165,6 +177,12 @@ message TagTemplateField {
 
   // Whether this is a required field. Defaults to false.
   bool is_required = 3;
+
+  // The order of this field with respect to other fields in this tag
+  // template.  A higher value indicates a more important field. The value can
+  // be negative. Multiple fields can have the same order, and field orders
+  // within a tag do not have to be sequential.
+  int32 order = 5;
 }
 
 message FieldType {

diff --git a/packages/google-cloud-datacatalog/protos/google/cloud/datacatalog/v1beta1/timestamps.proto b/packages/google-cloud-datacatalog/protos/google/cloud/datacatalog/v1beta1/timestamps.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2020 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -11,7 +11,6 @@
 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 // See the License for the specific language governing permissions and
 // limitations under the License.
-//
 
 syntax = "proto3";
 
@@ -21,9 +20,12 @@ import "google/api/field_behavior.proto";
 import "google/protobuf/timestamp.proto";
 
 option cc_enable_arenas = true;
+option csharp_namespace = "Google.Cloud.DataCatalog.V1Beta1";
 option go_package = "google.golang.org/genproto/googleapis/cloud/datacatalog/v1beta1;datacatalog";
 option java_multiple_files = true;
 option java_package = "com.google.cloud.datacatalog.v1beta1";
+option php_namespace = "Google\\Cloud\\DataCatalog\\V1beta1";
+option ruby_package = "Google::Cloud::DataCatalog::V1beta1";
 
 // Timestamps about this resource according to a particular system.
 message SystemTimestamps {

diff --git a/packages/google-cloud-datacatalog/protos/protos.d.ts b/packages/google-cloud-datacatalog/protos/protos.d.ts
@@ -8009,15 +8009,6 @@ export namespace google {
                     public toJSON(): { [k: string]: any };
                 }
 
-                /** EntryType enum. */
-                enum EntryType {
-                    ENTRY_TYPE_UNSPECIFIED = 0,
-                    TABLE = 2,
-                    MODEL = 5,
-                    DATA_STREAM = 3,
-                    FILESET = 4
-                }
-
                 /** Properties of a GetTagTemplateRequest. */
                 interface IGetTagTemplateRequest {
 
@@ -9380,6 +9371,15 @@ export namespace google {
                     public toJSON(): { [k: string]: any };
                 }
 
+                /** EntryType enum. */
+                enum EntryType {
+                    ENTRY_TYPE_UNSPECIFIED = 0,
+                    TABLE = 2,
+                    MODEL = 5,
+                    DATA_STREAM = 3,
+                    FILESET = 4
+                }
+
                 /** Properties of a GcsFilesetSpec. */
                 interface IGcsFilesetSpec {
 
@@ -10531,6 +10531,9 @@ export namespace google {
 
                     /** TagField enumValue */
                     enumValue?: (google.cloud.datacatalog.v1beta1.TagField.IEnumValue|null);
+
+                    /** TagField order */
+                    order?: (number|null);
                 }
 
                 /** Represents a TagField. */
@@ -10560,6 +10563,9 @@ export namespace google {
                     /** TagField enumValue. */
                     public enumValue?: (google.cloud.datacatalog.v1beta1.TagField.IEnumValue|null);
 
+                    /** TagField order. */
+                    public order: number;
+
                     /** TagField kind. */
                     public kind?: ("doubleValue"|"stringValue"|"boolValue"|"timestampValue"|"enumValue");
 
@@ -10843,6 +10849,9 @@ export namespace google {
 
                     /** TagTemplateField isRequired */
                     isRequired?: (boolean|null);
+
+                    /** TagTemplateField order */
+                    order?: (number|null);
                 }
 
                 /** Represents a TagTemplateField. */
@@ -10866,6 +10875,9 @@ export namespace google {
                     /** TagTemplateField isRequired. */
                     public isRequired: boolean;
 
+                    /** TagTemplateField order. */
+                    public order: number;
+
                     /**
                      * Creates a new TagTemplateField instance using the specified properties.
                      * @param [properties] Properties to set