@teemill/product-catalog 1.84.0 → 1.86.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.
@@ -5,6 +5,7 @@ All URIs are relative to *https://api.podos.io*
5
5
  |Method | HTTP request | Description|
6
6
  |------------- | ------------- | -------------|
7
7
  |[**exportProductAnalytics**](#exportproductanalytics) | **GET** /v1/catalog/analytics/export | Export product analytics|
8
+ |[**getProductAnalyticsSummary**](#getproductanalyticssummary) | **GET** /v1/catalog/analytics/summary | Get product analytics summary|
8
9
  |[**listProductAnalytics**](#listproductanalytics) | **GET** /v1/catalog/analytics | List product analytics|
9
10
 
10
11
  # **exportProductAnalytics**
@@ -24,9 +25,33 @@ const configuration = new Configuration();
24
25
  const apiInstance = new ProductAnalyticsApi(configuration);
25
26
 
26
27
  let project: string; //What project it is (default to undefined)
28
+ let sortBy: Array<string>; //An array of fields to sort by, prefixed with a \'-\' for descending order or \'+\' for ascending. Default is ascending. (optional) (default to undefined)
29
+ let search: string; //Search query string to filter results. Supports field-specific filters like: \'enabled:true\', \'gfn_product_ids:<id>\', \'tag:\"tag name\"\', \'internal_tag:\"internal tag name\"\', \'includeArchived:false\', \'hasSearchPhrase:false\', \'inDataFeeds:true\', \'aiOptimised:true\', \'productType:<id>\', \'genderGroup:\"male,female,unisex\"\', \'hasBarcode:true\', \'onSale:true\', \'type:product,template,bundle\', \'collection:<id>\'. Multiple filters can be combined with spaces and commas. (optional) (default to 'enabled:true')
30
+ let dateRangeStartDate: string; //Start date for the date range filter (ISO 8601 format) (optional) (default to undefined)
31
+ let dateRangeEndDate: string; //End date for the date range filter (ISO 8601 format) (optional) (default to undefined)
32
+ let minimumRevenue: number; //Filter to only include products with total revenue greater than or equal to this amount (optional) (default to undefined)
33
+ let maximumRevenue: number; //Filter to only include products with total revenue less than or equal to this amount (optional) (default to undefined)
34
+ let minimumSales: number; //Filter to only include products with total sales greater than or equal to this number (optional) (default to undefined)
35
+ let maximumSales: number; //Filter to only include products with total sales less than or equal to this number (optional) (default to undefined)
36
+ let minimumBasketPercent: number; //Filter to only include products where the average basket percentage is greater than or equal to this value (optional) (default to undefined)
37
+ let maximumBasketPercent: number; //Filter to only include products where the average basket percentage is less than or equal to this value (optional) (default to undefined)
38
+ let minimumTraffic: number; //Filter to only include products with total traffic greater than or equal to this number (optional) (default to undefined)
39
+ let maximumTraffic: number; //Filter to only include products with total traffic less than or equal to this number (optional) (default to undefined)
27
40
 
28
41
  const { status, data } = await apiInstance.exportProductAnalytics(
29
- project
42
+ project,
43
+ sortBy,
44
+ search,
45
+ dateRangeStartDate,
46
+ dateRangeEndDate,
47
+ minimumRevenue,
48
+ maximumRevenue,
49
+ minimumSales,
50
+ maximumSales,
51
+ minimumBasketPercent,
52
+ maximumBasketPercent,
53
+ minimumTraffic,
54
+ maximumTraffic
30
55
  );
31
56
  ```
32
57
 
@@ -35,6 +60,18 @@ const { status, data } = await apiInstance.exportProductAnalytics(
35
60
  |Name | Type | Description | Notes|
36
61
  |------------- | ------------- | ------------- | -------------|
37
62
  | **project** | [**string**] | What project it is | defaults to undefined|
63
+ | **sortBy** | **Array&lt;string&gt;** | An array of fields to sort by, prefixed with a \&#39;-\&#39; for descending order or \&#39;+\&#39; for ascending. Default is ascending. | (optional) defaults to undefined|
64
+ | **search** | [**string**] | Search query string to filter results. Supports field-specific filters like: \&#39;enabled:true\&#39;, \&#39;gfn_product_ids:&lt;id&gt;\&#39;, \&#39;tag:\&quot;tag name\&quot;\&#39;, \&#39;internal_tag:\&quot;internal tag name\&quot;\&#39;, \&#39;includeArchived:false\&#39;, \&#39;hasSearchPhrase:false\&#39;, \&#39;inDataFeeds:true\&#39;, \&#39;aiOptimised:true\&#39;, \&#39;productType:&lt;id&gt;\&#39;, \&#39;genderGroup:\&quot;male,female,unisex\&quot;\&#39;, \&#39;hasBarcode:true\&#39;, \&#39;onSale:true\&#39;, \&#39;type:product,template,bundle\&#39;, \&#39;collection:&lt;id&gt;\&#39;. Multiple filters can be combined with spaces and commas. | (optional) defaults to 'enabled:true'|
65
+ | **dateRangeStartDate** | [**string**] | Start date for the date range filter (ISO 8601 format) | (optional) defaults to undefined|
66
+ | **dateRangeEndDate** | [**string**] | End date for the date range filter (ISO 8601 format) | (optional) defaults to undefined|
67
+ | **minimumRevenue** | [**number**] | Filter to only include products with total revenue greater than or equal to this amount | (optional) defaults to undefined|
68
+ | **maximumRevenue** | [**number**] | Filter to only include products with total revenue less than or equal to this amount | (optional) defaults to undefined|
69
+ | **minimumSales** | [**number**] | Filter to only include products with total sales greater than or equal to this number | (optional) defaults to undefined|
70
+ | **maximumSales** | [**number**] | Filter to only include products with total sales less than or equal to this number | (optional) defaults to undefined|
71
+ | **minimumBasketPercent** | [**number**] | Filter to only include products where the average basket percentage is greater than or equal to this value | (optional) defaults to undefined|
72
+ | **maximumBasketPercent** | [**number**] | Filter to only include products where the average basket percentage is less than or equal to this value | (optional) defaults to undefined|
73
+ | **minimumTraffic** | [**number**] | Filter to only include products with total traffic greater than or equal to this number | (optional) defaults to undefined|
74
+ | **maximumTraffic** | [**number**] | Filter to only include products with total traffic less than or equal to this number | (optional) defaults to undefined|
38
75
 
39
76
 
40
77
  ### Return type
@@ -62,6 +99,60 @@ const { status, data } = await apiInstance.exportProductAnalytics(
62
99
 
63
100
  [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
64
101
 
102
+ # **getProductAnalyticsSummary**
103
+ > AnalyticsSummary getProductAnalyticsSummary()
104
+
105
+ Get the AI-generated summary of the product analytics for the given project.
106
+
107
+ ### Example
108
+
109
+ ```typescript
110
+ import {
111
+ ProductAnalyticsApi,
112
+ Configuration
113
+ } from '@teemill/product-catalog';
114
+
115
+ const configuration = new Configuration();
116
+ const apiInstance = new ProductAnalyticsApi(configuration);
117
+
118
+ let project: string; //What project it is (default to undefined)
119
+
120
+ const { status, data } = await apiInstance.getProductAnalyticsSummary(
121
+ project
122
+ );
123
+ ```
124
+
125
+ ### Parameters
126
+
127
+ |Name | Type | Description | Notes|
128
+ |------------- | ------------- | ------------- | -------------|
129
+ | **project** | [**string**] | What project it is | defaults to undefined|
130
+
131
+
132
+ ### Return type
133
+
134
+ **AnalyticsSummary**
135
+
136
+ ### Authorization
137
+
138
+ [session-oauth](../README.md#session-oauth), [api-key](../README.md#api-key)
139
+
140
+ ### HTTP request headers
141
+
142
+ - **Content-Type**: Not defined
143
+ - **Accept**: application/json
144
+
145
+
146
+ ### HTTP response details
147
+ | Status code | Description | Response headers |
148
+ |-------------|-------------|------------------|
149
+ |**200** | Successfully retrieved the AI-generated summary of the product analytics. | - |
150
+ |**401** | Not authorised to access this resource. | - |
151
+ |**403** | Refuse to authorize. | - |
152
+ |**500** | Unknown server error. | - |
153
+
154
+ [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
155
+
65
156
  # **listProductAnalytics**
66
157
  > ProductAnalyticsResponse listProductAnalytics()
67
158
 
@@ -80,16 +171,36 @@ const apiInstance = new ProductAnalyticsApi(configuration);
80
171
 
81
172
  let project: string; //What project it is (default to undefined)
82
173
  let pageToken: number; //Page reference token (optional) (default to 1)
174
+ let pageSize: number; //Max page size. This is the maximum page size that will be returned, but it might be smaller. (optional) (default to 100)
83
175
  let search: string; //Search query string to filter results. Supports field-specific filters like: \'enabled:true\', \'gfn_product_ids:<id>\', \'tag:\"tag name\"\', \'internal_tag:\"internal tag name\"\', \'includeArchived:false\', \'hasSearchPhrase:false\', \'inDataFeeds:true\', \'aiOptimised:true\', \'productType:<id>\', \'genderGroup:\"male,female,unisex\"\', \'hasBarcode:true\', \'onSale:true\', \'type:product,template,bundle\', \'collection:<id>\'. Multiple filters can be combined with spaces and commas. (optional) (default to 'enabled:true')
84
176
  let sortBy: Array<string>; //An array of fields to sort by, prefixed with a \'-\' for descending order or \'+\' for ascending. Default is ascending. (optional) (default to undefined)
85
- let pageSize: number; //Max page size. This is the maximum page size that will be returned, but it might be smaller. (optional) (default to 100)
177
+ let dateRangeStartDate: string; //Start date for the date range filter (ISO 8601 format) (optional) (default to undefined)
178
+ let dateRangeEndDate: string; //End date for the date range filter (ISO 8601 format) (optional) (default to undefined)
179
+ let minimumRevenue: number; //Filter to only include products with total revenue greater than or equal to this amount (optional) (default to undefined)
180
+ let maximumRevenue: number; //Filter to only include products with total revenue less than or equal to this amount (optional) (default to undefined)
181
+ let minimumSales: number; //Filter to only include products with total sales greater than or equal to this number (optional) (default to undefined)
182
+ let maximumSales: number; //Filter to only include products with total sales less than or equal to this number (optional) (default to undefined)
183
+ let minimumBasketPercent: number; //Filter to only include products where the average basket percentage is greater than or equal to this value (optional) (default to undefined)
184
+ let maximumBasketPercent: number; //Filter to only include products where the average basket percentage is less than or equal to this value (optional) (default to undefined)
185
+ let minimumTraffic: number; //Filter to only include products with total traffic greater than or equal to this number (optional) (default to undefined)
186
+ let maximumTraffic: number; //Filter to only include products with total traffic less than or equal to this number (optional) (default to undefined)
86
187
 
87
188
  const { status, data } = await apiInstance.listProductAnalytics(
88
189
  project,
89
190
  pageToken,
191
+ pageSize,
90
192
  search,
91
193
  sortBy,
92
- pageSize
194
+ dateRangeStartDate,
195
+ dateRangeEndDate,
196
+ minimumRevenue,
197
+ maximumRevenue,
198
+ minimumSales,
199
+ maximumSales,
200
+ minimumBasketPercent,
201
+ maximumBasketPercent,
202
+ minimumTraffic,
203
+ maximumTraffic
93
204
  );
94
205
  ```
95
206
 
@@ -99,9 +210,19 @@ const { status, data } = await apiInstance.listProductAnalytics(
99
210
  |------------- | ------------- | ------------- | -------------|
100
211
  | **project** | [**string**] | What project it is | defaults to undefined|
101
212
  | **pageToken** | [**number**] | Page reference token | (optional) defaults to 1|
213
+ | **pageSize** | [**number**] | Max page size. This is the maximum page size that will be returned, but it might be smaller. | (optional) defaults to 100|
102
214
  | **search** | [**string**] | Search query string to filter results. Supports field-specific filters like: \&#39;enabled:true\&#39;, \&#39;gfn_product_ids:&lt;id&gt;\&#39;, \&#39;tag:\&quot;tag name\&quot;\&#39;, \&#39;internal_tag:\&quot;internal tag name\&quot;\&#39;, \&#39;includeArchived:false\&#39;, \&#39;hasSearchPhrase:false\&#39;, \&#39;inDataFeeds:true\&#39;, \&#39;aiOptimised:true\&#39;, \&#39;productType:&lt;id&gt;\&#39;, \&#39;genderGroup:\&quot;male,female,unisex\&quot;\&#39;, \&#39;hasBarcode:true\&#39;, \&#39;onSale:true\&#39;, \&#39;type:product,template,bundle\&#39;, \&#39;collection:&lt;id&gt;\&#39;. Multiple filters can be combined with spaces and commas. | (optional) defaults to 'enabled:true'|
103
215
  | **sortBy** | **Array&lt;string&gt;** | An array of fields to sort by, prefixed with a \&#39;-\&#39; for descending order or \&#39;+\&#39; for ascending. Default is ascending. | (optional) defaults to undefined|
104
- | **pageSize** | [**number**] | Max page size. This is the maximum page size that will be returned, but it might be smaller. | (optional) defaults to 100|
216
+ | **dateRangeStartDate** | [**string**] | Start date for the date range filter (ISO 8601 format) | (optional) defaults to undefined|
217
+ | **dateRangeEndDate** | [**string**] | End date for the date range filter (ISO 8601 format) | (optional) defaults to undefined|
218
+ | **minimumRevenue** | [**number**] | Filter to only include products with total revenue greater than or equal to this amount | (optional) defaults to undefined|
219
+ | **maximumRevenue** | [**number**] | Filter to only include products with total revenue less than or equal to this amount | (optional) defaults to undefined|
220
+ | **minimumSales** | [**number**] | Filter to only include products with total sales greater than or equal to this number | (optional) defaults to undefined|
221
+ | **maximumSales** | [**number**] | Filter to only include products with total sales less than or equal to this number | (optional) defaults to undefined|
222
+ | **minimumBasketPercent** | [**number**] | Filter to only include products where the average basket percentage is greater than or equal to this value | (optional) defaults to undefined|
223
+ | **maximumBasketPercent** | [**number**] | Filter to only include products where the average basket percentage is less than or equal to this value | (optional) defaults to undefined|
224
+ | **minimumTraffic** | [**number**] | Filter to only include products with total traffic greater than or equal to this number | (optional) defaults to undefined|
225
+ | **maximumTraffic** | [**number**] | Filter to only include products with total traffic less than or equal to this number | (optional) defaults to undefined|
105
226
 
106
227
 
107
228
  ### Return type
@@ -0,0 +1,34 @@
1
+ # Recommendation
2
+
3
+
4
+ ## Properties
5
+
6
+ Name | Type | Description | Notes
7
+ ------------ | ------------- | ------------- | -------------
8
+ **id** | **string** | Unique object identifier | [default to undefined]
9
+ **ref** | **string** | A reference to the recommendation resource location | [default to undefined]
10
+ **reason** | **string** | The reason for the recommendation | [default to undefined]
11
+ **recommendation** | **string** | The recommendation for the target | [default to undefined]
12
+ **priority** | **string** | | [default to undefined]
13
+ **actions** | [**Array&lt;Action&gt;**](Action.md) | | [default to undefined]
14
+ **createdAt** | **string** | | [default to undefined]
15
+ **updatedAt** | **string** | | [default to undefined]
16
+
17
+ ## Example
18
+
19
+ ```typescript
20
+ import { Recommendation } from '@teemill/product-catalog';
21
+
22
+ const instance: Recommendation = {
23
+ id,
24
+ ref,
25
+ reason,
26
+ recommendation,
27
+ priority,
28
+ actions,
29
+ createdAt,
30
+ updatedAt,
31
+ };
32
+ ```
33
+
34
+ [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
package/index.ts CHANGED
@@ -4,7 +4,7 @@
4
4
  * Product Catalog API
5
5
  * Manage your Product Catalog. A catalog product is an object that represents a product listing that can be purchased from the given project. It contains a combination of design applications and a warehouse product, plus listing information such as title, description and tags.
6
6
  *
7
- * The version of the OpenAPI document: 1.84.0
7
+ * The version of the OpenAPI document: 1.86.0
8
8
  *
9
9
  *
10
10
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@teemill/product-catalog",
3
- "version": "1.84.0",
3
+ "version": "1.86.0",
4
4
  "description": "OpenAPI client for @teemill/product-catalog",
5
5
  "author": "OpenAPI-Generator Contributors",
6
6
  "repository": {