google-cloud-data_catalog-v1 0.7.3 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d06bb3a84476a4087453bde146f9e0a59d5cdb0e92bc66809ce6947f49a10dc4
-  data.tar.gz: 5b91a33cdfa973e5c95e41e1e4bab8f22023a67461967adc6e6a9bd670842d76
+  metadata.gz: ba6dc6009a98c8a25f244e37fadd139b37a2c100f1c855d599baf304a7c570aa
+  data.tar.gz: d5d529cebde9376bcafe9fac5ac1da3ceab4157365e84532a023ed5c96b3ce67
 SHA512:
-  metadata.gz: 414883ffab5f4ea94ca340935187604727e5612072abacf01d280bd5cd1805e2fe456ba2d33031c0d39e58d12c3e70e3d5feb4af8c4bdb8baa48f597e4c35857
-  data.tar.gz: 586188f37051be64cdd805f55b8abfd08c96f316936e99e779b7803d5371b737e8df09434274ac0692578d571152f0ded068e4b23a8b3c619f54c99c2a4d9984
+  metadata.gz: 0f956bfe7c2dc686e35ba1ff2be245ed7792806942ec1f5cb196a85e85750ea0ffc3c7d6b97268a7f3315ef190713265ac5e0e2ef3e3a6f847ff42ec33f6162f
+  data.tar.gz: 97e0d45757d40e7be14c3bac848adcb81f7090272413fc81c7ea56fc3a9483ec42808eff5c3f4a43061e78c97edf508a79fd41d9e5a967568290e00dbfc5c75f

data/lib/google/cloud/data_catalog/v1/data_catalog.rb

@@ -31,8 +31,8 @@ module Google
     module DataCatalog
       module V1
         ##
-        # 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.
         #
         # To load this service and instantiate a client:
         #

data/lib/google/cloud/data_catalog/v1/data_catalog/client.rb

@@ -27,8 +27,8 @@ module Google
           ##
           # Client for the DataCatalog service.
           #
-          # 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 Client
             include Paths
@@ -194,22 +194,21 @@ module Google
             # Service calls
 
             ##
-            # 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).
             #
             # @overload search_catalog(request, options = nil)
             #   Pass arguments to `search_catalog` via a request object, either of type
@@ -227,43 +226,47 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param scope [::Google::Cloud::DataCatalog::V1::SearchCatalogRequest::Scope, ::Hash]
-            #     Required. The scope of this search request. A `scope` that has empty
-            #     `include_org_ids`, `include_project_ids` AND false
-            #     `include_gcp_public_datasets` is considered invalid. Data Catalog will
-            #     return an error in such a case.
+            #     Required. The scope of this search request.
+            #
+            #     The `scope` is invalid if `include_org_ids`, `include_project_ids` are
+            #     empty AND `include_gcp_public_datasets` is set to `false`. In this case,
+            #     the request returns an error.
             #   @param query [::String]
-            #     Optional. The query string in search query syntax. An empty query string will result
-            #     in all data assets (in the specified scope) that the user has access to.
+            #     Optional. The query string with a minimum of 3 characters and specific syntax.
+            #     For more information, see
+            #     [Data Catalog search syntax](/data-catalog/docs/how-to/search-reference).
             #
-            #     Query strings can be simple as "x" or more qualified as:
+            #     An empty query string returns all data assets (in the specified scope)
+            #     that you have access to.
             #
-            #     * name:x
-            #     * column:x
-            #     * description:y
+            #     A query string can be a simple `xyz` or qualified by predicates:
             #
-            #     Note: Query tokens need to have a minimum of 3 characters for substring
-            #     matching to work correctly. See [Data Catalog Search
-            #     Syntax](https://cloud.google.com/data-catalog/docs/how-to/search-reference)
-            #     for more information.
+            #     * `name:x`
+            #     * `column:y`
+            #     * `description:z`
             #   @param page_size [::Integer]
-            #     Number of results in the search page. If <=0 then defaults to 10. Max limit
-            #     for page_size is 1000. Throws an invalid argument for page_size > 1000.
+            #     Number of results to return in a single search page.
+            #
+            #     Can't be negative or 0, defaults to 10 in this case.
+            #     The maximum number is 1000. If exceeded, throws an "invalid argument"
+            #     exception.
             #   @param page_token [::String]
-            #     Optional. Pagination token returned in an earlier
-            #     {::Google::Cloud::DataCatalog::V1::SearchCatalogResponse#next_page_token SearchCatalogResponse.next_page_token}, which
-            #     indicates that this is a continuation of a prior
+            #     Optional. Pagination token that, if specified, returns the next page of search
+            #     results. If empty, returns the first page.
+            #
+            #     This token is returned in the {::Google::Cloud::DataCatalog::V1::SearchCatalogResponse#next_page_token SearchCatalogResponse.next_page_token}
+            #     field of the response to a previous
             #     {::Google::Cloud::DataCatalog::V1::DataCatalog::Client#search_catalog SearchCatalogRequest}
-            #     call, and that the system should return the next page of data. If empty,
-            #     the first page is returned.
+            #     call.
             #   @param order_by [::String]
-            #     Specifies the ordering of results, currently supported case-sensitive
-            #     choices are:
+            #     Specifies the order of results.
             #
-            #       * `relevance`, only supports descending
-            #       * `last_modified_timestamp [asc|desc]`, defaults to descending if not
-            #         specified
+            #     Currently supported case-sensitive values are:
             #
-            #     If not specified, defaults to `relevance` descending.
+            #     * `relevance` that can only be descending
+            #     * `last_modified_timestamp [asc|desc]` with descending (`desc`) as default
+            #
+            #     If this parameter is omitted, it defaults to the descending `relevance`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::DataCatalog::V1::SearchCatalogResult>]
@@ -306,25 +309,33 @@ module Google
             end
 
             ##
-            # Creates an EntryGroup.
+            # Creates an 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.
             #
-            # 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.
+            # Data Catalog automatically creates entry groups with names that start with
+            # the `@` symbol for the following resources:
             #
-            # 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.
+            # * 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).
             #
             # @overload create_entry_group(request, options = nil)
             #   Pass arguments to `create_entry_group` via a request object, either of type
@@ -342,9 +353,7 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The name of the project this entry group belongs to. Example:
-            #
-            #     `projects/{project_id}/locations/{location}`
+            #     Required. The names of the project and location that the new entry group belongs to.
             #
             #     Note: The entry group itself and its child resources might not be
             #     stored in the location specified in its name.
@@ -355,7 +364,7 @@ module Google
             #     underscores (_), and must start with a letter or underscore.
             #     The maximum size is 64 bytes when encoded in UTF-8.
             #   @param entry_group [::Google::Cloud::DataCatalog::V1::EntryGroup, ::Hash]
-            #     The entry group to create. Defaults to an empty entry group.
+            #     The entry group to create. Defaults to empty.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::DataCatalog::V1::EntryGroup]
@@ -403,7 +412,7 @@ module Google
             end
 
             ##
-            # Gets an EntryGroup.
+            # Gets an entry group.
             #
             # @overload get_entry_group(request, options = nil)
             #   Pass arguments to `get_entry_group` via a request object, either of type
@@ -421,10 +430,9 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. The name of the entry group. For example,
-            #     `projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}`.
+            #     Required. The name of the entry group to get.
             #   @param read_mask [::Google::Protobuf::FieldMask, ::Hash]
-            #     The fields to return. If not set or empty, all fields are returned.
+            #     The fields to return. If empty or omitted, all fields are returned.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::DataCatalog::V1::EntryGroup]
@@ -472,11 +480,12 @@ module Google
             end
 
             ##
-            # 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).
             #
             # @overload update_entry_group(request, options = nil)
             #   Pass arguments to `update_entry_group` via a request object, either of type
@@ -494,7 +503,7 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param entry_group [::Google::Cloud::DataCatalog::V1::EntryGroup, ::Hash]
-            #     Required. The updated entry group. "name" field must be set.
+            #     Required. Updates for the entry group. The `name` field must be set.
             #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
             #     Names of fields whose values to overwrite on an entry group.
             #
@@ -548,11 +557,12 @@ module Google
             end
 
             ##
-            # 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).
             #
             # @overload delete_entry_group(request, options = nil)
             #   Pass arguments to `delete_entry_group` via a request object, either of type
@@ -570,8 +580,7 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. The name of the entry group. For example,
-            #     `projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}`.
+            #     Required. The name of the entry group to delete.
             #   @param force [::Boolean]
             #     Optional. If true, deletes all entries in the entry group.
             #
@@ -639,16 +648,17 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The name of the location that contains the entry groups, which can be
-            #     provided in URL format. Example:
+            #     Required. The name of the location that contains the entry groups to list.
             #
-            #     * projects/\\{project_id}/locations/\\{location}
+            #     Can be provided as a URL.
             #   @param page_size [::Integer]
-            #     Optional. The maximum number of items to return. Default is 10. Max limit is 1000.
-            #     Throws an invalid argument for `page_size > 1000`.
+            #     Optional. The maximum number of items to return.
+            #
+            #     Default is 10. Maximum limit is 1000.
+            #     Throws an invalid argument if `page_size` is greater than 1000.
             #   @param page_token [::String]
-            #     Optional. Token that specifies which page is requested. If empty, the first page is
-            #     returned.
+            #     Optional. Pagination token that specifies the next page to return.
+            #     If empty, returns the first page.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::DataCatalog::V1::EntryGroup>]
@@ -697,15 +707,17 @@ module Google
             end
 
             ##
-            # Creates an entry. Only entries of types 'FILESET', 'CLUSTER', 'DATA_STREAM'
-            # or with a user-specified type can be created.
+            # Creates an entry.
+            #
+            # 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.
             #
-            # 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).
             #
-            # A maximum of 100,000 entries may be created per entry group.
+            # An entry group can have a maximum of 100,000 entries.
             #
             # @overload create_entry(request, options = nil)
             #   Pass arguments to `create_entry` via a request object, either of type
@@ -723,9 +735,7 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The name of the entry group this entry belongs to. Example:
-            #
-            #     `projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}`
+            #     Required. The name of the entry group this entry belongs to.
             #
             #     Note: The entry itself and its child resources might not be stored in
             #     the location specified in its name.
@@ -785,10 +795,11 @@ module Google
 
             ##
             # 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).
             #
             # @overload update_entry(request, options = nil)
             #   Pass arguments to `update_entry` via a request object, either of type
@@ -806,7 +817,7 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param entry [::Google::Cloud::DataCatalog::V1::Entry, ::Hash]
-            #     Required. The updated entry. The "name" field must be set.
+            #     Required. Updates for the entry. The `name` field must be set.
             #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
             #     Names of fields whose values to overwrite on an entry.
             #
@@ -814,24 +825,29 @@ module Google
             #     are overwritten. If such fields are non-required and omitted in the
             #     request body, their values are emptied.
             #
-            #     The following fields are modifiable:
-            #
-            #     * For entries with type `DATA_STREAM`:
-            #        * `schema`
-            #     * For entries with type `FILESET`:
-            #        * `schema`
-            #        * `display_name`
-            #        * `description`
-            #        * `gcs_fileset_spec`
-            #        * `gcs_fileset_spec.file_patterns`
-            #     * For entries with `user_specified_type`:
-            #        * `schema`
-            #        * `display_name`
-            #        * `description`
-            #        * `user_specified_type`
-            #        * `user_specified_system`
-            #        * `linked_resource`
-            #        * `source_system_timestamps`
+            #     You can modify only the fields listed below.
+            #
+            #     For entries with type `DATA_STREAM`:
+            #
+            #     * `schema`
+            #
+            #     For entries with type `FILESET`:
+            #
+            #     * `schema`
+            #     * `display_name`
+            #     * `description`
+            #     * `gcs_fileset_spec`
+            #     * `gcs_fileset_spec.file_patterns`
+            #
+            #     For entries with `user_specified_type`:
+            #
+            #     * `schema`
+            #     * `display_name`
+            #     * `description`
+            #     * `user_specified_type`
+            #     * `user_specified_system`
+            #     * `linked_resource`
+            #     * `source_system_timestamps`
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::DataCatalog::V1::Entry]
@@ -879,13 +895,16 @@ module Google
             end
 
             ##
-            # Deletes an existing entry. Only entries created through
+            # Deletes an existing entry.
+            #
+            # You can delete only the entries created by the
             # {::Google::Cloud::DataCatalog::V1::DataCatalog::Client#create_entry 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).
             #
             # @overload delete_entry(request, options = nil)
             #   Pass arguments to `delete_entry` via a request object, either of type
@@ -903,9 +922,7 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. The name of the entry. Example:
-            #
-            #     * projects/\\{project_id}/locations/\\{location}/entryGroups/\\{entry_group_id}/entries/\\{entry_id}
+            #     Required. The name of the entry to delete.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Protobuf::Empty]
@@ -971,9 +988,7 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. The name of the entry. Example:
-            #
-            #     * projects/\\{project_id}/locations/\\{location}/entryGroups/\\{entry_group_id}/entries/\\{entry_id}
+            #     Required. The name of the entry to get.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::DataCatalog::V1::Entry]
@@ -1021,9 +1036,9 @@ module Google
             end
 
             ##
-            # 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.
             #
             # @overload lookup_entry(request, options = nil)
             #   Pass arguments to `lookup_entry` via a request object, either of type
@@ -1042,27 +1057,27 @@ module Google
             #
             #   @param linked_resource [::String]
             #     The full name of the Google Cloud Platform resource the Data Catalog
-            #     entry represents. See:
-            #     https://cloud.google.com/apis/design/resource_names#full_resource_name.
-            #     Full names are case-sensitive.
+            #     entry represents. For more information, see [Full Resource Name]
+            #     (https://cloud.google.com/apis/design/resource_names#full_resource_name).
             #
-            #     Examples:
+            #     Full names are case-sensitive. For example:
             #
-            #      * //bigquery.googleapis.com/projects/projectId/datasets/datasetId/tables/tableId
-            #      * //pubsub.googleapis.com/projects/projectId/topics/topicId
+            #      * `//bigquery.googleapis.com/projects/{PROJECT_ID}/datasets/{DATASET_ID}/tables/{TABLE_ID}`
+            #      * `//pubsub.googleapis.com/projects/{PROJECT_ID}/topics/{TOPIC_ID}`
             #   @param sql_resource [::String]
             #     The SQL name of the entry. SQL names are case-sensitive.
             #
             #     Examples:
             #
-            #       * `pubsub.project_id.topic_id`
-            #       * ``pubsub.project_id.`topic.id.with.dots` ``
-            #       * `bigquery.table.project_id.dataset_id.table_id`
-            #       * `bigquery.dataset.project_id.dataset_id`
-            #       * `datacatalog.entry.project_id.location_id.entry_group_id.entry_id`
+            #     * `pubsub.topic.{PROJECT_ID}.{TOPIC_ID}`
+            #     * `pubsub.topic.{PROJECT_ID}.`\``{TOPIC.ID.SEPARATED.WITH.DOTS}`\`
+            #     * `bigquery.table.{PROJECT_ID}.{DATASET_ID}.{TABLE_ID}`
+            #     * `bigquery.dataset.{PROJECT_ID}.{DATASET_ID}`
+            #     * `datacatalog.entry.{PROJECT_ID}.{LOCATION_ID}.{ENTRY_GROUP_ID}.{ENTRY_ID}`
             #
-            #     `*_id`s should satisfy the standard SQL rules for identifiers.
-            #     https://cloud.google.com/bigquery/docs/reference/standard-sql/lexical.
+            #     Identifiers (`*_ID`) should comply with the
+            #     [Lexical structure in Standard SQL]
+            #     (https://cloud.google.com/bigquery/docs/reference/standard-sql/lexical).
             #   @param fully_qualified_name [::String]
             #     Fully qualified name (FQN) of the resource.
             #
@@ -1078,7 +1093,7 @@ module Google
             #
             #     Example for a DPMS table:
             #
-            #     `dataproc_metastore:project_id.location_id.instance_id.database_id.table_id`
+            #     `dataproc_metastore:{PROJECT_ID}.{LOCATION_ID}.{INSTANCE_ID}.{DATABASE_ID}.{TABLE_ID}`
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::DataCatalog::V1::Entry]
@@ -1138,21 +1153,21 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The name of the entry group that contains the entries, which can
-            #     be provided in URL format. Example:
+            #     Required. The name of the entry group that contains the entries to list.
             #
-            #     * projects/\\{project_id}/locations/\\{location}/entryGroups/\\{entry_group_id}
+            #     Can be provided in URL format.
             #   @param page_size [::Integer]
-            #     The maximum number of items to return. Default is 10. Max limit is 1000.
-            #     Throws an invalid argument for `page_size > 1000`.
+            #     The maximum number of items to return. Default is 10. Maximum limit is
+            #     1000. Throws an invalid argument if `page_size` is more than 1000.
             #   @param page_token [::String]
-            #     Token that specifies which page is requested. If empty, the first page is
-            #     returned.
+            #     Pagination token that specifies the next page to return. If empty, the
+            #     first page is returned.
             #   @param read_mask [::Google::Protobuf::FieldMask, ::Hash]
-            #     The fields to return for each Entry. If not set or empty, all
+            #     The fields to return for each entry. If empty or omitted, all
             #     fields are returned.
-            #     For example, setting read_mask to contain only one path "name" will cause
-            #     ListEntries to return a list of Entries with only "name" field.
+            #
+            #     For example, to return a list of entries with only the `name` field,
+            #     set `read_mask` to only one path with the `name` value.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::DataCatalog::V1::Entry>]
@@ -1201,11 +1216,12 @@ module Google
             end
 
             ##
-            # 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).
             #
             # @overload create_tag_template(request, options = nil)
             #   Pass arguments to `create_tag_template` via a request object, either of type
@@ -1225,10 +1241,6 @@ module Google
             #   @param parent [::String]
             #     Required. The name of the project and the template location
             #     [region](https://cloud.google.com/data-catalog/docs/concepts/regions).
-            #
-            #     Example:
-            #
-            #     * projects/\\{project_id}/locations/us-central1
             #   @param tag_template_id [::String]
             #     Required. The ID of the tag template to create.
             #
@@ -1302,9 +1314,7 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. The name of the tag template. Example:
-            #
-            #     * projects/\\{project_id}/locations/\\{location}/tagTemplates/\\{tag_template_id}
+            #     Required. The name of the tag template to get.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::DataCatalog::V1::TagTemplate]
@@ -1352,13 +1362,15 @@ module Google
             end
 
             ##
-            # 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).
             #
             # @overload update_tag_template(request, options = nil)
             #   Pass arguments to `update_tag_template` via a request object, either of type
@@ -1376,12 +1388,12 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param tag_template [::Google::Cloud::DataCatalog::V1::TagTemplate, ::Hash]
-            #     Required. The template to update. The "name" field must be set.
+            #     Required. The template to update. The `name` field must be set.
             #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
             #     Names of fields whose values to overwrite on a tag template. Currently,
             #     only `display_name` can be overwritten.
             #
-            #     In general, if this parameter is absent or empty, all modifiable fields
+            #     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.
             #
@@ -1431,11 +1443,11 @@ module Google
             end
 
             ##
-            # 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).
             #
             # @overload delete_tag_template(request, options = nil)
             #   Pass arguments to `delete_tag_template` via a request object, either of type
@@ -1453,13 +1465,11 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. The name of the tag template to delete. Example:
-            #
-            #     * projects/\\{project_id}/locations/\\{location}/tagTemplates/\\{tag_template_id}
+            #     Required. The name of the tag template to delete.
             #   @param force [::Boolean]
-            #     Required. Currently, this field must always be set to `true`.
-            #     This confirms the deletion of any possible tags using this template.
-            #     `force = false` will be supported in the future.
+            #     Required. If true, deletes all tags that use this template.
+            #
+            #     Currently, `true` is the only supported value.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Protobuf::Empty]
@@ -1507,11 +1517,11 @@ module Google
             end
 
             ##
-            # 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).
             #
             # @overload create_tag_template_field(request, options = nil)
             #   Pass arguments to `create_tag_template_field` via a request object, either of type
@@ -1531,10 +1541,6 @@ module Google
             #   @param parent [::String]
             #     Required. The name of the project and the template location
             #     [region](https://cloud.google.com/data-catalog/docs/concepts/regions).
-            #
-            #     Example:
-            #
-            #     * projects/\\{project_id}/locations/us-central1/tagTemplates/\\{tag_template_id}
             #   @param tag_template_field_id [::String]
             #     Required. The ID of the tag template field to create.
             #
@@ -1593,11 +1599,14 @@ module Google
             end
 
             ##
-            # 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).
             #
             # @overload update_tag_template_field(request, options = nil)
             #   Pass arguments to `update_tag_template_field` via a request object, either of type
@@ -1615,18 +1624,16 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. The name of the tag template field. Example:
-            #
-            #     * projects/\\{project_id}/locations/\\{location}/tagTemplates/\\{tag_template_id}/fields/\\{tag_template_field_id}
+            #     Required. The name of the tag template field.
             #   @param tag_template_field [::Google::Cloud::DataCatalog::V1::TagTemplateField, ::Hash]
             #     Required. The template to update.
             #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
             #     Optional. Names of fields whose values to overwrite on an individual field of a tag
             #     template. The following fields are modifiable:
             #
-            #       * `display_name`
-            #       * `type.enum_type`
-            #       * `is_required`
+            #     * `display_name`
+            #     * `type.enum_type`
+            #     * `is_required`
             #
             #     If this parameter is absent or empty, all modifiable fields
             #     are overwritten. If such fields are non-required and omitted in the request
@@ -1684,11 +1691,11 @@ module Google
             end
 
             ##
-            # 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).
             #
             # @overload rename_tag_template_field(request, options = nil)
             #   Pass arguments to `rename_tag_template_field` via a request object, either of type
@@ -1706,9 +1713,7 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. The name of the tag template. Example:
-            #
-            #     * projects/\\{project_id}/locations/\\{location}/tagTemplates/\\{tag_template_id}/fields/\\{tag_template_field_id}
+            #     Required. The name of the tag template.
             #   @param new_tag_template_field_id [::String]
             #     Required. The new ID of this tag template field. For example, `my_new_field`.
             #
@@ -1758,8 +1763,9 @@ module Google
             end
 
             ##
-            # 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.
             #
             # @overload rename_tag_template_field_enum_value(request, options = nil)
             #   Pass arguments to `rename_tag_template_field_enum_value` via a request object, either of type
@@ -1777,9 +1783,7 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. The name of the enum field value. Example:
-            #
-            #     * projects/\\{project_id}/locations/\\{location}/tagTemplates/\\{tag_template_id}/fields/\\{tag_template_field_id}/enumValues/\\{enum_value_display_name}
+            #     Required. The name of the enum field value.
             #   @param new_enum_value_display_name [::String]
             #     Required. The new display name of the enum value. For example, `my_new_enum_value`.
             #
@@ -1829,11 +1833,12 @@ module Google
             end
 
             ##
-            # 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).
             #
             # @overload delete_tag_template_field(request, options = nil)
             #   Pass arguments to `delete_tag_template_field` via a request object, either of type
@@ -1851,13 +1856,11 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. The name of the tag template field to delete. Example:
-            #
-            #     * projects/\\{project_id}/locations/\\{location}/tagTemplates/\\{tag_template_id}/fields/\\{tag_template_field_id}
+            #     Required. The name of the tag template field to delete.
             #   @param force [::Boolean]
-            #     Required. Currently, this field must always be set to `true`.
-            #     This confirms the deletion of this field from any tags using this field.
-            #     `force = false` will be supported in the future.
+            #     Required. If true, deletes this field from any tags that use it.
+            #
+            #     Currently, `true` is the only supported value.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Protobuf::Empty]
@@ -1905,13 +1908,18 @@ module Google
             end
 
             ##
-            # Creates a tag on an {::Google::Cloud::DataCatalog::V1::Entry 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 {::Google::Cloud::DataCatalog::V1::Entry Entry} if the method name is
+            #   ``projects.locations.entryGroups.entries.tags.create``.
+            # * Or {::Google::Cloud::DataCatalog::V1::EntryGroup 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.
             #
             # @overload create_tag(request, options = nil)
             #   Pass arguments to `create_tag` via a request object, either of type
@@ -1929,10 +1937,10 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The name of the resource to attach this tag to. Tags can be attached to
-            #     entries. An entry can have up to 1000 attached tags. Example:
+            #     Required. The name of the resource to attach this tag to.
             #
-            #     `projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id}`
+            #     Tags can be attached to entries or entry groups. An entry can have up to
+            #     1000 attached tags.
             #
             #     Note: The tag and its child resources might not be stored in
             #     the location specified in its name.
@@ -2076,9 +2084,7 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. The name of the tag to delete. Example:
-            #
-            #     * projects/\\{project_id}/locations/\\{location}/entryGroups/\\{entry_group_id}/entries/\\{entry_id}/tags/\\{tag_id}
+            #     Required. The name of the tag to delete.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Protobuf::Empty]
@@ -2126,7 +2132,7 @@ module Google
             end
 
             ##
-            # Lists the tags on an {::Google::Cloud::DataCatalog::V1::Entry Entry}.
+            # Lists tags assigned to an {::Google::Cloud::DataCatalog::V1::Entry Entry}.
             #
             # @overload list_tags(request, options = nil)
             #   Pass arguments to `list_tags` via a request object, either of type
@@ -2144,19 +2150,16 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The name of the Data Catalog resource to list the tags of. The resource
-            #     could be an {::Google::Cloud::DataCatalog::V1::Entry Entry} or an
-            #     {::Google::Cloud::DataCatalog::V1::EntryGroup EntryGroup}.
+            #     Required. The name of the Data Catalog resource to list the tags of.
             #
-            #     Examples:
-            #
-            #     * projects/\\{project_id}/locations/\\{location}/entryGroups/\\{entry_group_id}
-            #     * projects/\\{project_id}/locations/\\{location}/entryGroups/\\{entry_group_id}/entries/\\{entry_id}
+            #     The resource can be an {::Google::Cloud::DataCatalog::V1::Entry Entry}
+            #     or an {::Google::Cloud::DataCatalog::V1::EntryGroup EntryGroup}
+            #     (without `/entries/{entries}` at the end).
             #   @param page_size [::Integer]
-            #     The maximum number of tags to return. Default is 10. Max limit is 1000.
+            #     The maximum number of tags to return. Default is 10. Maximum limit is 1000.
             #   @param page_token [::String]
-            #     Token that specifies which page is requested. If empty, the first page is
-            #     returned.
+            #     Pagination token that specifies the next page to return. If empty, the
+            #     first page is returned.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::DataCatalog::V1::Tag>]
@@ -2205,20 +2208,23 @@ module Google
             end
 
             ##
-            # 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.
             #
             # @overload set_iam_policy(request, options = nil)
             #   Pass arguments to `set_iam_policy` via a request object, either of type
@@ -2290,22 +2296,27 @@ module Google
             end
 
             ##
-            # 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.
             #
             # @overload get_iam_policy(request, options = nil)
             #   Pass arguments to `get_iam_policy` via a request object, either of type
@@ -2375,19 +2386,20 @@ module Google
             end
 
             ##
-            # 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.
             #
             # @overload test_iam_permissions(request, options = nil)
             #   Pass arguments to `test_iam_permissions` via a request object, either of type