google-cloud-data_catalog-v1 0.7.3 → 0.8.0

data/lib/google/cloud/datacatalog/v1/bigquery_pb.rb

@@ -0,0 +1,48 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/datacatalog/v1/bigquery.proto
+
+require 'google/protobuf'
+
+require 'google/api/field_behavior_pb'
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("google/cloud/datacatalog/v1/bigquery.proto", :syntax => :proto3) do
+    add_message "google.cloud.datacatalog.v1.BigQueryConnectionSpec" do
+      optional :connection_type, :enum, 1, "google.cloud.datacatalog.v1.BigQueryConnectionSpec.ConnectionType"
+      optional :has_credential, :bool, 3
+      oneof :connection_spec do
+        optional :cloud_sql, :message, 2, "google.cloud.datacatalog.v1.CloudSqlBigQueryConnectionSpec"
+      end
+    end
+    add_enum "google.cloud.datacatalog.v1.BigQueryConnectionSpec.ConnectionType" do
+      value :CONNECTION_TYPE_UNSPECIFIED, 0
+      value :CLOUD_SQL, 1
+    end
+    add_message "google.cloud.datacatalog.v1.CloudSqlBigQueryConnectionSpec" do
+      optional :instance_id, :string, 1
+      optional :database, :string, 2
+      optional :type, :enum, 3, "google.cloud.datacatalog.v1.CloudSqlBigQueryConnectionSpec.DatabaseType"
+    end
+    add_enum "google.cloud.datacatalog.v1.CloudSqlBigQueryConnectionSpec.DatabaseType" do
+      value :DATABASE_TYPE_UNSPECIFIED, 0
+      value :POSTGRES, 1
+      value :MYSQL, 2
+    end
+    add_message "google.cloud.datacatalog.v1.BigQueryRoutineSpec" do
+      repeated :imported_libraries, :string, 1
+    end
+  end
+end
+
+module Google
+  module Cloud
+    module DataCatalog
+      module V1
+        BigQueryConnectionSpec = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.BigQueryConnectionSpec").msgclass
+        BigQueryConnectionSpec::ConnectionType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.BigQueryConnectionSpec.ConnectionType").enummodule
+        CloudSqlBigQueryConnectionSpec = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.CloudSqlBigQueryConnectionSpec").msgclass
+        CloudSqlBigQueryConnectionSpec::DatabaseType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.CloudSqlBigQueryConnectionSpec.DatabaseType").enummodule
+        BigQueryRoutineSpec = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.BigQueryRoutineSpec").msgclass
+      end
+    end
+  end
+end

data/lib/google/cloud/datacatalog/v1/datacatalog_pb.rb

@@ -7,6 +7,7 @@ require 'google/api/annotations_pb'
 require 'google/api/client_pb'
 require 'google/api/field_behavior_pb'
 require 'google/api/resource_pb'
+require 'google/cloud/datacatalog/v1/bigquery_pb'
 require 'google/cloud/datacatalog/v1/common_pb'
 require 'google/cloud/datacatalog/v1/data_source_pb'
 require 'google/cloud/datacatalog/v1/gcs_fileset_spec_pb'
@@ -15,6 +16,7 @@ require 'google/cloud/datacatalog/v1/search_pb'
 require 'google/cloud/datacatalog/v1/table_spec_pb'
 require 'google/cloud/datacatalog/v1/tags_pb'
 require 'google/cloud/datacatalog/v1/timestamps_pb'
+require 'google/cloud/datacatalog/v1/usage_pb'
 require 'google/iam/v1/iam_policy_pb'
 require 'google/iam/v1/policy_pb'
 require 'google/protobuf/empty_pb'
@@ -34,6 +36,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       repeated :include_project_ids, :string, 3
       optional :include_gcp_public_datasets, :bool, 7
       repeated :restricted_locations, :string, 16
+      optional :include_public_tag_templates, :bool, 19
     end
     add_message "google.cloud.datacatalog.v1.SearchCatalogResponse" do
       repeated :results, :message, 1, "google.cloud.datacatalog.v1.SearchCatalogResult"
@@ -96,6 +99,8 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :description, :string, 4
       optional :schema, :message, 5, "google.cloud.datacatalog.v1.Schema"
       optional :source_system_timestamps, :message, 7, "google.cloud.datacatalog.v1.SystemTimestamps"
+      optional :usage_signal, :message, 13, "google.cloud.datacatalog.v1.UsageSignal"
+      map :labels, :string, :string, 14
       optional :data_source, :message, 20, "google.cloud.datacatalog.v1.DataSource"
       oneof :entry_type do
         optional :type, :enum, 2, "google.cloud.datacatalog.v1.EntryType"
@@ -112,6 +117,8 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       end
       oneof :spec do
         optional :database_table_spec, :message, 24, "google.cloud.datacatalog.v1.DatabaseTableSpec"
+        optional :data_source_connection_spec, :message, 27, "google.cloud.datacatalog.v1.DataSourceConnectionSpec"
+        optional :routine_spec, :message, 28, "google.cloud.datacatalog.v1.RoutineSpec"
       end
     end
     add_message "google.cloud.datacatalog.v1.DatabaseTableSpec" do
@@ -122,6 +129,35 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :NATIVE, 1
       value :EXTERNAL, 2
     end
+    add_message "google.cloud.datacatalog.v1.DataSourceConnectionSpec" do
+      optional :bigquery_connection_spec, :message, 1, "google.cloud.datacatalog.v1.BigQueryConnectionSpec"
+    end
+    add_message "google.cloud.datacatalog.v1.RoutineSpec" do
+      optional :routine_type, :enum, 1, "google.cloud.datacatalog.v1.RoutineSpec.RoutineType"
+      optional :language, :string, 2
+      repeated :routine_arguments, :message, 3, "google.cloud.datacatalog.v1.RoutineSpec.Argument"
+      optional :return_type, :string, 4
+      optional :definition_body, :string, 5
+      oneof :system_spec do
+        optional :bigquery_routine_spec, :message, 6, "google.cloud.datacatalog.v1.BigQueryRoutineSpec"
+      end
+    end
+    add_message "google.cloud.datacatalog.v1.RoutineSpec.Argument" do
+      optional :name, :string, 1
+      optional :mode, :enum, 2, "google.cloud.datacatalog.v1.RoutineSpec.Argument.Mode"
+      optional :type, :string, 3
+    end
+    add_enum "google.cloud.datacatalog.v1.RoutineSpec.Argument.Mode" do
+      value :MODE_UNSPECIFIED, 0
+      value :IN, 1
+      value :OUT, 2
+      value :INOUT, 3
+    end
+    add_enum "google.cloud.datacatalog.v1.RoutineSpec.RoutineType" do
+      value :ROUTINE_TYPE_UNSPECIFIED, 0
+      value :SCALAR_FUNCTION, 1
+      value :PROCEDURE, 2
+    end
     add_message "google.cloud.datacatalog.v1.EntryGroup" do
       optional :name, :string, 1
       optional :display_name, :string, 2
@@ -202,7 +238,10 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :MODEL, 5
       value :DATA_STREAM, 3
       value :FILESET, 4
+      value :CLUSTER, 6
       value :DATABASE, 7
+      value :DATA_SOURCE_CONNECTION, 8
+      value :ROUTINE, 9
       value :SERVICE, 14
     end
   end
@@ -229,6 +268,11 @@ module Google
         Entry = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.Entry").msgclass
         DatabaseTableSpec = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.DatabaseTableSpec").msgclass
         DatabaseTableSpec::TableType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.DatabaseTableSpec.TableType").enummodule
+        DataSourceConnectionSpec = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.DataSourceConnectionSpec").msgclass
+        RoutineSpec = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.RoutineSpec").msgclass
+        RoutineSpec::Argument = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.RoutineSpec.Argument").msgclass
+        RoutineSpec::Argument::Mode = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.RoutineSpec.Argument.Mode").enummodule
+        RoutineSpec::RoutineType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.RoutineSpec.RoutineType").enummodule
         EntryGroup = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.EntryGroup").msgclass
         CreateTagTemplateRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.CreateTagTemplateRequest").msgclass
         GetTagTemplateRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.GetTagTemplateRequest").msgclass

data/lib/google/cloud/datacatalog/v1/datacatalog_services_pb.rb

@@ -24,8 +24,8 @@ module Google
     module DataCatalog
       module V1
         module DataCatalog
-          # Data Catalog API service allows clients to discover, understand, and manage
-          # their data.
+          # Data Catalog API service allows you to discover, understand, and manage
+          # your data.
           class Service
 
             include GRPC::GenericService
@@ -34,199 +34,236 @@ module Google
             self.unmarshal_class_method = :decode
             self.service_name = 'google.cloud.datacatalog.v1.DataCatalog'
 
-            # Searches Data Catalog for multiple resources like entries, tags that
+            # Searches Data Catalog for multiple resources like entries and tags that
             # match a query.
             #
-            # This is a custom method
-            # (https://cloud.google.com/apis/design/custom_methods) and does not return
-            # the complete resource, only the resource identifier and high level
-            # fields. Clients can subsequently call `Get` methods.
+            # This is a [Custom Method]
+            # (https://cloud.google.com/apis/design/custom_methods) that doesn't return
+            # all information on a resource, only its ID and high level fields. To get
+            # more information, you can subsequently call specific get methods.
             #
-            # Note that Data Catalog search queries do not guarantee full recall. Query
-            # results that match your query may not be returned, even in subsequent
-            # result pages. Also note that results returned (and not returned) can vary
-            # across repeated search queries.
+            # Note: Data Catalog search queries don't guarantee full recall. Results
+            # that match your query might not be returned, even in subsequent
+            # result pages. Additionally, returned (and not returned) results can vary
+            # if you repeat search queries.
             #
-            # See [Data Catalog Search
-            # Syntax](https://cloud.google.com/data-catalog/docs/how-to/search-reference)
-            # for more information.
+            # For more information, see [Data Catalog search syntax]
+            # (https://cloud.google.com/data-catalog/docs/how-to/search-reference).
             rpc :SearchCatalog, ::Google::Cloud::DataCatalog::V1::SearchCatalogRequest, ::Google::Cloud::DataCatalog::V1::SearchCatalogResponse
-            # Creates an EntryGroup.
+            # Creates an entry group.
             #
-            # An entry group contains logically related entries together with Cloud
-            # Identity and Access Management policies that specify the users who can
-            # create, edit, and view entries within the entry group.
+            # An entry group contains logically related entries together with [Cloud
+            # Identity and Access Management](/data-catalog/docs/concepts/iam) policies.
+            # These policies specify users who can create, edit, and view entries
+            # within entry groups.
             #
-            # Data Catalog automatically creates an entry group for BigQuery entries
-            # ("@bigquery") and Pub/Sub topics ("@pubsub"). Users create their own entry
-            # group to contain Cloud Storage fileset entries or custom type entries,
-            # and the IAM policies associated with those entries. Entry groups, like
-            # entries, can be searched.
+            # Data Catalog automatically creates entry groups with names that start with
+            # the `@` symbol for the following resources:
+            #
+            # * BigQuery entries (`@bigquery`)
+            # * Pub/Sub topics (`@pubsub`)
+            # * Dataproc Metastore services (`@dataproc_metastore_{SERVICE_NAME_HASH}`)
+            #
+            # You can create your own entry groups for Cloud Storage fileset entries
+            # and custom entries together with the corresponding IAM policies.
+            # User-created entry groups can't contain the `@` symbol, it is reserved
+            # for automatically created groups.
+            #
+            # Entry groups, like entries, can be searched.
             #
             # A maximum of 10,000 entry groups may be created per organization across all
             # locations.
             #
-            # Users should enable the Data Catalog API in the project identified by
-            # the `parent` parameter (see [Data Catalog Resource Project]
-            # (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for
-            # more information).
+            # You must enable the Data Catalog API in the project identified by
+            # the `parent` parameter. For more information, see [Data Catalog resource
+            # project](https://cloud.google.com/data-catalog/docs/concepts/resource-project).
             rpc :CreateEntryGroup, ::Google::Cloud::DataCatalog::V1::CreateEntryGroupRequest, ::Google::Cloud::DataCatalog::V1::EntryGroup
-            # Gets an EntryGroup.
+            # Gets an entry group.
             rpc :GetEntryGroup, ::Google::Cloud::DataCatalog::V1::GetEntryGroupRequest, ::Google::Cloud::DataCatalog::V1::EntryGroup
-            # 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]
-            # (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for
-            # more information).
+            # Updates an entry group.
+            #
+            # You must enable the Data Catalog API in the project identified by
+            # the `entry_group.name` parameter. For more information, see [Data Catalog
+            # resource
+            # project](https://cloud.google.com/data-catalog/docs/concepts/resource-project).
             rpc :UpdateEntryGroup, ::Google::Cloud::DataCatalog::V1::UpdateEntryGroupRequest, ::Google::Cloud::DataCatalog::V1::EntryGroup
-            # 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]
-            # (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for
-            # more information).
+            # Deletes an entry group.
+            #
+            # You must enable the Data Catalog API in the project
+            # identified by the `name` parameter. For more information, see [Data Catalog
+            # resource
+            # project](https://cloud.google.com/data-catalog/docs/concepts/resource-project).
             rpc :DeleteEntryGroup, ::Google::Cloud::DataCatalog::V1::DeleteEntryGroupRequest, ::Google::Protobuf::Empty
             # Lists entry groups.
             rpc :ListEntryGroups, ::Google::Cloud::DataCatalog::V1::ListEntryGroupsRequest, ::Google::Cloud::DataCatalog::V1::ListEntryGroupsResponse
-            # Creates an entry. Only entries of types 'FILESET', 'CLUSTER', 'DATA_STREAM'
-            # or with a user-specified type can be created.
+            # Creates an entry.
             #
-            # Users should enable the Data Catalog API in the project identified by
-            # the `parent` parameter (see [Data Catalog Resource Project]
-            # (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for
-            # more information).
+            # You can create entries only with 'FILESET', 'CLUSTER', 'DATA_STREAM',
+            # or custom types. Data Catalog automatically creates entries with other
+            # types during metadata ingestion from integrated systems.
             #
-            # A maximum of 100,000 entries may be created per entry group.
+            # You must enable the Data Catalog API in the project identified by
+            # the `parent` parameter. For more information, see [Data Catalog resource
+            # project](https://cloud.google.com/data-catalog/docs/concepts/resource-project).
+            #
+            # An entry group can have a maximum of 100,000 entries.
             rpc :CreateEntry, ::Google::Cloud::DataCatalog::V1::CreateEntryRequest, ::Google::Cloud::DataCatalog::V1::Entry
             # 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]
-            # (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for
-            # more information).
+            #
+            # You must enable the Data Catalog API in the project identified by
+            # the `entry.name` parameter. For more information, see [Data Catalog
+            # resource
+            # project](https://cloud.google.com/data-catalog/docs/concepts/resource-project).
             rpc :UpdateEntry, ::Google::Cloud::DataCatalog::V1::UpdateEntryRequest, ::Google::Cloud::DataCatalog::V1::Entry
-            # Deletes an existing entry. Only entries created through
+            # Deletes an existing entry.
+            #
+            # You can delete only the entries created by the
             # [CreateEntry][google.cloud.datacatalog.v1.DataCatalog.CreateEntry]
-            # method can be deleted.
-            # Users should enable the Data Catalog API in the project identified by
-            # the `name` parameter (see [Data Catalog Resource Project]
-            # (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for
-            # more information).
+            # method.
+            #
+            # You must enable the Data Catalog API in the project identified by
+            # the `name` parameter. For more information, see [Data Catalog
+            # resource
+            # project](https://cloud.google.com/data-catalog/docs/concepts/resource-project).
             rpc :DeleteEntry, ::Google::Cloud::DataCatalog::V1::DeleteEntryRequest, ::Google::Protobuf::Empty
             # Gets an entry.
             rpc :GetEntry, ::Google::Cloud::DataCatalog::V1::GetEntryRequest, ::Google::Cloud::DataCatalog::V1::Entry
-            # Get an entry by target resource name. This method allows clients to use
-            # the resource name from the source Google Cloud Platform service to get the
-            # Data Catalog Entry.
+            # Gets an entry by its target resource name.
+            #
+            # The resource name comes from the source Google Cloud Platform service.
             rpc :LookupEntry, ::Google::Cloud::DataCatalog::V1::LookupEntryRequest, ::Google::Cloud::DataCatalog::V1::Entry
             # Lists entries.
             rpc :ListEntries, ::Google::Cloud::DataCatalog::V1::ListEntriesRequest, ::Google::Cloud::DataCatalog::V1::ListEntriesResponse
-            # 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](https://cloud.google.com/data-catalog/docs/concepts/resource-project)
-            # for more information).
+            # Creates a tag template.
+            #
+            # You must enable the Data Catalog API in the project identified by the
+            # `parent` parameter.
+            # For more information, see [Data Catalog resource project]
+            # (https://cloud.google.com/data-catalog/docs/concepts/resource-project).
             rpc :CreateTagTemplate, ::Google::Cloud::DataCatalog::V1::CreateTagTemplateRequest, ::Google::Cloud::DataCatalog::V1::TagTemplate
             # Gets a tag template.
             rpc :GetTagTemplate, ::Google::Cloud::DataCatalog::V1::GetTagTemplateRequest, ::Google::Cloud::DataCatalog::V1::TagTemplate
-            # Updates a tag template. This method cannot be used to update the fields of
-            # a template. The tag template fields are represented as separate resources
-            # 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]
-            # (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for
-            # more information).
+            # Updates a tag template.
+            #
+            # You can't update template fields with this method. These fields are
+            # separate resources with their own create, update, and delete methods.
+            #
+            # You must enable the Data Catalog API in the project identified by
+            # the `tag_template.name` parameter. For more information, see [Data Catalog
+            # resource
+            # project](https://cloud.google.com/data-catalog/docs/concepts/resource-project).
             rpc :UpdateTagTemplate, ::Google::Cloud::DataCatalog::V1::UpdateTagTemplateRequest, ::Google::Cloud::DataCatalog::V1::TagTemplate
-            # 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]
-            # (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for
-            # more information).
+            # Deletes a tag template and all tags that use it.
+            #
+            # You must enable the Data Catalog API in the project identified by
+            # the `name` parameter. For more information, see [Data Catalog resource
+            # project](https://cloud.google.com/data-catalog/docs/concepts/resource-project).
             rpc :DeleteTagTemplate, ::Google::Cloud::DataCatalog::V1::DeleteTagTemplateRequest, ::Google::Protobuf::Empty
-            # 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](https://cloud.google.com/data-catalog/docs/concepts/resource-project)
-            # for more information).
+            # Creates a field in a tag template.
+            #
+            # You must enable the Data Catalog API in the project identified by
+            # the `parent` parameter. For more information, see [Data Catalog resource
+            # project](https://cloud.google.com/data-catalog/docs/concepts/resource-project).
             rpc :CreateTagTemplateField, ::Google::Cloud::DataCatalog::V1::CreateTagTemplateFieldRequest, ::Google::Cloud::DataCatalog::V1::TagTemplateField
-            # 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]
-            # (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for
-            # more information).
+            # Updates a field in a tag template.
+            #
+            # You can't update the field type with this method.
+            #
+            # You must enable the Data Catalog API in the project
+            # identified by the `name` parameter. For more information, see [Data Catalog
+            # resource
+            # project](https://cloud.google.com/data-catalog/docs/concepts/resource-project).
             rpc :UpdateTagTemplateField, ::Google::Cloud::DataCatalog::V1::UpdateTagTemplateFieldRequest, ::Google::Cloud::DataCatalog::V1::TagTemplateField
-            # 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](https://cloud.google.com/data-catalog/docs/concepts/resource-project)
-            # for more information).
+            # Renames a field in a tag template.
+            #
+            # You must enable the Data Catalog API in the project identified by the
+            # `name` parameter. For more information, see [Data Catalog resource project]
+            # (https://cloud.google.com/data-catalog/docs/concepts/resource-project).
             rpc :RenameTagTemplateField, ::Google::Cloud::DataCatalog::V1::RenameTagTemplateFieldRequest, ::Google::Cloud::DataCatalog::V1::TagTemplateField
-            # Renames an enum value in a tag template. The enum values have to be unique
-            # within one enum field.
+            # Renames an enum value in a tag template.
+            #
+            # Within a single enum field, enum values must be unique.
             rpc :RenameTagTemplateFieldEnumValue, ::Google::Cloud::DataCatalog::V1::RenameTagTemplateFieldEnumValueRequest, ::Google::Cloud::DataCatalog::V1::TagTemplateField
-            # 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]
-            # (https://cloud.google.com/data-catalog/docs/concepts/resource-project) for
-            # more information).
+            # Deletes a field in a tag template and all uses of this field from the tags
+            # based on this template.
+            #
+            # You must enable the Data Catalog API in the project identified by
+            # the `name` parameter. For more information, see [Data Catalog resource
+            # project](https://cloud.google.com/data-catalog/docs/concepts/resource-project).
             rpc :DeleteTagTemplateField, ::Google::Cloud::DataCatalog::V1::DeleteTagTemplateFieldRequest, ::Google::Protobuf::Empty
-            # Creates a tag on an [Entry][google.cloud.datacatalog.v1.Entry].
-            # Note: The project identified by the `parent` parameter for the
-            # [tag](https://cloud.google.com/data-catalog/docs/reference/rest/v1/projects.locations.entryGroups.entries.tags/create#path-parameters)
-            # and the
-            # [tag
-            # 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.
+            # Creates a tag and assigns it to:
+            #
+            # * An [Entry][google.cloud.datacatalog.v1.Entry] if the method name is
+            #   ``projects.locations.entryGroups.entries.tags.create``.
+            # * Or [EntryGroup][google.cloud.datacatalog.v1.EntryGroup]if the method
+            #   name is ``projects.locations.entryGroups.tags.create``.
+            #
+            # Note: The project identified by the `parent` parameter for the [tag]
+            # (https://cloud.google.com/data-catalog/docs/reference/rest/v1/projects.locations.entryGroups.entries.tags/create#path-parameters)
+            # and the [tag template]
+            # (https://cloud.google.com/data-catalog/docs/reference/rest/v1/projects.locations.tagTemplates/create#path-parameters)
+            # used to create the tag must be in the same organization.
             rpc :CreateTag, ::Google::Cloud::DataCatalog::V1::CreateTagRequest, ::Google::Cloud::DataCatalog::V1::Tag
             # Updates an existing tag.
             rpc :UpdateTag, ::Google::Cloud::DataCatalog::V1::UpdateTagRequest, ::Google::Cloud::DataCatalog::V1::Tag
             # Deletes a tag.
             rpc :DeleteTag, ::Google::Cloud::DataCatalog::V1::DeleteTagRequest, ::Google::Protobuf::Empty
-            # Lists the tags on an [Entry][google.cloud.datacatalog.v1.Entry].
+            # Lists tags assigned to an [Entry][google.cloud.datacatalog.v1.Entry].
             rpc :ListTags, ::Google::Cloud::DataCatalog::V1::ListTagsRequest, ::Google::Cloud::DataCatalog::V1::ListTagsResponse
-            # Sets the access control policy for a resource. Replaces any existing
+            # Sets an access control policy for a resource. Replaces any existing
             # policy.
+            #
             # Supported resources are:
-            #   - Tag templates.
-            #   - Entries.
-            #   - Entry groups.
-            # Note, this method cannot be used to manage policies for BigQuery, Pub/Sub
-            # and any external Google Cloud Platform resources synced to Data Catalog.
-            #
-            # Callers must have following Google IAM permission
-            #   - `datacatalog.tagTemplates.setIamPolicy` to set policies on tag
-            #     templates.
-            #   - `datacatalog.entries.setIamPolicy` to set policies on entries.
-            #   - `datacatalog.entryGroups.setIamPolicy` to set policies on entry groups.
+            #
+            # - Tag templates
+            # - Entry groups
+            #
+            # Note: This method sets policies only within Data Catalog and can't be
+            # used to manage policies in BigQuery, Pub/Sub, Dataproc Metastore, and any
+            # external Google Cloud Platform resources synced with the Data Catalog.
+            #
+            # To call this method, you must have the following Google IAM permissions:
+            #
+            # - `datacatalog.tagTemplates.setIamPolicy` to set policies on tag
+            #   templates.
+            # - `datacatalog.entryGroups.setIamPolicy` to set policies on entry groups.
             rpc :SetIamPolicy, ::Google::Iam::V1::SetIamPolicyRequest, ::Google::Iam::V1::Policy
-            # Gets the access control policy for a resource. A `NOT_FOUND` error
-            # is returned if the resource does not exist. An empty policy is returned
-            # if the resource exists but does not have a policy set on it.
+            # Gets the access control policy for a resource.
+            #
+            # May return:
+            #
+            # * A`NOT_FOUND` error if the resource doesn't exist or you don't have the
+            #   permission to view it.
+            # * An empty policy if the resource exists but doesn't have a set policy.
             #
             # Supported resources are:
-            #   - Tag templates.
-            #   - Entries.
-            #   - Entry groups.
-            # Note, this method cannot be used to manage policies for BigQuery, Pub/Sub
-            # and any external Google Cloud Platform resources synced to Data Catalog.
-            #
-            # Callers must have following Google IAM permission
-            #   - `datacatalog.tagTemplates.getIamPolicy` to get policies on tag
-            #     templates.
-            #   - `datacatalog.entries.getIamPolicy` to get policies on entries.
-            #   - `datacatalog.entryGroups.getIamPolicy` to get policies on entry groups.
+            #
+            # - Tag templates
+            # - Entry groups
+            #
+            # Note: This method doesn't get policies from Google Cloud Platform
+            # resources ingested into Data Catalog.
+            #
+            # To call this method, you must have the following Google IAM permissions:
+            #
+            # - `datacatalog.tagTemplates.getIamPolicy` to get policies on tag
+            #   templates.
+            # - `datacatalog.entryGroups.getIamPolicy` to get policies on entry groups.
             rpc :GetIamPolicy, ::Google::Iam::V1::GetIamPolicyRequest, ::Google::Iam::V1::Policy
-            # Returns the caller's permissions on a resource.
-            # If the resource does not exist, an empty set of permissions is returned
-            # (We don't return a `NOT_FOUND` error).
+            # Gets your permissions on a resource.
+            #
+            # Returns an empty set of permissions if the resource doesn't exist.
             #
             # Supported resources are:
-            #   - Tag templates.
-            #   - Entries.
-            #   - Entry groups.
-            # Note, this method cannot be used to manage policies for BigQuery, Pub/Sub
-            # and any external Google Cloud Platform resources synced to Data Catalog.
-            #
-            # A caller is not required to have Google IAM permission to make this
-            # request.
+            #
+            # - Tag templates
+            # - Entry groups
+            #
+            # Note: This method gets policies only within Data Catalog and can't be
+            # used to get policies from BigQuery, Pub/Sub, Dataproc Metastore, and any
+            # external Google Cloud Platform resources ingested into Data Catalog.
+            #
+            # No Google IAM permissions are required to call this method.
             rpc :TestIamPermissions, ::Google::Iam::V1::TestIamPermissionsRequest, ::Google::Iam::V1::TestIamPermissionsResponse
           end