ultracart_api 4.1.16 → 4.1.17

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.
@@ -4,11 +4,15 @@ All URIs are relative to *https://secure.ultracart.com/rest/v2*
4
4
 
5
5
  | Method | HTTP request | Description |
6
6
  | ------ | ------------ | ----------- |
7
+ | [**delete_custom_dashboard**](DatawarehouseApi.md#delete_custom_dashboard) | **DELETE** /datawarehouse/custom_dashboards/{custom_dashboard_oid} | Delete a custom dashboard |
7
8
  | [**delete_custom_report**](DatawarehouseApi.md#delete_custom_report) | **DELETE** /datawarehouse/custom_reports/{custom_report_oid} | Delete a custom report |
8
9
  | [**delete_report**](DatawarehouseApi.md#delete_report) | **DELETE** /datawarehouse/reports/{report_oid} | Delete a report |
9
10
  | [**dry_run_report_queries**](DatawarehouseApi.md#dry_run_report_queries) | **PUT** /datawarehouse/reports/dryrun | Dry run the report queries |
10
11
  | [**execute_custom_report**](DatawarehouseApi.md#execute_custom_report) | **PUT** /datawarehouse/custom_reports/{custom_report_oid}/execute | Execute a custom report |
12
+ | [**execute_custom_reports**](DatawarehouseApi.md#execute_custom_reports) | **PUT** /datawarehouse/custom_reports/execute | Execute a custom reports |
11
13
  | [**execute_report_queries**](DatawarehouseApi.md#execute_report_queries) | **PUT** /datawarehouse/reports/execute | Execute the report queries |
14
+ | [**get_custom_dashboard**](DatawarehouseApi.md#get_custom_dashboard) | **GET** /datawarehouse/custom_dashboards/{custom_dashboard_oid} | Get a custom dashboard |
15
+ | [**get_custom_dashboards**](DatawarehouseApi.md#get_custom_dashboards) | **GET** /datawarehouse/custom_dashboards | Get custom dashboards |
12
16
  | [**get_custom_report**](DatawarehouseApi.md#get_custom_report) | **GET** /datawarehouse/custom_reports/{custom_report_oid} | Get a custom report |
13
17
  | [**get_custom_report_account_config**](DatawarehouseApi.md#get_custom_report_account_config) | **GET** /datawarehouse/custom_reports/account_config | Get custom report account configuration |
14
18
  | [**get_custom_reports**](DatawarehouseApi.md#get_custom_reports) | **GET** /datawarehouse/custom_reports | Get custom reports |
@@ -17,13 +21,68 @@ All URIs are relative to *https://secure.ultracart.com/rest/v2*
17
21
  | [**get_report_data_set_page**](DatawarehouseApi.md#get_report_data_set_page) | **GET** /datawarehouse/reports/dataset/{dataset_uuid}/pages/{page_number} | Get a report data set page |
18
22
  | [**get_report_websocket_authorization**](DatawarehouseApi.md#get_report_websocket_authorization) | **PUT** /datawarehouse/reports/auth | Get report websocket authorization |
19
23
  | [**get_reports**](DatawarehouseApi.md#get_reports) | **GET** /datawarehouse/reports | Get list of reports available |
24
+ | [**insert_custom_dashboard**](DatawarehouseApi.md#insert_custom_dashboard) | **POST** /datawarehouse/custom_dashboards | Create a custom dashboard |
20
25
  | [**insert_custom_report**](DatawarehouseApi.md#insert_custom_report) | **POST** /datawarehouse/custom_reports | Create a custom report |
21
26
  | [**insert_report**](DatawarehouseApi.md#insert_report) | **POST** /datawarehouse/reports | Create a report |
27
+ | [**update_custom_dashboard**](DatawarehouseApi.md#update_custom_dashboard) | **PUT** /datawarehouse/custom_dashboards/{custom_dashboard_oid} | Update a custom dashboard |
22
28
  | [**update_custom_report**](DatawarehouseApi.md#update_custom_report) | **PUT** /datawarehouse/custom_reports/{custom_report_oid} | Update a custom report |
23
29
  | [**update_custom_report_account_config**](DatawarehouseApi.md#update_custom_report_account_config) | **PUT** /datawarehouse/custom_reports/account_config | Update custom report account config |
24
30
  | [**update_report**](DatawarehouseApi.md#update_report) | **PUT** /datawarehouse/reports/{report_oid} | Update a report |
25
31
 
26
32
 
33
+ ## delete_custom_dashboard
34
+
35
+ > delete_custom_dashboard(custom_dashboard_oid)
36
+
37
+ Delete a custom dashboard
38
+
39
+ Delete a custom dashboard on the UltraCart account.
40
+
41
+
42
+ ### Examples
43
+
44
+
45
+ (No example for this operation).
46
+
47
+
48
+ #### Using the delete_custom_dashboard_with_http_info variant
49
+
50
+ This returns an Array which contains the response data (`nil` in this case), status code and headers.
51
+
52
+ > <Array(nil, Integer, Hash)> delete_custom_dashboard_with_http_info(custom_dashboard_oid)
53
+
54
+ ```ruby
55
+ begin
56
+ # Delete a custom dashboard
57
+ data, status_code, headers = api_instance.delete_custom_dashboard_with_http_info(custom_dashboard_oid)
58
+ p status_code # => 2xx
59
+ p headers # => { ... }
60
+ p data # => nil
61
+ rescue UltracartClient::ApiError => e
62
+ puts "Error when calling DatawarehouseApi->delete_custom_dashboard_with_http_info: #{e}"
63
+ end
64
+ ```
65
+
66
+ ### Parameters
67
+
68
+ | Name | Type | Description | Notes |
69
+ | ---- | ---- | ----------- | ----- |
70
+ | **custom_dashboard_oid** | **Integer** | The dashboard oid to delete. | |
71
+
72
+ ### Return type
73
+
74
+ nil (empty response body)
75
+
76
+ ### Authorization
77
+
78
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
79
+
80
+ ### HTTP request headers
81
+
82
+ - **Content-Type**: Not defined
83
+ - **Accept**: application/json
84
+
85
+
27
86
  ## delete_custom_report
28
87
 
29
88
  > delete_custom_report(custom_report_oid)
@@ -187,7 +246,7 @@ end
187
246
 
188
247
  ## execute_custom_report
189
248
 
190
- > <CustomReportResponse> execute_custom_report(custom_report_oid, execution_request)
249
+ > <CustomReportExecutionResponse> execute_custom_report(custom_report_oid, execution_request)
191
250
 
192
251
  Execute a custom report
193
252
 
@@ -204,7 +263,7 @@ Execute a custom report on the UltraCart account.
204
263
 
205
264
  This returns an Array which contains the response data, status code and headers.
206
265
 
207
- > <Array(<CustomReportResponse>, Integer, Hash)> execute_custom_report_with_http_info(custom_report_oid, execution_request)
266
+ > <Array(<CustomReportExecutionResponse>, Integer, Hash)> execute_custom_report_with_http_info(custom_report_oid, execution_request)
208
267
 
209
268
  ```ruby
210
269
  begin
@@ -212,7 +271,7 @@ begin
212
271
  data, status_code, headers = api_instance.execute_custom_report_with_http_info(custom_report_oid, execution_request)
213
272
  p status_code # => 2xx
214
273
  p headers # => { ... }
215
- p data # => <CustomReportResponse>
274
+ p data # => <CustomReportExecutionResponse>
216
275
  rescue UltracartClient::ApiError => e
217
276
  puts "Error when calling DatawarehouseApi->execute_custom_report_with_http_info: #{e}"
218
277
  end
@@ -227,7 +286,60 @@ end
227
286
 
228
287
  ### Return type
229
288
 
230
- [**CustomReportResponse**](CustomReportResponse.md)
289
+ [**CustomReportExecutionResponse**](CustomReportExecutionResponse.md)
290
+
291
+ ### Authorization
292
+
293
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
294
+
295
+ ### HTTP request headers
296
+
297
+ - **Content-Type**: application/json; charset=UTF-8
298
+ - **Accept**: application/json
299
+
300
+
301
+ ## execute_custom_reports
302
+
303
+ > <CustomReportsExecutionResponse> execute_custom_reports(execution_request)
304
+
305
+ Execute a custom reports
306
+
307
+ Execute a custom reports on the UltraCart account.
308
+
309
+
310
+ ### Examples
311
+
312
+
313
+ (No example for this operation).
314
+
315
+
316
+ #### Using the execute_custom_reports_with_http_info variant
317
+
318
+ This returns an Array which contains the response data, status code and headers.
319
+
320
+ > <Array(<CustomReportsExecutionResponse>, Integer, Hash)> execute_custom_reports_with_http_info(execution_request)
321
+
322
+ ```ruby
323
+ begin
324
+ # Execute a custom reports
325
+ data, status_code, headers = api_instance.execute_custom_reports_with_http_info(execution_request)
326
+ p status_code # => 2xx
327
+ p headers # => { ... }
328
+ p data # => <CustomReportsExecutionResponse>
329
+ rescue UltracartClient::ApiError => e
330
+ puts "Error when calling DatawarehouseApi->execute_custom_reports_with_http_info: #{e}"
331
+ end
332
+ ```
333
+
334
+ ### Parameters
335
+
336
+ | Name | Type | Description | Notes |
337
+ | ---- | ---- | ----------- | ----- |
338
+ | **execution_request** | [**CustomReportsExecutionRequest**](CustomReportsExecutionRequest.md) | Request to execute custom reports | |
339
+
340
+ ### Return type
341
+
342
+ [**CustomReportsExecutionResponse**](CustomReportsExecutionResponse.md)
231
343
 
232
344
  ### Authorization
233
345
 
@@ -293,6 +405,110 @@ nil (empty response body)
293
405
  - **Accept**: application/json
294
406
 
295
407
 
408
+ ## get_custom_dashboard
409
+
410
+ > <CustomDashboardResponse> get_custom_dashboard(custom_dashboard_oid)
411
+
412
+ Get a custom dashboard
413
+
414
+ Retrieve a custom dashboard
415
+
416
+
417
+ ### Examples
418
+
419
+
420
+ (No example for this operation).
421
+
422
+
423
+ #### Using the get_custom_dashboard_with_http_info variant
424
+
425
+ This returns an Array which contains the response data, status code and headers.
426
+
427
+ > <Array(<CustomDashboardResponse>, Integer, Hash)> get_custom_dashboard_with_http_info(custom_dashboard_oid)
428
+
429
+ ```ruby
430
+ begin
431
+ # Get a custom dashboard
432
+ data, status_code, headers = api_instance.get_custom_dashboard_with_http_info(custom_dashboard_oid)
433
+ p status_code # => 2xx
434
+ p headers # => { ... }
435
+ p data # => <CustomDashboardResponse>
436
+ rescue UltracartClient::ApiError => e
437
+ puts "Error when calling DatawarehouseApi->get_custom_dashboard_with_http_info: #{e}"
438
+ end
439
+ ```
440
+
441
+ ### Parameters
442
+
443
+ | Name | Type | Description | Notes |
444
+ | ---- | ---- | ----------- | ----- |
445
+ | **custom_dashboard_oid** | **Integer** | | |
446
+
447
+ ### Return type
448
+
449
+ [**CustomDashboardResponse**](CustomDashboardResponse.md)
450
+
451
+ ### Authorization
452
+
453
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
454
+
455
+ ### HTTP request headers
456
+
457
+ - **Content-Type**: Not defined
458
+ - **Accept**: application/json
459
+
460
+
461
+ ## get_custom_dashboards
462
+
463
+ > <CustomDashboardsResponse> get_custom_dashboards
464
+
465
+ Get custom dashboards
466
+
467
+ Retrieve a custom dashboards
468
+
469
+
470
+ ### Examples
471
+
472
+
473
+ (No example for this operation).
474
+
475
+
476
+ #### Using the get_custom_dashboards_with_http_info variant
477
+
478
+ This returns an Array which contains the response data, status code and headers.
479
+
480
+ > <Array(<CustomDashboardsResponse>, Integer, Hash)> get_custom_dashboards_with_http_info
481
+
482
+ ```ruby
483
+ begin
484
+ # Get custom dashboards
485
+ data, status_code, headers = api_instance.get_custom_dashboards_with_http_info
486
+ p status_code # => 2xx
487
+ p headers # => { ... }
488
+ p data # => <CustomDashboardsResponse>
489
+ rescue UltracartClient::ApiError => e
490
+ puts "Error when calling DatawarehouseApi->get_custom_dashboards_with_http_info: #{e}"
491
+ end
492
+ ```
493
+
494
+ ### Parameters
495
+
496
+ This endpoint does not need any parameter.
497
+
498
+ ### Return type
499
+
500
+ [**CustomDashboardsResponse**](CustomDashboardsResponse.md)
501
+
502
+ ### Authorization
503
+
504
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
505
+
506
+ ### HTTP request headers
507
+
508
+ - **Content-Type**: Not defined
509
+ - **Accept**: application/json
510
+
511
+
296
512
  ## get_custom_report
297
513
 
298
514
  > <CustomReportResponse> get_custom_report(custom_report_oid)
@@ -715,6 +931,59 @@ This endpoint does not need any parameter.
715
931
  - **Accept**: application/json
716
932
 
717
933
 
934
+ ## insert_custom_dashboard
935
+
936
+ > <CustomDashboardResponse> insert_custom_dashboard(dashboard)
937
+
938
+ Create a custom dashboard
939
+
940
+ Create a new custom dashboard on the UltraCart account.
941
+
942
+
943
+ ### Examples
944
+
945
+
946
+ (No example for this operation).
947
+
948
+
949
+ #### Using the insert_custom_dashboard_with_http_info variant
950
+
951
+ This returns an Array which contains the response data, status code and headers.
952
+
953
+ > <Array(<CustomDashboardResponse>, Integer, Hash)> insert_custom_dashboard_with_http_info(dashboard)
954
+
955
+ ```ruby
956
+ begin
957
+ # Create a custom dashboard
958
+ data, status_code, headers = api_instance.insert_custom_dashboard_with_http_info(dashboard)
959
+ p status_code # => 2xx
960
+ p headers # => { ... }
961
+ p data # => <CustomDashboardResponse>
962
+ rescue UltracartClient::ApiError => e
963
+ puts "Error when calling DatawarehouseApi->insert_custom_dashboard_with_http_info: #{e}"
964
+ end
965
+ ```
966
+
967
+ ### Parameters
968
+
969
+ | Name | Type | Description | Notes |
970
+ | ---- | ---- | ----------- | ----- |
971
+ | **dashboard** | [**CustomDashboard**](CustomDashboard.md) | Dashboard to create | |
972
+
973
+ ### Return type
974
+
975
+ [**CustomDashboardResponse**](CustomDashboardResponse.md)
976
+
977
+ ### Authorization
978
+
979
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
980
+
981
+ ### HTTP request headers
982
+
983
+ - **Content-Type**: application/json; charset=UTF-8
984
+ - **Accept**: application/json
985
+
986
+
718
987
  ## insert_custom_report
719
988
 
720
989
  > <CustomReportResponse> insert_custom_report(report)
@@ -822,6 +1091,60 @@ end
822
1091
  - **Accept**: application/json
823
1092
 
824
1093
 
1094
+ ## update_custom_dashboard
1095
+
1096
+ > <CustomDashboardResponse> update_custom_dashboard(custom_dashboard_oid, dashboard)
1097
+
1098
+ Update a custom dashboard
1099
+
1100
+ Update a custom dashboard on the UltraCart account.
1101
+
1102
+
1103
+ ### Examples
1104
+
1105
+
1106
+ (No example for this operation).
1107
+
1108
+
1109
+ #### Using the update_custom_dashboard_with_http_info variant
1110
+
1111
+ This returns an Array which contains the response data, status code and headers.
1112
+
1113
+ > <Array(<CustomDashboardResponse>, Integer, Hash)> update_custom_dashboard_with_http_info(custom_dashboard_oid, dashboard)
1114
+
1115
+ ```ruby
1116
+ begin
1117
+ # Update a custom dashboard
1118
+ data, status_code, headers = api_instance.update_custom_dashboard_with_http_info(custom_dashboard_oid, dashboard)
1119
+ p status_code # => 2xx
1120
+ p headers # => { ... }
1121
+ p data # => <CustomDashboardResponse>
1122
+ rescue UltracartClient::ApiError => e
1123
+ puts "Error when calling DatawarehouseApi->update_custom_dashboard_with_http_info: #{e}"
1124
+ end
1125
+ ```
1126
+
1127
+ ### Parameters
1128
+
1129
+ | Name | Type | Description | Notes |
1130
+ | ---- | ---- | ----------- | ----- |
1131
+ | **custom_dashboard_oid** | **Integer** | The dashboard oid to custom update. | |
1132
+ | **dashboard** | [**CustomDashboard**](CustomDashboard.md) | Dashboard to custom update | |
1133
+
1134
+ ### Return type
1135
+
1136
+ [**CustomDashboardResponse**](CustomDashboardResponse.md)
1137
+
1138
+ ### Authorization
1139
+
1140
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
1141
+
1142
+ ### HTTP request headers
1143
+
1144
+ - **Content-Type**: application/json; charset=UTF-8
1145
+ - **Accept**: application/json
1146
+
1147
+
825
1148
  ## update_custom_report
826
1149
 
827
1150
  > <CustomReportResponse> update_custom_report(custom_report_oid, report)
@@ -0,0 +1,26 @@
1
+ # UltracartClient::EmailEditorValuesResponse
2
+
3
+ ## Properties
4
+
5
+ | Name | Type | Description | Notes |
6
+ | ---- | ---- | ----------- | ----- |
7
+ | **error** | [**Error**](Error.md) | | [optional] |
8
+ | **loyalty_tiers** | **Array&lt;String&gt;** | | [optional] |
9
+ | **metadata** | [**ResponseMetadata**](ResponseMetadata.md) | | [optional] |
10
+ | **success** | **Boolean** | Indicates if API call was successful | [optional] |
11
+ | **warning** | [**Warning**](Warning.md) | | [optional] |
12
+
13
+ ## Example
14
+
15
+ ```ruby
16
+ require 'ultracart_api'
17
+
18
+ instance = UltracartClient::EmailEditorValuesResponse.new(
19
+ error: null,
20
+ loyalty_tiers: null,
21
+ metadata: null,
22
+ success: null,
23
+ warning: null
24
+ )
25
+ ```
26
+
@@ -44,6 +44,7 @@ All URIs are relative to *https://secure.ultracart.com/rest/v2*
44
44
  | [**get_email_campaigns**](StorefrontApi.md#get_email_campaigns) | **GET** /storefront/{storefront_oid}/email/campaigns | Get email campaigns |
45
45
  | [**get_email_campaigns_with_stats**](StorefrontApi.md#get_email_campaigns_with_stats) | **GET** /storefront/{storefront_oid}/email/campaignsWithStats/{stat_days} | Get email campaigns with stats |
46
46
  | [**get_email_commseq**](StorefrontApi.md#get_email_commseq) | **GET** /storefront/{storefront_oid}/email/commseqs/{commseq_uuid} | Get email commseq |
47
+ | [**get_email_commseq_editor_values**](StorefrontApi.md#get_email_commseq_editor_values) | **GET** /storefront/{storefront_oid}/email/commseqs/editorValues | Get email merchant specific editor values |
47
48
  | [**get_email_commseq_email_stats**](StorefrontApi.md#get_email_commseq_email_stats) | **POST** /storefront/{storefront_oid}/email/commseqs/{commseq_uuid}/emailStats | Get email communication sequence emails stats |
48
49
  | [**get_email_commseq_postcard_stats**](StorefrontApi.md#get_email_commseq_postcard_stats) | **POST** /storefront/{storefront_oid}/email/commseqs/{commseq_uuid}/postcardStats | Get email communication sequence postcard stats |
49
50
  | [**get_email_commseq_postcard_tracking**](StorefrontApi.md#get_email_commseq_postcard_tracking) | **GET** /storefront/{storefront_oid}/email/postcards/{commseq_postcard_uuid}/tracking | Get email communication postcard tracking |
@@ -2303,6 +2304,57 @@ end
2303
2304
  - **Accept**: application/json
2304
2305
 
2305
2306
 
2307
+ ## get_email_commseq_editor_values
2308
+
2309
+ > <EmailEditorValuesResponse> get_email_commseq_editor_values(storefront_oid)
2310
+
2311
+ Get email merchant specific editor values
2312
+
2313
+
2314
+ ### Examples
2315
+
2316
+
2317
+ (No example for this operation).
2318
+
2319
+
2320
+ #### Using the get_email_commseq_editor_values_with_http_info variant
2321
+
2322
+ This returns an Array which contains the response data, status code and headers.
2323
+
2324
+ > <Array(<EmailEditorValuesResponse>, Integer, Hash)> get_email_commseq_editor_values_with_http_info(storefront_oid)
2325
+
2326
+ ```ruby
2327
+ begin
2328
+ # Get email merchant specific editor values
2329
+ data, status_code, headers = api_instance.get_email_commseq_editor_values_with_http_info(storefront_oid)
2330
+ p status_code # => 2xx
2331
+ p headers # => { ... }
2332
+ p data # => <EmailEditorValuesResponse>
2333
+ rescue UltracartClient::ApiError => e
2334
+ puts "Error when calling StorefrontApi->get_email_commseq_editor_values_with_http_info: #{e}"
2335
+ end
2336
+ ```
2337
+
2338
+ ### Parameters
2339
+
2340
+ | Name | Type | Description | Notes |
2341
+ | ---- | ---- | ----------- | ----- |
2342
+ | **storefront_oid** | **Integer** | | |
2343
+
2344
+ ### Return type
2345
+
2346
+ [**EmailEditorValuesResponse**](EmailEditorValuesResponse.md)
2347
+
2348
+ ### Authorization
2349
+
2350
+ [ultraCartBrowserApiKey](../README.md#ultraCartBrowserApiKey), [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
2351
+
2352
+ ### HTTP request headers
2353
+
2354
+ - **Content-Type**: Not defined
2355
+ - **Accept**: application/json
2356
+
2357
+
2306
2358
  ## get_email_commseq_email_stats
2307
2359
 
2308
2360
  > <EmailStatSummaryResponse> get_email_commseq_email_stats(storefront_oid, commseq_uuid, stats_request)