@sp-api-sdk/product-type-definitions-api-2020-09-01 2.0.0 → 2.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -86,11 +86,14 @@ const DefinitionsApiAxiosParamCreator = function (configuration) {
86
86
  /**
87
87
  * Search for and return a list of Amazon product types that have definitions available. **Usage Plans:** | Plan type | Rate (requests per second) | Burst | | ---- | ---- | ---- | |Default| 5 | 10 | |Selling partner specific| Variable | Variable | The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. Rate limits for some selling partners will vary from the default rate and burst shown in the table above. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).
88
88
  * @param {Array<string>} marketplaceIds A comma-delimited list of Amazon marketplace identifiers for the request.
89
- * @param {Array<string>} [keywords] A comma-delimited list of keywords to search product types by.
89
+ * @param {Array<string>} [keywords] A comma-delimited list of keywords to search product types. **Note:** Cannot be used with &#x60;itemName&#x60;.
90
+ * @param {string} [itemName] The title of the ASIN to get the product type recommendation. **Note:** Cannot be used with &#x60;keywords&#x60;.
91
+ * @param {string} [locale] The locale for the display names in the response. Defaults to the primary locale of the marketplace.
92
+ * @param {string} [searchLocale] The locale used for the &#x60;keywords&#x60; and &#x60;itemName&#x60; parameters. Defaults to the primary locale of the marketplace.
90
93
  * @param {*} [options] Override http request option.
91
94
  * @throws {RequiredError}
92
95
  */
93
- searchDefinitionsProductTypes: async (marketplaceIds, keywords, options = {}) => {
96
+ searchDefinitionsProductTypes: async (marketplaceIds, keywords, itemName, locale, searchLocale, options = {}) => {
94
97
  // verify required parameter 'marketplaceIds' is not null or undefined
95
98
  (0, common_1.assertParamExists)('searchDefinitionsProductTypes', 'marketplaceIds', marketplaceIds);
96
99
  const localVarPath = `/definitions/2020-09-01/productTypes`;
@@ -109,6 +112,15 @@ const DefinitionsApiAxiosParamCreator = function (configuration) {
109
112
  if (marketplaceIds) {
110
113
  localVarQueryParameter['marketplaceIds'] = marketplaceIds.join(base_1.COLLECTION_FORMATS.csv);
111
114
  }
115
+ if (itemName !== undefined) {
116
+ localVarQueryParameter['itemName'] = itemName;
117
+ }
118
+ if (locale !== undefined) {
119
+ localVarQueryParameter['locale'] = locale;
120
+ }
121
+ if (searchLocale !== undefined) {
122
+ localVarQueryParameter['searchLocale'] = searchLocale;
123
+ }
112
124
  (0, common_1.setSearchParams)(localVarUrlObj, localVarQueryParameter);
113
125
  let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
114
126
  localVarRequestOptions.headers = { ...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers };
@@ -146,12 +158,15 @@ const DefinitionsApiFp = function (configuration) {
146
158
  /**
147
159
  * Search for and return a list of Amazon product types that have definitions available. **Usage Plans:** | Plan type | Rate (requests per second) | Burst | | ---- | ---- | ---- | |Default| 5 | 10 | |Selling partner specific| Variable | Variable | The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. Rate limits for some selling partners will vary from the default rate and burst shown in the table above. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).
148
160
  * @param {Array<string>} marketplaceIds A comma-delimited list of Amazon marketplace identifiers for the request.
149
- * @param {Array<string>} [keywords] A comma-delimited list of keywords to search product types by.
161
+ * @param {Array<string>} [keywords] A comma-delimited list of keywords to search product types. **Note:** Cannot be used with &#x60;itemName&#x60;.
162
+ * @param {string} [itemName] The title of the ASIN to get the product type recommendation. **Note:** Cannot be used with &#x60;keywords&#x60;.
163
+ * @param {string} [locale] The locale for the display names in the response. Defaults to the primary locale of the marketplace.
164
+ * @param {string} [searchLocale] The locale used for the &#x60;keywords&#x60; and &#x60;itemName&#x60; parameters. Defaults to the primary locale of the marketplace.
150
165
  * @param {*} [options] Override http request option.
151
166
  * @throws {RequiredError}
152
167
  */
153
- async searchDefinitionsProductTypes(marketplaceIds, keywords, options) {
154
- const localVarAxiosArgs = await localVarAxiosParamCreator.searchDefinitionsProductTypes(marketplaceIds, keywords, options);
168
+ async searchDefinitionsProductTypes(marketplaceIds, keywords, itemName, locale, searchLocale, options) {
169
+ const localVarAxiosArgs = await localVarAxiosParamCreator.searchDefinitionsProductTypes(marketplaceIds, keywords, itemName, locale, searchLocale, options);
155
170
  return (0, common_1.createRequestFunction)(localVarAxiosArgs, axios_1.default, base_1.BASE_PATH, configuration);
156
171
  },
157
172
  };
@@ -180,7 +195,7 @@ const DefinitionsApiFactory = function (configuration, basePath, axios) {
180
195
  * @throws {RequiredError}
181
196
  */
182
197
  searchDefinitionsProductTypes(requestParameters, options) {
183
- return localVarFp.searchDefinitionsProductTypes(requestParameters.marketplaceIds, requestParameters.keywords, options).then((request) => request(axios, basePath));
198
+ return localVarFp.searchDefinitionsProductTypes(requestParameters.marketplaceIds, requestParameters.keywords, requestParameters.itemName, requestParameters.locale, requestParameters.searchLocale, options).then((request) => request(axios, basePath));
184
199
  },
185
200
  };
186
201
  };
@@ -210,7 +225,7 @@ class DefinitionsApi extends base_1.BaseAPI {
210
225
  * @memberof DefinitionsApi
211
226
  */
212
227
  searchDefinitionsProductTypes(requestParameters, options) {
213
- return (0, exports.DefinitionsApiFp)(this.configuration).searchDefinitionsProductTypes(requestParameters.marketplaceIds, requestParameters.keywords, options).then((request) => request(this.axios, this.basePath));
228
+ return (0, exports.DefinitionsApiFp)(this.configuration).searchDefinitionsProductTypes(requestParameters.marketplaceIds, requestParameters.keywords, requestParameters.itemName, requestParameters.locale, requestParameters.searchLocale, options).then((request) => request(this.axios, this.basePath));
214
229
  }
215
230
  }
216
231
  exports.DefinitionsApi = DefinitionsApi;
@@ -80,11 +80,14 @@ export const DefinitionsApiAxiosParamCreator = function (configuration) {
80
80
  /**
81
81
  * Search for and return a list of Amazon product types that have definitions available. **Usage Plans:** | Plan type | Rate (requests per second) | Burst | | ---- | ---- | ---- | |Default| 5 | 10 | |Selling partner specific| Variable | Variable | The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. Rate limits for some selling partners will vary from the default rate and burst shown in the table above. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).
82
82
  * @param {Array<string>} marketplaceIds A comma-delimited list of Amazon marketplace identifiers for the request.
83
- * @param {Array<string>} [keywords] A comma-delimited list of keywords to search product types by.
83
+ * @param {Array<string>} [keywords] A comma-delimited list of keywords to search product types. **Note:** Cannot be used with &#x60;itemName&#x60;.
84
+ * @param {string} [itemName] The title of the ASIN to get the product type recommendation. **Note:** Cannot be used with &#x60;keywords&#x60;.
85
+ * @param {string} [locale] The locale for the display names in the response. Defaults to the primary locale of the marketplace.
86
+ * @param {string} [searchLocale] The locale used for the &#x60;keywords&#x60; and &#x60;itemName&#x60; parameters. Defaults to the primary locale of the marketplace.
84
87
  * @param {*} [options] Override http request option.
85
88
  * @throws {RequiredError}
86
89
  */
87
- searchDefinitionsProductTypes: async (marketplaceIds, keywords, options = {}) => {
90
+ searchDefinitionsProductTypes: async (marketplaceIds, keywords, itemName, locale, searchLocale, options = {}) => {
88
91
  // verify required parameter 'marketplaceIds' is not null or undefined
89
92
  assertParamExists('searchDefinitionsProductTypes', 'marketplaceIds', marketplaceIds);
90
93
  const localVarPath = `/definitions/2020-09-01/productTypes`;
@@ -103,6 +106,15 @@ export const DefinitionsApiAxiosParamCreator = function (configuration) {
103
106
  if (marketplaceIds) {
104
107
  localVarQueryParameter['marketplaceIds'] = marketplaceIds.join(COLLECTION_FORMATS.csv);
105
108
  }
109
+ if (itemName !== undefined) {
110
+ localVarQueryParameter['itemName'] = itemName;
111
+ }
112
+ if (locale !== undefined) {
113
+ localVarQueryParameter['locale'] = locale;
114
+ }
115
+ if (searchLocale !== undefined) {
116
+ localVarQueryParameter['searchLocale'] = searchLocale;
117
+ }
106
118
  setSearchParams(localVarUrlObj, localVarQueryParameter);
107
119
  let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
108
120
  localVarRequestOptions.headers = { ...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers };
@@ -139,12 +151,15 @@ export const DefinitionsApiFp = function (configuration) {
139
151
  /**
140
152
  * Search for and return a list of Amazon product types that have definitions available. **Usage Plans:** | Plan type | Rate (requests per second) | Burst | | ---- | ---- | ---- | |Default| 5 | 10 | |Selling partner specific| Variable | Variable | The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. Rate limits for some selling partners will vary from the default rate and burst shown in the table above. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).
141
153
  * @param {Array<string>} marketplaceIds A comma-delimited list of Amazon marketplace identifiers for the request.
142
- * @param {Array<string>} [keywords] A comma-delimited list of keywords to search product types by.
154
+ * @param {Array<string>} [keywords] A comma-delimited list of keywords to search product types. **Note:** Cannot be used with &#x60;itemName&#x60;.
155
+ * @param {string} [itemName] The title of the ASIN to get the product type recommendation. **Note:** Cannot be used with &#x60;keywords&#x60;.
156
+ * @param {string} [locale] The locale for the display names in the response. Defaults to the primary locale of the marketplace.
157
+ * @param {string} [searchLocale] The locale used for the &#x60;keywords&#x60; and &#x60;itemName&#x60; parameters. Defaults to the primary locale of the marketplace.
143
158
  * @param {*} [options] Override http request option.
144
159
  * @throws {RequiredError}
145
160
  */
146
- async searchDefinitionsProductTypes(marketplaceIds, keywords, options) {
147
- const localVarAxiosArgs = await localVarAxiosParamCreator.searchDefinitionsProductTypes(marketplaceIds, keywords, options);
161
+ async searchDefinitionsProductTypes(marketplaceIds, keywords, itemName, locale, searchLocale, options) {
162
+ const localVarAxiosArgs = await localVarAxiosParamCreator.searchDefinitionsProductTypes(marketplaceIds, keywords, itemName, locale, searchLocale, options);
148
163
  return createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration);
149
164
  },
150
165
  };
@@ -172,7 +187,7 @@ export const DefinitionsApiFactory = function (configuration, basePath, axios) {
172
187
  * @throws {RequiredError}
173
188
  */
174
189
  searchDefinitionsProductTypes(requestParameters, options) {
175
- return localVarFp.searchDefinitionsProductTypes(requestParameters.marketplaceIds, requestParameters.keywords, options).then((request) => request(axios, basePath));
190
+ return localVarFp.searchDefinitionsProductTypes(requestParameters.marketplaceIds, requestParameters.keywords, requestParameters.itemName, requestParameters.locale, requestParameters.searchLocale, options).then((request) => request(axios, basePath));
176
191
  },
177
192
  };
178
193
  };
@@ -201,6 +216,6 @@ export class DefinitionsApi extends BaseAPI {
201
216
  * @memberof DefinitionsApi
202
217
  */
203
218
  searchDefinitionsProductTypes(requestParameters, options) {
204
- return DefinitionsApiFp(this.configuration).searchDefinitionsProductTypes(requestParameters.marketplaceIds, requestParameters.keywords, options).then((request) => request(this.axios, this.basePath));
219
+ return DefinitionsApiFp(this.configuration).searchDefinitionsProductTypes(requestParameters.marketplaceIds, requestParameters.keywords, requestParameters.itemName, requestParameters.locale, requestParameters.searchLocale, options).then((request) => request(this.axios, this.basePath));
205
220
  }
206
221
  }
@@ -35,11 +35,14 @@ export declare const DefinitionsApiAxiosParamCreator: (configuration?: Configura
35
35
  /**
36
36
  * Search for and return a list of Amazon product types that have definitions available. **Usage Plans:** | Plan type | Rate (requests per second) | Burst | | ---- | ---- | ---- | |Default| 5 | 10 | |Selling partner specific| Variable | Variable | The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. Rate limits for some selling partners will vary from the default rate and burst shown in the table above. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).
37
37
  * @param {Array<string>} marketplaceIds A comma-delimited list of Amazon marketplace identifiers for the request.
38
- * @param {Array<string>} [keywords] A comma-delimited list of keywords to search product types by.
38
+ * @param {Array<string>} [keywords] A comma-delimited list of keywords to search product types. **Note:** Cannot be used with &#x60;itemName&#x60;.
39
+ * @param {string} [itemName] The title of the ASIN to get the product type recommendation. **Note:** Cannot be used with &#x60;keywords&#x60;.
40
+ * @param {string} [locale] The locale for the display names in the response. Defaults to the primary locale of the marketplace.
41
+ * @param {string} [searchLocale] The locale used for the &#x60;keywords&#x60; and &#x60;itemName&#x60; parameters. Defaults to the primary locale of the marketplace.
39
42
  * @param {*} [options] Override http request option.
40
43
  * @throws {RequiredError}
41
44
  */
42
- searchDefinitionsProductTypes: (marketplaceIds: Array<string>, keywords?: Array<string>, options?: AxiosRequestConfig) => Promise<RequestArgs>;
45
+ searchDefinitionsProductTypes: (marketplaceIds: Array<string>, keywords?: Array<string>, itemName?: string, locale?: string, searchLocale?: string, options?: AxiosRequestConfig) => Promise<RequestArgs>;
43
46
  };
44
47
  /**
45
48
  * DefinitionsApi - functional programming interface
@@ -62,11 +65,14 @@ export declare const DefinitionsApiFp: (configuration?: Configuration) => {
62
65
  /**
63
66
  * Search for and return a list of Amazon product types that have definitions available. **Usage Plans:** | Plan type | Rate (requests per second) | Burst | | ---- | ---- | ---- | |Default| 5 | 10 | |Selling partner specific| Variable | Variable | The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. Rate limits for some selling partners will vary from the default rate and burst shown in the table above. For more information, see [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).
64
67
  * @param {Array<string>} marketplaceIds A comma-delimited list of Amazon marketplace identifiers for the request.
65
- * @param {Array<string>} [keywords] A comma-delimited list of keywords to search product types by.
68
+ * @param {Array<string>} [keywords] A comma-delimited list of keywords to search product types. **Note:** Cannot be used with &#x60;itemName&#x60;.
69
+ * @param {string} [itemName] The title of the ASIN to get the product type recommendation. **Note:** Cannot be used with &#x60;keywords&#x60;.
70
+ * @param {string} [locale] The locale for the display names in the response. Defaults to the primary locale of the marketplace.
71
+ * @param {string} [searchLocale] The locale used for the &#x60;keywords&#x60; and &#x60;itemName&#x60; parameters. Defaults to the primary locale of the marketplace.
66
72
  * @param {*} [options] Override http request option.
67
73
  * @throws {RequiredError}
68
74
  */
69
- searchDefinitionsProductTypes(marketplaceIds: Array<string>, keywords?: Array<string>, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ProductTypeList>>;
75
+ searchDefinitionsProductTypes(marketplaceIds: Array<string>, keywords?: Array<string>, itemName?: string, locale?: string, searchLocale?: string, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ProductTypeList>>;
70
76
  };
71
77
  /**
72
78
  * DefinitionsApi - factory interface
@@ -150,11 +156,29 @@ export interface DefinitionsApiSearchDefinitionsProductTypesRequest {
150
156
  */
151
157
  readonly marketplaceIds: Array<string>;
152
158
  /**
153
- * A comma-delimited list of keywords to search product types by.
159
+ * A comma-delimited list of keywords to search product types. **Note:** Cannot be used with &#x60;itemName&#x60;.
154
160
  * @type {Array<string>}
155
161
  * @memberof DefinitionsApiSearchDefinitionsProductTypes
156
162
  */
157
163
  readonly keywords?: Array<string>;
164
+ /**
165
+ * The title of the ASIN to get the product type recommendation. **Note:** Cannot be used with &#x60;keywords&#x60;.
166
+ * @type {string}
167
+ * @memberof DefinitionsApiSearchDefinitionsProductTypes
168
+ */
169
+ readonly itemName?: string;
170
+ /**
171
+ * The locale for the display names in the response. Defaults to the primary locale of the marketplace.
172
+ * @type {string}
173
+ * @memberof DefinitionsApiSearchDefinitionsProductTypes
174
+ */
175
+ readonly locale?: string;
176
+ /**
177
+ * The locale used for the &#x60;keywords&#x60; and &#x60;itemName&#x60; parameters. Defaults to the primary locale of the marketplace.
178
+ * @type {string}
179
+ * @memberof DefinitionsApiSearchDefinitionsProductTypes
180
+ */
181
+ readonly searchLocale?: string;
158
182
  }
159
183
  /**
160
184
  * DefinitionsApi - object-oriented interface
@@ -68,6 +68,12 @@ export interface ProductTypeDefinition {
68
68
  * @memberof ProductTypeDefinition
69
69
  */
70
70
  'productType': string;
71
+ /**
72
+ * Human-readable and localized description of the Amazon product type.
73
+ * @type {string}
74
+ * @memberof ProductTypeDefinition
75
+ */
76
+ 'displayName': string;
71
77
  /**
72
78
  *
73
79
  * @type {ProductTypeVersion}
@@ -10,6 +10,7 @@
10
10
  * Do not edit the class manually.
11
11
  */
12
12
  import { ProductType } from './product-type';
13
+ import { ProductTypeVersion } from './product-type-version';
13
14
  /**
14
15
  * A list of Amazon product types with definitions available.
15
16
  * @export
@@ -22,4 +23,10 @@ export interface ProductTypeList {
22
23
  * @memberof ProductTypeList
23
24
  */
24
25
  'productTypes': Array<ProductType>;
26
+ /**
27
+ *
28
+ * @type {ProductTypeVersion}
29
+ * @memberof ProductTypeList
30
+ */
31
+ 'productTypeVersion': ProductTypeVersion;
25
32
  }
@@ -21,6 +21,12 @@ export interface ProductType {
21
21
  * @memberof ProductType
22
22
  */
23
23
  'name': string;
24
+ /**
25
+ * The human-readable and localized description of the Amazon product type.
26
+ * @type {string}
27
+ * @memberof ProductType
28
+ */
29
+ 'displayName': string;
24
30
  /**
25
31
  * The Amazon marketplace identifiers for which the product type definition is available.
26
32
  * @type {Array<string>}
package/package.json CHANGED
@@ -2,7 +2,7 @@
2
2
  "name": "@sp-api-sdk/product-type-definitions-api-2020-09-01",
3
3
  "author": "Vincent Mesquita <vincent.mesquita@bizon.solutions>",
4
4
  "description": "The Selling Partner API for Product Type Definitions provides programmatic access to attribute and data requirements for product types in the Amazon catalog. Use this API to return the JSON Schema for a product type that you can then use with other Selling Partner APIs, such as the Selling Partner API for Listings Items, the Selling Partner API for Catalog Items, and the Selling Partner API for Feeds (for JSON-based listing feeds). For more information, see the Product Type Definitions API Use Case Guide.",
5
- "version": "2.0.0",
5
+ "version": "2.1.0",
6
6
  "main": "dist/cjs/index.js",
7
7
  "module": "dist/es/index.js",
8
8
  "types": "dist/types/index.d.ts",
@@ -18,8 +18,8 @@
18
18
  "dist/**/*.d.ts"
19
19
  ],
20
20
  "dependencies": {
21
- "@sp-api-sdk/common": "2.0.0",
22
- "axios": "^1.5.1"
21
+ "@sp-api-sdk/common": "2.0.2",
22
+ "axios": "^1.6.1"
23
23
  },
24
24
  "repository": {
25
25
  "type": "git",
@@ -40,5 +40,5 @@
40
40
  "sp sdk",
41
41
  "product type definitions api"
42
42
  ],
43
- "gitHead": "a278405620f714b7bf6c42692d265f76d952bd49"
43
+ "gitHead": "23d420d10e931be7657141e989fccdc9dafe2a9c"
44
44
  }