google-apis-discoveryengine_v1beta 0.41.0 → 0.43.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -666,6 +666,9 @@ module Google
666
666
  # @param [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaDocument] google_cloud_discoveryengine_v1beta_document_object
667
667
  # @param [Boolean] allow_missing
668
668
  # If set to true, and the Document is not found, a new Document will be created.
669
+ # @param [String] update_mask
670
+ # Indicates which fields in the provided imported 'document' to update. If not
671
+ # set, will by default update all fields.
669
672
  # @param [String] fields
670
673
  # Selector specifying which fields to include in a partial response.
671
674
  # @param [String] quota_user
@@ -683,7 +686,7 @@ module Google
683
686
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
684
687
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
685
688
  # @raise [Google::Apis::AuthorizationError] Authorization is required
686
- 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)
689
+ def patch_project_location_collection_data_store_branch_document(name, google_cloud_discoveryengine_v1beta_document_object = nil, allow_missing: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
687
690
  command = make_simple_command(:patch, 'v1beta/{+name}', options)
688
691
  command.request_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaDocument::Representation
689
692
  command.request_object = google_cloud_discoveryengine_v1beta_document_object
@@ -691,6 +694,7 @@ module Google
691
694
  command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaDocument
692
695
  command.params['name'] = name unless name.nil?
693
696
  command.query['allowMissing'] = allow_missing unless allow_missing.nil?
697
+ command.query['updateMask'] = update_mask unless update_mask.nil?
694
698
  command.query['fields'] = fields unless fields.nil?
695
699
  command.query['quotaUser'] = quota_user unless quota_user.nil?
696
700
  execute_or_queue_command(command, &block)
@@ -996,9 +1000,9 @@ module Google
996
1000
  # Updates a Conversation. Conversation action type cannot be changed. If the
997
1001
  # Conversation to update does not exist, a NOT_FOUND error is returned.
998
1002
  # @param [String] name
999
- # Immutable. Fully qualified name `project/*/locations/global/collections/`
1000
- # collection`/dataStore/*/conversations/*` or `project/*/locations/global/
1001
- # collections/`collection`/engines/*/conversations/*`.
1003
+ # Immutable. Fully qualified name `projects/`project`/locations/global/
1004
+ # collections/`collection`/dataStore/*/conversations/*` or `projects/`project`/
1005
+ # locations/global/collections/`collection`/engines/*/conversations/*`.
1002
1006
  # @param [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaConversation] google_cloud_discoveryengine_v1beta_conversation_object
1003
1007
  # @param [String] update_mask
1004
1008
  # Indicates which fields in the provided Conversation to update. The following
@@ -1434,6 +1438,44 @@ module Google
1434
1438
  execute_or_queue_command(command, &block)
1435
1439
  end
1436
1440
 
1441
+ # Answer query method.
1442
+ # @param [String] serving_config
1443
+ # Required. The resource name of the Search serving config, such as `projects/*/
1444
+ # locations/global/collections/default_collection/engines/*/servingConfigs/
1445
+ # default_serving_config`, or `projects/*/locations/global/collections/
1446
+ # default_collection/dataStores/*/servingConfigs/default_serving_config`. This
1447
+ # field is used to identify the serving configuration name, set of models used
1448
+ # to make the search.
1449
+ # @param [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswerQueryRequest] google_cloud_discoveryengine_v1beta_answer_query_request_object
1450
+ # @param [String] fields
1451
+ # Selector specifying which fields to include in a partial response.
1452
+ # @param [String] quota_user
1453
+ # Available to use for quota purposes for server-side applications. Can be any
1454
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1455
+ # @param [Google::Apis::RequestOptions] options
1456
+ # Request-specific options
1457
+ #
1458
+ # @yield [result, err] Result & error if block supplied
1459
+ # @yieldparam result [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswerQueryResponse] parsed result object
1460
+ # @yieldparam err [StandardError] error object if request failed
1461
+ #
1462
+ # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswerQueryResponse]
1463
+ #
1464
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1465
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1466
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1467
+ def answer_project_location_collection_data_store_serving_config(serving_config, google_cloud_discoveryengine_v1beta_answer_query_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1468
+ command = make_simple_command(:post, 'v1beta/{+servingConfig}:answer', options)
1469
+ command.request_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswerQueryRequest::Representation
1470
+ command.request_object = google_cloud_discoveryengine_v1beta_answer_query_request_object
1471
+ command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswerQueryResponse::Representation
1472
+ command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswerQueryResponse
1473
+ command.params['servingConfig'] = serving_config unless serving_config.nil?
1474
+ command.query['fields'] = fields unless fields.nil?
1475
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1476
+ execute_or_queue_command(command, &block)
1477
+ end
1478
+
1437
1479
  # Gets a ServingConfig. Returns a NotFound error if the ServingConfig does not
1438
1480
  # exist.
1439
1481
  # @param [String] name
@@ -1625,6 +1667,227 @@ module Google
1625
1667
  execute_or_queue_command(command, &block)
1626
1668
  end
1627
1669
 
1670
+ # Creates a Session. If the Session to create already exists, an ALREADY_EXISTS
1671
+ # error is returned.
1672
+ # @param [String] parent
1673
+ # Required. Full resource name of parent data store. Format: `projects/`
1674
+ # project_number`/locations/`location_id`/collections/`collection`/dataStores/`
1675
+ # data_store_id``
1676
+ # @param [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession] google_cloud_discoveryengine_v1beta_session_object
1677
+ # @param [String] fields
1678
+ # Selector specifying which fields to include in a partial response.
1679
+ # @param [String] quota_user
1680
+ # Available to use for quota purposes for server-side applications. Can be any
1681
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1682
+ # @param [Google::Apis::RequestOptions] options
1683
+ # Request-specific options
1684
+ #
1685
+ # @yield [result, err] Result & error if block supplied
1686
+ # @yieldparam result [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession] parsed result object
1687
+ # @yieldparam err [StandardError] error object if request failed
1688
+ #
1689
+ # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession]
1690
+ #
1691
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1692
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1693
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1694
+ def create_project_location_collection_data_store_session(parent, google_cloud_discoveryengine_v1beta_session_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1695
+ command = make_simple_command(:post, 'v1beta/{+parent}/sessions', options)
1696
+ command.request_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession::Representation
1697
+ command.request_object = google_cloud_discoveryengine_v1beta_session_object
1698
+ command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession::Representation
1699
+ command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession
1700
+ command.params['parent'] = parent unless parent.nil?
1701
+ command.query['fields'] = fields unless fields.nil?
1702
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1703
+ execute_or_queue_command(command, &block)
1704
+ end
1705
+
1706
+ # Deletes a Session. If the Session to delete does not exist, a NOT_FOUND error
1707
+ # is returned.
1708
+ # @param [String] name
1709
+ # Required. The resource name of the Session to delete. Format: `projects/`
1710
+ # project_number`/locations/`location_id`/collections/`collection`/dataStores/`
1711
+ # data_store_id`/sessions/`session_id``
1712
+ # @param [String] fields
1713
+ # Selector specifying which fields to include in a partial response.
1714
+ # @param [String] quota_user
1715
+ # Available to use for quota purposes for server-side applications. Can be any
1716
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1717
+ # @param [Google::Apis::RequestOptions] options
1718
+ # Request-specific options
1719
+ #
1720
+ # @yield [result, err] Result & error if block supplied
1721
+ # @yieldparam result [Google::Apis::DiscoveryengineV1beta::GoogleProtobufEmpty] parsed result object
1722
+ # @yieldparam err [StandardError] error object if request failed
1723
+ #
1724
+ # @return [Google::Apis::DiscoveryengineV1beta::GoogleProtobufEmpty]
1725
+ #
1726
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1727
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1728
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1729
+ def delete_project_location_collection_data_store_session(name, fields: nil, quota_user: nil, options: nil, &block)
1730
+ command = make_simple_command(:delete, 'v1beta/{+name}', options)
1731
+ command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleProtobufEmpty::Representation
1732
+ command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleProtobufEmpty
1733
+ command.params['name'] = name unless name.nil?
1734
+ command.query['fields'] = fields unless fields.nil?
1735
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1736
+ execute_or_queue_command(command, &block)
1737
+ end
1738
+
1739
+ # Gets a Session.
1740
+ # @param [String] name
1741
+ # Required. The resource name of the Session to get. Format: `projects/`
1742
+ # project_number`/locations/`location_id`/collections/`collection`/dataStores/`
1743
+ # data_store_id`/sessions/`session_id``
1744
+ # @param [String] fields
1745
+ # Selector specifying which fields to include in a partial response.
1746
+ # @param [String] quota_user
1747
+ # Available to use for quota purposes for server-side applications. Can be any
1748
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1749
+ # @param [Google::Apis::RequestOptions] options
1750
+ # Request-specific options
1751
+ #
1752
+ # @yield [result, err] Result & error if block supplied
1753
+ # @yieldparam result [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession] parsed result object
1754
+ # @yieldparam err [StandardError] error object if request failed
1755
+ #
1756
+ # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession]
1757
+ #
1758
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1759
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1760
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1761
+ def get_project_location_collection_data_store_session(name, fields: nil, quota_user: nil, options: nil, &block)
1762
+ command = make_simple_command(:get, 'v1beta/{+name}', options)
1763
+ command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession::Representation
1764
+ command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession
1765
+ command.params['name'] = name unless name.nil?
1766
+ command.query['fields'] = fields unless fields.nil?
1767
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1768
+ execute_or_queue_command(command, &block)
1769
+ end
1770
+
1771
+ # Lists all Sessions by their parent DataStore.
1772
+ # @param [String] parent
1773
+ # Required. The data store resource name. Format: `projects/`project_number`/
1774
+ # locations/`location_id`/collections/`collection`/dataStores/`data_store_id``
1775
+ # @param [String] filter
1776
+ # A filter to apply on the list results. The supported features are:
1777
+ # user_pseudo_id, state. Example: "user_pseudo_id = some_id"
1778
+ # @param [String] order_by
1779
+ # A comma-separated list of fields to order by, sorted in ascending order. Use "
1780
+ # desc" after a field name for descending. Supported fields: * `update_time` * `
1781
+ # create_time` * `session_name` Example: "update_time desc" "create_time"
1782
+ # @param [Fixnum] page_size
1783
+ # Maximum number of results to return. If unspecified, defaults to 50. Max
1784
+ # allowed value is 1000.
1785
+ # @param [String] page_token
1786
+ # A page token, received from a previous `ListSessions` call. Provide this to
1787
+ # retrieve the subsequent page.
1788
+ # @param [String] fields
1789
+ # Selector specifying which fields to include in a partial response.
1790
+ # @param [String] quota_user
1791
+ # Available to use for quota purposes for server-side applications. Can be any
1792
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1793
+ # @param [Google::Apis::RequestOptions] options
1794
+ # Request-specific options
1795
+ #
1796
+ # @yield [result, err] Result & error if block supplied
1797
+ # @yieldparam result [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaListSessionsResponse] parsed result object
1798
+ # @yieldparam err [StandardError] error object if request failed
1799
+ #
1800
+ # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaListSessionsResponse]
1801
+ #
1802
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1803
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1804
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1805
+ def list_project_location_collection_data_store_sessions(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1806
+ command = make_simple_command(:get, 'v1beta/{+parent}/sessions', options)
1807
+ command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaListSessionsResponse::Representation
1808
+ command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaListSessionsResponse
1809
+ command.params['parent'] = parent unless parent.nil?
1810
+ command.query['filter'] = filter unless filter.nil?
1811
+ command.query['orderBy'] = order_by unless order_by.nil?
1812
+ command.query['pageSize'] = page_size unless page_size.nil?
1813
+ command.query['pageToken'] = page_token unless page_token.nil?
1814
+ command.query['fields'] = fields unless fields.nil?
1815
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1816
+ execute_or_queue_command(command, &block)
1817
+ end
1818
+
1819
+ # Updates a Session. Session action type cannot be changed. If the Session to
1820
+ # update does not exist, a NOT_FOUND error is returned.
1821
+ # @param [String] name
1822
+ # Immutable. Fully qualified name `projects/`project`/locations/global/
1823
+ # collections/`collection`/engines/`engine`/sessions/*`
1824
+ # @param [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession] google_cloud_discoveryengine_v1beta_session_object
1825
+ # @param [String] update_mask
1826
+ # Indicates which fields in the provided Session to update. The following are
1827
+ # NOT supported: * Session.name If not set or empty, all supported fields are
1828
+ # updated.
1829
+ # @param [String] fields
1830
+ # Selector specifying which fields to include in a partial response.
1831
+ # @param [String] quota_user
1832
+ # Available to use for quota purposes for server-side applications. Can be any
1833
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1834
+ # @param [Google::Apis::RequestOptions] options
1835
+ # Request-specific options
1836
+ #
1837
+ # @yield [result, err] Result & error if block supplied
1838
+ # @yieldparam result [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession] parsed result object
1839
+ # @yieldparam err [StandardError] error object if request failed
1840
+ #
1841
+ # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession]
1842
+ #
1843
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1844
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1845
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1846
+ def patch_project_location_collection_data_store_session(name, google_cloud_discoveryengine_v1beta_session_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
1847
+ command = make_simple_command(:patch, 'v1beta/{+name}', options)
1848
+ command.request_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession::Representation
1849
+ command.request_object = google_cloud_discoveryengine_v1beta_session_object
1850
+ command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession::Representation
1851
+ command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession
1852
+ command.params['name'] = name unless name.nil?
1853
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1854
+ command.query['fields'] = fields unless fields.nil?
1855
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1856
+ execute_or_queue_command(command, &block)
1857
+ end
1858
+
1859
+ # Gets a Answer.
1860
+ # @param [String] name
1861
+ # Required. The resource name of the Answer to get. Format: `projects/`
1862
+ # project_number`/locations/`location_id`/collections/`collection`/engines/`
1863
+ # engine_id`/sessions/`session_id`/answers/`answer_id``
1864
+ # @param [String] fields
1865
+ # Selector specifying which fields to include in a partial response.
1866
+ # @param [String] quota_user
1867
+ # Available to use for quota purposes for server-side applications. Can be any
1868
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1869
+ # @param [Google::Apis::RequestOptions] options
1870
+ # Request-specific options
1871
+ #
1872
+ # @yield [result, err] Result & error if block supplied
1873
+ # @yieldparam result [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswer] parsed result object
1874
+ # @yieldparam err [StandardError] error object if request failed
1875
+ #
1876
+ # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswer]
1877
+ #
1878
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1879
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1880
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1881
+ def get_project_location_collection_data_store_session_answer(name, fields: nil, quota_user: nil, options: nil, &block)
1882
+ command = make_simple_command(:get, 'v1beta/{+name}', options)
1883
+ command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswer::Representation
1884
+ command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswer
1885
+ command.params['name'] = name unless name.nil?
1886
+ command.query['fields'] = fields unless fields.nil?
1887
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1888
+ execute_or_queue_command(command, &block)
1889
+ end
1890
+
1628
1891
  # Verify target sites' ownership and validity. This API sends all the target
1629
1892
  # sites under site search engine for verification.
1630
1893
  # @param [String] parent
@@ -2328,8 +2591,12 @@ module Google
2328
2591
 
2329
2592
  # Writes a single user event.
2330
2593
  # @param [String] parent
2331
- # Required. The parent DataStore resource name, such as `projects/`project`/
2332
- # locations/`location`/collections/`collection`/dataStores/`data_store``.
2594
+ # Required. The parent resource name. If the write user event action is applied
2595
+ # in DataStore level, the format is: `projects/`project`/locations/`location`/
2596
+ # collections/`collection`/dataStores/`data_store``. If the write user event
2597
+ # action is applied in Location level, for example, the event with Document
2598
+ # across multiple DataStore, the format is: `projects/`project`/locations/`
2599
+ # location``.
2333
2600
  # @param [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaUserEvent] google_cloud_discoveryengine_v1beta_user_event_object
2334
2601
  # @param [String] fields
2335
2602
  # Selector specifying which fields to include in a partial response.
@@ -2843,9 +3110,9 @@ module Google
2843
3110
  # Updates a Conversation. Conversation action type cannot be changed. If the
2844
3111
  # Conversation to update does not exist, a NOT_FOUND error is returned.
2845
3112
  # @param [String] name
2846
- # Immutable. Fully qualified name `project/*/locations/global/collections/`
2847
- # collection`/dataStore/*/conversations/*` or `project/*/locations/global/
2848
- # collections/`collection`/engines/*/conversations/*`.
3113
+ # Immutable. Fully qualified name `projects/`project`/locations/global/
3114
+ # collections/`collection`/dataStore/*/conversations/*` or `projects/`project`/
3115
+ # locations/global/collections/`collection`/engines/*/conversations/*`.
2849
3116
  # @param [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaConversation] google_cloud_discoveryengine_v1beta_conversation_object
2850
3117
  # @param [String] update_mask
2851
3118
  # Indicates which fields in the provided Conversation to update. The following
@@ -2952,6 +3219,44 @@ module Google
2952
3219
  execute_or_queue_command(command, &block)
2953
3220
  end
2954
3221
 
3222
+ # Answer query method.
3223
+ # @param [String] serving_config
3224
+ # Required. The resource name of the Search serving config, such as `projects/*/
3225
+ # locations/global/collections/default_collection/engines/*/servingConfigs/
3226
+ # default_serving_config`, or `projects/*/locations/global/collections/
3227
+ # default_collection/dataStores/*/servingConfigs/default_serving_config`. This
3228
+ # field is used to identify the serving configuration name, set of models used
3229
+ # to make the search.
3230
+ # @param [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswerQueryRequest] google_cloud_discoveryengine_v1beta_answer_query_request_object
3231
+ # @param [String] fields
3232
+ # Selector specifying which fields to include in a partial response.
3233
+ # @param [String] quota_user
3234
+ # Available to use for quota purposes for server-side applications. Can be any
3235
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3236
+ # @param [Google::Apis::RequestOptions] options
3237
+ # Request-specific options
3238
+ #
3239
+ # @yield [result, err] Result & error if block supplied
3240
+ # @yieldparam result [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswerQueryResponse] parsed result object
3241
+ # @yieldparam err [StandardError] error object if request failed
3242
+ #
3243
+ # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswerQueryResponse]
3244
+ #
3245
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3246
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3247
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3248
+ def answer_project_location_collection_engine_serving_config(serving_config, google_cloud_discoveryengine_v1beta_answer_query_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
3249
+ command = make_simple_command(:post, 'v1beta/{+servingConfig}:answer', options)
3250
+ command.request_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswerQueryRequest::Representation
3251
+ command.request_object = google_cloud_discoveryengine_v1beta_answer_query_request_object
3252
+ command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswerQueryResponse::Representation
3253
+ command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswerQueryResponse
3254
+ command.params['servingConfig'] = serving_config unless serving_config.nil?
3255
+ command.query['fields'] = fields unless fields.nil?
3256
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3257
+ execute_or_queue_command(command, &block)
3258
+ end
3259
+
2955
3260
  # Gets a ServingConfig. Returns a NotFound error if the ServingConfig does not
2956
3261
  # exist.
2957
3262
  # @param [String] name
@@ -3143,10 +3448,13 @@ module Google
3143
3448
  execute_or_queue_command(command, &block)
3144
3449
  end
3145
3450
 
3146
- # Gets the latest state of a long-running operation. Clients can use this method
3147
- # to poll the operation result at intervals as recommended by the API service.
3148
- # @param [String] name
3149
- # The name of the operation resource.
3451
+ # Creates a Session. If the Session to create already exists, an ALREADY_EXISTS
3452
+ # error is returned.
3453
+ # @param [String] parent
3454
+ # Required. Full resource name of parent data store. Format: `projects/`
3455
+ # project_number`/locations/`location_id`/collections/`collection`/dataStores/`
3456
+ # data_store_id``
3457
+ # @param [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession] google_cloud_discoveryengine_v1beta_session_object
3150
3458
  # @param [String] fields
3151
3459
  # Selector specifying which fields to include in a partial response.
3152
3460
  # @param [String] quota_user
@@ -3156,34 +3464,32 @@ module Google
3156
3464
  # Request-specific options
3157
3465
  #
3158
3466
  # @yield [result, err] Result & error if block supplied
3159
- # @yieldparam result [Google::Apis::DiscoveryengineV1beta::GoogleLongrunningOperation] parsed result object
3467
+ # @yieldparam result [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession] parsed result object
3160
3468
  # @yieldparam err [StandardError] error object if request failed
3161
3469
  #
3162
- # @return [Google::Apis::DiscoveryengineV1beta::GoogleLongrunningOperation]
3470
+ # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession]
3163
3471
  #
3164
3472
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3165
3473
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3166
3474
  # @raise [Google::Apis::AuthorizationError] Authorization is required
3167
- def get_project_location_collection_operation(name, fields: nil, quota_user: nil, options: nil, &block)
3168
- command = make_simple_command(:get, 'v1beta/{+name}', options)
3169
- command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleLongrunningOperation::Representation
3170
- command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleLongrunningOperation
3171
- command.params['name'] = name unless name.nil?
3475
+ def create_project_location_collection_engine_session(parent, google_cloud_discoveryengine_v1beta_session_object = nil, fields: nil, quota_user: nil, options: nil, &block)
3476
+ command = make_simple_command(:post, 'v1beta/{+parent}/sessions', options)
3477
+ command.request_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession::Representation
3478
+ command.request_object = google_cloud_discoveryengine_v1beta_session_object
3479
+ command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession::Representation
3480
+ command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession
3481
+ command.params['parent'] = parent unless parent.nil?
3172
3482
  command.query['fields'] = fields unless fields.nil?
3173
3483
  command.query['quotaUser'] = quota_user unless quota_user.nil?
3174
3484
  execute_or_queue_command(command, &block)
3175
3485
  end
3176
3486
 
3177
- # Lists operations that match the specified filter in the request. If the server
3178
- # doesn't support this method, it returns `UNIMPLEMENTED`.
3487
+ # Deletes a Session. If the Session to delete does not exist, a NOT_FOUND error
3488
+ # is returned.
3179
3489
  # @param [String] name
3180
- # The name of the operation's parent resource.
3181
- # @param [String] filter
3182
- # The standard list filter.
3183
- # @param [Fixnum] page_size
3184
- # The standard list page size.
3185
- # @param [String] page_token
3186
- # The standard list page token.
3490
+ # Required. The resource name of the Session to delete. Format: `projects/`
3491
+ # project_number`/locations/`location_id`/collections/`collection`/dataStores/`
3492
+ # data_store_id`/sessions/`session_id``
3187
3493
  # @param [String] fields
3188
3494
  # Selector specifying which fields to include in a partial response.
3189
3495
  # @param [String] quota_user
@@ -3193,20 +3499,240 @@ module Google
3193
3499
  # Request-specific options
3194
3500
  #
3195
3501
  # @yield [result, err] Result & error if block supplied
3196
- # @yieldparam result [Google::Apis::DiscoveryengineV1beta::GoogleLongrunningListOperationsResponse] parsed result object
3502
+ # @yieldparam result [Google::Apis::DiscoveryengineV1beta::GoogleProtobufEmpty] parsed result object
3197
3503
  # @yieldparam err [StandardError] error object if request failed
3198
3504
  #
3199
- # @return [Google::Apis::DiscoveryengineV1beta::GoogleLongrunningListOperationsResponse]
3505
+ # @return [Google::Apis::DiscoveryengineV1beta::GoogleProtobufEmpty]
3200
3506
  #
3201
3507
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3202
3508
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3203
3509
  # @raise [Google::Apis::AuthorizationError] Authorization is required
3204
- def list_project_location_collection_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
3205
- command = make_simple_command(:get, 'v1beta/{+name}/operations', options)
3206
- command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleLongrunningListOperationsResponse::Representation
3207
- command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleLongrunningListOperationsResponse
3510
+ def delete_project_location_collection_engine_session(name, fields: nil, quota_user: nil, options: nil, &block)
3511
+ command = make_simple_command(:delete, 'v1beta/{+name}', options)
3512
+ command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleProtobufEmpty::Representation
3513
+ command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleProtobufEmpty
3208
3514
  command.params['name'] = name unless name.nil?
3209
- command.query['filter'] = filter unless filter.nil?
3515
+ command.query['fields'] = fields unless fields.nil?
3516
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3517
+ execute_or_queue_command(command, &block)
3518
+ end
3519
+
3520
+ # Gets a Session.
3521
+ # @param [String] name
3522
+ # Required. The resource name of the Session to get. Format: `projects/`
3523
+ # project_number`/locations/`location_id`/collections/`collection`/dataStores/`
3524
+ # data_store_id`/sessions/`session_id``
3525
+ # @param [String] fields
3526
+ # Selector specifying which fields to include in a partial response.
3527
+ # @param [String] quota_user
3528
+ # Available to use for quota purposes for server-side applications. Can be any
3529
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3530
+ # @param [Google::Apis::RequestOptions] options
3531
+ # Request-specific options
3532
+ #
3533
+ # @yield [result, err] Result & error if block supplied
3534
+ # @yieldparam result [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession] parsed result object
3535
+ # @yieldparam err [StandardError] error object if request failed
3536
+ #
3537
+ # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession]
3538
+ #
3539
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3540
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3541
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3542
+ def get_project_location_collection_engine_session(name, fields: nil, quota_user: nil, options: nil, &block)
3543
+ command = make_simple_command(:get, 'v1beta/{+name}', options)
3544
+ command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession::Representation
3545
+ command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession
3546
+ command.params['name'] = name unless name.nil?
3547
+ command.query['fields'] = fields unless fields.nil?
3548
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3549
+ execute_or_queue_command(command, &block)
3550
+ end
3551
+
3552
+ # Lists all Sessions by their parent DataStore.
3553
+ # @param [String] parent
3554
+ # Required. The data store resource name. Format: `projects/`project_number`/
3555
+ # locations/`location_id`/collections/`collection`/dataStores/`data_store_id``
3556
+ # @param [String] filter
3557
+ # A filter to apply on the list results. The supported features are:
3558
+ # user_pseudo_id, state. Example: "user_pseudo_id = some_id"
3559
+ # @param [String] order_by
3560
+ # A comma-separated list of fields to order by, sorted in ascending order. Use "
3561
+ # desc" after a field name for descending. Supported fields: * `update_time` * `
3562
+ # create_time` * `session_name` Example: "update_time desc" "create_time"
3563
+ # @param [Fixnum] page_size
3564
+ # Maximum number of results to return. If unspecified, defaults to 50. Max
3565
+ # allowed value is 1000.
3566
+ # @param [String] page_token
3567
+ # A page token, received from a previous `ListSessions` call. Provide this to
3568
+ # retrieve the subsequent page.
3569
+ # @param [String] fields
3570
+ # Selector specifying which fields to include in a partial response.
3571
+ # @param [String] quota_user
3572
+ # Available to use for quota purposes for server-side applications. Can be any
3573
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3574
+ # @param [Google::Apis::RequestOptions] options
3575
+ # Request-specific options
3576
+ #
3577
+ # @yield [result, err] Result & error if block supplied
3578
+ # @yieldparam result [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaListSessionsResponse] parsed result object
3579
+ # @yieldparam err [StandardError] error object if request failed
3580
+ #
3581
+ # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaListSessionsResponse]
3582
+ #
3583
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3584
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3585
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3586
+ def list_project_location_collection_engine_sessions(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
3587
+ command = make_simple_command(:get, 'v1beta/{+parent}/sessions', options)
3588
+ command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaListSessionsResponse::Representation
3589
+ command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaListSessionsResponse
3590
+ command.params['parent'] = parent unless parent.nil?
3591
+ command.query['filter'] = filter unless filter.nil?
3592
+ command.query['orderBy'] = order_by unless order_by.nil?
3593
+ command.query['pageSize'] = page_size unless page_size.nil?
3594
+ command.query['pageToken'] = page_token unless page_token.nil?
3595
+ command.query['fields'] = fields unless fields.nil?
3596
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3597
+ execute_or_queue_command(command, &block)
3598
+ end
3599
+
3600
+ # Updates a Session. Session action type cannot be changed. If the Session to
3601
+ # update does not exist, a NOT_FOUND error is returned.
3602
+ # @param [String] name
3603
+ # Immutable. Fully qualified name `projects/`project`/locations/global/
3604
+ # collections/`collection`/engines/`engine`/sessions/*`
3605
+ # @param [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession] google_cloud_discoveryengine_v1beta_session_object
3606
+ # @param [String] update_mask
3607
+ # Indicates which fields in the provided Session to update. The following are
3608
+ # NOT supported: * Session.name If not set or empty, all supported fields are
3609
+ # updated.
3610
+ # @param [String] fields
3611
+ # Selector specifying which fields to include in a partial response.
3612
+ # @param [String] quota_user
3613
+ # Available to use for quota purposes for server-side applications. Can be any
3614
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3615
+ # @param [Google::Apis::RequestOptions] options
3616
+ # Request-specific options
3617
+ #
3618
+ # @yield [result, err] Result & error if block supplied
3619
+ # @yieldparam result [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession] parsed result object
3620
+ # @yieldparam err [StandardError] error object if request failed
3621
+ #
3622
+ # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession]
3623
+ #
3624
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3625
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3626
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3627
+ def patch_project_location_collection_engine_session(name, google_cloud_discoveryengine_v1beta_session_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
3628
+ command = make_simple_command(:patch, 'v1beta/{+name}', options)
3629
+ command.request_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession::Representation
3630
+ command.request_object = google_cloud_discoveryengine_v1beta_session_object
3631
+ command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession::Representation
3632
+ command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession
3633
+ command.params['name'] = name unless name.nil?
3634
+ command.query['updateMask'] = update_mask unless update_mask.nil?
3635
+ command.query['fields'] = fields unless fields.nil?
3636
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3637
+ execute_or_queue_command(command, &block)
3638
+ end
3639
+
3640
+ # Gets a Answer.
3641
+ # @param [String] name
3642
+ # Required. The resource name of the Answer to get. Format: `projects/`
3643
+ # project_number`/locations/`location_id`/collections/`collection`/engines/`
3644
+ # engine_id`/sessions/`session_id`/answers/`answer_id``
3645
+ # @param [String] fields
3646
+ # Selector specifying which fields to include in a partial response.
3647
+ # @param [String] quota_user
3648
+ # Available to use for quota purposes for server-side applications. Can be any
3649
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3650
+ # @param [Google::Apis::RequestOptions] options
3651
+ # Request-specific options
3652
+ #
3653
+ # @yield [result, err] Result & error if block supplied
3654
+ # @yieldparam result [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswer] parsed result object
3655
+ # @yieldparam err [StandardError] error object if request failed
3656
+ #
3657
+ # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswer]
3658
+ #
3659
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3660
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3661
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3662
+ def get_project_location_collection_engine_session_answer(name, fields: nil, quota_user: nil, options: nil, &block)
3663
+ command = make_simple_command(:get, 'v1beta/{+name}', options)
3664
+ command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswer::Representation
3665
+ command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswer
3666
+ command.params['name'] = name unless name.nil?
3667
+ command.query['fields'] = fields unless fields.nil?
3668
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3669
+ execute_or_queue_command(command, &block)
3670
+ end
3671
+
3672
+ # Gets the latest state of a long-running operation. Clients can use this method
3673
+ # to poll the operation result at intervals as recommended by the API service.
3674
+ # @param [String] name
3675
+ # The name of the operation resource.
3676
+ # @param [String] fields
3677
+ # Selector specifying which fields to include in a partial response.
3678
+ # @param [String] quota_user
3679
+ # Available to use for quota purposes for server-side applications. Can be any
3680
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3681
+ # @param [Google::Apis::RequestOptions] options
3682
+ # Request-specific options
3683
+ #
3684
+ # @yield [result, err] Result & error if block supplied
3685
+ # @yieldparam result [Google::Apis::DiscoveryengineV1beta::GoogleLongrunningOperation] parsed result object
3686
+ # @yieldparam err [StandardError] error object if request failed
3687
+ #
3688
+ # @return [Google::Apis::DiscoveryengineV1beta::GoogleLongrunningOperation]
3689
+ #
3690
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3691
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3692
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3693
+ def get_project_location_collection_operation(name, fields: nil, quota_user: nil, options: nil, &block)
3694
+ command = make_simple_command(:get, 'v1beta/{+name}', options)
3695
+ command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleLongrunningOperation::Representation
3696
+ command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleLongrunningOperation
3697
+ command.params['name'] = name unless name.nil?
3698
+ command.query['fields'] = fields unless fields.nil?
3699
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3700
+ execute_or_queue_command(command, &block)
3701
+ end
3702
+
3703
+ # Lists operations that match the specified filter in the request. If the server
3704
+ # doesn't support this method, it returns `UNIMPLEMENTED`.
3705
+ # @param [String] name
3706
+ # The name of the operation's parent resource.
3707
+ # @param [String] filter
3708
+ # The standard list filter.
3709
+ # @param [Fixnum] page_size
3710
+ # The standard list page size.
3711
+ # @param [String] page_token
3712
+ # The standard list page token.
3713
+ # @param [String] fields
3714
+ # Selector specifying which fields to include in a partial response.
3715
+ # @param [String] quota_user
3716
+ # Available to use for quota purposes for server-side applications. Can be any
3717
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3718
+ # @param [Google::Apis::RequestOptions] options
3719
+ # Request-specific options
3720
+ #
3721
+ # @yield [result, err] Result & error if block supplied
3722
+ # @yieldparam result [Google::Apis::DiscoveryengineV1beta::GoogleLongrunningListOperationsResponse] parsed result object
3723
+ # @yieldparam err [StandardError] error object if request failed
3724
+ #
3725
+ # @return [Google::Apis::DiscoveryengineV1beta::GoogleLongrunningListOperationsResponse]
3726
+ #
3727
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3728
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3729
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3730
+ def list_project_location_collection_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
3731
+ command = make_simple_command(:get, 'v1beta/{+name}/operations', options)
3732
+ command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleLongrunningListOperationsResponse::Representation
3733
+ command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleLongrunningListOperationsResponse
3734
+ command.params['name'] = name unless name.nil?
3735
+ command.query['filter'] = filter unless filter.nil?
3210
3736
  command.query['pageSize'] = page_size unless page_size.nil?
3211
3737
  command.query['pageToken'] = page_token unless page_token.nil?
3212
3738
  command.query['fields'] = fields unless fields.nil?
@@ -3723,6 +4249,9 @@ module Google
3723
4249
  # @param [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaDocument] google_cloud_discoveryengine_v1beta_document_object
3724
4250
  # @param [Boolean] allow_missing
3725
4251
  # If set to true, and the Document is not found, a new Document will be created.
4252
+ # @param [String] update_mask
4253
+ # Indicates which fields in the provided imported 'document' to update. If not
4254
+ # set, will by default update all fields.
3726
4255
  # @param [String] fields
3727
4256
  # Selector specifying which fields to include in a partial response.
3728
4257
  # @param [String] quota_user
@@ -3740,7 +4269,7 @@ module Google
3740
4269
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3741
4270
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3742
4271
  # @raise [Google::Apis::AuthorizationError] Authorization is required
3743
- def patch_project_location_data_store_branch_document(name, google_cloud_discoveryengine_v1beta_document_object = nil, allow_missing: nil, fields: nil, quota_user: nil, options: nil, &block)
4272
+ def patch_project_location_data_store_branch_document(name, google_cloud_discoveryengine_v1beta_document_object = nil, allow_missing: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
3744
4273
  command = make_simple_command(:patch, 'v1beta/{+name}', options)
3745
4274
  command.request_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaDocument::Representation
3746
4275
  command.request_object = google_cloud_discoveryengine_v1beta_document_object
@@ -3748,6 +4277,7 @@ module Google
3748
4277
  command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaDocument
3749
4278
  command.params['name'] = name unless name.nil?
3750
4279
  command.query['allowMissing'] = allow_missing unless allow_missing.nil?
4280
+ command.query['updateMask'] = update_mask unless update_mask.nil?
3751
4281
  command.query['fields'] = fields unless fields.nil?
3752
4282
  command.query['quotaUser'] = quota_user unless quota_user.nil?
3753
4283
  execute_or_queue_command(command, &block)
@@ -4053,9 +4583,9 @@ module Google
4053
4583
  # Updates a Conversation. Conversation action type cannot be changed. If the
4054
4584
  # Conversation to update does not exist, a NOT_FOUND error is returned.
4055
4585
  # @param [String] name
4056
- # Immutable. Fully qualified name `project/*/locations/global/collections/`
4057
- # collection`/dataStore/*/conversations/*` or `project/*/locations/global/
4058
- # collections/`collection`/engines/*/conversations/*`.
4586
+ # Immutable. Fully qualified name `projects/`project`/locations/global/
4587
+ # collections/`collection`/dataStore/*/conversations/*` or `projects/`project`/
4588
+ # locations/global/collections/`collection`/engines/*/conversations/*`.
4059
4589
  # @param [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaConversation] google_cloud_discoveryengine_v1beta_conversation_object
4060
4590
  # @param [String] update_mask
4061
4591
  # Indicates which fields in the provided Conversation to update. The following
@@ -4420,6 +4950,44 @@ module Google
4420
4950
  execute_or_queue_command(command, &block)
4421
4951
  end
4422
4952
 
4953
+ # Answer query method.
4954
+ # @param [String] serving_config
4955
+ # Required. The resource name of the Search serving config, such as `projects/*/
4956
+ # locations/global/collections/default_collection/engines/*/servingConfigs/
4957
+ # default_serving_config`, or `projects/*/locations/global/collections/
4958
+ # default_collection/dataStores/*/servingConfigs/default_serving_config`. This
4959
+ # field is used to identify the serving configuration name, set of models used
4960
+ # to make the search.
4961
+ # @param [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswerQueryRequest] google_cloud_discoveryengine_v1beta_answer_query_request_object
4962
+ # @param [String] fields
4963
+ # Selector specifying which fields to include in a partial response.
4964
+ # @param [String] quota_user
4965
+ # Available to use for quota purposes for server-side applications. Can be any
4966
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
4967
+ # @param [Google::Apis::RequestOptions] options
4968
+ # Request-specific options
4969
+ #
4970
+ # @yield [result, err] Result & error if block supplied
4971
+ # @yieldparam result [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswerQueryResponse] parsed result object
4972
+ # @yieldparam err [StandardError] error object if request failed
4973
+ #
4974
+ # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswerQueryResponse]
4975
+ #
4976
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
4977
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
4978
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
4979
+ def answer_project_location_data_store_serving_config(serving_config, google_cloud_discoveryengine_v1beta_answer_query_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
4980
+ command = make_simple_command(:post, 'v1beta/{+servingConfig}:answer', options)
4981
+ command.request_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswerQueryRequest::Representation
4982
+ command.request_object = google_cloud_discoveryengine_v1beta_answer_query_request_object
4983
+ command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswerQueryResponse::Representation
4984
+ command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswerQueryResponse
4985
+ command.params['servingConfig'] = serving_config unless serving_config.nil?
4986
+ command.query['fields'] = fields unless fields.nil?
4987
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
4988
+ execute_or_queue_command(command, &block)
4989
+ end
4990
+
4423
4991
  # Gets a ServingConfig. Returns a NotFound error if the ServingConfig does not
4424
4992
  # exist.
4425
4993
  # @param [String] name
@@ -4611,6 +5179,227 @@ module Google
4611
5179
  execute_or_queue_command(command, &block)
4612
5180
  end
4613
5181
 
5182
+ # Creates a Session. If the Session to create already exists, an ALREADY_EXISTS
5183
+ # error is returned.
5184
+ # @param [String] parent
5185
+ # Required. Full resource name of parent data store. Format: `projects/`
5186
+ # project_number`/locations/`location_id`/collections/`collection`/dataStores/`
5187
+ # data_store_id``
5188
+ # @param [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession] google_cloud_discoveryengine_v1beta_session_object
5189
+ # @param [String] fields
5190
+ # Selector specifying which fields to include in a partial response.
5191
+ # @param [String] quota_user
5192
+ # Available to use for quota purposes for server-side applications. Can be any
5193
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5194
+ # @param [Google::Apis::RequestOptions] options
5195
+ # Request-specific options
5196
+ #
5197
+ # @yield [result, err] Result & error if block supplied
5198
+ # @yieldparam result [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession] parsed result object
5199
+ # @yieldparam err [StandardError] error object if request failed
5200
+ #
5201
+ # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession]
5202
+ #
5203
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5204
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5205
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5206
+ def create_project_location_data_store_session(parent, google_cloud_discoveryengine_v1beta_session_object = nil, fields: nil, quota_user: nil, options: nil, &block)
5207
+ command = make_simple_command(:post, 'v1beta/{+parent}/sessions', options)
5208
+ command.request_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession::Representation
5209
+ command.request_object = google_cloud_discoveryengine_v1beta_session_object
5210
+ command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession::Representation
5211
+ command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession
5212
+ command.params['parent'] = parent unless parent.nil?
5213
+ command.query['fields'] = fields unless fields.nil?
5214
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5215
+ execute_or_queue_command(command, &block)
5216
+ end
5217
+
5218
+ # Deletes a Session. If the Session to delete does not exist, a NOT_FOUND error
5219
+ # is returned.
5220
+ # @param [String] name
5221
+ # Required. The resource name of the Session to delete. Format: `projects/`
5222
+ # project_number`/locations/`location_id`/collections/`collection`/dataStores/`
5223
+ # data_store_id`/sessions/`session_id``
5224
+ # @param [String] fields
5225
+ # Selector specifying which fields to include in a partial response.
5226
+ # @param [String] quota_user
5227
+ # Available to use for quota purposes for server-side applications. Can be any
5228
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5229
+ # @param [Google::Apis::RequestOptions] options
5230
+ # Request-specific options
5231
+ #
5232
+ # @yield [result, err] Result & error if block supplied
5233
+ # @yieldparam result [Google::Apis::DiscoveryengineV1beta::GoogleProtobufEmpty] parsed result object
5234
+ # @yieldparam err [StandardError] error object if request failed
5235
+ #
5236
+ # @return [Google::Apis::DiscoveryengineV1beta::GoogleProtobufEmpty]
5237
+ #
5238
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5239
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5240
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5241
+ def delete_project_location_data_store_session(name, fields: nil, quota_user: nil, options: nil, &block)
5242
+ command = make_simple_command(:delete, 'v1beta/{+name}', options)
5243
+ command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleProtobufEmpty::Representation
5244
+ command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleProtobufEmpty
5245
+ command.params['name'] = name unless name.nil?
5246
+ command.query['fields'] = fields unless fields.nil?
5247
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5248
+ execute_or_queue_command(command, &block)
5249
+ end
5250
+
5251
+ # Gets a Session.
5252
+ # @param [String] name
5253
+ # Required. The resource name of the Session to get. Format: `projects/`
5254
+ # project_number`/locations/`location_id`/collections/`collection`/dataStores/`
5255
+ # data_store_id`/sessions/`session_id``
5256
+ # @param [String] fields
5257
+ # Selector specifying which fields to include in a partial response.
5258
+ # @param [String] quota_user
5259
+ # Available to use for quota purposes for server-side applications. Can be any
5260
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5261
+ # @param [Google::Apis::RequestOptions] options
5262
+ # Request-specific options
5263
+ #
5264
+ # @yield [result, err] Result & error if block supplied
5265
+ # @yieldparam result [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession] parsed result object
5266
+ # @yieldparam err [StandardError] error object if request failed
5267
+ #
5268
+ # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession]
5269
+ #
5270
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5271
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5272
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5273
+ def get_project_location_data_store_session(name, fields: nil, quota_user: nil, options: nil, &block)
5274
+ command = make_simple_command(:get, 'v1beta/{+name}', options)
5275
+ command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession::Representation
5276
+ command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession
5277
+ command.params['name'] = name unless name.nil?
5278
+ command.query['fields'] = fields unless fields.nil?
5279
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5280
+ execute_or_queue_command(command, &block)
5281
+ end
5282
+
5283
+ # Lists all Sessions by their parent DataStore.
5284
+ # @param [String] parent
5285
+ # Required. The data store resource name. Format: `projects/`project_number`/
5286
+ # locations/`location_id`/collections/`collection`/dataStores/`data_store_id``
5287
+ # @param [String] filter
5288
+ # A filter to apply on the list results. The supported features are:
5289
+ # user_pseudo_id, state. Example: "user_pseudo_id = some_id"
5290
+ # @param [String] order_by
5291
+ # A comma-separated list of fields to order by, sorted in ascending order. Use "
5292
+ # desc" after a field name for descending. Supported fields: * `update_time` * `
5293
+ # create_time` * `session_name` Example: "update_time desc" "create_time"
5294
+ # @param [Fixnum] page_size
5295
+ # Maximum number of results to return. If unspecified, defaults to 50. Max
5296
+ # allowed value is 1000.
5297
+ # @param [String] page_token
5298
+ # A page token, received from a previous `ListSessions` call. Provide this to
5299
+ # retrieve the subsequent page.
5300
+ # @param [String] fields
5301
+ # Selector specifying which fields to include in a partial response.
5302
+ # @param [String] quota_user
5303
+ # Available to use for quota purposes for server-side applications. Can be any
5304
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5305
+ # @param [Google::Apis::RequestOptions] options
5306
+ # Request-specific options
5307
+ #
5308
+ # @yield [result, err] Result & error if block supplied
5309
+ # @yieldparam result [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaListSessionsResponse] parsed result object
5310
+ # @yieldparam err [StandardError] error object if request failed
5311
+ #
5312
+ # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaListSessionsResponse]
5313
+ #
5314
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5315
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5316
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5317
+ def list_project_location_data_store_sessions(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
5318
+ command = make_simple_command(:get, 'v1beta/{+parent}/sessions', options)
5319
+ command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaListSessionsResponse::Representation
5320
+ command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaListSessionsResponse
5321
+ command.params['parent'] = parent unless parent.nil?
5322
+ command.query['filter'] = filter unless filter.nil?
5323
+ command.query['orderBy'] = order_by unless order_by.nil?
5324
+ command.query['pageSize'] = page_size unless page_size.nil?
5325
+ command.query['pageToken'] = page_token unless page_token.nil?
5326
+ command.query['fields'] = fields unless fields.nil?
5327
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5328
+ execute_or_queue_command(command, &block)
5329
+ end
5330
+
5331
+ # Updates a Session. Session action type cannot be changed. If the Session to
5332
+ # update does not exist, a NOT_FOUND error is returned.
5333
+ # @param [String] name
5334
+ # Immutable. Fully qualified name `projects/`project`/locations/global/
5335
+ # collections/`collection`/engines/`engine`/sessions/*`
5336
+ # @param [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession] google_cloud_discoveryengine_v1beta_session_object
5337
+ # @param [String] update_mask
5338
+ # Indicates which fields in the provided Session to update. The following are
5339
+ # NOT supported: * Session.name If not set or empty, all supported fields are
5340
+ # updated.
5341
+ # @param [String] fields
5342
+ # Selector specifying which fields to include in a partial response.
5343
+ # @param [String] quota_user
5344
+ # Available to use for quota purposes for server-side applications. Can be any
5345
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5346
+ # @param [Google::Apis::RequestOptions] options
5347
+ # Request-specific options
5348
+ #
5349
+ # @yield [result, err] Result & error if block supplied
5350
+ # @yieldparam result [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession] parsed result object
5351
+ # @yieldparam err [StandardError] error object if request failed
5352
+ #
5353
+ # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession]
5354
+ #
5355
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5356
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5357
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5358
+ def patch_project_location_data_store_session(name, google_cloud_discoveryengine_v1beta_session_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
5359
+ command = make_simple_command(:patch, 'v1beta/{+name}', options)
5360
+ command.request_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession::Representation
5361
+ command.request_object = google_cloud_discoveryengine_v1beta_session_object
5362
+ command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession::Representation
5363
+ command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaSession
5364
+ command.params['name'] = name unless name.nil?
5365
+ command.query['updateMask'] = update_mask unless update_mask.nil?
5366
+ command.query['fields'] = fields unless fields.nil?
5367
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5368
+ execute_or_queue_command(command, &block)
5369
+ end
5370
+
5371
+ # Gets a Answer.
5372
+ # @param [String] name
5373
+ # Required. The resource name of the Answer to get. Format: `projects/`
5374
+ # project_number`/locations/`location_id`/collections/`collection`/engines/`
5375
+ # engine_id`/sessions/`session_id`/answers/`answer_id``
5376
+ # @param [String] fields
5377
+ # Selector specifying which fields to include in a partial response.
5378
+ # @param [String] quota_user
5379
+ # Available to use for quota purposes for server-side applications. Can be any
5380
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5381
+ # @param [Google::Apis::RequestOptions] options
5382
+ # Request-specific options
5383
+ #
5384
+ # @yield [result, err] Result & error if block supplied
5385
+ # @yieldparam result [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswer] parsed result object
5386
+ # @yieldparam err [StandardError] error object if request failed
5387
+ #
5388
+ # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswer]
5389
+ #
5390
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5391
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5392
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5393
+ def get_project_location_data_store_session_answer(name, fields: nil, quota_user: nil, options: nil, &block)
5394
+ command = make_simple_command(:get, 'v1beta/{+name}', options)
5395
+ command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswer::Representation
5396
+ command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaAnswer
5397
+ command.params['name'] = name unless name.nil?
5398
+ command.query['fields'] = fields unless fields.nil?
5399
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5400
+ execute_or_queue_command(command, &block)
5401
+ end
5402
+
4614
5403
  # Downgrade from advanced site search to basic site search.
4615
5404
  # @param [String] site_search_engine
4616
5405
  # Required. Full resource name of the SiteSearchEngine, such as `projects/`
@@ -5091,8 +5880,12 @@ module Google
5091
5880
 
5092
5881
  # Writes a single user event.
5093
5882
  # @param [String] parent
5094
- # Required. The parent DataStore resource name, such as `projects/`project`/
5095
- # locations/`location`/collections/`collection`/dataStores/`data_store``.
5883
+ # Required. The parent resource name. If the write user event action is applied
5884
+ # in DataStore level, the format is: `projects/`project`/locations/`location`/
5885
+ # collections/`collection`/dataStores/`data_store``. If the write user event
5886
+ # action is applied in Location level, for example, the event with Document
5887
+ # across multiple DataStore, the format is: `projects/`project`/locations/`
5888
+ # location``.
5096
5889
  # @param [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaUserEvent] google_cloud_discoveryengine_v1beta_user_event_object
5097
5890
  # @param [String] fields
5098
5891
  # Selector specifying which fields to include in a partial response.
@@ -5123,6 +5916,40 @@ module Google
5123
5916
  execute_or_queue_command(command, &block)
5124
5917
  end
5125
5918
 
5919
+ # Performs a grounding check.
5920
+ # @param [String] grounding_config
5921
+ # Required. The resource name of the grounding config, such as `projects/*/
5922
+ # locations/global/groundingConfigs/default_grounding_config`.
5923
+ # @param [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaCheckGroundingRequest] google_cloud_discoveryengine_v1beta_check_grounding_request_object
5924
+ # @param [String] fields
5925
+ # Selector specifying which fields to include in a partial response.
5926
+ # @param [String] quota_user
5927
+ # Available to use for quota purposes for server-side applications. Can be any
5928
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5929
+ # @param [Google::Apis::RequestOptions] options
5930
+ # Request-specific options
5931
+ #
5932
+ # @yield [result, err] Result & error if block supplied
5933
+ # @yieldparam result [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaCheckGroundingResponse] parsed result object
5934
+ # @yieldparam err [StandardError] error object if request failed
5935
+ #
5936
+ # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaCheckGroundingResponse]
5937
+ #
5938
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5939
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5940
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5941
+ def check_project_location_grounding_config(grounding_config, google_cloud_discoveryengine_v1beta_check_grounding_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
5942
+ command = make_simple_command(:post, 'v1beta/{+groundingConfig}:check', options)
5943
+ command.request_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaCheckGroundingRequest::Representation
5944
+ command.request_object = google_cloud_discoveryengine_v1beta_check_grounding_request_object
5945
+ command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaCheckGroundingResponse::Representation
5946
+ command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaCheckGroundingResponse
5947
+ command.params['groundingConfig'] = grounding_config unless grounding_config.nil?
5948
+ command.query['fields'] = fields unless fields.nil?
5949
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5950
+ execute_or_queue_command(command, &block)
5951
+ end
5952
+
5126
5953
  # Gets the latest state of a long-running operation. Clients can use this method
5127
5954
  # to poll the operation result at intervals as recommended by the API service.
5128
5955
  # @param [String] name
@@ -5228,6 +6055,44 @@ module Google
5228
6055
  execute_or_queue_command(command, &block)
5229
6056
  end
5230
6057
 
6058
+ # Writes a single user event.
6059
+ # @param [String] parent
6060
+ # Required. The parent resource name. If the write user event action is applied
6061
+ # in DataStore level, the format is: `projects/`project`/locations/`location`/
6062
+ # collections/`collection`/dataStores/`data_store``. If the write user event
6063
+ # action is applied in Location level, for example, the event with Document
6064
+ # across multiple DataStore, the format is: `projects/`project`/locations/`
6065
+ # location``.
6066
+ # @param [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaUserEvent] google_cloud_discoveryengine_v1beta_user_event_object
6067
+ # @param [String] fields
6068
+ # Selector specifying which fields to include in a partial response.
6069
+ # @param [String] quota_user
6070
+ # Available to use for quota purposes for server-side applications. Can be any
6071
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
6072
+ # @param [Google::Apis::RequestOptions] options
6073
+ # Request-specific options
6074
+ #
6075
+ # @yield [result, err] Result & error if block supplied
6076
+ # @yieldparam result [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaUserEvent] parsed result object
6077
+ # @yieldparam err [StandardError] error object if request failed
6078
+ #
6079
+ # @return [Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaUserEvent]
6080
+ #
6081
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
6082
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
6083
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
6084
+ def write_project_location_user_event(parent, google_cloud_discoveryengine_v1beta_user_event_object = nil, fields: nil, quota_user: nil, options: nil, &block)
6085
+ command = make_simple_command(:post, 'v1beta/{+parent}/userEvents:write', options)
6086
+ command.request_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaUserEvent::Representation
6087
+ command.request_object = google_cloud_discoveryengine_v1beta_user_event_object
6088
+ command.response_representation = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaUserEvent::Representation
6089
+ command.response_class = Google::Apis::DiscoveryengineV1beta::GoogleCloudDiscoveryengineV1betaUserEvent
6090
+ command.params['parent'] = parent unless parent.nil?
6091
+ command.query['fields'] = fields unless fields.nil?
6092
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
6093
+ execute_or_queue_command(command, &block)
6094
+ end
6095
+
5231
6096
  # Gets the latest state of a long-running operation. Clients can use this method
5232
6097
  # to poll the operation result at intervals as recommended by the API service.
5233
6098
  # @param [String] name