google-apis-discoveryengine_v1beta 0.41.0 → 0.43.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -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