google-cloud-discovery_engine-v1 2.0.0 → 2.1.0

data/lib/google/cloud/discovery_engine/v1/site_search_engine_service/rest/client.rb

@@ -856,6 +856,279 @@ module Google
                 raise ::Google::Cloud::Error.from_error(e)
               end
 
+              ##
+              # Creates a {::Google::Cloud::DiscoveryEngine::V1::Sitemap Sitemap}.
+              #
+              # @overload create_sitemap(request, options = nil)
+              #   Pass arguments to `create_sitemap` via a request object, either of type
+              #   {::Google::Cloud::DiscoveryEngine::V1::CreateSitemapRequest} or an equivalent Hash.
+              #
+              #   @param request [::Google::Cloud::DiscoveryEngine::V1::CreateSitemapRequest, ::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 create_sitemap(parent: nil, sitemap: nil)
+              #   Pass arguments to `create_sitemap` 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 parent [::String]
+              #     Required. Parent resource name of the
+              #     {::Google::Cloud::DiscoveryEngine::V1::SiteSearchEngine SiteSearchEngine}, such
+              #     as `projects/*/locations/*/collections/*/dataStores/*/siteSearchEngine`.
+              #   @param sitemap [::Google::Cloud::DiscoveryEngine::V1::Sitemap, ::Hash]
+              #     Required. The {::Google::Cloud::DiscoveryEngine::V1::Sitemap Sitemap} to create.
+              # @yield [result, operation] Access the result along with the TransportOperation object
+              # @yieldparam result [::Gapic::Operation]
+              # @yieldparam operation [::Gapic::Rest::TransportOperation]
+              #
+              # @return [::Gapic::Operation]
+              #
+              # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/discovery_engine/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::DiscoveryEngine::V1::SiteSearchEngineService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::DiscoveryEngine::V1::CreateSitemapRequest.new
+              #
+              #   # Call the create_sitemap method.
+              #   result = client.create_sitemap request
+              #
+              #   # The returned object is of type Gapic::Operation. You can use it to
+              #   # check the status of an operation, cancel it, or wait for results.
+              #   # Here is how to wait for a response.
+              #   result.wait_until_done! timeout: 60
+              #   if result.response?
+              #     p result.response
+              #   else
+              #     puts "No response received."
+              #   end
+              #
+              def create_sitemap request, options = nil
+                raise ::ArgumentError, "request must be provided" if request.nil?
+
+                request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DiscoveryEngine::V1::CreateSitemapRequest
+
+                # 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
+                call_metadata = @config.rpcs.create_sitemap.metadata.to_h
+
+                # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
+                call_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::DiscoveryEngine::V1::VERSION,
+                  transports_version_send: [:rest]
+
+                call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
+                call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+                options.apply_defaults timeout:      @config.rpcs.create_sitemap.timeout,
+                                       metadata:     call_metadata,
+                                       retry_policy: @config.rpcs.create_sitemap.retry_policy
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
+                                       retry_policy: @config.retry_policy
+
+                @site_search_engine_service_stub.create_sitemap request, options do |result, operation|
+                  result = ::Gapic::Operation.new result, @operations_client, options: options
+                  yield result, operation if block_given?
+                  throw :response, result
+                end
+              rescue ::Gapic::Rest::Error => e
+                raise ::Google::Cloud::Error.from_error(e)
+              end
+
+              ##
+              # Deletes a {::Google::Cloud::DiscoveryEngine::V1::Sitemap Sitemap}.
+              #
+              # @overload delete_sitemap(request, options = nil)
+              #   Pass arguments to `delete_sitemap` via a request object, either of type
+              #   {::Google::Cloud::DiscoveryEngine::V1::DeleteSitemapRequest} or an equivalent Hash.
+              #
+              #   @param request [::Google::Cloud::DiscoveryEngine::V1::DeleteSitemapRequest, ::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 delete_sitemap(name: nil)
+              #   Pass arguments to `delete_sitemap` 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. Full resource name of
+              #     {::Google::Cloud::DiscoveryEngine::V1::Sitemap Sitemap}, such as
+              #     `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/siteSearchEngine/sitemaps/{sitemap}`.
+              #
+              #     If the caller does not have permission to access the
+              #     {::Google::Cloud::DiscoveryEngine::V1::Sitemap Sitemap}, regardless of whether
+              #     or not it exists, a PERMISSION_DENIED error is returned.
+              #
+              #     If the requested {::Google::Cloud::DiscoveryEngine::V1::Sitemap Sitemap} does
+              #     not exist, a NOT_FOUND error is returned.
+              # @yield [result, operation] Access the result along with the TransportOperation object
+              # @yieldparam result [::Gapic::Operation]
+              # @yieldparam operation [::Gapic::Rest::TransportOperation]
+              #
+              # @return [::Gapic::Operation]
+              #
+              # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/discovery_engine/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::DiscoveryEngine::V1::SiteSearchEngineService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::DiscoveryEngine::V1::DeleteSitemapRequest.new
+              #
+              #   # Call the delete_sitemap method.
+              #   result = client.delete_sitemap request
+              #
+              #   # The returned object is of type Gapic::Operation. You can use it to
+              #   # check the status of an operation, cancel it, or wait for results.
+              #   # Here is how to wait for a response.
+              #   result.wait_until_done! timeout: 60
+              #   if result.response?
+              #     p result.response
+              #   else
+              #     puts "No response received."
+              #   end
+              #
+              def delete_sitemap request, options = nil
+                raise ::ArgumentError, "request must be provided" if request.nil?
+
+                request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DiscoveryEngine::V1::DeleteSitemapRequest
+
+                # 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
+                call_metadata = @config.rpcs.delete_sitemap.metadata.to_h
+
+                # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
+                call_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::DiscoveryEngine::V1::VERSION,
+                  transports_version_send: [:rest]
+
+                call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
+                call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+                options.apply_defaults timeout:      @config.rpcs.delete_sitemap.timeout,
+                                       metadata:     call_metadata,
+                                       retry_policy: @config.rpcs.delete_sitemap.retry_policy
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
+                                       retry_policy: @config.retry_policy
+
+                @site_search_engine_service_stub.delete_sitemap request, options do |result, operation|
+                  result = ::Gapic::Operation.new result, @operations_client, options: options
+                  yield result, operation if block_given?
+                  throw :response, result
+                end
+              rescue ::Gapic::Rest::Error => e
+                raise ::Google::Cloud::Error.from_error(e)
+              end
+
+              ##
+              # Fetch {::Google::Cloud::DiscoveryEngine::V1::Sitemap Sitemap}s in a
+              # {::Google::Cloud::DiscoveryEngine::V1::DataStore DataStore}.
+              #
+              # @overload fetch_sitemaps(request, options = nil)
+              #   Pass arguments to `fetch_sitemaps` via a request object, either of type
+              #   {::Google::Cloud::DiscoveryEngine::V1::FetchSitemapsRequest} or an equivalent Hash.
+              #
+              #   @param request [::Google::Cloud::DiscoveryEngine::V1::FetchSitemapsRequest, ::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 fetch_sitemaps(parent: nil, matcher: nil)
+              #   Pass arguments to `fetch_sitemaps` 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 parent [::String]
+              #     Required. Parent resource name of the
+              #     {::Google::Cloud::DiscoveryEngine::V1::SiteSearchEngine SiteSearchEngine}, such
+              #     as `projects/*/locations/*/collections/*/dataStores/*/siteSearchEngine`.
+              #   @param matcher [::Google::Cloud::DiscoveryEngine::V1::FetchSitemapsRequest::Matcher, ::Hash]
+              #     Optional. If specified, fetches the matching
+              #     {::Google::Cloud::DiscoveryEngine::V1::Sitemap Sitemap}s. If not specified,
+              #     fetches all {::Google::Cloud::DiscoveryEngine::V1::Sitemap Sitemap}s in the
+              #     {::Google::Cloud::DiscoveryEngine::V1::DataStore DataStore}.
+              # @yield [result, operation] Access the result along with the TransportOperation object
+              # @yieldparam result [::Google::Cloud::DiscoveryEngine::V1::FetchSitemapsResponse]
+              # @yieldparam operation [::Gapic::Rest::TransportOperation]
+              #
+              # @return [::Google::Cloud::DiscoveryEngine::V1::FetchSitemapsResponse]
+              #
+              # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/discovery_engine/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::DiscoveryEngine::V1::SiteSearchEngineService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::DiscoveryEngine::V1::FetchSitemapsRequest.new
+              #
+              #   # Call the fetch_sitemaps method.
+              #   result = client.fetch_sitemaps request
+              #
+              #   # The returned object is of type Google::Cloud::DiscoveryEngine::V1::FetchSitemapsResponse.
+              #   p result
+              #
+              def fetch_sitemaps request, options = nil
+                raise ::ArgumentError, "request must be provided" if request.nil?
+
+                request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DiscoveryEngine::V1::FetchSitemapsRequest
+
+                # 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
+                call_metadata = @config.rpcs.fetch_sitemaps.metadata.to_h
+
+                # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
+                call_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::DiscoveryEngine::V1::VERSION,
+                  transports_version_send: [:rest]
+
+                call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
+                call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+                options.apply_defaults timeout:      @config.rpcs.fetch_sitemaps.timeout,
+                                       metadata:     call_metadata,
+                                       retry_policy: @config.rpcs.fetch_sitemaps.retry_policy
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
+                                       retry_policy: @config.retry_policy
+
+                @site_search_engine_service_stub.fetch_sitemaps request, options do |result, operation|
+                  yield result, operation if block_given?
+                end
+              rescue ::Gapic::Rest::Error => e
+                raise ::Google::Cloud::Error.from_error(e)
+              end
+
               ##
               # Upgrade from basic site search to advanced site search.
               #
@@ -1064,9 +1337,7 @@ module Google
               #     {::Google::Cloud::DiscoveryEngine::V1::TargetSite TargetSite} in
               #     `site_search_engine`.
               #   @param site_credential [::String]
-              #     Optional. Full resource name of the [SiteCredential][], such as
-              #     `projects/*/locations/*/collections/*/dataStores/*/siteSearchEngine/siteCredentials/*`.
-              #     Only set to crawl private URIs.
+              #     Optional. Credential id to use for crawling.
               # @yield [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Gapic::Operation]
               # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1507,6 +1778,21 @@ module Google
                   #
                   attr_reader :list_target_sites
                   ##
+                  # RPC-specific configuration for `create_sitemap`
+                  # @return [::Gapic::Config::Method]
+                  #
+                  attr_reader :create_sitemap
+                  ##
+                  # RPC-specific configuration for `delete_sitemap`
+                  # @return [::Gapic::Config::Method]
+                  #
+                  attr_reader :delete_sitemap
+                  ##
+                  # RPC-specific configuration for `fetch_sitemaps`
+                  # @return [::Gapic::Config::Method]
+                  #
+                  attr_reader :fetch_sitemaps
+                  ##
                   # RPC-specific configuration for `enable_advanced_site_search`
                   # @return [::Gapic::Config::Method]
                   #
@@ -1548,6 +1834,12 @@ module Google
                     @delete_target_site = ::Gapic::Config::Method.new delete_target_site_config
                     list_target_sites_config = parent_rpcs.list_target_sites if parent_rpcs.respond_to? :list_target_sites
                     @list_target_sites = ::Gapic::Config::Method.new list_target_sites_config
+                    create_sitemap_config = parent_rpcs.create_sitemap if parent_rpcs.respond_to? :create_sitemap
+                    @create_sitemap = ::Gapic::Config::Method.new create_sitemap_config
+                    delete_sitemap_config = parent_rpcs.delete_sitemap if parent_rpcs.respond_to? :delete_sitemap
+                    @delete_sitemap = ::Gapic::Config::Method.new delete_sitemap_config
+                    fetch_sitemaps_config = parent_rpcs.fetch_sitemaps if parent_rpcs.respond_to? :fetch_sitemaps
+                    @fetch_sitemaps = ::Gapic::Config::Method.new fetch_sitemaps_config
                     enable_advanced_site_search_config = parent_rpcs.enable_advanced_site_search if parent_rpcs.respond_to? :enable_advanced_site_search
                     @enable_advanced_site_search = ::Gapic::Config::Method.new enable_advanced_site_search_config
                     disable_advanced_site_search_config = parent_rpcs.disable_advanced_site_search if parent_rpcs.respond_to? :disable_advanced_site_search

data/lib/google/cloud/discovery_engine/v1/site_search_engine_service/rest/service_stub.rb

@@ -353,6 +353,126 @@ module Google
                 end
               end
 
+              ##
+              # Baseline implementation for the create_sitemap REST call
+              #
+              # @param request_pb [::Google::Cloud::DiscoveryEngine::V1::CreateSitemapRequest]
+              #   A request object representing the call parameters. Required.
+              # @param options [::Gapic::CallOptions]
+              #   Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+              #
+              # @yield [result, operation] Access the result along with the TransportOperation object
+              # @yieldparam result [::Google::Longrunning::Operation]
+              # @yieldparam operation [::Gapic::Rest::TransportOperation]
+              #
+              # @return [::Google::Longrunning::Operation]
+              #   A result object deserialized from the server's reply
+              def create_sitemap request_pb, options = nil
+                raise ::ArgumentError, "request must be provided" if request_pb.nil?
+
+                verb, uri, query_string_params, body = ServiceStub.transcode_create_sitemap_request request_pb
+                query_string_params = if query_string_params.any?
+                                        query_string_params.to_h { |p| p.split "=", 2 }
+                                      else
+                                        {}
+                                      end
+
+                response = @client_stub.make_http_request(
+                  verb,
+                  uri: uri,
+                  body: body || "",
+                  params: query_string_params,
+                  method_name: "create_sitemap",
+                  options: options
+                )
+                operation = ::Gapic::Rest::TransportOperation.new response
+                result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
+                catch :response do
+                  yield result, operation if block_given?
+                  result
+                end
+              end
+
+              ##
+              # Baseline implementation for the delete_sitemap REST call
+              #
+              # @param request_pb [::Google::Cloud::DiscoveryEngine::V1::DeleteSitemapRequest]
+              #   A request object representing the call parameters. Required.
+              # @param options [::Gapic::CallOptions]
+              #   Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+              #
+              # @yield [result, operation] Access the result along with the TransportOperation object
+              # @yieldparam result [::Google::Longrunning::Operation]
+              # @yieldparam operation [::Gapic::Rest::TransportOperation]
+              #
+              # @return [::Google::Longrunning::Operation]
+              #   A result object deserialized from the server's reply
+              def delete_sitemap request_pb, options = nil
+                raise ::ArgumentError, "request must be provided" if request_pb.nil?
+
+                verb, uri, query_string_params, body = ServiceStub.transcode_delete_sitemap_request request_pb
+                query_string_params = if query_string_params.any?
+                                        query_string_params.to_h { |p| p.split "=", 2 }
+                                      else
+                                        {}
+                                      end
+
+                response = @client_stub.make_http_request(
+                  verb,
+                  uri: uri,
+                  body: body || "",
+                  params: query_string_params,
+                  method_name: "delete_sitemap",
+                  options: options
+                )
+                operation = ::Gapic::Rest::TransportOperation.new response
+                result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
+                catch :response do
+                  yield result, operation if block_given?
+                  result
+                end
+              end
+
+              ##
+              # Baseline implementation for the fetch_sitemaps REST call
+              #
+              # @param request_pb [::Google::Cloud::DiscoveryEngine::V1::FetchSitemapsRequest]
+              #   A request object representing the call parameters. Required.
+              # @param options [::Gapic::CallOptions]
+              #   Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+              #
+              # @yield [result, operation] Access the result along with the TransportOperation object
+              # @yieldparam result [::Google::Cloud::DiscoveryEngine::V1::FetchSitemapsResponse]
+              # @yieldparam operation [::Gapic::Rest::TransportOperation]
+              #
+              # @return [::Google::Cloud::DiscoveryEngine::V1::FetchSitemapsResponse]
+              #   A result object deserialized from the server's reply
+              def fetch_sitemaps request_pb, options = nil
+                raise ::ArgumentError, "request must be provided" if request_pb.nil?
+
+                verb, uri, query_string_params, body = ServiceStub.transcode_fetch_sitemaps_request request_pb
+                query_string_params = if query_string_params.any?
+                                        query_string_params.to_h { |p| p.split "=", 2 }
+                                      else
+                                        {}
+                                      end
+
+                response = @client_stub.make_http_request(
+                  verb,
+                  uri: uri,
+                  body: body || "",
+                  params: query_string_params,
+                  method_name: "fetch_sitemaps",
+                  options: options
+                )
+                operation = ::Gapic::Rest::TransportOperation.new response
+                result = ::Google::Cloud::DiscoveryEngine::V1::FetchSitemapsResponse.decode_json response.body, ignore_unknown_fields: true
+                catch :response do
+                  yield result, operation if block_given?
+                  result
+                end
+              end
+
               ##
               # Baseline implementation for the enable_advanced_site_search REST call
               #
@@ -755,6 +875,92 @@ module Google
                 transcoder.transcode request_pb
               end
 
+              ##
+              # @private
+              #
+              # GRPC transcoding helper method for the create_sitemap REST call
+              #
+              # @param request_pb [::Google::Cloud::DiscoveryEngine::V1::CreateSitemapRequest]
+              #   A request object representing the call parameters. Required.
+              # @return [Array(String, [String, nil], Hash{String => String})]
+              #   Uri, Body, Query string parameters
+              def self.transcode_create_sitemap_request request_pb
+                transcoder = Gapic::Rest::GrpcTranscoder.new
+                                                        .with_bindings(
+                                                          uri_method: :post,
+                                                          uri_template: "/v1/{parent}/sitemaps",
+                                                          body: "sitemap",
+                                                          matches: [
+                                                            ["parent", %r{^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/siteSearchEngine/?$}, false]
+                                                          ]
+                                                        )
+                                                        .with_bindings(
+                                                          uri_method: :post,
+                                                          uri_template: "/v1/{parent}/sitemaps",
+                                                          body: "sitemap",
+                                                          matches: [
+                                                            ["parent", %r{^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/siteSearchEngine/?$}, false]
+                                                          ]
+                                                        )
+                transcoder.transcode request_pb
+              end
+
+              ##
+              # @private
+              #
+              # GRPC transcoding helper method for the delete_sitemap REST call
+              #
+              # @param request_pb [::Google::Cloud::DiscoveryEngine::V1::DeleteSitemapRequest]
+              #   A request object representing the call parameters. Required.
+              # @return [Array(String, [String, nil], Hash{String => String})]
+              #   Uri, Body, Query string parameters
+              def self.transcode_delete_sitemap_request request_pb
+                transcoder = Gapic::Rest::GrpcTranscoder.new
+                                                        .with_bindings(
+                                                          uri_method: :delete,
+                                                          uri_template: "/v1/{name}",
+                                                          matches: [
+                                                            ["name", %r{^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/siteSearchEngine/sitemaps/[^/]+/?$}, false]
+                                                          ]
+                                                        )
+                                                        .with_bindings(
+                                                          uri_method: :delete,
+                                                          uri_template: "/v1/{name}",
+                                                          matches: [
+                                                            ["name", %r{^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/siteSearchEngine/sitemaps/[^/]+/?$}, false]
+                                                          ]
+                                                        )
+                transcoder.transcode request_pb
+              end
+
+              ##
+              # @private
+              #
+              # GRPC transcoding helper method for the fetch_sitemaps REST call
+              #
+              # @param request_pb [::Google::Cloud::DiscoveryEngine::V1::FetchSitemapsRequest]
+              #   A request object representing the call parameters. Required.
+              # @return [Array(String, [String, nil], Hash{String => String})]
+              #   Uri, Body, Query string parameters
+              def self.transcode_fetch_sitemaps_request request_pb
+                transcoder = Gapic::Rest::GrpcTranscoder.new
+                                                        .with_bindings(
+                                                          uri_method: :get,
+                                                          uri_template: "/v1/{parent}/sitemaps:fetch",
+                                                          matches: [
+                                                            ["parent", %r{^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/siteSearchEngine/?$}, false]
+                                                          ]
+                                                        )
+                                                        .with_bindings(
+                                                          uri_method: :get,
+                                                          uri_template: "/v1/{parent}/sitemaps:fetch",
+                                                          matches: [
+                                                            ["parent", %r{^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/siteSearchEngine/?$}, false]
+                                                          ]
+                                                        )
+                transcoder.transcode request_pb
+              end
+
               ##
               # @private
               #

data/lib/google/cloud/discovery_engine/v1/user_event_service/client.rb

@@ -247,9 +247,9 @@ module Google
             #     {::Google::Cloud::DiscoveryEngine::V1::DataStore DataStore} level, the format
             #     is:
             #     `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}`.
-            #     If the write user event action is applied in [Location][] level, for
-            #     example, the event with
-            #     {::Google::Cloud::DiscoveryEngine::V1::Document Document} across multiple
+            #     If the write user event action is applied in
+            #     `::Google::Cloud::Location::Location` level, for example, the event
+            #     with {::Google::Cloud::DiscoveryEngine::V1::Document Document} across multiple
             #     {::Google::Cloud::DiscoveryEngine::V1::DataStore DataStore}, the format is:
             #     `projects/{project}/locations/{location}`.
             #   @param user_event [::Google::Cloud::DiscoveryEngine::V1::UserEvent, ::Hash]
@@ -345,8 +345,16 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The parent DataStore resource name, such as
+            #     Required. The parent resource name.
+            #     If the collect user event action is applied in
+            #     {::Google::Cloud::DiscoveryEngine::V1::DataStore DataStore} level, the format
+            #     is:
             #     `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}`.
+            #     If the collect user event action is applied in
+            #     `::Google::Cloud::Location::Location` level, for example, the event
+            #     with {::Google::Cloud::DiscoveryEngine::V1::Document Document} across multiple
+            #     {::Google::Cloud::DiscoveryEngine::V1::DataStore DataStore}, the format is:
+            #     `projects/{project}/locations/{location}`.
             #   @param user_event [::String]
             #     Required. URL encoded UserEvent proto with a length limit of 2,000,000
             #     characters.
@@ -462,16 +470,20 @@ module Google
             #     * `userId`: Double quoted string. Specifying this will delete all events
             #       associated with a user.
             #
+            #     Note: This API only supports purging a max range of 30 days.
+            #
             #     Examples:
             #
             #     * Deleting all events in a time range:
             #       `eventTime > "2012-04-23T18:25:43.511Z"
             #       eventTime < "2012-04-23T18:30:43.511Z"`
-            #     * Deleting specific eventType:
-            #       `eventType = "search"`
-            #     * Deleting all events for a specific visitor:
-            #       `userPseudoId = "visitor1024"`
-            #     * Deleting all events inside a DataStore:
+            #     * Deleting specific eventType in a time range:
+            #       `eventTime > "2012-04-23T18:25:43.511Z"
+            #       eventTime < "2012-04-23T18:30:43.511Z" eventType = "search"`
+            #     * Deleting all events for a specific visitor in a time range:
+            #       `eventTime > "2012-04-23T18:25:43.511Z"
+            #       eventTime < "2012-04-23T18:30:43.511Z" userPseudoId = "visitor1024"`
+            #     * Deleting the past 30 days of events inside a DataStore:
             #       `*`
             #
             #     The filtering fields are assumed to have an implicit AND.

data/lib/google/cloud/discovery_engine/v1/user_event_service/rest/client.rb

@@ -240,9 +240,9 @@ module Google
               #     {::Google::Cloud::DiscoveryEngine::V1::DataStore DataStore} level, the format
               #     is:
               #     `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}`.
-              #     If the write user event action is applied in [Location][] level, for
-              #     example, the event with
-              #     {::Google::Cloud::DiscoveryEngine::V1::Document Document} across multiple
+              #     If the write user event action is applied in
+              #     `::Google::Cloud::Location::Location` level, for example, the event
+              #     with {::Google::Cloud::DiscoveryEngine::V1::Document Document} across multiple
               #     {::Google::Cloud::DiscoveryEngine::V1::DataStore DataStore}, the format is:
               #     `projects/{project}/locations/{location}`.
               #   @param user_event [::Google::Cloud::DiscoveryEngine::V1::UserEvent, ::Hash]
@@ -331,8 +331,16 @@ module Google
               #   the default parameter values, pass an empty Hash as a request object (see above).
               #
               #   @param parent [::String]
-              #     Required. The parent DataStore resource name, such as
+              #     Required. The parent resource name.
+              #     If the collect user event action is applied in
+              #     {::Google::Cloud::DiscoveryEngine::V1::DataStore DataStore} level, the format
+              #     is:
               #     `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}`.
+              #     If the collect user event action is applied in
+              #     `::Google::Cloud::Location::Location` level, for example, the event
+              #     with {::Google::Cloud::DiscoveryEngine::V1::Document Document} across multiple
+              #     {::Google::Cloud::DiscoveryEngine::V1::DataStore DataStore}, the format is:
+              #     `projects/{project}/locations/{location}`.
               #   @param user_event [::String]
               #     Required. URL encoded UserEvent proto with a length limit of 2,000,000
               #     characters.
@@ -441,16 +449,20 @@ module Google
               #     * `userId`: Double quoted string. Specifying this will delete all events
               #       associated with a user.
               #
+              #     Note: This API only supports purging a max range of 30 days.
+              #
               #     Examples:
               #
               #     * Deleting all events in a time range:
               #       `eventTime > "2012-04-23T18:25:43.511Z"
               #       eventTime < "2012-04-23T18:30:43.511Z"`
-              #     * Deleting specific eventType:
-              #       `eventType = "search"`
-              #     * Deleting all events for a specific visitor:
-              #       `userPseudoId = "visitor1024"`
-              #     * Deleting all events inside a DataStore:
+              #     * Deleting specific eventType in a time range:
+              #       `eventTime > "2012-04-23T18:25:43.511Z"
+              #       eventTime < "2012-04-23T18:30:43.511Z" eventType = "search"`
+              #     * Deleting all events for a specific visitor in a time range:
+              #       `eventTime > "2012-04-23T18:25:43.511Z"
+              #       eventTime < "2012-04-23T18:30:43.511Z" userPseudoId = "visitor1024"`
+              #     * Deleting the past 30 days of events inside a DataStore:
               #       `*`
               #
               #     The filtering fields are assumed to have an implicit AND.