ultracart_api 4.1.217 → 4.1.219
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.
- checksums.yaml +4 -4
- data/README.md +11 -2
- data/docs/ItemPaymentProcessing.md +2 -0
- data/docs/SfvbApi.md +168 -0
- data/docs/SfvbApprovalCreateRequest.md +3 -1
- data/docs/SfvbApprovalParams.md +2 -0
- data/docs/SfvbCommsSegmentDetail.md +38 -0
- data/docs/SfvbCommsSegmentResponse.md +20 -0
- data/docs/SfvbCommsSegmentUsedBy.md +24 -0
- data/docs/SfvbCommsSegmentWriteRequest.md +22 -0
- data/lib/ultracart_api/api/sfvb_api.rb +236 -0
- data/lib/ultracart_api/models/item_payment_processing.rb +11 -1
- data/lib/ultracart_api/models/sfvb_approval_create_request.rb +15 -6
- data/lib/ultracart_api/models/sfvb_approval_params.rb +11 -1
- data/lib/ultracart_api/models/sfvb_comms_segment_detail.rb +322 -0
- data/lib/ultracart_api/models/sfvb_comms_segment_response.rb +231 -0
- data/lib/ultracart_api/models/sfvb_comms_segment_used_by.rb +284 -0
- data/lib/ultracart_api/models/sfvb_comms_segment_write_request.rb +240 -0
- data/lib/ultracart_api/version.rb +1 -1
- data/lib/ultracart_api.rb +4 -0
- metadata +10 -2
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: e85e145044e21ca3027cf792c90310a8514c9ea77b6653a1b44ce3df77beebcb
|
|
4
|
+
data.tar.gz: 68de13bbf5f7aedde6487537f8180463517a740fd21297b9c953ef29138abe10
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 4c0d1e3c50eaa9d3ca5ee5cedab03defc74ebdcf06f0c965fc57eb5d56a9e233d363615f6c75c3ed7dd5c239101066e98e664913b9a34b4b7bd74fdd2d16c935
|
|
7
|
+
data.tar.gz: 58d3013bdc90636a7f0bc5a16a30682e9d45a1da68146ce15816d6482b8f22675e8e09d17b31c8debf2210b713323b3e9e72462cc46ff1c8d5f12ef341b76588
|
data/README.md
CHANGED
|
@@ -7,7 +7,7 @@ Note: Every method has a sample for every language. See https://github.com/Ultr
|
|
|
7
7
|
This SDK is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
|
|
8
8
|
|
|
9
9
|
- API version: 2.0.0
|
|
10
|
-
- Package version: 4.1.
|
|
10
|
+
- Package version: 4.1.219
|
|
11
11
|
- Build package: org.openapitools.codegen.languages.RubyClientCodegen
|
|
12
12
|
- For more information, please visit [http://www.ultracart.com/api/](http://www.ultracart.com/api/)
|
|
13
13
|
|
|
@@ -16,7 +16,7 @@ This SDK is automatically generated by the [OpenAPI Generator](https://openapi-g
|
|
|
16
16
|
gemfile:
|
|
17
17
|
|
|
18
18
|
```shell
|
|
19
|
-
gem 'ultracart_api', '4.1.
|
|
19
|
+
gem 'ultracart_api', '4.1.219'
|
|
20
20
|
```
|
|
21
21
|
|
|
22
22
|
install:
|
|
@@ -529,6 +529,7 @@ Class | Method | HTTP request | Description
|
|
|
529
529
|
*UltracartClient::SfvbApi* | [**get_sfvb_blog_post**](docs/SfvbApi.md#get_sfvb_blog_post) | **GET** /sfvb/storefronts/{storefront_oid}/blog_posts/{blog_post_oid} | Read a blog post
|
|
530
530
|
*UltracartClient::SfvbApi* | [**get_sfvb_campaign**](docs/SfvbApi.md#get_sfvb_campaign) | **GET** /sfvb/storefronts/{storefront_oid}/campaigns/{campaign_uuid} | Get a campaign
|
|
531
531
|
*UltracartClient::SfvbApi* | [**get_sfvb_cjson_used_elements**](docs/SfvbApi.md#get_sfvb_cjson_used_elements) | **POST** /sfvb/cjson/elements | Element types used by a container
|
|
532
|
+
*UltracartClient::SfvbApi* | [**get_sfvb_comms_segment**](docs/SfvbApi.md#get_sfvb_comms_segment) | **GET** /sfvb/storefronts/{storefront_oid}/segments/{segment_uuid} | Read one segment, with its rule
|
|
532
533
|
*UltracartClient::SfvbApi* | [**get_sfvb_comms_sending_domain**](docs/SfvbApi.md#get_sfvb_comms_sending_domain) | **GET** /sfvb/comms/sending_domains/{domain} | Read a sending domain
|
|
533
534
|
*UltracartClient::SfvbApi* | [**get_sfvb_comms_sending_domains**](docs/SfvbApi.md#get_sfvb_comms_sending_domains) | **GET** /sfvb/comms/sending_domains | List the sending domains
|
|
534
535
|
*UltracartClient::SfvbApi* | [**get_sfvb_comms_twilio_account**](docs/SfvbApi.md#get_sfvb_comms_twilio_account) | **GET** /sfvb/comms/twilio_account | Read the Twilio account
|
|
@@ -589,6 +590,7 @@ Class | Method | HTTP request | Description
|
|
|
589
590
|
*UltracartClient::SfvbApi* | [**import_sfvb_redirects**](docs/SfvbApi.md#import_sfvb_redirects) | **POST** /sfvb/storefronts/{storefront_oid}/redirects/import | Apply a reviewed redirect import
|
|
590
591
|
*UltracartClient::SfvbApi* | [**insert_sfvb_approval**](docs/SfvbApi.md#insert_sfvb_approval) | **POST** /sfvb/approvals | Request a human approval
|
|
591
592
|
*UltracartClient::SfvbApi* | [**insert_sfvb_blog_post**](docs/SfvbApi.md#insert_sfvb_blog_post) | **POST** /sfvb/storefronts/{storefront_oid}/blog_posts | Create a blog post
|
|
593
|
+
*UltracartClient::SfvbApi* | [**insert_sfvb_comms_segment**](docs/SfvbApi.md#insert_sfvb_comms_segment) | **POST** /sfvb/storefronts/{storefront_oid}/segments | Create a segment
|
|
592
594
|
*UltracartClient::SfvbApi* | [**insert_sfvb_comms_sending_domain**](docs/SfvbApi.md#insert_sfvb_comms_sending_domain) | **POST** /sfvb/comms/sending_domains | Add a sending domain
|
|
593
595
|
*UltracartClient::SfvbApi* | [**insert_sfvb_comms_twilio_account**](docs/SfvbApi.md#insert_sfvb_comms_twilio_account) | **POST** /sfvb/comms/twilio_account | Connect the Twilio account
|
|
594
596
|
*UltracartClient::SfvbApi* | [**insert_sfvb_page**](docs/SfvbApi.md#insert_sfvb_page) | **POST** /sfvb/storefronts/{storefront_oid}/pages | Create a page
|
|
@@ -668,6 +670,7 @@ Class | Method | HTTP request | Description
|
|
|
668
670
|
*UltracartClient::SfvbApi* | [**unshare_sfvb_library_entry**](docs/SfvbApi.md#unshare_sfvb_library_entry) | **DELETE** /sfvb/storefronts/{storefront_oid}/library/{library_oid}/shares/{merchant_id} | Stop sharing a library entry with an account
|
|
669
671
|
*UltracartClient::SfvbApi* | [**update_sfvb_blog_post**](docs/SfvbApi.md#update_sfvb_blog_post) | **PUT** /sfvb/storefronts/{storefront_oid}/blog_posts/{blog_post_oid} | Change a blog post
|
|
670
672
|
*UltracartClient::SfvbApi* | [**update_sfvb_campaign**](docs/SfvbApi.md#update_sfvb_campaign) | **PUT** /sfvb/storefronts/{storefront_oid}/campaigns/{campaign_uuid} | Change a campaign
|
|
673
|
+
*UltracartClient::SfvbApi* | [**update_sfvb_comms_segment**](docs/SfvbApi.md#update_sfvb_comms_segment) | **PUT** /sfvb/storefronts/{storefront_oid}/segments/{segment_uuid} | Change a segment's name, rule or folder
|
|
671
674
|
*UltracartClient::SfvbApi* | [**update_sfvb_comms_sending_domain**](docs/SfvbApi.md#update_sfvb_comms_sending_domain) | **PUT** /sfvb/comms/sending_domains/{domain} | Update a sending domain
|
|
672
675
|
*UltracartClient::SfvbApi* | [**update_sfvb_comms_twilio_account**](docs/SfvbApi.md#update_sfvb_comms_twilio_account) | **PUT** /sfvb/comms/twilio_account | Update the Twilio account
|
|
673
676
|
*UltracartClient::SfvbApi* | [**update_sfvb_email**](docs/SfvbApi.md#update_sfvb_email) | **PUT** /sfvb/storefronts/{storefront_oid}/emails/{email_uuid} | Change a flow or campaign email's subject or preview text
|
|
@@ -1932,6 +1935,10 @@ Class | Method | HTTP request | Description
|
|
|
1932
1935
|
- [UltracartClient::SfvbCommsListsResponse](docs/SfvbCommsListsResponse.md)
|
|
1933
1936
|
- [UltracartClient::SfvbCommsPostcard](docs/SfvbCommsPostcard.md)
|
|
1934
1937
|
- [UltracartClient::SfvbCommsSegment](docs/SfvbCommsSegment.md)
|
|
1938
|
+
- [UltracartClient::SfvbCommsSegmentDetail](docs/SfvbCommsSegmentDetail.md)
|
|
1939
|
+
- [UltracartClient::SfvbCommsSegmentResponse](docs/SfvbCommsSegmentResponse.md)
|
|
1940
|
+
- [UltracartClient::SfvbCommsSegmentUsedBy](docs/SfvbCommsSegmentUsedBy.md)
|
|
1941
|
+
- [UltracartClient::SfvbCommsSegmentWriteRequest](docs/SfvbCommsSegmentWriteRequest.md)
|
|
1935
1942
|
- [UltracartClient::SfvbCommsSegmentsResponse](docs/SfvbCommsSegmentsResponse.md)
|
|
1936
1943
|
- [UltracartClient::SfvbCommsSendingDomain](docs/SfvbCommsSendingDomain.md)
|
|
1937
1944
|
- [UltracartClient::SfvbCommsSendingDomainsResponse](docs/SfvbCommsSendingDomainsResponse.md)
|
|
@@ -2336,6 +2343,8 @@ Not every change is committed to every SDK.
|
|
|
2336
2343
|
|
|
2337
2344
|
| Version | Date | Comments |
|
|
2338
2345
|
| --: | :-: | --- |
|
|
2346
|
+
| 4.1.219 | 10/30/2026 | item - field for hsa/fsa eligibility |
|
|
2347
|
+
| 4.1.218 | 10/30/2026 | svfb internal testing |
|
|
2339
2348
|
| 4.1.217 | 10/29/2026 | sfvb internal testing |
|
|
2340
2349
|
| 4.1.216 | 10/29/2026 | sfvb internal testing |
|
|
2341
2350
|
| 4.1.215 | 10/28/2026 | sfvb internal testing |
|
|
@@ -7,6 +7,7 @@
|
|
|
7
7
|
| **block_prepaid** | **Boolean** | True if prepaid cards should be blocked from buying this item | [optional] |
|
|
8
8
|
| **block_refunds** | **Boolean** | True if this item should block any refund attempts, set to false otherwise, null value will not update the field | [optional] |
|
|
9
9
|
| **credit_card_transaction_type** | **String** | Credit card transaction type | [optional] |
|
|
10
|
+
| **hsa_fsa_eligibility** | **String** | HSA/FSA eligibility. eligible_with_lmn means the customer needs a Letter of Medical Necessity. Kept in sync automatically when Truemed is configured. Empty string clears it, null value will not update the field | [optional] |
|
|
10
11
|
| **no_realtime_charge** | **Boolean** | True if no real-time charge should be performed on this item. | [optional] |
|
|
11
12
|
| **payment_method_validity** | **Array<String>** | Payment method validity | [optional] |
|
|
12
13
|
| **rotating_transaction_gateway_codes** | **Array<String>** | Rotating transaction gateway codes | [optional] |
|
|
@@ -20,6 +21,7 @@ instance = UltracartClient::ItemPaymentProcessing.new(
|
|
|
20
21
|
block_prepaid: null,
|
|
21
22
|
block_refunds: null,
|
|
22
23
|
credit_card_transaction_type: null,
|
|
24
|
+
hsa_fsa_eligibility: null,
|
|
23
25
|
no_realtime_charge: null,
|
|
24
26
|
payment_method_validity: null,
|
|
25
27
|
rotating_transaction_gateway_codes: null
|
data/docs/SfvbApi.md
CHANGED
|
@@ -57,6 +57,7 @@ All URIs are relative to *https://secure.ultracart.com/rest/v2*
|
|
|
57
57
|
| [**get_sfvb_blog_post**](SfvbApi.md#get_sfvb_blog_post) | **GET** /sfvb/storefronts/{storefront_oid}/blog_posts/{blog_post_oid} | Read a blog post |
|
|
58
58
|
| [**get_sfvb_campaign**](SfvbApi.md#get_sfvb_campaign) | **GET** /sfvb/storefronts/{storefront_oid}/campaigns/{campaign_uuid} | Get a campaign |
|
|
59
59
|
| [**get_sfvb_cjson_used_elements**](SfvbApi.md#get_sfvb_cjson_used_elements) | **POST** /sfvb/cjson/elements | Element types used by a container |
|
|
60
|
+
| [**get_sfvb_comms_segment**](SfvbApi.md#get_sfvb_comms_segment) | **GET** /sfvb/storefronts/{storefront_oid}/segments/{segment_uuid} | Read one segment, with its rule |
|
|
60
61
|
| [**get_sfvb_comms_sending_domain**](SfvbApi.md#get_sfvb_comms_sending_domain) | **GET** /sfvb/comms/sending_domains/{domain} | Read a sending domain |
|
|
61
62
|
| [**get_sfvb_comms_sending_domains**](SfvbApi.md#get_sfvb_comms_sending_domains) | **GET** /sfvb/comms/sending_domains | List the sending domains |
|
|
62
63
|
| [**get_sfvb_comms_twilio_account**](SfvbApi.md#get_sfvb_comms_twilio_account) | **GET** /sfvb/comms/twilio_account | Read the Twilio account |
|
|
@@ -117,6 +118,7 @@ All URIs are relative to *https://secure.ultracart.com/rest/v2*
|
|
|
117
118
|
| [**import_sfvb_redirects**](SfvbApi.md#import_sfvb_redirects) | **POST** /sfvb/storefronts/{storefront_oid}/redirects/import | Apply a reviewed redirect import |
|
|
118
119
|
| [**insert_sfvb_approval**](SfvbApi.md#insert_sfvb_approval) | **POST** /sfvb/approvals | Request a human approval |
|
|
119
120
|
| [**insert_sfvb_blog_post**](SfvbApi.md#insert_sfvb_blog_post) | **POST** /sfvb/storefronts/{storefront_oid}/blog_posts | Create a blog post |
|
|
121
|
+
| [**insert_sfvb_comms_segment**](SfvbApi.md#insert_sfvb_comms_segment) | **POST** /sfvb/storefronts/{storefront_oid}/segments | Create a segment |
|
|
120
122
|
| [**insert_sfvb_comms_sending_domain**](SfvbApi.md#insert_sfvb_comms_sending_domain) | **POST** /sfvb/comms/sending_domains | Add a sending domain |
|
|
121
123
|
| [**insert_sfvb_comms_twilio_account**](SfvbApi.md#insert_sfvb_comms_twilio_account) | **POST** /sfvb/comms/twilio_account | Connect the Twilio account |
|
|
122
124
|
| [**insert_sfvb_page**](SfvbApi.md#insert_sfvb_page) | **POST** /sfvb/storefronts/{storefront_oid}/pages | Create a page |
|
|
@@ -196,6 +198,7 @@ All URIs are relative to *https://secure.ultracart.com/rest/v2*
|
|
|
196
198
|
| [**unshare_sfvb_library_entry**](SfvbApi.md#unshare_sfvb_library_entry) | **DELETE** /sfvb/storefronts/{storefront_oid}/library/{library_oid}/shares/{merchant_id} | Stop sharing a library entry with an account |
|
|
197
199
|
| [**update_sfvb_blog_post**](SfvbApi.md#update_sfvb_blog_post) | **PUT** /sfvb/storefronts/{storefront_oid}/blog_posts/{blog_post_oid} | Change a blog post |
|
|
198
200
|
| [**update_sfvb_campaign**](SfvbApi.md#update_sfvb_campaign) | **PUT** /sfvb/storefronts/{storefront_oid}/campaigns/{campaign_uuid} | Change a campaign |
|
|
201
|
+
| [**update_sfvb_comms_segment**](SfvbApi.md#update_sfvb_comms_segment) | **PUT** /sfvb/storefronts/{storefront_oid}/segments/{segment_uuid} | Change a segment's name, rule or folder |
|
|
199
202
|
| [**update_sfvb_comms_sending_domain**](SfvbApi.md#update_sfvb_comms_sending_domain) | **PUT** /sfvb/comms/sending_domains/{domain} | Update a sending domain |
|
|
200
203
|
| [**update_sfvb_comms_twilio_account**](SfvbApi.md#update_sfvb_comms_twilio_account) | **PUT** /sfvb/comms/twilio_account | Update the Twilio account |
|
|
201
204
|
| [**update_sfvb_email**](SfvbApi.md#update_sfvb_email) | **PUT** /sfvb/storefronts/{storefront_oid}/emails/{email_uuid} | Change a flow or campaign email's subject or preview text |
|
|
@@ -3097,6 +3100,60 @@ end
|
|
|
3097
3100
|
- **Accept**: application/json
|
|
3098
3101
|
|
|
3099
3102
|
|
|
3103
|
+
## get_sfvb_comms_segment
|
|
3104
|
+
|
|
3105
|
+
> <SfvbCommsSegmentResponse> get_sfvb_comms_segment(storefront_oid, segment_uuid)
|
|
3106
|
+
|
|
3107
|
+
Read one segment, with its rule
|
|
3108
|
+
|
|
3109
|
+
The segment's name, folder, rule, member count at its last rebuild, whether a rebuild is still due, and the campaigns and flows that use it, each with whether it is live. hash_sha256 is the If-Match for an update. Never its members, its Facebook audience, its ranking or its third party sync settings.
|
|
3110
|
+
|
|
3111
|
+
|
|
3112
|
+
### Examples
|
|
3113
|
+
|
|
3114
|
+
|
|
3115
|
+
(No example for this operation).
|
|
3116
|
+
|
|
3117
|
+
|
|
3118
|
+
#### Using the get_sfvb_comms_segment_with_http_info variant
|
|
3119
|
+
|
|
3120
|
+
This returns an Array which contains the response data, status code and headers.
|
|
3121
|
+
|
|
3122
|
+
> <Array(<SfvbCommsSegmentResponse>, Integer, Hash)> get_sfvb_comms_segment_with_http_info(storefront_oid, segment_uuid)
|
|
3123
|
+
|
|
3124
|
+
```ruby
|
|
3125
|
+
begin
|
|
3126
|
+
# Read one segment, with its rule
|
|
3127
|
+
data, status_code, headers = api_instance.get_sfvb_comms_segment_with_http_info(storefront_oid, segment_uuid)
|
|
3128
|
+
p status_code # => 2xx
|
|
3129
|
+
p headers # => { ... }
|
|
3130
|
+
p data # => <SfvbCommsSegmentResponse>
|
|
3131
|
+
rescue UltracartClient::ApiError => e
|
|
3132
|
+
puts "Error when calling SfvbApi->get_sfvb_comms_segment_with_http_info: #{e}"
|
|
3133
|
+
end
|
|
3134
|
+
```
|
|
3135
|
+
|
|
3136
|
+
### Parameters
|
|
3137
|
+
|
|
3138
|
+
| Name | Type | Description | Notes |
|
|
3139
|
+
| ---- | ---- | ----------- | ----- |
|
|
3140
|
+
| **storefront_oid** | **Integer** | | |
|
|
3141
|
+
| **segment_uuid** | **String** | | |
|
|
3142
|
+
|
|
3143
|
+
### Return type
|
|
3144
|
+
|
|
3145
|
+
[**SfvbCommsSegmentResponse**](SfvbCommsSegmentResponse.md)
|
|
3146
|
+
|
|
3147
|
+
### Authorization
|
|
3148
|
+
|
|
3149
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
3150
|
+
|
|
3151
|
+
### HTTP request headers
|
|
3152
|
+
|
|
3153
|
+
- **Content-Type**: Not defined
|
|
3154
|
+
- **Accept**: application/json
|
|
3155
|
+
|
|
3156
|
+
|
|
3100
3157
|
## get_sfvb_comms_sending_domain
|
|
3101
3158
|
|
|
3102
3159
|
> <SfvbCommsSendingDomain> get_sfvb_comms_sending_domain(domain)
|
|
@@ -6342,6 +6399,60 @@ end
|
|
|
6342
6399
|
- **Accept**: application/json
|
|
6343
6400
|
|
|
6344
6401
|
|
|
6402
|
+
## insert_sfvb_comms_segment
|
|
6403
|
+
|
|
6404
|
+
> <SfvbCommsSegmentResponse> insert_sfvb_comms_segment(storefront_oid, segment_write_request)
|
|
6405
|
+
|
|
6406
|
+
Create a segment
|
|
6407
|
+
|
|
6408
|
+
A new segment with the name, rule and folder given. The rule needs at least one group, each with at least one function of a rule type the segment rebuild knows, and any list or segment it names must be on this storefront. The segment starts empty and rebuilds in the background; member_count is out of date until rebuild_required is false.
|
|
6409
|
+
|
|
6410
|
+
|
|
6411
|
+
### Examples
|
|
6412
|
+
|
|
6413
|
+
|
|
6414
|
+
(No example for this operation).
|
|
6415
|
+
|
|
6416
|
+
|
|
6417
|
+
#### Using the insert_sfvb_comms_segment_with_http_info variant
|
|
6418
|
+
|
|
6419
|
+
This returns an Array which contains the response data, status code and headers.
|
|
6420
|
+
|
|
6421
|
+
> <Array(<SfvbCommsSegmentResponse>, Integer, Hash)> insert_sfvb_comms_segment_with_http_info(storefront_oid, segment_write_request)
|
|
6422
|
+
|
|
6423
|
+
```ruby
|
|
6424
|
+
begin
|
|
6425
|
+
# Create a segment
|
|
6426
|
+
data, status_code, headers = api_instance.insert_sfvb_comms_segment_with_http_info(storefront_oid, segment_write_request)
|
|
6427
|
+
p status_code # => 2xx
|
|
6428
|
+
p headers # => { ... }
|
|
6429
|
+
p data # => <SfvbCommsSegmentResponse>
|
|
6430
|
+
rescue UltracartClient::ApiError => e
|
|
6431
|
+
puts "Error when calling SfvbApi->insert_sfvb_comms_segment_with_http_info: #{e}"
|
|
6432
|
+
end
|
|
6433
|
+
```
|
|
6434
|
+
|
|
6435
|
+
### Parameters
|
|
6436
|
+
|
|
6437
|
+
| Name | Type | Description | Notes |
|
|
6438
|
+
| ---- | ---- | ----------- | ----- |
|
|
6439
|
+
| **storefront_oid** | **Integer** | | |
|
|
6440
|
+
| **segment_write_request** | [**SfvbCommsSegmentWriteRequest**](SfvbCommsSegmentWriteRequest.md) | The new segment's name, rule and folder | |
|
|
6441
|
+
|
|
6442
|
+
### Return type
|
|
6443
|
+
|
|
6444
|
+
[**SfvbCommsSegmentResponse**](SfvbCommsSegmentResponse.md)
|
|
6445
|
+
|
|
6446
|
+
### Authorization
|
|
6447
|
+
|
|
6448
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
6449
|
+
|
|
6450
|
+
### HTTP request headers
|
|
6451
|
+
|
|
6452
|
+
- **Content-Type**: application/json
|
|
6453
|
+
- **Accept**: application/json
|
|
6454
|
+
|
|
6455
|
+
|
|
6345
6456
|
## insert_sfvb_comms_sending_domain
|
|
6346
6457
|
|
|
6347
6458
|
> <SfvbCommsSendingDomain> insert_sfvb_comms_sending_domain(sending_domain)
|
|
@@ -10701,6 +10812,63 @@ end
|
|
|
10701
10812
|
- **Accept**: application/json
|
|
10702
10813
|
|
|
10703
10814
|
|
|
10815
|
+
## update_sfvb_comms_segment
|
|
10816
|
+
|
|
10817
|
+
> <SfvbCommsSegmentResponse> update_sfvb_comms_segment(storefront_oid, segment_uuid, if_match, segment_write_request, opts)
|
|
10818
|
+
|
|
10819
|
+
Change a segment's name, rule or folder
|
|
10820
|
+
|
|
10821
|
+
A field left out stays as it is. Send the segment's hash_sha256 as If-Match; the change applies only while the name, rule and folder are still what was read. A changed rule is checked as on a create and starts a rebuild. Changing the rule of a segment a live campaign or flow uses needs sfvb_publish and an approved segment.update approval (Approval-Id); a name or folder change, or a segment nothing live uses, needs neither.
|
|
10822
|
+
|
|
10823
|
+
|
|
10824
|
+
### Examples
|
|
10825
|
+
|
|
10826
|
+
|
|
10827
|
+
(No example for this operation).
|
|
10828
|
+
|
|
10829
|
+
|
|
10830
|
+
#### Using the update_sfvb_comms_segment_with_http_info variant
|
|
10831
|
+
|
|
10832
|
+
This returns an Array which contains the response data, status code and headers.
|
|
10833
|
+
|
|
10834
|
+
> <Array(<SfvbCommsSegmentResponse>, Integer, Hash)> update_sfvb_comms_segment_with_http_info(storefront_oid, segment_uuid, if_match, segment_write_request, opts)
|
|
10835
|
+
|
|
10836
|
+
```ruby
|
|
10837
|
+
begin
|
|
10838
|
+
# Change a segment's name, rule or folder
|
|
10839
|
+
data, status_code, headers = api_instance.update_sfvb_comms_segment_with_http_info(storefront_oid, segment_uuid, if_match, segment_write_request, opts)
|
|
10840
|
+
p status_code # => 2xx
|
|
10841
|
+
p headers # => { ... }
|
|
10842
|
+
p data # => <SfvbCommsSegmentResponse>
|
|
10843
|
+
rescue UltracartClient::ApiError => e
|
|
10844
|
+
puts "Error when calling SfvbApi->update_sfvb_comms_segment_with_http_info: #{e}"
|
|
10845
|
+
end
|
|
10846
|
+
```
|
|
10847
|
+
|
|
10848
|
+
### Parameters
|
|
10849
|
+
|
|
10850
|
+
| Name | Type | Description | Notes |
|
|
10851
|
+
| ---- | ---- | ----------- | ----- |
|
|
10852
|
+
| **storefront_oid** | **Integer** | | |
|
|
10853
|
+
| **segment_uuid** | **String** | | |
|
|
10854
|
+
| **if_match** | **String** | The segment's hash_sha256 from the last read. Required; 428 when absent, 412 when stale. | |
|
|
10855
|
+
| **segment_write_request** | [**SfvbCommsSegmentWriteRequest**](SfvbCommsSegmentWriteRequest.md) | The fields to change | |
|
|
10856
|
+
| **approval_id** | **String** | When the rule changes and a live campaign or flow uses the segment, the approval_id of an approved segment.update request for this change. See POST /sfvb/approvals. | [optional] |
|
|
10857
|
+
|
|
10858
|
+
### Return type
|
|
10859
|
+
|
|
10860
|
+
[**SfvbCommsSegmentResponse**](SfvbCommsSegmentResponse.md)
|
|
10861
|
+
|
|
10862
|
+
### Authorization
|
|
10863
|
+
|
|
10864
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
10865
|
+
|
|
10866
|
+
### HTTP request headers
|
|
10867
|
+
|
|
10868
|
+
- **Content-Type**: application/json
|
|
10869
|
+
- **Accept**: application/json
|
|
10870
|
+
|
|
10871
|
+
|
|
10704
10872
|
## update_sfvb_comms_sending_domain
|
|
10705
10873
|
|
|
10706
10874
|
> <SfvbCommsSendingDomain> update_sfvb_comms_sending_domain(domain, sending_domain)
|
|
@@ -12,6 +12,7 @@
|
|
|
12
12
|
| **params** | [**SfvbApprovalParams**](SfvbApprovalParams.md) | | [optional] |
|
|
13
13
|
| **reason** | **String** | Why the agent wants to do this, in a sentence. Shown to the person as unverified text, capped at 500 characters. | [optional] |
|
|
14
14
|
| **redirect_rows** | [**Array<SfvbRedirectDeleteRow>**](SfvbRedirectDeleteRow.md) | For redirect.delete_batch, exactly the rows the batch delete will send, up to 5,000, each with its hash_sha256. UltraCart keeps only their hash. | [optional] |
|
|
15
|
+
| **segment_update** | [**SfvbCommsSegmentWriteRequest**](SfvbCommsSegmentWriteRequest.md) | | [optional] |
|
|
15
16
|
|
|
16
17
|
## Example
|
|
17
18
|
|
|
@@ -26,7 +27,8 @@ instance = UltracartClient::SfvbApprovalCreateRequest.new(
|
|
|
26
27
|
item_pricing: null,
|
|
27
28
|
params: null,
|
|
28
29
|
reason: null,
|
|
29
|
-
redirect_rows: null
|
|
30
|
+
redirect_rows: null,
|
|
31
|
+
segment_update: null
|
|
30
32
|
)
|
|
31
33
|
```
|
|
32
34
|
|
data/docs/SfvbApprovalParams.md
CHANGED
|
@@ -16,6 +16,7 @@
|
|
|
16
16
|
| **request_sha256** | **String** | For experiment.start of a url experiment, the hash of the checked experiment approved, and for item.pricing the hash of the change. Set by the server. The gated call must send the same. | [optional] |
|
|
17
17
|
| **rows_sha256** | **String** | For redirect.delete_batch and item.attribute_batch, the plan_hash of the exact rows approved. Set by the server. The batch must send rows with this hash. | [optional] |
|
|
18
18
|
| **rule_count** | **Integer** | For redirect.delete_batch, how many rules the batch would delete when it was requested. Set by the server. | [optional] |
|
|
19
|
+
| **segment_uuid** | **String** | The segment whose rule changes, for segment.update. | [optional] |
|
|
19
20
|
| **sequence_uuid** | **String** | The communication sequence, for sequence_step.delete. | [optional] |
|
|
20
21
|
| **slot** | **String** | For experiment.start of a page experiment, the page body name. Defaults to body. | [optional] |
|
|
21
22
|
| **step_uuid** | **String** | The step to remove, for sequence_step.delete. | [optional] |
|
|
@@ -43,6 +44,7 @@ instance = UltracartClient::SfvbApprovalParams.new(
|
|
|
43
44
|
request_sha256: null,
|
|
44
45
|
rows_sha256: null,
|
|
45
46
|
rule_count: null,
|
|
47
|
+
segment_uuid: null,
|
|
46
48
|
sequence_uuid: null,
|
|
47
49
|
slot: null,
|
|
48
50
|
step_uuid: null,
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
# UltracartClient::SfvbCommsSegmentDetail
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **created_dts** | **String** | When it was created (ISO 8601, UTC). | [optional] |
|
|
8
|
+
| **filter_profile_equation_json** | **String** | The rule, as JSON text in the admin editor's shape. Every entry in groups must hold, and inside a group one function is enough. | [optional] |
|
|
9
|
+
| **folder_uuid** | **String** | The list and segment folder it is filed in, or absent. | [optional] |
|
|
10
|
+
| **hash_sha256** | **String** | Send as If-Match on an update. Covers the name, the rule and the folder. | [optional] |
|
|
11
|
+
| **member_count** | **Integer** | How many customers it held at its last rebuild. Out of date while rebuild_required is true. | [optional] |
|
|
12
|
+
| **name** | **String** | The segment name. | [optional] |
|
|
13
|
+
| **rebuild_nightly** | **Boolean** | True when the rule has a date range, so the segment is also rebuilt every night. | [optional] |
|
|
14
|
+
| **rebuild_percentage** | **Float** | How far the current rebuild has got, when one is running. | [optional] |
|
|
15
|
+
| **rebuild_required** | **Boolean** | True when the rule changed and the segment has not finished rebuilding. | [optional] |
|
|
16
|
+
| **segment_uuid** | **String** | The segment uuid. | [optional] |
|
|
17
|
+
| **used_by** | [**Array<SfvbCommsSegmentUsedBy>**](SfvbCommsSegmentUsedBy.md) | The campaigns that send to it and the flows it starts. | [optional] |
|
|
18
|
+
|
|
19
|
+
## Example
|
|
20
|
+
|
|
21
|
+
```ruby
|
|
22
|
+
require 'ultracart_api'
|
|
23
|
+
|
|
24
|
+
instance = UltracartClient::SfvbCommsSegmentDetail.new(
|
|
25
|
+
created_dts: null,
|
|
26
|
+
filter_profile_equation_json: null,
|
|
27
|
+
folder_uuid: null,
|
|
28
|
+
hash_sha256: null,
|
|
29
|
+
member_count: null,
|
|
30
|
+
name: null,
|
|
31
|
+
rebuild_nightly: null,
|
|
32
|
+
rebuild_percentage: null,
|
|
33
|
+
rebuild_required: null,
|
|
34
|
+
segment_uuid: null,
|
|
35
|
+
used_by: null
|
|
36
|
+
)
|
|
37
|
+
```
|
|
38
|
+
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
# UltracartClient::SfvbCommsSegmentResponse
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **notes** | **Array<String>** | What happens next, such as the rebuild a changed rule starts. | [optional] |
|
|
8
|
+
| **segment** | [**SfvbCommsSegmentDetail**](SfvbCommsSegmentDetail.md) | | [optional] |
|
|
9
|
+
|
|
10
|
+
## Example
|
|
11
|
+
|
|
12
|
+
```ruby
|
|
13
|
+
require 'ultracart_api'
|
|
14
|
+
|
|
15
|
+
instance = UltracartClient::SfvbCommsSegmentResponse.new(
|
|
16
|
+
notes: null,
|
|
17
|
+
segment: null
|
|
18
|
+
)
|
|
19
|
+
```
|
|
20
|
+
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
# UltracartClient::SfvbCommsSegmentUsedBy
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **live** | **Boolean** | True when the campaign or flow reaches customers now, so a change to the rule changes who gets its mail. | [optional] |
|
|
8
|
+
| **name** | **String** | The campaign or flow name. | [optional] |
|
|
9
|
+
| **type** | **String** | campaign or flow. | [optional] |
|
|
10
|
+
| **uuid** | **String** | The campaign or flow uuid. | [optional] |
|
|
11
|
+
|
|
12
|
+
## Example
|
|
13
|
+
|
|
14
|
+
```ruby
|
|
15
|
+
require 'ultracart_api'
|
|
16
|
+
|
|
17
|
+
instance = UltracartClient::SfvbCommsSegmentUsedBy.new(
|
|
18
|
+
live: null,
|
|
19
|
+
name: null,
|
|
20
|
+
type: null,
|
|
21
|
+
uuid: null
|
|
22
|
+
)
|
|
23
|
+
```
|
|
24
|
+
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
# UltracartClient::SfvbCommsSegmentWriteRequest
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **filter_profile_equation_json** | **String** | The rule, as JSON text in the admin editor's shape. Required on a create. At least one group, each with at least one function, each of a rule type the segment rebuild knows. | [optional] |
|
|
8
|
+
| **folder_uuid** | **String** | A list and segment folder on this storefront. An empty string takes the segment out of its folder. | [optional] |
|
|
9
|
+
| **name** | **String** | The segment name. Required on a create. | [optional] |
|
|
10
|
+
|
|
11
|
+
## Example
|
|
12
|
+
|
|
13
|
+
```ruby
|
|
14
|
+
require 'ultracart_api'
|
|
15
|
+
|
|
16
|
+
instance = UltracartClient::SfvbCommsSegmentWriteRequest.new(
|
|
17
|
+
filter_profile_equation_json: null,
|
|
18
|
+
folder_uuid: null,
|
|
19
|
+
name: null
|
|
20
|
+
)
|
|
21
|
+
```
|
|
22
|
+
|