google-apis-discoveryengine_v1alpha 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d7136aa86da1970091aacbc721332a7f699a922c0a66dde3f09875ed85a83313
-  data.tar.gz: c82165a3bea960d8f093fce7cf52f006c7c4faaf8d156ff706c624ba07bf9324
+  metadata.gz: 72020d972f060f202e08822ec349c894298051fc77fa419f7b71ea39f9dab7a7
+  data.tar.gz: e20445ca485fc70e9354f08be22bafdbce4163b8a47ef35118d455911f6c0f3e
 SHA512:
-  metadata.gz: 2233c682eaa078fd8d4011c3abde6e34c460aaff4764b4e2bc49ae0145629425775b4045d106f9c5a8005cba4b2cc7495797d19d6f0ecc2a7d5cb8dc812a826b
-  data.tar.gz: 7de0f1d0f7818229ade6f3b8586900fd6271e27822c7b0804a27a90937208dabd0b9edf4b4832fd4aefabed5a96a6422b33c9f04819f77c8734e65c27c25eb4d
+  metadata.gz: b16e70b37f72562a083c4f45e292b3f2f5dfc067aeb819d6c8f5d4df56908e68ac61bfce4d04e0659a9bab0a3e4d407a881ad552bf7c86690954e7760600b03d
+  data.tar.gz: 574f3172fe9082cc35c5d4a290941961a6011c2b415291e6a6e426fa02a98445f843808e1e63b85cb2f003271611fbc32e73945e455b951f48cbd2e13f567242

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release history for google-apis-discoveryengine_v1alpha
 
+### v0.6.0 (2023-03-05)
+
+* Regenerated from discovery document revision 20230227
+
 ### v0.5.0 (2023-02-26)
 
 * Regenerated from discovery document revision 20230209

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

@@ -105,9 +105,10 @@ module Google
         # @return [Google::Apis::DiscoveryengineV1alpha::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::DiscoveryengineV1alpha::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::DiscoveryengineV1alpha::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
@@ -416,9 +396,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
@@ -466,8 +446,8 @@ module Google
         attr_accessor :id
       
         # Required. The Document resource full name, of the form: projects/`project\_id`/
-        # locations/`location`/dataStores/`data\_store\_id`/branches/`branch\_id`/
-        # documents/`document\_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_v1alpha/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module DiscoveryengineV1alpha
       # Version of the google-apis-discoveryengine_v1alpha gem
-      GEM_VERSION = "0.5.0"
+      GEM_VERSION = "0.6.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 = "20230209"
+      REVISION = "20230227"
     end
   end
 end

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

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

data/lib/google/apis/discoveryengine_v1alpha/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::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaDocument] google_cloud_discoveryengine_v1alpha_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::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaDocument] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaDocument]
+        #
+        # @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_v1alpha_document_object = nil, document_id: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1alpha/{+parent}/documents', options)
+          command.request_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaDocument::Representation
+          command.request_object = google_cloud_discoveryengine_v1alpha_document_object
+          command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaDocument::Representation
+          command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaDocument
+          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::DiscoveryengineV1alpha::GoogleProtobufEmpty] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DiscoveryengineV1alpha::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, 'v1alpha/{+name}', options)
+          command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleProtobufEmpty::Representation
+          command.response_class = Google::Apis::DiscoveryengineV1alpha::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::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaDocument] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaDocument]
+        #
+        # @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, 'v1alpha/{+name}', options)
+          command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaDocument::Representation
+          command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaDocument
+          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::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaImportDocumentsRequest] google_cloud_discoveryengine_v1alpha_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::DiscoveryengineV1alpha::GoogleLongrunningOperation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DiscoveryengineV1alpha::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_v1alpha_import_documents_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1alpha/{+parent}/documents:import', options)
+          command.request_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaImportDocumentsRequest::Representation
+          command.request_object = google_cloud_discoveryengine_v1alpha_import_documents_request_object
+          command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation::Representation
+          command.response_class = Google::Apis::DiscoveryengineV1alpha::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::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaListDocumentsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaListDocumentsResponse]
+        #
+        # @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, 'v1alpha/{+parent}/documents', options)
+          command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaListDocumentsResponse::Representation
+          command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaListDocumentsResponse
+          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::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaDocument] google_cloud_discoveryengine_v1alpha_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::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaDocument] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaDocument]
+        #
+        # @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_v1alpha_document_object = nil, allow_missing: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:patch, 'v1alpha/{+name}', options)
+          command.request_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaDocument::Representation
+          command.request_object = google_cloud_discoveryengine_v1alpha_document_object
+          command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaDocument::Representation
+          command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaDocument
+          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::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaRecommendRequest] google_cloud_discoveryengine_v1alpha_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::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaRecommendResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaRecommendResponse]
+        #
+        # @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_v1alpha_recommend_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1alpha/{+servingConfig}:recommend', options)
+          command.request_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaRecommendRequest::Representation
+          command.request_object = google_cloud_discoveryengine_v1alpha_recommend_request_object
+          command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaRecommendResponse::Representation
+          command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaRecommendResponse
+          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::DiscoveryengineV1alpha::GoogleApiHttpBody] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DiscoveryengineV1alpha::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, 'v1alpha/{+parent}/userEvents:collect', options)
+          command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleApiHttpBody::Representation
+          command.response_class = Google::Apis::DiscoveryengineV1alpha::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::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaImportUserEventsRequest] google_cloud_discoveryengine_v1alpha_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::DiscoveryengineV1alpha::GoogleLongrunningOperation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DiscoveryengineV1alpha::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_v1alpha_import_user_events_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1alpha/{+parent}/userEvents:import', options)
+          command.request_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaImportUserEventsRequest::Representation
+          command.request_object = google_cloud_discoveryengine_v1alpha_import_user_events_request_object
+          command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation::Representation
+          command.response_class = Google::Apis::DiscoveryengineV1alpha::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::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaUserEvent] google_cloud_discoveryengine_v1alpha_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::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaUserEvent] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaUserEvent]
+        #
+        # @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_v1alpha_user_event_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1alpha/{+parent}/userEvents:write', options)
+          command.request_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaUserEvent::Representation
+          command.request_object = google_cloud_discoveryengine_v1alpha_user_event_object
+          command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaUserEvent::Representation
+          command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaUserEvent
+          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::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaDocument] google_cloud_discoveryengine_v1alpha_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::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaImportDocumentsRequest] google_cloud_discoveryengine_v1alpha_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::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaDocument] google_cloud_discoveryengine_v1alpha_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::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaRecommendRequest] google_cloud_discoveryengine_v1alpha_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::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaImportUserEventsRequest] google_cloud_discoveryengine_v1alpha_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::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaUserEvent] google_cloud_discoveryengine_v1alpha_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_v1alpha
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-02-26 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_v1alpha/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-discoveryengine_v1alpha/v0.5.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-discoveryengine_v1alpha/v0.6.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-discoveryengine_v1alpha
 post_install_message: 
 rdoc_options: []