google-apis-discoveryengine_v1alpha 0.81.0 → 0.82.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.
@@ -86,6 +86,74 @@ module Google
86
86
  execute_or_queue_command(command, &block)
87
87
  end
88
88
 
89
+ # Gets a BillingAccountLicenseConfig.
90
+ # @param [String] name
91
+ # Required. Full resource name of BillingAccountLicenseConfig. Format: `
92
+ # billingAccounts/`billing_account`/billingAccountLicenseConfigs/`
93
+ # billing_account_license_config_id``.
94
+ # @param [String] fields
95
+ # Selector specifying which fields to include in a partial response.
96
+ # @param [String] quota_user
97
+ # Available to use for quota purposes for server-side applications. Can be any
98
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
99
+ # @param [Google::Apis::RequestOptions] options
100
+ # Request-specific options
101
+ #
102
+ # @yield [result, err] Result & error if block supplied
103
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaBillingAccountLicenseConfig] parsed result object
104
+ # @yieldparam err [StandardError] error object if request failed
105
+ #
106
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaBillingAccountLicenseConfig]
107
+ #
108
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
109
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
110
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
111
+ def get_billing_account_billing_account_license_config(name, fields: nil, quota_user: nil, options: nil, &block)
112
+ command = make_simple_command(:get, 'v1alpha/{+name}', options)
113
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaBillingAccountLicenseConfig::Representation
114
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaBillingAccountLicenseConfig
115
+ command.params['name'] = name unless name.nil?
116
+ command.query['fields'] = fields unless fields.nil?
117
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
118
+ execute_or_queue_command(command, &block)
119
+ end
120
+
121
+ # Lists all BillingAccountLicenseConfigs for a given billing account.
122
+ # @param [String] parent
123
+ # Required. Format: `billingAccounts/`billing_account``.
124
+ # @param [Fixnum] page_size
125
+ # Optional. Not supported.
126
+ # @param [String] page_token
127
+ # Optional. Not supported.
128
+ # @param [String] fields
129
+ # Selector specifying which fields to include in a partial response.
130
+ # @param [String] quota_user
131
+ # Available to use for quota purposes for server-side applications. Can be any
132
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
133
+ # @param [Google::Apis::RequestOptions] options
134
+ # Request-specific options
135
+ #
136
+ # @yield [result, err] Result & error if block supplied
137
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaListBillingAccountLicenseConfigsResponse] parsed result object
138
+ # @yieldparam err [StandardError] error object if request failed
139
+ #
140
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaListBillingAccountLicenseConfigsResponse]
141
+ #
142
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
143
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
144
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
145
+ def list_billing_account_billing_account_license_configs(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
146
+ command = make_simple_command(:get, 'v1alpha/{+parent}/billingAccountLicenseConfigs', options)
147
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaListBillingAccountLicenseConfigsResponse::Representation
148
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaListBillingAccountLicenseConfigsResponse
149
+ command.params['parent'] = parent unless parent.nil?
150
+ command.query['pageSize'] = page_size unless page_size.nil?
151
+ command.query['pageToken'] = page_token unless page_token.nil?
152
+ command.query['fields'] = fields unless fields.nil?
153
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
154
+ execute_or_queue_command(command, &block)
155
+ end
156
+
89
157
  # This method is called from the billing account side to retract the
90
158
  # LicenseConfig from the given project back to the billing account.
91
159
  # @param [String] billing_account_license_config
@@ -167,6 +235,52 @@ module Google
167
235
  execute_or_queue_command(command, &block)
168
236
  end
169
237
 
238
+ # Uploads a file for the assistant to use as a source of information within the
239
+ # session.
240
+ # @param [String] name
241
+ # Required. The resource name of the Session. Format: `projects/`project`/
242
+ # locations/`location`/collections/`collection`/engines/`engine`/sessions/`
243
+ # session``
244
+ # @param [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaUploadSessionFileRequest] google_cloud_discoveryengine_v1alpha_upload_session_file_request_object
245
+ # @param [String] fields
246
+ # Selector specifying which fields to include in a partial response.
247
+ # @param [String] quota_user
248
+ # Available to use for quota purposes for server-side applications. Can be any
249
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
250
+ # @param [IO, String] upload_source
251
+ # IO stream or filename containing content to upload
252
+ # @param [String] content_type
253
+ # Content type of the uploaded content.
254
+ # @param [Google::Apis::RequestOptions] options
255
+ # Request-specific options
256
+ #
257
+ # @yield [result, err] Result & error if block supplied
258
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaUploadSessionFileResponse] parsed result object
259
+ # @yieldparam err [StandardError] error object if request failed
260
+ #
261
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaUploadSessionFileResponse]
262
+ #
263
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
264
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
265
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
266
+ def upload_medium(name, google_cloud_discoveryengine_v1alpha_upload_session_file_request_object = nil, fields: nil, quota_user: nil, upload_source: nil, content_type: nil, options: nil, &block)
267
+ if upload_source.nil?
268
+ command = make_simple_command(:post, 'v1alpha/{+name}:uploadFile', options)
269
+ else
270
+ command = make_upload_command(:post, 'v1alpha/{+name}:uploadFile', options)
271
+ command.upload_source = upload_source
272
+ command.upload_content_type = content_type
273
+ end
274
+ command.request_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaUploadSessionFileRequest::Representation
275
+ command.request_object = google_cloud_discoveryengine_v1alpha_upload_session_file_request_object
276
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaUploadSessionFileResponse::Representation
277
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaUploadSessionFileResponse
278
+ command.params['name'] = name unless name.nil?
279
+ command.query['fields'] = fields unless fields.nil?
280
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
281
+ execute_or_queue_command(command, &block)
282
+ end
283
+
170
284
  # Gets a Project. Returns NOT_FOUND when the project is not yet created.
171
285
  # @param [String] name
172
286
  # Required. Full resource name of a Project, such as `projects/`
@@ -742,6 +856,190 @@ module Google
742
856
  execute_or_queue_command(command, &block)
743
857
  end
744
858
 
859
+ # Creates an Authorization.
860
+ # @param [String] parent
861
+ # Required. The parent resource name. Format: `projects/`project`/locations/`
862
+ # location``
863
+ # @param [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaAuthorization] google_cloud_discoveryengine_v1alpha_authorization_object
864
+ # @param [String] authorization_id
865
+ # Required. The ID to use for the authorization, which will become the final
866
+ # component of the resource name. This field must conform to [RFC-1034](https://
867
+ # tools.ietf.org/html/rfc1034) with a length limit of 63 characters.
868
+ # @param [String] fields
869
+ # Selector specifying which fields to include in a partial response.
870
+ # @param [String] quota_user
871
+ # Available to use for quota purposes for server-side applications. Can be any
872
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
873
+ # @param [Google::Apis::RequestOptions] options
874
+ # Request-specific options
875
+ #
876
+ # @yield [result, err] Result & error if block supplied
877
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaAuthorization] parsed result object
878
+ # @yieldparam err [StandardError] error object if request failed
879
+ #
880
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaAuthorization]
881
+ #
882
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
883
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
884
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
885
+ def create_project_location_authorization(parent, google_cloud_discoveryengine_v1alpha_authorization_object = nil, authorization_id: nil, fields: nil, quota_user: nil, options: nil, &block)
886
+ command = make_simple_command(:post, 'v1alpha/{+parent}/authorizations', options)
887
+ command.request_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaAuthorization::Representation
888
+ command.request_object = google_cloud_discoveryengine_v1alpha_authorization_object
889
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaAuthorization::Representation
890
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaAuthorization
891
+ command.params['parent'] = parent unless parent.nil?
892
+ command.query['authorizationId'] = authorization_id unless authorization_id.nil?
893
+ command.query['fields'] = fields unless fields.nil?
894
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
895
+ execute_or_queue_command(command, &block)
896
+ end
897
+
898
+ # Deletes an Authorization.
899
+ # @param [String] name
900
+ # Required. Resource name of Authorization. Format: `projects/`project`/
901
+ # locations/`location`/authorizations/`authorization`` If the caller does not
902
+ # have permission to delete the authorization, regardless of whether or not it
903
+ # exists, a `PERMISSION_DENIED` error is returned. If the authorization to
904
+ # delete does not exist, a `NOT_FOUND` error is returned.
905
+ # @param [String] fields
906
+ # Selector specifying which fields to include in a partial response.
907
+ # @param [String] quota_user
908
+ # Available to use for quota purposes for server-side applications. Can be any
909
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
910
+ # @param [Google::Apis::RequestOptions] options
911
+ # Request-specific options
912
+ #
913
+ # @yield [result, err] Result & error if block supplied
914
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleProtobufEmpty] parsed result object
915
+ # @yieldparam err [StandardError] error object if request failed
916
+ #
917
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleProtobufEmpty]
918
+ #
919
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
920
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
921
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
922
+ def delete_project_location_authorization(name, fields: nil, quota_user: nil, options: nil, &block)
923
+ command = make_simple_command(:delete, 'v1alpha/{+name}', options)
924
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleProtobufEmpty::Representation
925
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleProtobufEmpty
926
+ command.params['name'] = name unless name.nil?
927
+ command.query['fields'] = fields unless fields.nil?
928
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
929
+ execute_or_queue_command(command, &block)
930
+ end
931
+
932
+ # Gets an Authorization.
933
+ # @param [String] name
934
+ # Required. Resource name of Authorization. Format: `projects/`project`/
935
+ # locations/`location`/authorizations/`authorization``
936
+ # @param [String] fields
937
+ # Selector specifying which fields to include in a partial response.
938
+ # @param [String] quota_user
939
+ # Available to use for quota purposes for server-side applications. Can be any
940
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
941
+ # @param [Google::Apis::RequestOptions] options
942
+ # Request-specific options
943
+ #
944
+ # @yield [result, err] Result & error if block supplied
945
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaAuthorization] parsed result object
946
+ # @yieldparam err [StandardError] error object if request failed
947
+ #
948
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaAuthorization]
949
+ #
950
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
951
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
952
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
953
+ def get_project_location_authorization(name, fields: nil, quota_user: nil, options: nil, &block)
954
+ command = make_simple_command(:get, 'v1alpha/{+name}', options)
955
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaAuthorization::Representation
956
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaAuthorization
957
+ command.params['name'] = name unless name.nil?
958
+ command.query['fields'] = fields unless fields.nil?
959
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
960
+ execute_or_queue_command(command, &block)
961
+ end
962
+
963
+ # Lists all Authorizations under an Engine.
964
+ # @param [String] parent
965
+ # Required. The parent resource name. Format: `projects/`project`/locations/`
966
+ # location``
967
+ # @param [Fixnum] page_size
968
+ # Maximum number of Authorizations to return. If unspecified, defaults to 100.
969
+ # The maximum allowed value is 1000; anything above that will be coerced down to
970
+ # 1000.
971
+ # @param [String] page_token
972
+ # A page token ListAuthorizationsResponse.next_page_token, received from a
973
+ # previous AuthorizationService.ListAuthorizations call. Provide this to
974
+ # retrieve the subsequent page. When paginating, all other parameters provided
975
+ # to ListAuthorizations must match the call that provided the page token.
976
+ # @param [String] fields
977
+ # Selector specifying which fields to include in a partial response.
978
+ # @param [String] quota_user
979
+ # Available to use for quota purposes for server-side applications. Can be any
980
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
981
+ # @param [Google::Apis::RequestOptions] options
982
+ # Request-specific options
983
+ #
984
+ # @yield [result, err] Result & error if block supplied
985
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaListAuthorizationsResponse] parsed result object
986
+ # @yieldparam err [StandardError] error object if request failed
987
+ #
988
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaListAuthorizationsResponse]
989
+ #
990
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
991
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
992
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
993
+ def list_project_location_authorizations(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
994
+ command = make_simple_command(:get, 'v1alpha/{+parent}/authorizations', options)
995
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaListAuthorizationsResponse::Representation
996
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaListAuthorizationsResponse
997
+ command.params['parent'] = parent unless parent.nil?
998
+ command.query['pageSize'] = page_size unless page_size.nil?
999
+ command.query['pageToken'] = page_token unless page_token.nil?
1000
+ command.query['fields'] = fields unless fields.nil?
1001
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1002
+ execute_or_queue_command(command, &block)
1003
+ end
1004
+
1005
+ # Updates an Authorization
1006
+ # @param [String] name
1007
+ # Identifier. Resource name of the authorization. Format: `projects/`project`/
1008
+ # locations/`location`/authorizations/`authorization`` It must be a UTF-8
1009
+ # encoded string with a length limit of 1024 characters.
1010
+ # @param [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaAuthorization] google_cloud_discoveryengine_v1alpha_authorization_object
1011
+ # @param [String] update_mask
1012
+ # The list of fields to update.
1013
+ # @param [String] fields
1014
+ # Selector specifying which fields to include in a partial response.
1015
+ # @param [String] quota_user
1016
+ # Available to use for quota purposes for server-side applications. Can be any
1017
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1018
+ # @param [Google::Apis::RequestOptions] options
1019
+ # Request-specific options
1020
+ #
1021
+ # @yield [result, err] Result & error if block supplied
1022
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaAuthorization] parsed result object
1023
+ # @yieldparam err [StandardError] error object if request failed
1024
+ #
1025
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaAuthorization]
1026
+ #
1027
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1028
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1029
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1030
+ def patch_project_location_authorization(name, google_cloud_discoveryengine_v1alpha_authorization_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
1031
+ command = make_simple_command(:patch, 'v1alpha/{+name}', options)
1032
+ command.request_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaAuthorization::Representation
1033
+ command.request_object = google_cloud_discoveryengine_v1alpha_authorization_object
1034
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaAuthorization::Representation
1035
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaAuthorization
1036
+ command.params['name'] = name unless name.nil?
1037
+ command.query['updateMask'] = update_mask unless update_mask.nil?
1038
+ command.query['fields'] = fields unless fields.nil?
1039
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1040
+ execute_or_queue_command(command, &block)
1041
+ end
1042
+
745
1043
  # De-provisions a CmekConfig.
746
1044
  # @param [String] name
747
1045
  # Required. The resource name of the CmekConfig to delete, such as `projects/`
@@ -1394,9 +1692,9 @@ module Google
1394
1692
  # values: * `document` is the default model for regular dataStores. * `search-
1395
1693
  # history` is the default model for site search dataStores.
1396
1694
  # @param [String] user_pseudo_id
1397
- # A unique identifier for tracking visitors. For example, this could be
1398
- # implemented with an HTTP cookie, which should be able to uniquely identify a
1399
- # visitor on a single device. This unique identifier should not change if the
1695
+ # Optional. A unique identifier for tracking visitors. For example, this could
1696
+ # be implemented with an HTTP cookie, which should be able to uniquely identify
1697
+ # a visitor on a single device. This unique identifier should not change if the
1400
1698
  # visitor logs in or out of the website. This field should NOT have a fixed
1401
1699
  # value such as `unknown_visitor`. This should be the same identifier as
1402
1700
  # UserEvent.user_pseudo_id and SearchRequest.user_pseudo_id. The field must be a
@@ -4968,6 +5266,47 @@ module Google
4968
5266
  execute_or_queue_command(command, &block)
4969
5267
  end
4970
5268
 
5269
+ # Update a WidgetConfig.
5270
+ # @param [String] name
5271
+ # Immutable. The full resource name of the widget config. Format: `projects/`
5272
+ # project`/locations/`location`/collections/`collection_id`/dataStores/`
5273
+ # data_store_id`/widgetConfigs/`widget_config_id``. This field must be a UTF-8
5274
+ # encoded string with a length limit of 1024 characters.
5275
+ # @param [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaWidgetConfig] google_cloud_discoveryengine_v1alpha_widget_config_object
5276
+ # @param [String] update_mask
5277
+ # Indicates which fields in the provided WidgetConfig to update. The following
5278
+ # are the only supported fields: * WidgetConfig.enable_autocomplete If not set,
5279
+ # all supported fields are updated.
5280
+ # @param [String] fields
5281
+ # Selector specifying which fields to include in a partial response.
5282
+ # @param [String] quota_user
5283
+ # Available to use for quota purposes for server-side applications. Can be any
5284
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5285
+ # @param [Google::Apis::RequestOptions] options
5286
+ # Request-specific options
5287
+ #
5288
+ # @yield [result, err] Result & error if block supplied
5289
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaWidgetConfig] parsed result object
5290
+ # @yieldparam err [StandardError] error object if request failed
5291
+ #
5292
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaWidgetConfig]
5293
+ #
5294
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5295
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5296
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5297
+ def patch_project_location_collection_data_store_widget_config(name, google_cloud_discoveryengine_v1alpha_widget_config_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
5298
+ command = make_simple_command(:patch, 'v1alpha/{+name}', options)
5299
+ command.request_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaWidgetConfig::Representation
5300
+ command.request_object = google_cloud_discoveryengine_v1alpha_widget_config_object
5301
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaWidgetConfig::Representation
5302
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaWidgetConfig
5303
+ command.params['name'] = name unless name.nil?
5304
+ command.query['updateMask'] = update_mask unless update_mask.nil?
5305
+ command.query['fields'] = fields unless fields.nil?
5306
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5307
+ execute_or_queue_command(command, &block)
5308
+ end
5309
+
4971
5310
  # Creates a Engine.
4972
5311
  # @param [String] parent
4973
5312
  # Required. The parent resource name, such as `projects/`project`/locations/`
@@ -5431,6 +5770,228 @@ module Google
5431
5770
  execute_or_queue_command(command, &block)
5432
5771
  end
5433
5772
 
5773
+ # Creates an Agent.
5774
+ # @param [String] parent
5775
+ # Required. The parent resource name. Format: `projects/`project`/locations/`
5776
+ # location`/collections/`collection`/engines/`engine`/assistants/`assistant``
5777
+ # @param [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaAgent] google_cloud_discoveryengine_v1alpha_agent_object
5778
+ # @param [String] fields
5779
+ # Selector specifying which fields to include in a partial response.
5780
+ # @param [String] quota_user
5781
+ # Available to use for quota purposes for server-side applications. Can be any
5782
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5783
+ # @param [Google::Apis::RequestOptions] options
5784
+ # Request-specific options
5785
+ #
5786
+ # @yield [result, err] Result & error if block supplied
5787
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaAgent] parsed result object
5788
+ # @yieldparam err [StandardError] error object if request failed
5789
+ #
5790
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaAgent]
5791
+ #
5792
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5793
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5794
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5795
+ def create_project_location_collection_engine_assistant_agent(parent, google_cloud_discoveryengine_v1alpha_agent_object = nil, fields: nil, quota_user: nil, options: nil, &block)
5796
+ command = make_simple_command(:post, 'v1alpha/{+parent}/agents', options)
5797
+ command.request_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaAgent::Representation
5798
+ command.request_object = google_cloud_discoveryengine_v1alpha_agent_object
5799
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaAgent::Representation
5800
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaAgent
5801
+ command.params['parent'] = parent unless parent.nil?
5802
+ command.query['fields'] = fields unless fields.nil?
5803
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5804
+ execute_or_queue_command(command, &block)
5805
+ end
5806
+
5807
+ # Deletes an Agent.
5808
+ # @param [String] name
5809
+ # Required. Resource name of Agent. Format: `projects/`project`/locations/`
5810
+ # location`/collections/`collection`/engines/`engine`/assistants/`assistant`/
5811
+ # agents/`agent`` If the caller does not have permission to delete the agent,
5812
+ # regardless of whether or not it exists, a `PERMISSION_DENIED` error is
5813
+ # returned. If the agent to delete does not exist, a `NOT_FOUND` error is
5814
+ # returned.
5815
+ # @param [String] fields
5816
+ # Selector specifying which fields to include in a partial response.
5817
+ # @param [String] quota_user
5818
+ # Available to use for quota purposes for server-side applications. Can be any
5819
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5820
+ # @param [Google::Apis::RequestOptions] options
5821
+ # Request-specific options
5822
+ #
5823
+ # @yield [result, err] Result & error if block supplied
5824
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation] parsed result object
5825
+ # @yieldparam err [StandardError] error object if request failed
5826
+ #
5827
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation]
5828
+ #
5829
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5830
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5831
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5832
+ def delete_project_location_collection_engine_assistant_agent(name, fields: nil, quota_user: nil, options: nil, &block)
5833
+ command = make_simple_command(:delete, 'v1alpha/{+name}', options)
5834
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation::Representation
5835
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleLongrunningOperation
5836
+ command.params['name'] = name unless name.nil?
5837
+ command.query['fields'] = fields unless fields.nil?
5838
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5839
+ execute_or_queue_command(command, &block)
5840
+ end
5841
+
5842
+ # Gets an Agent.
5843
+ # @param [String] name
5844
+ # Required. Resource name of Agent. Format: `projects/`project`/locations/`
5845
+ # location`/collections/`collection`/engines/`engine`/assistants/`assistant`/
5846
+ # agents/`agent``
5847
+ # @param [String] fields
5848
+ # Selector specifying which fields to include in a partial response.
5849
+ # @param [String] quota_user
5850
+ # Available to use for quota purposes for server-side applications. Can be any
5851
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5852
+ # @param [Google::Apis::RequestOptions] options
5853
+ # Request-specific options
5854
+ #
5855
+ # @yield [result, err] Result & error if block supplied
5856
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaAgent] parsed result object
5857
+ # @yieldparam err [StandardError] error object if request failed
5858
+ #
5859
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaAgent]
5860
+ #
5861
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5862
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5863
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5864
+ def get_project_location_collection_engine_assistant_agent(name, fields: nil, quota_user: nil, options: nil, &block)
5865
+ command = make_simple_command(:get, 'v1alpha/{+name}', options)
5866
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaAgent::Representation
5867
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaAgent
5868
+ command.params['name'] = name unless name.nil?
5869
+ command.query['fields'] = fields unless fields.nil?
5870
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5871
+ execute_or_queue_command(command, &block)
5872
+ end
5873
+
5874
+ # Lists all Agents under an Assistant which were created by the caller.
5875
+ # @param [String] parent
5876
+ # Required. The parent resource name. Format: `projects/`project`/locations/`
5877
+ # location`/collections/`collection`/engines/`engine`/assistants/`assistant``
5878
+ # @param [String] order_by
5879
+ # Optional. A comma-separated list of fields to order by, sorted in ascending
5880
+ # order. Use "desc" after a field name for descending. Supported fields: * `
5881
+ # update_time` * `is_pinned` Example: * "update_time desc" * "is_pinned desc,
5882
+ # update_time desc": list agents by is_pinned first, then by update_time.
5883
+ # @param [Fixnum] page_size
5884
+ # Optional. Maximum number of Agents to return. If unspecified, defaults to 100.
5885
+ # The maximum allowed value is 1000; anything above that will be coerced down to
5886
+ # 1000.
5887
+ # @param [String] page_token
5888
+ # Optional. A page token ListAgentsResponse.next_page_token, received from a
5889
+ # previous AgentService.ListAgents call. Provide this to retrieve the subsequent
5890
+ # page. When paginating, all other parameters provided to ListAgents must match
5891
+ # the call that provided the page token.
5892
+ # @param [String] fields
5893
+ # Selector specifying which fields to include in a partial response.
5894
+ # @param [String] quota_user
5895
+ # Available to use for quota purposes for server-side applications. Can be any
5896
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5897
+ # @param [Google::Apis::RequestOptions] options
5898
+ # Request-specific options
5899
+ #
5900
+ # @yield [result, err] Result & error if block supplied
5901
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaListAgentsResponse] parsed result object
5902
+ # @yieldparam err [StandardError] error object if request failed
5903
+ #
5904
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaListAgentsResponse]
5905
+ #
5906
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5907
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5908
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5909
+ def list_project_location_collection_engine_assistant_agents(parent, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
5910
+ command = make_simple_command(:get, 'v1alpha/{+parent}/agents', options)
5911
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaListAgentsResponse::Representation
5912
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaListAgentsResponse
5913
+ command.params['parent'] = parent unless parent.nil?
5914
+ command.query['orderBy'] = order_by unless order_by.nil?
5915
+ command.query['pageSize'] = page_size unless page_size.nil?
5916
+ command.query['pageToken'] = page_token unless page_token.nil?
5917
+ command.query['fields'] = fields unless fields.nil?
5918
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5919
+ execute_or_queue_command(command, &block)
5920
+ end
5921
+
5922
+ # Updates an Agent
5923
+ # @param [String] name
5924
+ # Identifier. Resource name of the agent. Format: `projects/`project`/locations/`
5925
+ # location`/collections/`collection`/engines/`engine`/assistants/`assistant`/
5926
+ # agents/`agent``
5927
+ # @param [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaAgent] google_cloud_discoveryengine_v1alpha_agent_object
5928
+ # @param [String] update_mask
5929
+ # Optional. The list of fields to update.
5930
+ # @param [String] fields
5931
+ # Selector specifying which fields to include in a partial response.
5932
+ # @param [String] quota_user
5933
+ # Available to use for quota purposes for server-side applications. Can be any
5934
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5935
+ # @param [Google::Apis::RequestOptions] options
5936
+ # Request-specific options
5937
+ #
5938
+ # @yield [result, err] Result & error if block supplied
5939
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaAgent] parsed result object
5940
+ # @yieldparam err [StandardError] error object if request failed
5941
+ #
5942
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaAgent]
5943
+ #
5944
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5945
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5946
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5947
+ def patch_project_location_collection_engine_assistant_agent(name, google_cloud_discoveryengine_v1alpha_agent_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
5948
+ command = make_simple_command(:patch, 'v1alpha/{+name}', options)
5949
+ command.request_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaAgent::Representation
5950
+ command.request_object = google_cloud_discoveryengine_v1alpha_agent_object
5951
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaAgent::Representation
5952
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaAgent
5953
+ command.params['name'] = name unless name.nil?
5954
+ command.query['updateMask'] = update_mask unless update_mask.nil?
5955
+ command.query['fields'] = fields unless fields.nil?
5956
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5957
+ execute_or_queue_command(command, &block)
5958
+ end
5959
+
5960
+ # Imports a file to an Agent. Currently only No-Code agents are supported.
5961
+ # @param [String] parent
5962
+ # Required. The resource name of the Agent. Format: `projects/`project`/
5963
+ # locations/`location`/collections/`collection`/engines/`engine`/assistants/`
5964
+ # assistant`/agents/`agent``
5965
+ # @param [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaImportAgentFileRequest] google_cloud_discoveryengine_v1alpha_import_agent_file_request_object
5966
+ # @param [String] fields
5967
+ # Selector specifying which fields to include in a partial response.
5968
+ # @param [String] quota_user
5969
+ # Available to use for quota purposes for server-side applications. Can be any
5970
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
5971
+ # @param [Google::Apis::RequestOptions] options
5972
+ # Request-specific options
5973
+ #
5974
+ # @yield [result, err] Result & error if block supplied
5975
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaImportAgentFileResponse] parsed result object
5976
+ # @yieldparam err [StandardError] error object if request failed
5977
+ #
5978
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaImportAgentFileResponse]
5979
+ #
5980
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
5981
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
5982
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
5983
+ def import_project_location_collection_engine_assistant_agent_file(parent, google_cloud_discoveryengine_v1alpha_import_agent_file_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
5984
+ command = make_simple_command(:post, 'v1alpha/{+parent}/files:import', options)
5985
+ command.request_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaImportAgentFileRequest::Representation
5986
+ command.request_object = google_cloud_discoveryengine_v1alpha_import_agent_file_request_object
5987
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaImportAgentFileResponse::Representation
5988
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaImportAgentFileResponse
5989
+ command.params['parent'] = parent unless parent.nil?
5990
+ command.query['fields'] = fields unless fields.nil?
5991
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
5992
+ execute_or_queue_command(command, &block)
5993
+ end
5994
+
5434
5995
  # Creates a CannedQuery.
5435
5996
  # @param [String] parent
5436
5997
  # Required. The parent resource name. Format: `projects/`project`/locations/`
@@ -6854,6 +7415,47 @@ module Google
6854
7415
  execute_or_queue_command(command, &block)
6855
7416
  end
6856
7417
 
7418
+ # Update a WidgetConfig.
7419
+ # @param [String] name
7420
+ # Immutable. The full resource name of the widget config. Format: `projects/`
7421
+ # project`/locations/`location`/collections/`collection_id`/dataStores/`
7422
+ # data_store_id`/widgetConfigs/`widget_config_id``. This field must be a UTF-8
7423
+ # encoded string with a length limit of 1024 characters.
7424
+ # @param [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaWidgetConfig] google_cloud_discoveryengine_v1alpha_widget_config_object
7425
+ # @param [String] update_mask
7426
+ # Indicates which fields in the provided WidgetConfig to update. The following
7427
+ # are the only supported fields: * WidgetConfig.enable_autocomplete If not set,
7428
+ # all supported fields are updated.
7429
+ # @param [String] fields
7430
+ # Selector specifying which fields to include in a partial response.
7431
+ # @param [String] quota_user
7432
+ # Available to use for quota purposes for server-side applications. Can be any
7433
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
7434
+ # @param [Google::Apis::RequestOptions] options
7435
+ # Request-specific options
7436
+ #
7437
+ # @yield [result, err] Result & error if block supplied
7438
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaWidgetConfig] parsed result object
7439
+ # @yieldparam err [StandardError] error object if request failed
7440
+ #
7441
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaWidgetConfig]
7442
+ #
7443
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
7444
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
7445
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
7446
+ def patch_project_location_collection_engine_widget_config(name, google_cloud_discoveryengine_v1alpha_widget_config_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
7447
+ command = make_simple_command(:patch, 'v1alpha/{+name}', options)
7448
+ command.request_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaWidgetConfig::Representation
7449
+ command.request_object = google_cloud_discoveryengine_v1alpha_widget_config_object
7450
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaWidgetConfig::Representation
7451
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaWidgetConfig
7452
+ command.params['name'] = name unless name.nil?
7453
+ command.query['updateMask'] = update_mask unless update_mask.nil?
7454
+ command.query['fields'] = fields unless fields.nil?
7455
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
7456
+ execute_or_queue_command(command, &block)
7457
+ end
7458
+
6857
7459
  # Gets the latest state of a long-running operation. Clients can use this method
6858
7460
  # to poll the operation result at intervals as recommended by the API service.
6859
7461
  # @param [String] name
@@ -6957,9 +7559,9 @@ module Google
6957
7559
  # values: * `document` is the default model for regular dataStores. * `search-
6958
7560
  # history` is the default model for site search dataStores.
6959
7561
  # @param [String] user_pseudo_id
6960
- # A unique identifier for tracking visitors. For example, this could be
6961
- # implemented with an HTTP cookie, which should be able to uniquely identify a
6962
- # visitor on a single device. This unique identifier should not change if the
7562
+ # Optional. A unique identifier for tracking visitors. For example, this could
7563
+ # be implemented with an HTTP cookie, which should be able to uniquely identify
7564
+ # a visitor on a single device. This unique identifier should not change if the
6963
7565
  # visitor logs in or out of the website. This field should NOT have a fixed
6964
7566
  # value such as `unknown_visitor`. This should be the same identifier as
6965
7567
  # UserEvent.user_pseudo_id and SearchRequest.user_pseudo_id. The field must be a
@@ -10079,6 +10681,47 @@ module Google
10079
10681
  execute_or_queue_command(command, &block)
10080
10682
  end
10081
10683
 
10684
+ # Update a WidgetConfig.
10685
+ # @param [String] name
10686
+ # Immutable. The full resource name of the widget config. Format: `projects/`
10687
+ # project`/locations/`location`/collections/`collection_id`/dataStores/`
10688
+ # data_store_id`/widgetConfigs/`widget_config_id``. This field must be a UTF-8
10689
+ # encoded string with a length limit of 1024 characters.
10690
+ # @param [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaWidgetConfig] google_cloud_discoveryengine_v1alpha_widget_config_object
10691
+ # @param [String] update_mask
10692
+ # Indicates which fields in the provided WidgetConfig to update. The following
10693
+ # are the only supported fields: * WidgetConfig.enable_autocomplete If not set,
10694
+ # all supported fields are updated.
10695
+ # @param [String] fields
10696
+ # Selector specifying which fields to include in a partial response.
10697
+ # @param [String] quota_user
10698
+ # Available to use for quota purposes for server-side applications. Can be any
10699
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
10700
+ # @param [Google::Apis::RequestOptions] options
10701
+ # Request-specific options
10702
+ #
10703
+ # @yield [result, err] Result & error if block supplied
10704
+ # @yieldparam result [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaWidgetConfig] parsed result object
10705
+ # @yieldparam err [StandardError] error object if request failed
10706
+ #
10707
+ # @return [Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaWidgetConfig]
10708
+ #
10709
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
10710
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
10711
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
10712
+ def patch_project_location_data_store_widget_config(name, google_cloud_discoveryengine_v1alpha_widget_config_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
10713
+ command = make_simple_command(:patch, 'v1alpha/{+name}', options)
10714
+ command.request_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaWidgetConfig::Representation
10715
+ command.request_object = google_cloud_discoveryengine_v1alpha_widget_config_object
10716
+ command.response_representation = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaWidgetConfig::Representation
10717
+ command.response_class = Google::Apis::DiscoveryengineV1alpha::GoogleCloudDiscoveryengineV1alphaWidgetConfig
10718
+ command.params['name'] = name unless name.nil?
10719
+ command.query['updateMask'] = update_mask unless update_mask.nil?
10720
+ command.query['fields'] = fields unless fields.nil?
10721
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
10722
+ execute_or_queue_command(command, &block)
10723
+ end
10724
+
10082
10725
  # Creates a Evaluation. Upon creation, the evaluation will be automatically
10083
10726
  # triggered and begin execution.
10084
10727
  # @param [String] parent