google-apis-discoveryengine_v1beta 0.6.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3de6e627c61e4f1b771df012578ffd621ccc8bc8ea9cd282298e510ea3412d63
-  data.tar.gz: '0778ed2b8a44985221d28b85a99a1a3dc9ec028091d665f9b4934e1f5df4ecf1'
+  metadata.gz: 3a96c53759f1a0739e5bdc188111fb1b0635f6dfa5742d43860f146314a0cbe6
+  data.tar.gz: b7b27196087c0813affa64c550cdfbf98b0e22323ad4fa8ab9b1e045fa67f0cb
 SHA512:
-  metadata.gz: 0faa49d24aef60e7d1d5ad20630b8ff416c9b4bf9e5a6d639c4aabcc5aa9fdc0be2cbfc299d9e6fdc67c4eaa70fc302a53498f59239fda8b4bf7d084f00b38af
-  data.tar.gz: f0d613bf872075bda8a75c8c7ed1a236a370a03e6eccf0e489ca6c8a43a24aae22916dd186f137a15b684a996148e6adde94dc13fc9352bf75f9174ee1c1d153
+  metadata.gz: b35e5f087cf0edcbf2f892efec6e8022e9b14a62feb8090ad24e2fc83d98c01dbb0f845e92c585a703f1e03a3eb5342cbfd37dba7a4ee0bde23f7c8bc16970f6
+  data.tar.gz: d2b0df649bdfb32dcb2a2de959eee3246de03ab2ca9391540f2b3eca63f8fbb9ef0c694a2a76f5c6f8151acdbe7efe7890b40906a07174ee441fc8bed006ba72

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-discoveryengine_v1beta
 
+### v0.8.0 (2023-03-05)
+
+* Regenerated from discovery document revision 20230227
+
+### v0.7.0 (2023-02-26)
+
+* Regenerated from discovery document revision 20230209
+
 ### v0.6.0 (2023-02-15)
 
 * Regenerated using generator version 0.12.0

data/lib/google/apis/discoveryengine_v1beta/classes.rb

@@ -105,9 +105,10 @@ module Google
         # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineLoggingErrorContext]
         attr_accessor :context
       
-        # The error payload that is populated on LRO import APIs. Including: "google.
-        # cloud.discoveryengine.v1alpha.DocumentService.ImportDocuments" "google.cloud.
-        # discoveryengine.v1alpha.UserEventService.ImportUserEvents"
+        # The error payload that is populated on LRO import APIs, including the
+        # following: * `google.cloud.discoveryengine.v1alpha.DocumentService.
+        # ImportDocuments` * `google.cloud.discoveryengine.v1alpha.UserEventService.
+        # ImportUserEvents`
         # Corresponds to the JSON property `importPayload`
         # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineLoggingImportErrorContext]
         attr_accessor :import_payload
@@ -117,26 +118,6 @@ module Google
         # @return [String]
         attr_accessor :message
       
-        # The API request payload, represented as a protocol buffer. Most API request
-        # types are supported. For example: "type.googleapis.com/google.cloud.
-        # discoveryengine.v1alpha.DocumentService.CreateDocumentRequest" "type.
-        # googleapis.com/google.cloud.discoveryengine.v1alpha.UserEventService.
-        # WriteUserEventRequest"
-        # Corresponds to the JSON property `requestPayload`
-        # @return [Hash<String,Object>]
-        attr_accessor :request_payload
-      
-        # The API response payload, represented as a protocol buffer. This is used to
-        # log some "soft errors", where the response is valid but we consider there are
-        # some quality issues like unjoined events. The following API responses are
-        # supported and no PII is included: "google.cloud.discoveryengine.v1alpha.
-        # RecommendationService.Recommend" "google.cloud.discoveryengine.v1alpha.
-        # UserEventService.WriteUserEvent" "google.cloud.discoveryengine.v1alpha.
-        # UserEventService.CollectUserEvent"
-        # Corresponds to the JSON property `responsePayload`
-        # @return [Hash<String,Object>]
-        attr_accessor :response_payload
-      
         # Describes a running service that sends errors.
         # Corresponds to the JSON property `serviceContext`
         # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineLoggingServiceContext]
@@ -161,8 +142,6 @@ module Google
           @context = args[:context] if args.key?(:context)
           @import_payload = args[:import_payload] if args.key?(:import_payload)
           @message = args[:message] if args.key?(:message)
-          @request_payload = args[:request_payload] if args.key?(:request_payload)
-          @response_payload = args[:response_payload] if args.key?(:response_payload)
           @service_context = args[:service_context] if args.key?(:service_context)
           @status = args[:status] if args.key?(:status)
         end
@@ -187,9 +166,10 @@ module Google
         end
       end
       
-      # The error payload that is populated on LRO import APIs. Including: "google.
-      # cloud.discoveryengine.v1alpha.DocumentService.ImportDocuments" "google.cloud.
-      # discoveryengine.v1alpha.UserEventService.ImportUserEvents"
+      # The error payload that is populated on LRO import APIs, including the
+      # following: * `google.cloud.discoveryengine.v1alpha.DocumentService.
+      # ImportDocuments` * `google.cloud.discoveryengine.v1alpha.UserEventService.
+      # ImportUserEvents`
       class GoogleCloudDiscoveryengineLoggingImportErrorContext
         include Google::Apis::Core::Hashable
       
@@ -238,7 +218,7 @@ module Google
       class GoogleCloudDiscoveryengineLoggingServiceContext
         include Google::Apis::Core::Hashable
       
-        # An identifier of the service. For example, "discoveryengine.googleapis.com".
+        # An identifier of the service—for example, `discoveryengine.googleapis.com`.
         # Corresponds to the JSON property `service`
         # @return [String]
         attr_accessor :service
@@ -258,8 +238,8 @@ module Google
       class GoogleCloudDiscoveryengineLoggingSourceLocation
         include Google::Apis::Core::Hashable
       
-        # Human-readable name of a function or method. For example, " google.cloud.
-        # discoveryengine.v1alpha.RecommendationService.Recommend".
+        # Human-readable name of a function or method—for example, `google.cloud.
+        # discoveryengine.v1alpha.RecommendationService.Recommend`.
         # Corresponds to the JSON property `functionName`
         # @return [String]
         attr_accessor :function_name
@@ -582,9 +562,9 @@ module Google
         attr_accessor :json_data
       
         # Immutable. The full resource name of the document. Format: `projects/`project`/
-        # locations/`location`/dataStores/`data_store`/branches/`branch`/documents/`
-        # document_id``. This field must be a UTF-8 encoded string with a length limit
-        # of 1024 characters.
+        # locations/`location`/collections/`collection`/dataStores/`data_store`/branches/
+        # `branch`/documents/`document_id``. This field must be a UTF-8 encoded string
+        # with a length limit of 1024 characters.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -631,8 +611,9 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # Required. The Document resource full name, of the form: projects//locations//
-        # dataStores//branches//documents/
+        # Required. The Document resource full name, of the form: projects/`project\_id`/
+        # locations/`location`/collections/`collection\_id`/dataStores/`data\_store\_id`/
+        # branches/`branch\_id`/documents/`document\_id`
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name

data/lib/google/apis/discoveryengine_v1beta/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module DiscoveryengineV1beta
       # Version of the google-apis-discoveryengine_v1beta gem
-      GEM_VERSION = "0.6.0"
+      GEM_VERSION = "0.8.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.12.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20230105"
+      REVISION = "20230227"
     end
   end
 end

data/lib/google/apis/discoveryengine_v1beta/representations.rb

@@ -307,8 +307,6 @@ module Google
           property :import_payload, as: 'importPayload', class: Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineLoggingImportErrorContext, decorator: Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineLoggingImportErrorContext::Representation
       
           property :message, as: 'message'
-          hash :request_payload, as: 'requestPayload'
-          hash :response_payload, as: 'responsePayload'
           property :service_context, as: 'serviceContext', class: Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineLoggingServiceContext, decorator: Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineLoggingServiceContext::Representation
       
           property :status, as: 'status', class: Google::Apis::DiscoveryengineV1beta::GoogleRpcStatus, decorator: Google::Apis::DiscoveryengineV1beta::GoogleRpcStatus::Representation

data/lib/google/apis/discoveryengine_v1beta/service.rb

@@ -52,7 +52,400 @@ module Google
         # Creates a Document.
         # @param [String] parent
         #   Required. The parent resource name, such as `projects/`project`/locations/`
-        #   location`/dataStores/`data_store`/branches/`branch``.
+        #   location`/collections/`collection`/dataStores/`data_store`/branches/`branch``.
+        # @param [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaDocument] google_cloud_discoveryengine_v1beta_document_object
+        # @param [String] document_id
+        #   Required. The ID to use for the Document, which will become the final
+        #   component of the Document.name. If the caller does not have permission to
+        #   create the Document, regardless of whether or not it exists, a
+        #   PERMISSION_DENIED error is returned. This field must be unique among all
+        #   Documents with the same parent. Otherwise, an ALREADY_EXISTS error is returned.
+        #   This field must conform to [RFC-1034](https://tools.ietf.org/html/rfc1034)
+        #   standard with a length limit of 63 characters. Otherwise, an INVALID_ARGUMENT
+        #   error is returned.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaDocument] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaDocument]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def create_project_location_collection_data_store_branch_document(parent, google_cloud_discoveryengine_v1beta_document_object = nil, document_id: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1beta/{+parent}/documents', options)
+          command.request_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaDocument::Representation
+          command.request_object = google_cloud_discoveryengine_v1beta_document_object
+          command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaDocument::Representation
+          command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaDocument
+          command.params['parent'] = parent unless parent.nil?
+          command.query['documentId'] = document_id unless document_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Deletes a Document.
+        # @param [String] name
+        #   Required. Full resource name of Document, such as `projects/`project`/
+        #   locations/`location`/collections/`collection`/dataStores/`data_store`/branches/
+        #   `branch`/documents/`document``. If the caller does not have permission to
+        #   delete the Document, regardless of whether or not it exists, a
+        #   PERMISSION_DENIED error is returned. If the Document to delete does not exist,
+        #   a NOT_FOUND error is returned.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::DiscoveryengineV1beta::GoogleProtobufEmpty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DiscoveryengineV1beta::GoogleProtobufEmpty]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def delete_project_location_collection_data_store_branch_document(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'v1beta/{+name}', options)
+          command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleProtobufEmpty::Representation
+          command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleProtobufEmpty
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Gets a Document.
+        # @param [String] name
+        #   Required. Full resource name of Document, such as `projects/`project`/
+        #   locations/`location`/collections/`collection`/dataStores/`data_store`/branches/
+        #   `branch`/documents/`document``. If the caller does not have permission to
+        #   access the Document, regardless of whether or not it exists, a
+        #   PERMISSION_DENIED error is returned. If the requested Document does not exist,
+        #   a NOT_FOUND error is returned.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaDocument] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaDocument]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_project_location_collection_data_store_branch_document(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1beta/{+name}', options)
+          command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaDocument::Representation
+          command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaDocument
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Bulk import of multiple Documents. Request processing may be synchronous. Non-
+        # existing items will be created. Note: It is possible for a subset of the
+        # Documents to be successfully updated.
+        # @param [String] parent
+        #   Required. The parent branch resource name, such as `projects/`project`/
+        #   locations/`location`/collections/`collection`/dataStores/`data_store`/branches/
+        #   `branch``. Requires create/update permission.
+        # @param [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaImportDocumentsRequest] google_cloud_discoveryengine_v1beta_import_documents_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::DiscoveryengineV1beta::GoogleLongrunningOperation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DiscoveryengineV1beta::GoogleLongrunningOperation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def import_project_location_collection_data_store_branch_document(parent, google_cloud_discoveryengine_v1beta_import_documents_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1beta/{+parent}/documents:import', options)
+          command.request_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaImportDocumentsRequest::Representation
+          command.request_object = google_cloud_discoveryengine_v1beta_import_documents_request_object
+          command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleLongrunningOperation::Representation
+          command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleLongrunningOperation
+          command.params['parent'] = parent unless parent.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Gets a list of Documents.
+        # @param [String] parent
+        #   Required. The parent branch resource name, such as `projects/`project`/
+        #   locations/`location`/collections/`collection`/dataStores/`data_store`/branches/
+        #   `branch``. Use `default_branch` as the branch ID, to list documents under the
+        #   default branch. If the caller does not have permission to list Documentss
+        #   under this branch, regardless of whether or not this branch exists, a
+        #   PERMISSION_DENIED error is returned.
+        # @param [Fixnum] page_size
+        #   Maximum number of Documents to return. If unspecified, defaults to 100. The
+        #   maximum allowed value is 1000. Values above 1000 will be coerced to 1000. If
+        #   this field is negative, an INVALID_ARGUMENT error is returned.
+        # @param [String] page_token
+        #   A page token ListDocumentsResponse.next_page_token, received from a previous
+        #   DocumentService.ListDocuments call. Provide this to retrieve the subsequent
+        #   page. When paginating, all other parameters provided to DocumentService.
+        #   ListDocuments must match the call that provided the page token. Otherwise, an
+        #   INVALID_ARGUMENT error is returned.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaListDocumentsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaListDocumentsResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def list_project_location_collection_data_store_branch_documents(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1beta/{+parent}/documents', options)
+          command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaListDocumentsResponse::Representation
+          command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaListDocumentsResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Updates a Document.
+        # @param [String] name
+        #   Immutable. The full resource name of the document. Format: `projects/`project`/
+        #   locations/`location`/collections/`collection`/dataStores/`data_store`/branches/
+        #   `branch`/documents/`document_id``. This field must be a UTF-8 encoded string
+        #   with a length limit of 1024 characters.
+        # @param [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaDocument] google_cloud_discoveryengine_v1beta_document_object
+        # @param [Boolean] allow_missing
+        #   If set to true, and the Document is not found, a new Document will be created.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaDocument] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaDocument]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def patch_project_location_collection_data_store_branch_document(name, google_cloud_discoveryengine_v1beta_document_object = nil, allow_missing: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:patch, 'v1beta/{+name}', options)
+          command.request_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaDocument::Representation
+          command.request_object = google_cloud_discoveryengine_v1beta_document_object
+          command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaDocument::Representation
+          command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaDocument
+          command.params['name'] = name unless name.nil?
+          command.query['allowMissing'] = allow_missing unless allow_missing.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Makes a recommendation, which requires a contextual user event.
+        # @param [String] serving_config
+        #   Required. Full resource name of the format: projects/*/locations/global/
+        #   collections/*/dataStores/*/servingConfigs/* Before you can request
+        #   recommendations from your model, you must create at least one serving config
+        #   for it.
+        # @param [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaRecommendRequest] google_cloud_discoveryengine_v1beta_recommend_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaRecommendResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaRecommendResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def recommend_project_location_collection_data_store_serving_config(serving_config, google_cloud_discoveryengine_v1beta_recommend_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1beta/{+servingConfig}:recommend', options)
+          command.request_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaRecommendRequest::Representation
+          command.request_object = google_cloud_discoveryengine_v1beta_recommend_request_object
+          command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaRecommendResponse::Representation
+          command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaRecommendResponse
+          command.params['servingConfig'] = serving_config unless serving_config.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Writes a single user event from the browser. This uses a GET request to due to
+        # browser restriction of POST-ing to a 3rd party domain. This method is used
+        # only by the Discovery Engine API JavaScript pixel and Google Tag Manager.
+        # Users should not call this method directly.
+        # @param [String] parent
+        #   Required. The parent DataStore resource name, such as `projects/`project`/
+        #   locations/`location`/collections/`collection`/dataStores/`data_store``.
+        # @param [Fixnum] ets
+        #   The event timestamp in milliseconds. This prevents browser caching of
+        #   otherwise identical get requests. The name is abbreviated to reduce the
+        #   payload bytes.
+        # @param [String] uri
+        #   The URL including cgi-parameters but excluding the hash fragment with a length
+        #   limit of 5,000 characters. This is often more useful than the referer URL,
+        #   because many browsers only send the domain for 3rd party requests.
+        # @param [String] user_event
+        #   Required. URL encoded UserEvent proto with a length limit of 2,000,000
+        #   characters.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::DiscoveryengineV1beta::GoogleApiHttpBody] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DiscoveryengineV1beta::GoogleApiHttpBody]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def collect_project_location_collection_data_store_user_event(parent, ets: nil, uri: nil, user_event: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1beta/{+parent}/userEvents:collect', options)
+          command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleApiHttpBody::Representation
+          command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleApiHttpBody
+          command.params['parent'] = parent unless parent.nil?
+          command.query['ets'] = ets unless ets.nil?
+          command.query['uri'] = uri unless uri.nil?
+          command.query['userEvent'] = user_event unless user_event.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Bulk import of User events. Request processing might be synchronous. Events
+        # that already exist are skipped. Use this method for backfilling historical
+        # user events. Operation.response is of type ImportResponse. Note that it is
+        # possible for a subset of the items to be successfully inserted. Operation.
+        # metadata is of type ImportMetadata.
+        # @param [String] parent
+        #   Required. Parent DataStore resource name, of the form `projects/`project`/
+        #   locations/`location`/collections/`collection`/dataStores/`data_store``
+        # @param [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaImportUserEventsRequest] google_cloud_discoveryengine_v1beta_import_user_events_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::DiscoveryengineV1beta::GoogleLongrunningOperation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DiscoveryengineV1beta::GoogleLongrunningOperation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def import_project_location_collection_data_store_user_event(parent, google_cloud_discoveryengine_v1beta_import_user_events_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1beta/{+parent}/userEvents:import', options)
+          command.request_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaImportUserEventsRequest::Representation
+          command.request_object = google_cloud_discoveryengine_v1beta_import_user_events_request_object
+          command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleLongrunningOperation::Representation
+          command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleLongrunningOperation
+          command.params['parent'] = parent unless parent.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Writes a single user event.
+        # @param [String] parent
+        #   Required. The parent DataStore resource name, such as `projects/`project`/
+        #   locations/`location`/collections/`collection`/dataStores/`data_store``.
+        # @param [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaUserEvent] google_cloud_discoveryengine_v1beta_user_event_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaUserEvent] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaUserEvent]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def write_project_location_collection_data_store_user_event(parent, google_cloud_discoveryengine_v1beta_user_event_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1beta/{+parent}/userEvents:write', options)
+          command.request_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaUserEvent::Representation
+          command.request_object = google_cloud_discoveryengine_v1beta_user_event_object
+          command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaUserEvent::Representation
+          command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaUserEvent
+          command.params['parent'] = parent unless parent.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Creates a Document.
+        # @param [String] parent
+        #   Required. The parent resource name, such as `projects/`project`/locations/`
+        #   location`/collections/`collection`/dataStores/`data_store`/branches/`branch``.
         # @param [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaDocument] google_cloud_discoveryengine_v1beta_document_object
         # @param [String] document_id
         #   Required. The ID to use for the Document, which will become the final
@@ -96,10 +489,11 @@ module Google
         # Deletes a Document.
         # @param [String] name
         #   Required. Full resource name of Document, such as `projects/`project`/
-        #   locations/`location`/dataStores/`data_store`/branches/`branch`/documents/`
-        #   document``. If the caller does not have permission to delete the Document,
-        #   regardless of whether or not it exists, a PERMISSION_DENIED error is returned.
-        #   If the Document to delete does not exist, a NOT_FOUND error is returned.
+        #   locations/`location`/collections/`collection`/dataStores/`data_store`/branches/
+        #   `branch`/documents/`document``. If the caller does not have permission to
+        #   delete the Document, regardless of whether or not it exists, a
+        #   PERMISSION_DENIED error is returned. If the Document to delete does not exist,
+        #   a NOT_FOUND error is returned.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -130,10 +524,11 @@ module Google
         # Gets a Document.
         # @param [String] name
         #   Required. Full resource name of Document, such as `projects/`project`/
-        #   locations/`location`/dataStores/`data_store`/branches/`branch`/documents/`
-        #   document``. If the caller does not have permission to access the Document,
-        #   regardless of whether or not it exists, a PERMISSION_DENIED error is returned.
-        #   If the requested Document does not exist, a NOT_FOUND error is returned.
+        #   locations/`location`/collections/`collection`/dataStores/`data_store`/branches/
+        #   `branch`/documents/`document``. If the caller does not have permission to
+        #   access the Document, regardless of whether or not it exists, a
+        #   PERMISSION_DENIED error is returned. If the requested Document does not exist,
+        #   a NOT_FOUND error is returned.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -166,8 +561,8 @@ module Google
         # Documents to be successfully updated.
         # @param [String] parent
         #   Required. The parent branch resource name, such as `projects/`project`/
-        #   locations/`location`/dataStores/`data_store`/branches/`branch``. Requires
-        #   create/update permission.
+        #   locations/`location`/collections/`collection`/dataStores/`data_store`/branches/
+        #   `branch``. Requires create/update permission.
         # @param [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaImportDocumentsRequest] google_cloud_discoveryengine_v1beta_import_documents_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -201,11 +596,11 @@ module Google
         # Gets a list of Documents.
         # @param [String] parent
         #   Required. The parent branch resource name, such as `projects/`project`/
-        #   locations/`location`/dataStores/`data_store`/branches/`branch``. Use `
-        #   default_branch` as the branch ID, to list documents under the default branch.
-        #   If the caller does not have permission to list Documentss under this branch,
-        #   regardless of whether or not this branch exists, a PERMISSION_DENIED error is
-        #   returned.
+        #   locations/`location`/collections/`collection`/dataStores/`data_store`/branches/
+        #   `branch``. Use `default_branch` as the branch ID, to list documents under the
+        #   default branch. If the caller does not have permission to list Documentss
+        #   under this branch, regardless of whether or not this branch exists, a
+        #   PERMISSION_DENIED error is returned.
         # @param [Fixnum] page_size
         #   Maximum number of Documents to return. If unspecified, defaults to 100. The
         #   maximum allowed value is 1000. Values above 1000 will be coerced to 1000. If
@@ -248,9 +643,9 @@ module Google
         # Updates a Document.
         # @param [String] name
         #   Immutable. The full resource name of the document. Format: `projects/`project`/
-        #   locations/`location`/dataStores/`data_store`/branches/`branch`/documents/`
-        #   document_id``. This field must be a UTF-8 encoded string with a length limit
-        #   of 1024 characters.
+        #   locations/`location`/collections/`collection`/dataStores/`data_store`/branches/
+        #   `branch`/documents/`document_id``. This field must be a UTF-8 encoded string
+        #   with a length limit of 1024 characters.
         # @param [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaDocument] google_cloud_discoveryengine_v1beta_document_object
         # @param [Boolean] allow_missing
         #   If set to true, and the Document is not found, a new Document will be created.
@@ -518,8 +913,9 @@ module Google
         # Makes a recommendation, which requires a contextual user event.
         # @param [String] serving_config
         #   Required. Full resource name of the format: projects/*/locations/global/
-        #   dataStores/*/servingConfigs/* Before you can request recommendations from your
-        #   model, you must create at least one serving config for it.
+        #   collections/*/dataStores/*/servingConfigs/* Before you can request
+        #   recommendations from your model, you must create at least one serving config
+        #   for it.
         # @param [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaRecommendRequest] google_cloud_discoveryengine_v1beta_recommend_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -556,7 +952,7 @@ module Google
         # Users should not call this method directly.
         # @param [String] parent
         #   Required. The parent DataStore resource name, such as `projects/`project`/
-        #   locations/`location`/dataStores/`data_store``.
+        #   locations/`location`/collections/`collection`/dataStores/`data_store``.
         # @param [Fixnum] ets
         #   The event timestamp in milliseconds. This prevents browser caching of
         #   otherwise identical get requests. The name is abbreviated to reduce the
@@ -605,7 +1001,7 @@ module Google
         # metadata is of type ImportMetadata.
         # @param [String] parent
         #   Required. Parent DataStore resource name, of the form `projects/`project`/
-        #   locations/`location`/dataStores/`data_store``
+        #   locations/`location`/collections/`collection`/dataStores/`data_store``
         # @param [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaImportUserEventsRequest] google_cloud_discoveryengine_v1beta_import_user_events_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -639,7 +1035,7 @@ module Google
         # Writes a single user event.
         # @param [String] parent
         #   Required. The parent DataStore resource name, such as `projects/`project`/
-        #   locations/`location`/dataStores/`data_store``.
+        #   locations/`location`/collections/`collection`/dataStores/`data_store``.
         # @param [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaUserEvent] google_cloud_discoveryengine_v1beta_user_event_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-discoveryengine_v1beta
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-02-19 00:00:00.000000000 Z
+date: 2023-03-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-discoveryengine_v1beta/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-discoveryengine_v1beta/v0.6.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-discoveryengine_v1beta/v0.8.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-discoveryengine_v1beta
 post_install_message: 
 rdoc_options: []