google-cloud-data_catalog-v1 0.8.2 → 0.10.0

data/proto_docs/google/cloud/datacatalog/v1/datacatalog.rb

@@ -34,7 +34,8 @@ module Google
         #   @return [::String]
         #     Optional. The query string with a minimum of 3 characters and specific syntax.
         #     For more information, see
-        #     [Data Catalog search syntax](https://cloud.google.com/data-catalog/docs/how-to/search-reference).
+        #     [Data Catalog search
+        #     syntax](https://cloud.google.com/data-catalog/docs/how-to/search-reference).
         #
         #     An empty query string returns all data assets (in the specified scope)
         #     that you have access to.
@@ -68,6 +69,7 @@ module Google
         #
         #     * `relevance` that can only be descending
         #     * `last_modified_timestamp [asc|desc]` with descending (`desc`) as default
+        #     * `default` that can only be descending
         #
         #     If this parameter is omitted, it defaults to the descending `relevance`.
         class SearchCatalogRequest
@@ -107,17 +109,15 @@ module Google
           #     `SearchCatalogResponse.unreachable` field. To get additional information
           #     on the error, repeat the search request and set the location name as the
           #     value of this parameter.
-          # @!attribute [rw] include_public_tag_templates
+          # @!attribute [rw] starred_only
           #   @return [::Boolean]
-          #     Optional. If `true`, include [public tag
-          #     templates][google.cloud.datacatalog.v1.TagTemplate.is_publicly_readable]
-          #     in the search results. By default, they are included only if you have
-          #     explicit permissions on them to view them. For example, if you are the
-          #     owner.
+          #     Optional. If `true`, search only among starred entries.
           #
-          #     Other scope fields, for example, ``include_org_ids``,
-          #     still restrict the returned public tag templates and at least one of
-          #     them is required.
+          #     By default, all results are returned, starred or not.
+          # @!attribute [rw] include_public_tag_templates
+          #   @return [::Boolean]
+          #     Optional. This field is deprecated. The search mechanism for public and private tag
+          #     templates is the same.
           class Scope
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -424,6 +424,7 @@ module Google
         #     and read-only afterwards. Can be used for search and lookup of the entries.
         #
         #
+        #
         #     FQNs take two forms:
         #
         #     * For non-regionalized resources:
@@ -519,6 +520,9 @@ module Google
         #     (CR), and page breaks (FF).
         #     The maximum size is 2000 bytes when encoded in UTF-8.
         #     Default value is an empty string.
+        # @!attribute [rw] business_context
+        #   @return [::Google::Cloud::DataCatalog::V1::BusinessContext]
+        #     Business Context of the entry. Not supported for BigQuery datasets.
         # @!attribute [rw] schema
         #   @return [::Google::Cloud::DataCatalog::V1::Schema]
         #     Schema of the entry. An entry might not have any schema attached to it.
@@ -543,6 +547,9 @@ module Google
         # @!attribute [r] data_source
         #   @return [::Google::Cloud::DataCatalog::V1::DataSource]
         #     Output only. Physical location of the entry.
+        # @!attribute [r] personal_details
+        #   @return [::Google::Cloud::DataCatalog::V1::PersonalDetails]
+        #     Output only. Additional information related to the entry. Private to the current user.
         class Entry
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -663,6 +670,55 @@ module Google
           end
         end
 
+        # Business Context of the entry.
+        # @!attribute [rw] entry_overview
+        #   @return [::Google::Cloud::DataCatalog::V1::EntryOverview]
+        #     Entry overview fields for rich text descriptions of entries.
+        # @!attribute [rw] contacts
+        #   @return [::Google::Cloud::DataCatalog::V1::Contacts]
+        #     Contact people for the entry.
+        class BusinessContext
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Entry overview fields for rich text descriptions of entries.
+        # @!attribute [rw] overview
+        #   @return [::String]
+        #     Entry overview with support for rich text.
+        #
+        #     The overview must only contain Unicode characters, and should be
+        #     formatted using HTML.
+        #     The maximum length is 10 MiB as this value holds HTML descriptions
+        #     including encoded images. The maximum length of the text without images
+        #     is 100 KiB.
+        class EntryOverview
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Contact people for the entry.
+        # @!attribute [rw] people
+        #   @return [::Array<::Google::Cloud::DataCatalog::V1::Contacts::Person>]
+        #     The list of contact people for the entry.
+        class Contacts
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # A contact person for the entry.
+          # @!attribute [rw] designation
+          #   @return [::String]
+          #     Designation of the person, for example, Data Steward.
+          # @!attribute [rw] email
+          #   @return [::String]
+          #     Email of the person in the format of `john.doe@example.com`,
+          #     `<john.doe@example.com>`, or `John Doe<john.doe@example.com>`.
+          class Person
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
         # Entry group metadata.
         #
         # An `EntryGroup` resource represents a logical grouping of zero or more
@@ -729,11 +785,14 @@ module Google
         # @!attribute [rw] update_mask
         #   @return [::Google::Protobuf::FieldMask]
         #     Names of fields whose values to overwrite on a tag template. Currently,
-        #     only `display_name` can be overwritten.
+        #     only `display_name` and `is_publicly_readable` can be overwritten.
         #
         #     If this parameter is absent or empty, all modifiable fields
         #     are overwritten. If such fields are non-required and omitted in the
         #     request body, their values are emptied.
+        #
+        #     Note: Updating the `is_publicly_readable` field may require up to 12
+        #     hours to take effect in search results.
         class UpdateTagTemplateRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -860,7 +919,7 @@ module Google
         # {::Google::Cloud::DataCatalog::V1::DataCatalog::Client#rename_tag_template_field RenameTagTemplateField}.
         # @!attribute [rw] name
         #   @return [::String]
-        #     Required. The name of the tag template.
+        #     Required. The name of the tag template field.
         # @!attribute [rw] new_tag_template_field_id
         #   @return [::String]
         #     Required. The new ID of this tag template field. For example, `my_new_field`.
@@ -973,6 +1032,68 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Request message for
+        # {::Google::Cloud::DataCatalog::V1::DataCatalog::Client#star_entry StarEntry}.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the entry to mark as starred.
+        class StarEntryRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response message for
+        # {::Google::Cloud::DataCatalog::V1::DataCatalog::Client#star_entry StarEntry}.
+        # Empty for now
+        class StarEntryResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for
+        # {::Google::Cloud::DataCatalog::V1::DataCatalog::Client#unstar_entry UnstarEntry}.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the entry to mark as **not** starred.
+        class UnstarEntryRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response message for
+        # {::Google::Cloud::DataCatalog::V1::DataCatalog::Client#unstar_entry UnstarEntry}.
+        # Empty for now
+        class UnstarEntryResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for
+        # {::Google::Cloud::DataCatalog::V1::DataCatalog::Client#modify_entry_overview ModifyEntryOverview}.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The full resource name of the entry.
+        # @!attribute [rw] entry_overview
+        #   @return [::Google::Cloud::DataCatalog::V1::EntryOverview]
+        #     Required. The new value for the Entry Overview.
+        class ModifyEntryOverviewRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for
+        # {::Google::Cloud::DataCatalog::V1::DataCatalog::Client#modify_entry_contacts ModifyEntryContacts}.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The full resource name of the entry.
+        # @!attribute [rw] contacts
+        #   @return [::Google::Cloud::DataCatalog::V1::Contacts]
+        #     Required. The new value for the Contacts.
+        class ModifyEntryContactsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # The enum field that lists all the types of entry resources in Data
         # Catalog. For example, a BigQuery table entry has the `TABLE` type.
         module EntryType

data/proto_docs/google/cloud/datacatalog/v1/policytagmanager.rb

@@ -105,8 +105,7 @@ module Google
         #   @return [::String]
         #     Output only. Resource name of this policy tag in the URL format.
         #
-        #     The policy tag manager generates unique taxonomy IDs and policy tag IDs.<br
-        #     /><br />
+        #     The policy tag manager generates unique taxonomy IDs and policy tag IDs.
         # @!attribute [rw] display_name
         #   @return [::String]
         #     Required. User-defined name of this policy tag.
@@ -228,8 +227,7 @@ module Google
         # {::Google::Cloud::DataCatalog::V1::PolicyTagManager::Client#create_policy_tag CreatePolicyTag}.
         # @!attribute [rw] parent
         #   @return [::String]
-        #     Required. Resource name of the taxonomy that the policy tag will belong to.<br /><br
-        #     />
+        #     Required. Resource name of the taxonomy that the policy tag will belong to.
         # @!attribute [rw] policy_tag
         #   @return [::Google::Cloud::DataCatalog::V1::PolicyTag]
         #     The policy tag to create.

data/proto_docs/google/cloud/datacatalog/v1/search.rb

@@ -83,6 +83,13 @@ module Google
         #     Example for a DPMS table:
         #
         #     `dataproc_metastore:PROJECT_ID.LOCATION_ID.INSTANCE_ID.DATABASE_ID.TABLE_ID`
+        # @!attribute [rw] display_name
+        #   @return [::String]
+        #     The display name of the result.
+        # @!attribute [rw] description
+        #   @return [::String]
+        #     Entry description that can consist of several sentences or paragraphs that
+        #     describe entry contents.
         class SearchCatalogResult
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/datacatalog/v1/table_spec.rb

@@ -83,6 +83,9 @@ module Google
         # @!attribute [r] shard_count
         #   @return [::Integer]
         #     Output only. Total number of shards.
+        # @!attribute [r] latest_shard_resource
+        #   @return [::String]
+        #     Output only. BigQuery resource name of the latest shard.
         class BigQueryDateShardedSpec
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/datacatalog/v1/tags.rb

@@ -149,33 +149,12 @@ module Google
         #     The maximum length is 200 characters.
         # @!attribute [rw] is_publicly_readable
         #   @return [::Boolean]
-        #     Indicates whether this is a public tag template.
+        #     Indicates whether tags created with this template are public. Public tags
+        #     do not require tag template access to appear in
+        #     [ListTags][google.cloud.datacatalog.v1.ListTags] API response.
         #
-        #     Every user has view access to a *public* tag template by default.
-        #     This means that:
-        #
-        #       * Every user can use this tag template to tag an entry.
-        #       * If an entry is tagged using the tag template, the tag is always
-        #         shown in the response to ``ListTags`` called on the entry.
-        #       * To get the template using the GetTagTemplate method, you
-        #         need view access either on the project or the organization the tag
-        #         template resides in but no other permission is needed.
-        #       * Operations on the tag template other than viewing (for example,
-        #         editing IAM policies) follow standard IAM structures.
-        #
-        #     Tags created with a public tag template are referred to as public tags.
-        #
-        #     You can search for a public tag by value with a
+        #     Additionally, you can search for a public tag by value with a
         #     simple search query instead of using a ``tag:`` predicate.
-        #
-        #     Public tag templates may not appear in search results depending on scope,
-        #     see:
-        #     {::Google::Cloud::DataCatalog::V1::SearchCatalogRequest::Scope#include_public_tag_templates include_public_tag_templates}
-        #
-        #     Note: If an [IAM domain
-        #     restriction](https://cloud.google.com/resource-manager/docs/organization-policy/restricting-domains)
-        #     is configured in the tag template's location, the public access will not be
-        #     enabled but the simple search for tag values will still work.
         # @!attribute [rw] fields
         #   @return [::Google::Protobuf::Map{::String => ::Google::Cloud::DataCatalog::V1::TagTemplateField}]
         #     Required. Map of tag template field IDs to the settings for the field.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-data_catalog-v1
 version: !ruby/object:Gem::Version
-  version: 0.8.2
+  version: 0.10.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-08-23 00:00:00.000000000 Z
+date: 2022-02-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -264,7 +264,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.17
+rubygems_version: 3.3.5
 signing_key: 
 specification_version: 4
 summary: API Client library for the Data Catalog V1 API