ultracart_api 4.1.159 → 4.1.161
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 +50 -2
- data/docs/SfvbApi.md +1123 -10
- data/docs/SfvbBlogPost.md +30 -0
- data/docs/SfvbBlogPostsResponse.md +24 -0
- data/docs/SfvbExperiment.md +36 -0
- data/docs/SfvbExperimentEndRequest.md +18 -0
- data/docs/SfvbExperimentObjective.md +24 -0
- data/docs/SfvbExperimentObjectivesResponse.md +18 -0
- data/docs/SfvbExperimentStartRequest.md +40 -0
- data/docs/SfvbExperimentStartVariation.md +22 -0
- data/docs/SfvbExperimentVariationUpdateRequest.md +18 -0
- data/docs/SfvbExperimentsResponse.md +18 -0
- data/docs/SfvbPageBlogPostSelector.md +26 -0
- data/docs/SfvbPageBlogPostsRequest.md +18 -0
- data/docs/SfvbPageBlogPostsResponse.md +22 -0
- data/docs/SfvbPageCreateRequest.md +34 -0
- data/docs/SfvbPageDuplicateRequest.md +22 -0
- data/docs/SfvbPageItem.md +26 -0
- data/docs/SfvbPageItemSelector.md +42 -0
- data/docs/SfvbPageItemsAddRequest.md +18 -0
- data/docs/SfvbPageItemsRemoveRequest.md +18 -0
- data/docs/SfvbPageItemsResponse.md +24 -0
- data/docs/SfvbPageListResponse.md +18 -0
- data/docs/SfvbPageResponse.md +13 -1
- data/docs/SfvbPageSelectors.md +26 -0
- data/docs/SfvbPageSettingsRequest.md +44 -0
- data/docs/SfvbPageSummary.md +44 -0
- data/docs/SfvbTemplate.md +36 -0
- data/docs/SfvbTemplatesResponse.md +20 -0
- data/lib/ultracart_api/api/sfvb_api.rb +1722 -211
- data/lib/ultracart_api/models/sfvb_blog_post.rb +280 -0
- data/lib/ultracart_api/models/sfvb_blog_posts_response.rb +252 -0
- data/lib/ultracart_api/models/sfvb_experiment.rb +309 -0
- data/lib/ultracart_api/models/sfvb_experiment_end_request.rb +220 -0
- data/lib/ultracart_api/models/sfvb_experiment_objective.rb +250 -0
- data/lib/ultracart_api/models/sfvb_experiment_objectives_response.rb +222 -0
- data/lib/ultracart_api/models/sfvb_experiment_start_request.rb +332 -0
- data/lib/ultracart_api/models/sfvb_experiment_start_variation.rb +240 -0
- data/lib/ultracart_api/models/sfvb_experiment_variation_update_request.rb +220 -0
- data/lib/ultracart_api/models/sfvb_experiments_response.rb +222 -0
- data/lib/ultracart_api/models/sfvb_page_blog_post_selector.rb +260 -0
- data/lib/ultracart_api/models/sfvb_page_blog_posts_request.rb +222 -0
- data/lib/ultracart_api/models/sfvb_page_blog_posts_response.rb +242 -0
- data/lib/ultracart_api/models/sfvb_page_create_request.rb +300 -0
- data/lib/ultracart_api/models/sfvb_page_duplicate_request.rb +240 -0
- data/lib/ultracart_api/models/sfvb_page_item.rb +260 -0
- data/lib/ultracart_api/models/sfvb_page_item_selector.rb +340 -0
- data/lib/ultracart_api/models/sfvb_page_items_add_request.rb +222 -0
- data/lib/ultracart_api/models/sfvb_page_items_remove_request.rb +222 -0
- data/lib/ultracart_api/models/sfvb_page_items_response.rb +252 -0
- data/lib/ultracart_api/models/sfvb_page_list_response.rb +222 -0
- data/lib/ultracart_api/models/sfvb_page_response.rb +64 -4
- data/lib/ultracart_api/models/sfvb_page_selectors.rb +264 -0
- data/lib/ultracart_api/models/sfvb_page_settings_request.rb +350 -0
- data/lib/ultracart_api/models/sfvb_page_summary.rb +350 -0
- data/lib/ultracart_api/models/sfvb_template.rb +310 -0
- data/lib/ultracart_api/models/sfvb_templates_response.rb +232 -0
- data/lib/ultracart_api/version.rb +1 -1
- data/lib/ultracart_api.rb +26 -0
- metadata +53 -1
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
# UltracartClient::SfvbBlogPost
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **author** | **String** | The post author. | [optional] |
|
|
8
|
+
| **blog_post_oid** | **Integer** | The blog post's oid. This is what a page's blog post assignment names. | [optional] |
|
|
9
|
+
| **publication_dts** | **String** | When the post was published (ISO 8601, UTC), or when it was created if it has no publication time. | [optional] |
|
|
10
|
+
| **title** | **String** | The post title. | [optional] |
|
|
11
|
+
| **unassigned** | **Boolean** | True when no page shows this post yet. Only reported by the blog post list. | [optional] |
|
|
12
|
+
| **url_part** | **String** | The post's name in its URL. | [optional] |
|
|
13
|
+
| **visibility** | **String** | P public, L logged in customers only, D draft. | [optional] |
|
|
14
|
+
|
|
15
|
+
## Example
|
|
16
|
+
|
|
17
|
+
```ruby
|
|
18
|
+
require 'ultracart_api'
|
|
19
|
+
|
|
20
|
+
instance = UltracartClient::SfvbBlogPost.new(
|
|
21
|
+
author: null,
|
|
22
|
+
blog_post_oid: null,
|
|
23
|
+
publication_dts: null,
|
|
24
|
+
title: null,
|
|
25
|
+
unassigned: null,
|
|
26
|
+
url_part: null,
|
|
27
|
+
visibility: null
|
|
28
|
+
)
|
|
29
|
+
```
|
|
30
|
+
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
# UltracartClient::SfvbBlogPostsResponse
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **blog_posts** | [**Array<SfvbBlogPost>**](SfvbBlogPost.md) | One page of the storefront's blog posts, newest first. | [optional] |
|
|
8
|
+
| **page** | **Integer** | The page returned, starting at 1. | [optional] |
|
|
9
|
+
| **page_size** | **Integer** | Posts per page. | [optional] |
|
|
10
|
+
| **total** | **Integer** | How many posts match, across all pages. | [optional] |
|
|
11
|
+
|
|
12
|
+
## Example
|
|
13
|
+
|
|
14
|
+
```ruby
|
|
15
|
+
require 'ultracart_api'
|
|
16
|
+
|
|
17
|
+
instance = UltracartClient::SfvbBlogPostsResponse.new(
|
|
18
|
+
blog_posts: null,
|
|
19
|
+
page: null,
|
|
20
|
+
page_size: null,
|
|
21
|
+
total: null
|
|
22
|
+
)
|
|
23
|
+
```
|
|
24
|
+
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
# UltracartClient::SfvbExperiment
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **auto_ends_at** | **String** | When the experiment engine will end this experiment by itself and declare the variation with the best raw objective per session the winner, without a significance check (ISO 8601, UTC). Set for running url and theme experiments, and for any running experiment whose traffic shifts toward the leader (equal_weighting false). Null when only ending it deliberately will stop it. | [optional] |
|
|
8
|
+
| **days_elapsed** | **Integer** | Whole days the experiment has run, up to now or to when it ended. | [optional] |
|
|
9
|
+
| **experiment** | [**Experiment**](Experiment.md) | | [optional] |
|
|
10
|
+
| **notice** | **String** | Something the caller should know about what this call did or could not do. | [optional] |
|
|
11
|
+
| **p_value_test** | **String** | The test behind p_value. one_way_anova across all variations, so a low p_value says some variation differs, not which one is best. | [optional] |
|
|
12
|
+
| **page_body_path** | **String** | Set when this call rewrote a page body - starting a page experiment writes its id there, and ending one without a winner clears it. Pull the file again before editing it. | [optional] |
|
|
13
|
+
| **page_body_sha256** | **String** | The rewritten page body's new hash, for If-Match on the next write. | [optional] |
|
|
14
|
+
| **router_url** | **String** | For a url experiment, the address visitors must enter through to be split between the pages. Ads and links must point here, not at the pages. | [optional] |
|
|
15
|
+
| **sessions_needed_computed_dts** | **String** | When p95_sessions_needed was last estimated (ISO 8601, UTC). It is estimated only once the experiment has 1000 sessions, and at most hourly. Null before then. | [optional] |
|
|
16
|
+
| **type** | **String** | page for an experiment element inside a page, url for a split between pages, theme for a split between themes, openai for a generated headline experiment. | [optional] |
|
|
17
|
+
|
|
18
|
+
## Example
|
|
19
|
+
|
|
20
|
+
```ruby
|
|
21
|
+
require 'ultracart_api'
|
|
22
|
+
|
|
23
|
+
instance = UltracartClient::SfvbExperiment.new(
|
|
24
|
+
auto_ends_at: null,
|
|
25
|
+
days_elapsed: null,
|
|
26
|
+
experiment: null,
|
|
27
|
+
notice: null,
|
|
28
|
+
p_value_test: null,
|
|
29
|
+
page_body_path: null,
|
|
30
|
+
page_body_sha256: null,
|
|
31
|
+
router_url: null,
|
|
32
|
+
sessions_needed_computed_dts: null,
|
|
33
|
+
type: null
|
|
34
|
+
)
|
|
35
|
+
```
|
|
36
|
+
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# UltracartClient::SfvbExperimentEndRequest
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **winner_variation_number** | **Integer** | The variation to declare the winner. Leave it out to end without one - a page experiment then shows variation 0, and a url experiment sends everyone to variation 0. | [optional] |
|
|
8
|
+
|
|
9
|
+
## Example
|
|
10
|
+
|
|
11
|
+
```ruby
|
|
12
|
+
require 'ultracart_api'
|
|
13
|
+
|
|
14
|
+
instance = UltracartClient::SfvbExperimentEndRequest.new(
|
|
15
|
+
winner_variation_number: null
|
|
16
|
+
)
|
|
17
|
+
```
|
|
18
|
+
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
# UltracartClient::SfvbExperimentObjective
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **objective** | **String** | The value an experiment's objective holds. | [optional] |
|
|
8
|
+
| **per_session_value** | **String** | What is measured in each session and compared between variations. | [optional] |
|
|
9
|
+
| **requires_parameter** | **Boolean** | True when the experiment also needs objective_parameter, the event name. | [optional] |
|
|
10
|
+
| **usual_optimization_type** | **String** | MAXIMUM or MINIMUM, whichever is the usual goal for this objective. | [optional] |
|
|
11
|
+
|
|
12
|
+
## Example
|
|
13
|
+
|
|
14
|
+
```ruby
|
|
15
|
+
require 'ultracart_api'
|
|
16
|
+
|
|
17
|
+
instance = UltracartClient::SfvbExperimentObjective.new(
|
|
18
|
+
objective: null,
|
|
19
|
+
per_session_value: null,
|
|
20
|
+
requires_parameter: null,
|
|
21
|
+
usual_optimization_type: null
|
|
22
|
+
)
|
|
23
|
+
```
|
|
24
|
+
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# UltracartClient::SfvbExperimentObjectivesResponse
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **objectives** | [**Array<SfvbExperimentObjective>**](SfvbExperimentObjective.md) | Every objective an experiment can optimize. | [optional] |
|
|
8
|
+
|
|
9
|
+
## Example
|
|
10
|
+
|
|
11
|
+
```ruby
|
|
12
|
+
require 'ultracart_api'
|
|
13
|
+
|
|
14
|
+
instance = UltracartClient::SfvbExperimentObjectivesResponse.new(
|
|
15
|
+
objectives: null
|
|
16
|
+
)
|
|
17
|
+
```
|
|
18
|
+
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
# UltracartClient::SfvbExperimentStartRequest
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **duration_days** | **Integer** | url - 3 to 90. A url experiment always ends by itself after this many days. | [optional] |
|
|
8
|
+
| **equal_weighting** | **Boolean** | url - true keeps the split fixed. false shifts traffic toward the leader as the experiment runs. Defaults to true. | [optional] |
|
|
9
|
+
| **name** | **String** | url - experiment name. | [optional] |
|
|
10
|
+
| **notes** | **String** | url - notes, such as the hypothesis being tested. | [optional] |
|
|
11
|
+
| **objective** | **String** | url - one of the objectives from the objective list. | [optional] |
|
|
12
|
+
| **objective_parameter** | **String** | url - the event name, when the objective is Events. | [optional] |
|
|
13
|
+
| **optimization_type** | **String** | url - MAXIMUM or MINIMUM. | [optional] |
|
|
14
|
+
| **path** | **String** | page - path of the page whose body holds the experiment element. | [optional] |
|
|
15
|
+
| **slot** | **String** | page - the body file's name without .cjson. Defaults to body. | [optional] |
|
|
16
|
+
| **type** | **String** | page or url. | [optional] |
|
|
17
|
+
| **variations** | [**Array<SfvbExperimentStartVariation>**](SfvbExperimentStartVariation.md) | url - 2 to 5 pages. The first is the control. | [optional] |
|
|
18
|
+
| **widget_id** | **String** | page - id of the experiment element in that body. | [optional] |
|
|
19
|
+
|
|
20
|
+
## Example
|
|
21
|
+
|
|
22
|
+
```ruby
|
|
23
|
+
require 'ultracart_api'
|
|
24
|
+
|
|
25
|
+
instance = UltracartClient::SfvbExperimentStartRequest.new(
|
|
26
|
+
duration_days: null,
|
|
27
|
+
equal_weighting: null,
|
|
28
|
+
name: null,
|
|
29
|
+
notes: null,
|
|
30
|
+
objective: null,
|
|
31
|
+
objective_parameter: null,
|
|
32
|
+
optimization_type: null,
|
|
33
|
+
path: null,
|
|
34
|
+
slot: null,
|
|
35
|
+
type: null,
|
|
36
|
+
variations: null,
|
|
37
|
+
widget_id: null
|
|
38
|
+
)
|
|
39
|
+
```
|
|
40
|
+
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
# UltracartClient::SfvbExperimentStartVariation
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **name** | **String** | Variation name, shown in the statistics. | [optional] |
|
|
8
|
+
| **path** | **String** | Path of an existing page on this storefront, for example /lp/spring-sale-b/. | [optional] |
|
|
9
|
+
| **traffic_percentage** | **Integer** | Starting share of traffic, 1 to 100. Set it on every variation, adding up to 100, or on none for an even split. | [optional] |
|
|
10
|
+
|
|
11
|
+
## Example
|
|
12
|
+
|
|
13
|
+
```ruby
|
|
14
|
+
require 'ultracart_api'
|
|
15
|
+
|
|
16
|
+
instance = UltracartClient::SfvbExperimentStartVariation.new(
|
|
17
|
+
name: null,
|
|
18
|
+
path: null,
|
|
19
|
+
traffic_percentage: null
|
|
20
|
+
)
|
|
21
|
+
```
|
|
22
|
+
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# UltracartClient::SfvbExperimentVariationUpdateRequest
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **paused** | **Boolean** | true stops sending new visitors to the variation, false resumes it. Visitors already assigned keep seeing it. Variation 0 cannot be paused. | [optional] |
|
|
8
|
+
|
|
9
|
+
## Example
|
|
10
|
+
|
|
11
|
+
```ruby
|
|
12
|
+
require 'ultracart_api'
|
|
13
|
+
|
|
14
|
+
instance = UltracartClient::SfvbExperimentVariationUpdateRequest.new(
|
|
15
|
+
paused: null
|
|
16
|
+
)
|
|
17
|
+
```
|
|
18
|
+
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# UltracartClient::SfvbExperimentsResponse
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **experiments** | [**Array<SfvbExperiment>**](SfvbExperiment.md) | Experiments, running first, then by name. Deleted experiments are left out. Daily statistics are only on the single experiment read. | [optional] |
|
|
8
|
+
|
|
9
|
+
## Example
|
|
10
|
+
|
|
11
|
+
```ruby
|
|
12
|
+
require 'ultracart_api'
|
|
13
|
+
|
|
14
|
+
instance = UltracartClient::SfvbExperimentsResponse.new(
|
|
15
|
+
experiments: null
|
|
16
|
+
)
|
|
17
|
+
```
|
|
18
|
+
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# UltracartClient::SfvbPageBlogPostSelector
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **attribute_name** | **String** | attribute - the blog post attribute name. Required with attribute_value. | [optional] |
|
|
8
|
+
| **attribute_value** | **String** | attribute - the value to match. | [optional] |
|
|
9
|
+
| **author_name** | **String** | author name - required. | [optional] |
|
|
10
|
+
| **tag** | **String** | tag - required. | [optional] |
|
|
11
|
+
| **type** | **String** | One of all, author name, attribute, tag. | [optional] |
|
|
12
|
+
|
|
13
|
+
## Example
|
|
14
|
+
|
|
15
|
+
```ruby
|
|
16
|
+
require 'ultracart_api'
|
|
17
|
+
|
|
18
|
+
instance = UltracartClient::SfvbPageBlogPostSelector.new(
|
|
19
|
+
attribute_name: null,
|
|
20
|
+
attribute_value: null,
|
|
21
|
+
author_name: null,
|
|
22
|
+
tag: null,
|
|
23
|
+
type: null
|
|
24
|
+
)
|
|
25
|
+
```
|
|
26
|
+
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# UltracartClient::SfvbPageBlogPostsRequest
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **blog_post_oids** | **Array<Integer>** | Blog post oids from the blog post list, at most 500. | [optional] |
|
|
8
|
+
|
|
9
|
+
## Example
|
|
10
|
+
|
|
11
|
+
```ruby
|
|
12
|
+
require 'ultracart_api'
|
|
13
|
+
|
|
14
|
+
instance = UltracartClient::SfvbPageBlogPostsRequest.new(
|
|
15
|
+
blog_post_oids: null
|
|
16
|
+
)
|
|
17
|
+
```
|
|
18
|
+
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
# UltracartClient::SfvbPageBlogPostsResponse
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **blog_posts** | [**Array<SfvbBlogPost>**](SfvbBlogPost.md) | The blog posts assigned to the page, newest first. | [optional] |
|
|
8
|
+
| **path** | **String** | The page path. | [optional] |
|
|
9
|
+
| **uses_selectors** | **Boolean** | True when selectors choose this page's blog posts. They are then recalculated from the selectors, and adding or removing posts by hand is refused. | [optional] |
|
|
10
|
+
|
|
11
|
+
## Example
|
|
12
|
+
|
|
13
|
+
```ruby
|
|
14
|
+
require 'ultracart_api'
|
|
15
|
+
|
|
16
|
+
instance = UltracartClient::SfvbPageBlogPostsResponse.new(
|
|
17
|
+
blog_posts: null,
|
|
18
|
+
path: null,
|
|
19
|
+
uses_selectors: null
|
|
20
|
+
)
|
|
21
|
+
```
|
|
22
|
+
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
# UltracartClient::SfvbPageCreateRequest
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **description** | **String** | The page description, for templates that show one. | [optional] |
|
|
8
|
+
| **exclude_from_sitemap** | **Boolean** | Leave the page out of the sitemap and mark it noindex. Usual for ad landing pages. | [optional] |
|
|
9
|
+
| **group_template** | **String** | Template that renders the page, a name from the template list. When omitted the page inherits its parent's templates, or catalog_group.vm directly under the root. | [optional] |
|
|
10
|
+
| **item_template** | **String** | Template that renders the item pages under this page. Inherited or defaulted like group_template. | [optional] |
|
|
11
|
+
| **page_type** | **String** | S for a static page, D for a dynamic one. Defaults to D, as in the admin. | [optional] |
|
|
12
|
+
| **path** | **String** | Path of the new page, for example /lp/spring-sale/. The parent page must already exist, and the last part may only contain letters, digits, hyphens and underscores. | [optional] |
|
|
13
|
+
| **title** | **String** | The page title. | [optional] |
|
|
14
|
+
| **visible** | **Boolean** | False creates the page hidden, so it answers 404 to shoppers until it is shown. | [optional] |
|
|
15
|
+
| **visible_dts** | **String** | Keep the page hidden until this time (ISO 8601). | [optional] |
|
|
16
|
+
|
|
17
|
+
## Example
|
|
18
|
+
|
|
19
|
+
```ruby
|
|
20
|
+
require 'ultracart_api'
|
|
21
|
+
|
|
22
|
+
instance = UltracartClient::SfvbPageCreateRequest.new(
|
|
23
|
+
description: null,
|
|
24
|
+
exclude_from_sitemap: null,
|
|
25
|
+
group_template: null,
|
|
26
|
+
item_template: null,
|
|
27
|
+
page_type: null,
|
|
28
|
+
path: null,
|
|
29
|
+
title: null,
|
|
30
|
+
visible: null,
|
|
31
|
+
visible_dts: null
|
|
32
|
+
)
|
|
33
|
+
```
|
|
34
|
+
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
# UltracartClient::SfvbPageDuplicateRequest
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **path** | **String** | Path of the copy, for example /lp/spring-sale-b/. The same rules as creating a page - the parent must exist, the path must be new, and the last part may only contain letters, digits, hyphens and underscores. | [optional] |
|
|
8
|
+
| **source_path** | **String** | Path of the page to copy. Not the root, and not a page with pages under it. | [optional] |
|
|
9
|
+
| **title** | **String** | Title of the copy. Defaults to the source page's title. | [optional] |
|
|
10
|
+
|
|
11
|
+
## Example
|
|
12
|
+
|
|
13
|
+
```ruby
|
|
14
|
+
require 'ultracart_api'
|
|
15
|
+
|
|
16
|
+
instance = UltracartClient::SfvbPageDuplicateRequest.new(
|
|
17
|
+
path: null,
|
|
18
|
+
source_path: null,
|
|
19
|
+
title: null
|
|
20
|
+
)
|
|
21
|
+
```
|
|
22
|
+
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# UltracartClient::SfvbPageItem
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **default_assignment** | **Boolean** | True when this page is the item's canonical home. Read only - set in the store admin. | [optional] |
|
|
8
|
+
| **item_id** | **String** | The item id, as the merchant knows it. | [optional] |
|
|
9
|
+
| **merchant_item_oid** | **Integer** | The item's internal oid. Read only. | [optional] |
|
|
10
|
+
| **sort_order** | **Integer** | Position on the page. Used only when the page sorts its items by a custom order (sort_order_child_items C). | [optional] |
|
|
11
|
+
| **url_part** | **String** | The item page's name under this page, so the item is shown at the page path plus url_part plus .html. Letters, digits, hyphens and underscores. When empty the item id is used. | [optional] |
|
|
12
|
+
|
|
13
|
+
## Example
|
|
14
|
+
|
|
15
|
+
```ruby
|
|
16
|
+
require 'ultracart_api'
|
|
17
|
+
|
|
18
|
+
instance = UltracartClient::SfvbPageItem.new(
|
|
19
|
+
default_assignment: null,
|
|
20
|
+
item_id: null,
|
|
21
|
+
merchant_item_oid: null,
|
|
22
|
+
sort_order: null,
|
|
23
|
+
url_part: null
|
|
24
|
+
)
|
|
25
|
+
```
|
|
26
|
+
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
# UltracartClient::SfvbPageItemSelector
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **attribute_name** | **String** | attribute - the item attribute name. Required with attribute_value. | [optional] |
|
|
8
|
+
| **attribute_value** | **String** | attribute - the value to match. | [optional] |
|
|
9
|
+
| **item_folder_oid** | **Integer** | item folder and item folder tree - the item folder, which must exist. | [optional] |
|
|
10
|
+
| **manufacturer_name** | **String** | manufacturer name - required. | [optional] |
|
|
11
|
+
| **retail_cost_high** | **Float** | retail cost - the highest price. | [optional] |
|
|
12
|
+
| **retail_cost_low** | **Float** | retail cost - the lowest price. At least one of low and high is required. | [optional] |
|
|
13
|
+
| **sale_item** | **Boolean** | sale item - match items on sale. | [optional] |
|
|
14
|
+
| **tag** | **String** | tag - the item tag to match. Required. | [optional] |
|
|
15
|
+
| **top_seller_count** | **Integer** | top seller - how many items, 1 to 250. Required with top_seller_days. | [optional] |
|
|
16
|
+
| **top_seller_days** | **Integer** | top seller - over how many days, 1 to 180. | [optional] |
|
|
17
|
+
| **type** | **String** | One of retail cost, attribute, variation, not variation, manufacturer name, exploded diagram, sale item, item folder, item folder tree, top seller, new, pre-order, tag. | [optional] |
|
|
18
|
+
| **variation_name** | **String** | variation - the variation name. Required with variation_value. | [optional] |
|
|
19
|
+
| **variation_value** | **String** | variation - the variation value to match. | [optional] |
|
|
20
|
+
|
|
21
|
+
## Example
|
|
22
|
+
|
|
23
|
+
```ruby
|
|
24
|
+
require 'ultracart_api'
|
|
25
|
+
|
|
26
|
+
instance = UltracartClient::SfvbPageItemSelector.new(
|
|
27
|
+
attribute_name: null,
|
|
28
|
+
attribute_value: null,
|
|
29
|
+
item_folder_oid: null,
|
|
30
|
+
manufacturer_name: null,
|
|
31
|
+
retail_cost_high: null,
|
|
32
|
+
retail_cost_low: null,
|
|
33
|
+
sale_item: null,
|
|
34
|
+
tag: null,
|
|
35
|
+
top_seller_count: null,
|
|
36
|
+
top_seller_days: null,
|
|
37
|
+
type: null,
|
|
38
|
+
variation_name: null,
|
|
39
|
+
variation_value: null
|
|
40
|
+
)
|
|
41
|
+
```
|
|
42
|
+
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# UltracartClient::SfvbPageItemsAddRequest
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **items** | [**Array<SfvbPageItem>**](SfvbPageItem.md) | Items to assign, at most 500. An item already on the page keeps its place unless a sort_order or url_part is given, which replaces the stored one. | [optional] |
|
|
8
|
+
|
|
9
|
+
## Example
|
|
10
|
+
|
|
11
|
+
```ruby
|
|
12
|
+
require 'ultracart_api'
|
|
13
|
+
|
|
14
|
+
instance = UltracartClient::SfvbPageItemsAddRequest.new(
|
|
15
|
+
items: null
|
|
16
|
+
)
|
|
17
|
+
```
|
|
18
|
+
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# UltracartClient::SfvbPageItemsRemoveRequest
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **item_ids** | **Array<String>** | Item ids to take off the page, at most 500. Every one must be on the page. | [optional] |
|
|
8
|
+
|
|
9
|
+
## Example
|
|
10
|
+
|
|
11
|
+
```ruby
|
|
12
|
+
require 'ultracart_api'
|
|
13
|
+
|
|
14
|
+
instance = UltracartClient::SfvbPageItemsRemoveRequest.new(
|
|
15
|
+
item_ids: null
|
|
16
|
+
)
|
|
17
|
+
```
|
|
18
|
+
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
# UltracartClient::SfvbPageItemsResponse
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **items** | [**Array<SfvbPageItem>**](SfvbPageItem.md) | The items assigned to the page. | [optional] |
|
|
8
|
+
| **path** | **String** | The page path. | [optional] |
|
|
9
|
+
| **sort_order_child_items** | **String** | How the page orders its items. C means by each item's sort_order. | [optional] |
|
|
10
|
+
| **uses_selectors** | **Boolean** | True when selectors choose this page's items. The items are then recalculated from the selectors, and adding or removing items by hand is refused. | [optional] |
|
|
11
|
+
|
|
12
|
+
## Example
|
|
13
|
+
|
|
14
|
+
```ruby
|
|
15
|
+
require 'ultracart_api'
|
|
16
|
+
|
|
17
|
+
instance = UltracartClient::SfvbPageItemsResponse.new(
|
|
18
|
+
items: null,
|
|
19
|
+
path: null,
|
|
20
|
+
sort_order_child_items: null,
|
|
21
|
+
uses_selectors: null
|
|
22
|
+
)
|
|
23
|
+
```
|
|
24
|
+
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# UltracartClient::SfvbPageListResponse
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **pages** | [**Array<SfvbPageSummary>**](SfvbPageSummary.md) | Pages sorted by path, the root first. Hidden pages are included. | [optional] |
|
|
8
|
+
|
|
9
|
+
## Example
|
|
10
|
+
|
|
11
|
+
```ruby
|
|
12
|
+
require 'ultracart_api'
|
|
13
|
+
|
|
14
|
+
instance = UltracartClient::SfvbPageListResponse.new(
|
|
15
|
+
pages: null
|
|
16
|
+
)
|
|
17
|
+
```
|
|
18
|
+
|
data/docs/SfvbPageResponse.md
CHANGED
|
@@ -5,8 +5,14 @@
|
|
|
5
5
|
| Name | Type | Description | Notes |
|
|
6
6
|
| ---- | ---- | ----------- | ----- |
|
|
7
7
|
| **attributes** | [**Array<SfvbPageAttribute>**](SfvbPageAttribute.md) | Every attribute this page has, including ones a template declares but nothing has set yet. These are what the pageattribute element renders. Sorted by name. | [optional] |
|
|
8
|
+
| **exclude_from_sitemap** | **Boolean** | True when the page is left out of the sitemap and marked noindex. | [optional] |
|
|
9
|
+
| **group_template** | **String** | Template file that renders the page itself, a bare .vm name found anywhere in the active theme. | [optional] |
|
|
10
|
+
| **item_template** | **String** | Template file that renders the item pages under this page. | [optional] |
|
|
8
11
|
| **multimedia** | [**Array<SfvbPageMultimedia>**](SfvbPageMultimedia.md) | The page's images, including codes a template declares but nothing has attached yet. These are what the pageimage element renders - the default image when pageImageCode is empty, otherwise the image with that code. The default image comes first. | [optional] |
|
|
9
12
|
| **path** | **String** | The page path, normalized to begin and end with a slash. | [optional] |
|
|
13
|
+
| **title** | **String** | The page title. | [optional] |
|
|
14
|
+
| **visible** | **Boolean** | False when the page is hidden. A hidden page answers 404 to shoppers. | [optional] |
|
|
15
|
+
| **visible_dts** | **String** | When set, the page stays hidden until this time (ISO 8601, UTC). | [optional] |
|
|
10
16
|
|
|
11
17
|
## Example
|
|
12
18
|
|
|
@@ -15,8 +21,14 @@ require 'ultracart_api'
|
|
|
15
21
|
|
|
16
22
|
instance = UltracartClient::SfvbPageResponse.new(
|
|
17
23
|
attributes: null,
|
|
24
|
+
exclude_from_sitemap: null,
|
|
25
|
+
group_template: null,
|
|
26
|
+
item_template: null,
|
|
18
27
|
multimedia: null,
|
|
19
|
-
path: null
|
|
28
|
+
path: null,
|
|
29
|
+
title: null,
|
|
30
|
+
visible: null,
|
|
31
|
+
visible_dts: null
|
|
20
32
|
)
|
|
21
33
|
```
|
|
22
34
|
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# UltracartClient::SfvbPageSelectors
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **blog_post_selectors** | [**Array<SfvbPageBlogPostSelector>**](SfvbPageBlogPostSelector.md) | The conditions that choose the page's blog posts. | [optional] |
|
|
8
|
+
| **item_selectors** | [**Array<SfvbPageItemSelector>**](SfvbPageItemSelector.md) | The conditions that choose the page's items. While there are any, the page's items are recalculated from them and cannot be assigned by hand. | [optional] |
|
|
9
|
+
| **match_all_blog_post_selectors** | **Boolean** | True when a blog post must meet every blog post selector, false when any one is enough. | [optional] |
|
|
10
|
+
| **match_all_item_selectors** | **Boolean** | True when an item must meet every item selector, false when meeting any one is enough. | [optional] |
|
|
11
|
+
| **path** | **String** | The page path. Read only. | [optional] |
|
|
12
|
+
|
|
13
|
+
## Example
|
|
14
|
+
|
|
15
|
+
```ruby
|
|
16
|
+
require 'ultracart_api'
|
|
17
|
+
|
|
18
|
+
instance = UltracartClient::SfvbPageSelectors.new(
|
|
19
|
+
blog_post_selectors: null,
|
|
20
|
+
item_selectors: null,
|
|
21
|
+
match_all_blog_post_selectors: null,
|
|
22
|
+
match_all_item_selectors: null,
|
|
23
|
+
path: null
|
|
24
|
+
)
|
|
25
|
+
```
|
|
26
|
+
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
# UltracartClient::SfvbPageSettingsRequest
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **blog_post_template** | **String** | Template that renders the blog posts under this page. | [optional] |
|
|
8
|
+
| **description** | **String** | The page description. Null or empty clears it. | [optional] |
|
|
9
|
+
| **exclude_from_sitemap** | **Boolean** | Leave the page out of the sitemap and mark it noindex. | [optional] |
|
|
10
|
+
| **group_template** | **String** | Template that renders the page, a name from the template list. | [optional] |
|
|
11
|
+
| **item_template** | **String** | Template that renders the item pages under this page. | [optional] |
|
|
12
|
+
| **items_per_page** | **Integer** | Items per page on a template that paginates. Null returns to the template's default. | [optional] |
|
|
13
|
+
| **page_type** | **String** | S for a static page, D for a dynamic one. | [optional] |
|
|
14
|
+
| **review_template** | **String** | Template that renders the item review pages under this page. | [optional] |
|
|
15
|
+
| **sort_order** | **Integer** | Position among its siblings when the parent sorts child pages by a custom order. Null clears it. | [optional] |
|
|
16
|
+
| **sort_order_child_groups** | **String** | How the pages under this one are ordered. TA or TD by title, DA or DD by description, C custom. | [optional] |
|
|
17
|
+
| **sort_order_child_items** | **String** | How the page's items are ordered. IA or ID by item id, DA or DD by description, SA or SD by manufacturer SKU, PA or PD by price, RA or RD by review, NA or ND by inventory, C custom. | [optional] |
|
|
18
|
+
| **title** | **String** | The page title. | [optional] |
|
|
19
|
+
| **visible** | **Boolean** | False hides the page, so it answers 404 to shoppers. The root page cannot be hidden. | [optional] |
|
|
20
|
+
| **visible_dts** | **String** | Keep the page hidden until this time (ISO 8601). Null or empty clears it. | [optional] |
|
|
21
|
+
|
|
22
|
+
## Example
|
|
23
|
+
|
|
24
|
+
```ruby
|
|
25
|
+
require 'ultracart_api'
|
|
26
|
+
|
|
27
|
+
instance = UltracartClient::SfvbPageSettingsRequest.new(
|
|
28
|
+
blog_post_template: null,
|
|
29
|
+
description: null,
|
|
30
|
+
exclude_from_sitemap: null,
|
|
31
|
+
group_template: null,
|
|
32
|
+
item_template: null,
|
|
33
|
+
items_per_page: null,
|
|
34
|
+
page_type: null,
|
|
35
|
+
review_template: null,
|
|
36
|
+
sort_order: null,
|
|
37
|
+
sort_order_child_groups: null,
|
|
38
|
+
sort_order_child_items: null,
|
|
39
|
+
title: null,
|
|
40
|
+
visible: null,
|
|
41
|
+
visible_dts: null
|
|
42
|
+
)
|
|
43
|
+
```
|
|
44
|
+
|