Changes to Create Product and Edit Product APIs

资料正文

§1 Summary

When sellers create or edit products via API, they can pass values to optional product fields such as GTIN, product attributes, and brand_id. If the format validation fails for these fields, previously the API call would fail. Now, the API call will succeed by adopting sane defaults. The API will return a new property, warnings.message and will contain information on which fields have been reset. Only the following parameters are affected:

brand_id
identifier_code
product_attributes

§2 What is changing?

§3 Brand ID (brand_id)

Brand ID (brand_id)

Before	After
API calls fail when the brand chosen does not fit the product category	* API calls will be successful and the brand parameter will default to "No Brand". * New property `warnings.message` will be returned indicating the original brand value is wiped out and defaulted to "No Brand".

§4 Identifier Code (identifier_code)

Identifier Code (identifier_code)

Before	After
API calls fail when the GTIN format (14 digits, the last digit is character) is not correct.	* Only applies for the GTIN type * API calls will be successful and the `identifier_code.code` parameter value will be empty. * New property `warnings.message` will be returned indicating the GTIN value is wiped out and reset to default.

§5 Product Attributes (product_attributes)

Product Attributes (product_attributes)

Before	After
API calls fail when product attributes value are in the wrong format. Format validation rules vary according to different attributes and markets.	* API calls will be successful and the `product_attributes.values.name` parameter value will be empty. * New property `warnings.message` will be returned indicating the fields that are reset to default.

§6 What markets & sellers are affected?

What markets & sellers are affected?

All markets and all sellers are impacted by this change.

§7 What versions are these changes for?

This change is applicable to all versions.

§8 Required Actions

We recommend adopting this new version and taking advantage of the feature where API calls will not fail but reset to defaults.