v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-1382037.3 KB
accounts

Inserts or updates the attributes of the product in a Manufacturer Center account. Creates a product with the provided attributes. If the product already exists, then all attributes are replaced with the new ones. The checks at upload time are minimal. All required attributes need to be present for a product to be valid. Issues may show up later after the API has accepted a new upload for a product and it is possible to overwrite an existing valid product with an invalid product. To detect this, you should retrieve the product and check it for issues once the new version is available. Uploaded attributes first need to be processed before they can be retrieved. Until then, new products will be unavailable, and retrieval of previously uploaded products will return the original state of the product.

put/v1/{+parent}/products/{+name}

Path parameters

parentstring required

Parent ID in the format accounts/{account_id}. account_id - The ID of the Manufacturer Center account.

namestring required

Name in the format {target_country}:{content_language}:{product_id}. target_country - The target country of the product as a CLDR territory code (for example, US). content_language - The content language of the product as a two-letter ISO 639-1 language code (for example, en). product_id - The ID of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#id.

Request body

colorstring

The color of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#color.

descriptionstring

The description of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#description.

ageGroupstring

The target age group of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#agegroup.

flavorstring

The flavor of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#flavor.

patternstring

The pattern of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#pattern.

formatstring

The format of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#format.

disclosureDatestring

The disclosure date of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#disclosure.

sizeSystemstring

The size system of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#sizesystem.

itemGroupIdstring

The item group id of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#itemgroupid.

brandstring

The brand name of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#brand.

productTypestring[]

The type or category of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#producttype.

productNamestring

The canonical name of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#productname.

genderstring

The target gender of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#gender.

virtualModelLinkstring

Virtual Model (3d) asset link.

materialstring

The material of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#material.

richProductContentstring[]

Rich product content. For more information, see https://support.google.com/manufacturers/answer/9389865

includedDestinationstring[]

A list of included destinations such as "ClientExport", "ClientShoppingCatalog" or "PartnerShoppingCatalog". For more information, see https://support.google.com/manufacturers/answer/7443550

productLinestring

The name of the group of products related to the product. For more information, see https://support.google.com/manufacturers/answer/6124116#productline.

titlestring

The title of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#title.

sizeTypestring[]

The size type of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#sizetype.

releaseDatestring

The release date of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#release.

themestring

The theme of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#theme.

mpnstring

The Manufacturer Part Number (MPN) of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#mpn.

sizestring

The size of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#size.

intendedCountrystring[]

Optional. List of countries to show this product in. Countries provided in this attribute will override any of the countries configured at feed level. The values should be: the CLDR territory code of the countries in which this item will be shown.

gtinstring[]

The Global Trade Item Number (GTIN) of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#gtin.

productHighlightstring[]

The product highlights. For more information, see https://support.google.com/manufacturers/answer/10066942

targetClientIdstring

The target client id. Should only be used in the accounts of the data partners. For more information, see https://support.google.com/manufacturers/answer/10857344

excludedDestinationstring[]

A list of excluded destinations such as "ClientExport", "ClientShoppingCatalog" or "PartnerShoppingCatalog". For more information, see https://support.google.com/manufacturers/answer/7443550

productPageUrlstring

The URL of the detail page of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#productpage.

videoLinkstring[]

The videos of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#video.

scentstring

The scent of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#scent.

Response

Successful response