google-cloud-data_catalog-v1 0.9.1 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8a311e5a10026572c0e92fe24e6c88e88aefcc45721a71e665e22b294e05073b
-  data.tar.gz: befa1ec6aebee3e381eb38c635f28395ac78bcf0e923920df0f2d62bf3d94594
+  metadata.gz: 8ad643a4d17fd3db4f1a03cbf47927c7dbe7689143e746855de9c5be56d87391
+  data.tar.gz: 275d56cb790a053a2487ba4a104b043d1a2a05068420875897d9b87c92a0ec08
 SHA512:
-  metadata.gz: 43cfc151fed16cb0a1232e5e1389486b8af28915a745f1092f077b879cb8b2b64a0eed8c8a92ffc010034e0d22d609de89cd20605579efeffbc2b74164191be8
-  data.tar.gz: ffaa0bb1e5aa359f042ff0d27ac31e67e33979d981cf34b05c0648ae61c1774b240a1cab6eb2526b20c11419b60b02faf1b93d36b7c229736308766e3f4077a7
+  metadata.gz: a06e4b529947202ee77a3c92b5423bb766c983a0c05f9b36b77c585482f1a62080cd95718bdda89f7643a6d5c194df6ab2c95bd170e47c06df42d27bb345a467
+  data.tar.gz: 21bc61fe436fb546ceff79e706c7fa55c486fc831e2ac13dd1d1bdbee5dae2bfe636a05a0d72eb7ec8a7030f942198f67b3a2678d42d0cf14e0358d86ac51cf7

data/README.md

@@ -37,7 +37,7 @@ request = ::Google::Cloud::DataCatalog::V1::SearchCatalogRequest.new # (request
 response = client.search_catalog request
 ```
 
-View the [Client Library Documentation](https://googleapis.dev/ruby/google-cloud-data_catalog-v1/latest)
+View the [Client Library Documentation](https://cloud.google.com/ruby/docs/reference/google-cloud-data_catalog-v1/latest)
 for class and method documentation.
 
 See also the [Product Documentation](https://cloud.google.com/data-catalog)

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

@@ -260,6 +260,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`.
             #
@@ -1456,6 +1457,188 @@ module Google
               raise ::Google::Cloud::Error.from_error(e)
             end
 
+            ##
+            # Modifies entry overview, part of the business context of an
+            # {::Google::Cloud::DataCatalog::V1::Entry Entry}.
+            #
+            # To call this method, you must have the `datacatalog.entries.updateOverview`
+            # IAM permission on the corresponding project.
+            #
+            # @overload modify_entry_overview(request, options = nil)
+            #   Pass arguments to `modify_entry_overview` via a request object, either of type
+            #   {::Google::Cloud::DataCatalog::V1::ModifyEntryOverviewRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::DataCatalog::V1::ModifyEntryOverviewRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
+            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+            #
+            # @overload modify_entry_overview(name: nil, entry_overview: nil)
+            #   Pass arguments to `modify_entry_overview` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param name [::String]
+            #     Required. The full resource name of the entry.
+            #   @param entry_overview [::Google::Cloud::DataCatalog::V1::EntryOverview, ::Hash]
+            #     Required. The new value for the Entry Overview.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Google::Cloud::DataCatalog::V1::EntryOverview]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Google::Cloud::DataCatalog::V1::EntryOverview]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            # @example Basic example
+            #   require "google/cloud/data_catalog/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::DataCatalog::V1::DataCatalog::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::DataCatalog::V1::ModifyEntryOverviewRequest.new
+            #
+            #   # Call the modify_entry_overview method.
+            #   result = client.modify_entry_overview request
+            #
+            #   # The returned object is of type Google::Cloud::DataCatalog::V1::EntryOverview.
+            #   p result
+            #
+            def modify_entry_overview request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::ModifyEntryOverviewRequest
+
+              # Converts hash and nil to an options object
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+              # Customize the options with defaults
+              metadata = @config.rpcs.modify_entry_overview.metadata.to_h
+
+              # Set x-goog-api-client and x-goog-user-project headers
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
+              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              metadata[:"x-goog-request-params"] ||= request_params_header
+
+              options.apply_defaults timeout:      @config.rpcs.modify_entry_overview.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.modify_entry_overview.retry_policy
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @data_catalog_stub.call_rpc :modify_entry_overview, request, options: options do |response, operation|
+                yield response, operation if block_given?
+                return response
+              end
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
+            end
+
+            ##
+            # Modifies contacts, part of the business context of an
+            # {::Google::Cloud::DataCatalog::V1::Entry Entry}.
+            #
+            # To call this method, you must have the `datacatalog.entries.updateContacts`
+            # IAM permission on the corresponding project.
+            #
+            # @overload modify_entry_contacts(request, options = nil)
+            #   Pass arguments to `modify_entry_contacts` via a request object, either of type
+            #   {::Google::Cloud::DataCatalog::V1::ModifyEntryContactsRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::DataCatalog::V1::ModifyEntryContactsRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
+            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+            #
+            # @overload modify_entry_contacts(name: nil, contacts: nil)
+            #   Pass arguments to `modify_entry_contacts` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param name [::String]
+            #     Required. The full resource name of the entry.
+            #   @param contacts [::Google::Cloud::DataCatalog::V1::Contacts, ::Hash]
+            #     Required. The new value for the Contacts.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Google::Cloud::DataCatalog::V1::Contacts]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Google::Cloud::DataCatalog::V1::Contacts]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            # @example Basic example
+            #   require "google/cloud/data_catalog/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::DataCatalog::V1::DataCatalog::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::DataCatalog::V1::ModifyEntryContactsRequest.new
+            #
+            #   # Call the modify_entry_contacts method.
+            #   result = client.modify_entry_contacts request
+            #
+            #   # The returned object is of type Google::Cloud::DataCatalog::V1::Contacts.
+            #   p result
+            #
+            def modify_entry_contacts request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::ModifyEntryContactsRequest
+
+              # Converts hash and nil to an options object
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+              # Customize the options with defaults
+              metadata = @config.rpcs.modify_entry_contacts.metadata.to_h
+
+              # Set x-goog-api-client and x-goog-user-project headers
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
+              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              metadata[:"x-goog-request-params"] ||= request_params_header
+
+              options.apply_defaults timeout:      @config.rpcs.modify_entry_contacts.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.modify_entry_contacts.retry_policy
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @data_catalog_stub.call_rpc :modify_entry_contacts, request, options: options do |response, operation|
+                yield response, operation if block_given?
+                return response
+              end
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
+            end
+
             ##
             # Creates a tag template.
             #
@@ -1677,9 +1860,7 @@ module Google
             #     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. Additionally, it also requires
-            #     the `tagTemplates.getIamPolicy` and `tagTemplates.setIamPolicy`
-            #     permissions.
+            #     hours to take effect in search results.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::DataCatalog::V1::TagTemplate]
@@ -2607,6 +2788,8 @@ module Google
 
             ##
             # Lists tags assigned to an {::Google::Cloud::DataCatalog::V1::Entry Entry}.
+            # The {::Google::Cloud::DataCatalog::V1::Tag#column columns} in the response are
+            # lowercased.
             #
             # @overload list_tags(request, options = nil)
             #   Pass arguments to `list_tags` via a request object, either of type
@@ -2706,6 +2889,178 @@ module Google
               raise ::Google::Cloud::Error.from_error(e)
             end
 
+            ##
+            # Marks an {::Google::Cloud::DataCatalog::V1::Entry Entry} as starred by
+            # the current user. Starring information is private to each user.
+            #
+            # @overload star_entry(request, options = nil)
+            #   Pass arguments to `star_entry` via a request object, either of type
+            #   {::Google::Cloud::DataCatalog::V1::StarEntryRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::DataCatalog::V1::StarEntryRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
+            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+            #
+            # @overload star_entry(name: nil)
+            #   Pass arguments to `star_entry` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param name [::String]
+            #     Required. The name of the entry to mark as starred.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Google::Cloud::DataCatalog::V1::StarEntryResponse]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Google::Cloud::DataCatalog::V1::StarEntryResponse]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            # @example Basic example
+            #   require "google/cloud/data_catalog/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::DataCatalog::V1::DataCatalog::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::DataCatalog::V1::StarEntryRequest.new
+            #
+            #   # Call the star_entry method.
+            #   result = client.star_entry request
+            #
+            #   # The returned object is of type Google::Cloud::DataCatalog::V1::StarEntryResponse.
+            #   p result
+            #
+            def star_entry request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::StarEntryRequest
+
+              # Converts hash and nil to an options object
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+              # Customize the options with defaults
+              metadata = @config.rpcs.star_entry.metadata.to_h
+
+              # Set x-goog-api-client and x-goog-user-project headers
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
+              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              metadata[:"x-goog-request-params"] ||= request_params_header
+
+              options.apply_defaults timeout:      @config.rpcs.star_entry.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.star_entry.retry_policy
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @data_catalog_stub.call_rpc :star_entry, request, options: options do |response, operation|
+                yield response, operation if block_given?
+                return response
+              end
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
+            end
+
+            ##
+            # Marks an {::Google::Cloud::DataCatalog::V1::Entry Entry} as NOT starred by
+            # the current user. Starring information is private to each user.
+            #
+            # @overload unstar_entry(request, options = nil)
+            #   Pass arguments to `unstar_entry` via a request object, either of type
+            #   {::Google::Cloud::DataCatalog::V1::UnstarEntryRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::DataCatalog::V1::UnstarEntryRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
+            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+            #
+            # @overload unstar_entry(name: nil)
+            #   Pass arguments to `unstar_entry` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param name [::String]
+            #     Required. The name of the entry to mark as **not** starred.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Google::Cloud::DataCatalog::V1::UnstarEntryResponse]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Google::Cloud::DataCatalog::V1::UnstarEntryResponse]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            # @example Basic example
+            #   require "google/cloud/data_catalog/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::DataCatalog::V1::DataCatalog::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::DataCatalog::V1::UnstarEntryRequest.new
+            #
+            #   # Call the unstar_entry method.
+            #   result = client.unstar_entry request
+            #
+            #   # The returned object is of type Google::Cloud::DataCatalog::V1::UnstarEntryResponse.
+            #   p result
+            #
+            def unstar_entry request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::UnstarEntryRequest
+
+              # Converts hash and nil to an options object
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+              # Customize the options with defaults
+              metadata = @config.rpcs.unstar_entry.metadata.to_h
+
+              # Set x-goog-api-client and x-goog-user-project headers
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              header_params = {}
+              if request.name
+                header_params["name"] = request.name
+              end
+
+              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              metadata[:"x-goog-request-params"] ||= request_params_header
+
+              options.apply_defaults timeout:      @config.rpcs.unstar_entry.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.unstar_entry.retry_policy
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @data_catalog_stub.call_rpc :unstar_entry, request, options: options do |response, operation|
+                yield response, operation if block_given?
+                return response
+              end
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
+            end
+
             ##
             # Sets an access control policy for a resource. Replaces any existing
             # policy.
@@ -3222,6 +3577,16 @@ module Google
                 #
                 attr_reader :list_entries
                 ##
+                # RPC-specific configuration for `modify_entry_overview`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :modify_entry_overview
+                ##
+                # RPC-specific configuration for `modify_entry_contacts`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :modify_entry_contacts
+                ##
                 # RPC-specific configuration for `create_tag_template`
                 # @return [::Gapic::Config::Method]
                 #
@@ -3287,6 +3652,16 @@ module Google
                 #
                 attr_reader :list_tags
                 ##
+                # RPC-specific configuration for `star_entry`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :star_entry
+                ##
+                # RPC-specific configuration for `unstar_entry`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :unstar_entry
+                ##
                 # RPC-specific configuration for `set_iam_policy`
                 # @return [::Gapic::Config::Method]
                 #
@@ -3328,6 +3703,10 @@ module Google
                   @lookup_entry = ::Gapic::Config::Method.new lookup_entry_config
                   list_entries_config = parent_rpcs.list_entries if parent_rpcs.respond_to? :list_entries
                   @list_entries = ::Gapic::Config::Method.new list_entries_config
+                  modify_entry_overview_config = parent_rpcs.modify_entry_overview if parent_rpcs.respond_to? :modify_entry_overview
+                  @modify_entry_overview = ::Gapic::Config::Method.new modify_entry_overview_config
+                  modify_entry_contacts_config = parent_rpcs.modify_entry_contacts if parent_rpcs.respond_to? :modify_entry_contacts
+                  @modify_entry_contacts = ::Gapic::Config::Method.new modify_entry_contacts_config
                   create_tag_template_config = parent_rpcs.create_tag_template if parent_rpcs.respond_to? :create_tag_template
                   @create_tag_template = ::Gapic::Config::Method.new create_tag_template_config
                   get_tag_template_config = parent_rpcs.get_tag_template if parent_rpcs.respond_to? :get_tag_template
@@ -3354,6 +3733,10 @@ module Google
                   @delete_tag = ::Gapic::Config::Method.new delete_tag_config
                   list_tags_config = parent_rpcs.list_tags if parent_rpcs.respond_to? :list_tags
                   @list_tags = ::Gapic::Config::Method.new list_tags_config
+                  star_entry_config = parent_rpcs.star_entry if parent_rpcs.respond_to? :star_entry
+                  @star_entry = ::Gapic::Config::Method.new star_entry_config
+                  unstar_entry_config = parent_rpcs.unstar_entry if parent_rpcs.respond_to? :unstar_entry
+                  @unstar_entry = ::Gapic::Config::Method.new unstar_entry_config
                   set_iam_policy_config = parent_rpcs.set_iam_policy if parent_rpcs.respond_to? :set_iam_policy
                   @set_iam_policy = ::Gapic::Config::Method.new set_iam_policy_config
                   get_iam_policy_config = parent_rpcs.get_iam_policy if parent_rpcs.respond_to? :get_iam_policy

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module DataCatalog
       module V1
-        VERSION = "0.9.1"
+        VERSION = "0.10.0"
       end
     end
   end

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

@@ -6,6 +6,10 @@ require 'google/protobuf'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/cloud/datacatalog/v1/common.proto", :syntax => :proto3) do
+    add_message "google.cloud.datacatalog.v1.PersonalDetails" do
+      optional :starred, :bool, 1
+      optional :star_time, :message, 2, "google.protobuf.Timestamp"
+    end
     add_enum "google.cloud.datacatalog.v1.IntegratedSystem" do
       value :INTEGRATED_SYSTEM_UNSPECIFIED, 0
       value :BIGQUERY, 1
@@ -19,6 +23,7 @@ module Google
   module Cloud
     module DataCatalog
       module V1
+        PersonalDetails = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.PersonalDetails").msgclass
         IntegratedSystem = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.IntegratedSystem").enummodule
       end
     end

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

@@ -36,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 :starred_only, :bool, 18
       optional :include_public_tag_templates, :bool, 19
     end
     add_message "google.cloud.datacatalog.v1.SearchCatalogResponse" do
@@ -97,11 +98,13 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :fully_qualified_name, :string, 29
       optional :display_name, :string, 3
       optional :description, :string, 4
+      optional :business_context, :message, 37, "google.cloud.datacatalog.v1.BusinessContext"
       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"
+      optional :personal_details, :message, 26, "google.cloud.datacatalog.v1.PersonalDetails"
       oneof :entry_type do
         optional :type, :enum, 2, "google.cloud.datacatalog.v1.EntryType"
         optional :user_specified_type, :string, 16
@@ -158,6 +161,20 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :SCALAR_FUNCTION, 1
       value :PROCEDURE, 2
     end
+    add_message "google.cloud.datacatalog.v1.BusinessContext" do
+      optional :entry_overview, :message, 1, "google.cloud.datacatalog.v1.EntryOverview"
+      optional :contacts, :message, 2, "google.cloud.datacatalog.v1.Contacts"
+    end
+    add_message "google.cloud.datacatalog.v1.EntryOverview" do
+      optional :overview, :string, 1
+    end
+    add_message "google.cloud.datacatalog.v1.Contacts" do
+      repeated :people, :message, 1, "google.cloud.datacatalog.v1.Contacts.Person"
+    end
+    add_message "google.cloud.datacatalog.v1.Contacts.Person" do
+      optional :designation, :string, 1
+      optional :email, :string, 2
+    end
     add_message "google.cloud.datacatalog.v1.EntryGroup" do
       optional :name, :string, 1
       optional :display_name, :string, 2
@@ -232,6 +249,24 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       repeated :entries, :message, 1, "google.cloud.datacatalog.v1.Entry"
       optional :next_page_token, :string, 2
     end
+    add_message "google.cloud.datacatalog.v1.StarEntryRequest" do
+      optional :name, :string, 1
+    end
+    add_message "google.cloud.datacatalog.v1.StarEntryResponse" do
+    end
+    add_message "google.cloud.datacatalog.v1.UnstarEntryRequest" do
+      optional :name, :string, 1
+    end
+    add_message "google.cloud.datacatalog.v1.UnstarEntryResponse" do
+    end
+    add_message "google.cloud.datacatalog.v1.ModifyEntryOverviewRequest" do
+      optional :name, :string, 1
+      optional :entry_overview, :message, 2, "google.cloud.datacatalog.v1.EntryOverview"
+    end
+    add_message "google.cloud.datacatalog.v1.ModifyEntryContactsRequest" do
+      optional :name, :string, 1
+      optional :contacts, :message, 2, "google.cloud.datacatalog.v1.Contacts"
+    end
     add_enum "google.cloud.datacatalog.v1.EntryType" do
       value :ENTRY_TYPE_UNSPECIFIED, 0
       value :TABLE, 2
@@ -273,6 +308,10 @@ module Google
         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
+        BusinessContext = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.BusinessContext").msgclass
+        EntryOverview = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.EntryOverview").msgclass
+        Contacts = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.Contacts").msgclass
+        Contacts::Person = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.Contacts.Person").msgclass
         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
@@ -290,6 +329,12 @@ module Google
         ListTagsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.ListTagsResponse").msgclass
         ListEntriesRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.ListEntriesRequest").msgclass
         ListEntriesResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.ListEntriesResponse").msgclass
+        StarEntryRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.StarEntryRequest").msgclass
+        StarEntryResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.StarEntryResponse").msgclass
+        UnstarEntryRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.UnstarEntryRequest").msgclass
+        UnstarEntryResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.UnstarEntryResponse").msgclass
+        ModifyEntryOverviewRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.ModifyEntryOverviewRequest").msgclass
+        ModifyEntryContactsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.ModifyEntryContactsRequest").msgclass
         EntryType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.datacatalog.v1.EntryType").enummodule
       end
     end

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

@@ -138,6 +138,18 @@ module Google
             # To get a list of both custom and automatically created entries, use
             # [SearchCatalog][google.cloud.datacatalog.v1.DataCatalog.SearchCatalog].
             rpc :ListEntries, ::Google::Cloud::DataCatalog::V1::ListEntriesRequest, ::Google::Cloud::DataCatalog::V1::ListEntriesResponse
+            # Modifies entry overview, part of the business context of an
+            # [Entry][google.cloud.datacatalog.v1.Entry].
+            #
+            # To call this method, you must have the `datacatalog.entries.updateOverview`
+            # IAM permission on the corresponding project.
+            rpc :ModifyEntryOverview, ::Google::Cloud::DataCatalog::V1::ModifyEntryOverviewRequest, ::Google::Cloud::DataCatalog::V1::EntryOverview
+            # Modifies contacts, part of the business context of an
+            # [Entry][google.cloud.datacatalog.v1.Entry].
+            #
+            # To call this method, you must have the `datacatalog.entries.updateContacts`
+            # IAM permission on the corresponding project.
+            rpc :ModifyEntryContacts, ::Google::Cloud::DataCatalog::V1::ModifyEntryContactsRequest, ::Google::Cloud::DataCatalog::V1::Contacts
             # Creates a tag template.
             #
             # You must enable the Data Catalog API in the project identified by the
@@ -213,7 +225,15 @@ module Google
             # Deletes a tag.
             rpc :DeleteTag, ::Google::Cloud::DataCatalog::V1::DeleteTagRequest, ::Google::Protobuf::Empty
             # Lists tags assigned to an [Entry][google.cloud.datacatalog.v1.Entry].
+            # The [columns][google.cloud.datacatalog.v1.Tag.column] in the response are
+            # lowercased.
             rpc :ListTags, ::Google::Cloud::DataCatalog::V1::ListTagsRequest, ::Google::Cloud::DataCatalog::V1::ListTagsResponse
+            # Marks an [Entry][google.cloud.datacatalog.v1.Entry] as starred by
+            # the current user. Starring information is private to each user.
+            rpc :StarEntry, ::Google::Cloud::DataCatalog::V1::StarEntryRequest, ::Google::Cloud::DataCatalog::V1::StarEntryResponse
+            # Marks an [Entry][google.cloud.datacatalog.v1.Entry] as NOT starred by
+            # the current user. Starring information is private to each user.
+            rpc :UnstarEntry, ::Google::Cloud::DataCatalog::V1::UnstarEntryRequest, ::Google::Cloud::DataCatalog::V1::UnstarEntryResponse
             # Sets an access control policy for a resource. Replaces any existing
             # policy.
             #

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

@@ -2,11 +2,11 @@
 # source: google/cloud/datacatalog/v1/policytagmanagerserialization.proto
 
 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/policytagmanager_pb'
 require 'google/iam/v1/policy_pb'
-require 'google/api/client_pb'
 require 'google/protobuf'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do

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

@@ -21,6 +21,18 @@ module Google
   module Cloud
     module DataCatalog
       module V1
+        # Entry metadata relevant only to the user and private to them.
+        # @!attribute [rw] starred
+        #   @return [::Boolean]
+        #     True if the entry is starred by the user; false otherwise.
+        # @!attribute [rw] star_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Set if the entry is starred; unset otherwise.
+        class PersonalDetails
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # This enum lists all the systems that Data Catalog integrates with.
         module IntegratedSystem
           # Default unknown system.

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

@@ -69,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
@@ -108,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
@@ -521,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.
@@ -545,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
@@ -665,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
@@ -738,9 +792,7 @@ module Google
         #     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. Additionally, it also requires
-        #     the `tagTemplates.getIamPolicy` and `tagTemplates.setIamPolicy`
-        #     permissions.
+        #     hours to take effect in search results.
         class UpdateTagTemplateRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -980,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/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.9.1
+  version: 0.10.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-01-11 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.3.4
+rubygems_version: 3.3.5
 signing_key: 
 specification_version: 4
 summary: API Client library for the Data Catalog V1 API