--- title: "POST /v1/{+parent}/cssProductInputs:insert" method: POST path: "/v1/{+parent}/cssProductInputs:insert" tags: ["accounts"] --- # POST /v1/{+parent}/cssProductInputs:insert `POST /v1/{+parent}/cssProductInputs:insert` Uploads a CssProductInput to your CSS Center account. If an input with the same contentLanguage, identity, feedLabel and feedId already exists, this method replaces that entry. After inserting, updating, or deleting a CSS Product input, it may take several minutes before the processed CSS Product can be retrieved. ## Path parameters - `parent` string, required ## Query parameters - `feedId` string ## Request body - CssProductInput — This resource represents input data you submit for a CSS Product, not the processed CSS Product that you see in CSS Center, in Shopping Ads, or across Google surfaces. - `name` string — Identifier. The name of the CSS Product input. Format: `accounts/{account}/cssProductInputs/{css_product_input}`, where the last section `css_product_input` consists of 3 parts: contentLanguage~feedLabel~offerId. Example: accounts/123/cssProductInputs/de~DE~rawProvidedId123 - `freshnessTime` string, google-datetime — DEPRECATED. Use expiration_date instead. Represents the existing version (freshness) of the CSS Product, which can be used to preserve the right order when multiple updates are done at the same time. This field must not be set to the future time. If set, the update is prevented if a newer version of the item already exists in our system (that is the last update time of the existing CSS products is later than the freshness time set in the update). If the update happens, the last update time is then set to this freshness time. If not set, the update will not be prevented and the last update time will default to when this request was received by the CSS API. If the operation is prevented, the aborted exception will be thrown. - `rawProvidedId` string — Required. Your unique identifier for the CSS Product. This is the same for the CSS Product input and processed CSS Product. We only allow ids with alphanumerics, underscores and dashes. See the [products feed specification](https://support.google.com/merchants/answer/188494#id) for details. - `feedLabel` string — Required. The [feed label](https://developers.google.com/shopping-content/guides/products/feed-labels) for the CSS Product. Feed Label is synonymous to "target country" and hence should always be a valid region code. For example: 'DE' for Germany, 'FR' for France. - `attributes` Attributes — Attributes for CSS Product. - `imageLink` string — URL of an image of the item. - `headlineOfferMobileLink` string — Mobile Link to the headline offer. - `customLabel2` string — Custom label 2 for custom grouping of items in a Shopping campaign. - `cppAdsRedirect` string — Allows advertisers to override the item URL when the product is shown within the context of Product Ads. - `adult` boolean — Set to true if the item is targeted towards adults. - `excludedDestinations` string[] — The list of destinations to exclude for this target (corresponds to unchecked check boxes in Merchant Center). - `headlineOfferInstallment` HeadlineOfferInstallment — A message that represents installment. - `months` string, int64 — The number of installments the buyer has to pay. - `amount` Price — The price represented as a number and currency. - `amountMicros` string, int64 — The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros). - `currencyCode` string — The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217). - `downpayment` Price — The price represented as a number and currency. - `amountMicros` string, int64 — The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros). - `currencyCode` string — The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217). - `pattern` string — The item's pattern (e.g. polka dots). - `size` string — Size of the item. Only one value is allowed. For variants with different sizes, insert a separate product for each size with the same `itemGroupId` value (see [https://support.google.com/merchants/answer/6324492](size definition)). - `minRating` string, int64 — Minimum rating score of the product. Required if `rating` is provided. This field is for an upcoming feature and is not yet used. - `color` string — Color of the item. - `title` string — Title of the item. - `isBundle` boolean — Whether the item is a merchant-defined bundle. A bundle is a custom grouping of different products sold by a merchant for a single price. - `sizeTypes` string[] — The cut of the item. It can be used to represent combined size types for apparel items. Maximum two of size types can be provided (see [size type](https://support.google.com/merchants/answer/6324497). - `customLabel4` string — Custom label 4 for custom grouping of items in a Shopping campaign. - `highPrice` Price — The price represented as a number and currency. - `amountMicros` string, int64 — The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros). - `currencyCode` string — The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217). - `cppMobileLink` string — URL for the mobile-optimized version of the Product Detail Page of the CSS. - `pause` string — Publication of this item will be temporarily paused. - `customLabel1` string — Custom label 1 for custom grouping of items in a Shopping campaign. - `description` string — Description of the item. - `expirationDate` string, google-datetime — Date on which the item should expire, as specified upon insertion, in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format. The actual expiration date is exposed in `productstatuses` as [googleExpirationDate](https://support.google.com/merchants/answer/6324499) and might be earlier if `expirationDate` is too far in the future. Note: It may take 2+ days from the expiration date for the item to actually get deleted. - `cppLink` string — URL directly linking to your the Product Detail Page of the CSS. - `mpn` string — Manufacturer Part Number ([MPN](https://support.google.com/merchants/answer/188494#mpn)) of the item. - `ageGroup` string — Target age group of the item. - `headlineOfferPrice` Price — The price represented as a number and currency. - `amountMicros` string, int64 — The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros). - `currencyCode` string — The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217). - `productWidth` ProductDimension — The dimension of the product. - `unit` string — Required. The dimension units. Acceptable values are: * "`in`" * "`cm`" - `value` number, double — Required. The dimension value represented as a number. The value can have a maximum precision of four decimal places. - `certifications` Certification[] — A list of certificates claimed by the CSS for the given product. - `code` string — The code of the certification. For example, for the EPREL certificate with the link https://eprel.ec.europa.eu/screen/product/dishwashers2019/123456 the code is 123456. The code is required for European Energy Labels. - `name` string — The name of the certification. At this time, the most common value is "EPREL", which represents energy efficiency certifications in the EU European Registry for Energy Labeling (EPREL) database. - `authority` string — The authority or certification body responsible for issuing the certification. At this time, the most common value is "EC" or “European_Commission” for energy labels in the EU. - `additionalImageLinks` string[] — Additional URL of images of the item. - `material` string — The material of which the item is made. - `numberOfOffers` string, int64 — The number of CSS Products. - `sizeSystem` string — System in which the size is specified. Recommended for apparel items. - `brand` string — Product Related Attributes.[14-36] Brand of the item. - `headlineOfferSubscriptionCost` HeadlineOfferSubscriptionCost — The SubscriptionCost of the product. - `period` 'SUBSCRIPTION_PERIOD_UNSPECIFIED' | 'MONTH' | 'YEAR' — The type of subscription period. Supported values are: * "`month`" * "`year`" - `amount` Price — The price represented as a number and currency. - `amountMicros` string, int64 — The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros). - `currencyCode` string — The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217). - `periodLength` string, int64 — The number of subscription periods the buyer has to pay. - `gtin` string — Global Trade Item Number ([GTIN](https://support.google.com/merchants/answer/188494#gtin)) of the item. - `customLabel3` string — Custom label 3 for custom grouping of items in a Shopping campaign. - `headlineOfferShippingPrice` Price — The price represented as a number and currency. - `amountMicros` string, int64 — The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros). - `currencyCode` string — The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217). - `rating` number, double — Average rating score of the product. The value must be within the range of [`min_rating`, `max_rating`], inclusive. When displayed on the product page, this rating is normalized to a scale of [1, 5] with one decimal place. If provided, `review_count`, `min_rating`, and `max_rating` are also required. This field is for an upcoming feature and is not yet used. - `itemGroupId` string — Shared identifier for all variants of the same product. - `headlineOfferCondition` string — Condition of the headline offer. - `gender` string — Target gender of the item. - `productHighlights` string[] — Bullet points describing the most relevant highlights of a product. - `productHeight` ProductDimension — The dimension of the product. - `unit` string — Required. The dimension units. Acceptable values are: * "`in`" * "`cm`" - `value` number, double — Required. The dimension value represented as a number. The value can have a maximum precision of four decimal places. - `lowPrice` Price — The price represented as a number and currency. - `amountMicros` string, int64 — The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros). - `currencyCode` string — The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217). - `productLength` ProductDimension — The dimension of the product. - `unit` string — Required. The dimension units. Acceptable values are: * "`in`" * "`cm`" - `value` number, double — Required. The dimension value represented as a number. The value can have a maximum precision of four decimal places. - `customLabel0` string — Custom label 0 for custom grouping of items in a Shopping campaign. - `googleProductCategory` string — Google's category of the item (see [Google product taxonomy](https://support.google.com/merchants/answer/1705911)). When querying products, this field will contain the user provided value. There is currently no way to get back the auto assigned google product categories through the API. - `productDetails` ProductDetail[] — Technical specification or additional product details. - `attributeName` string — The name of the product detail. - `sectionName` string — The section header used to group a set of product details. - `attributeValue` string — The value of the product detail. - `productWeight` ProductWeight — The weight of the product. - `unit` string — Required. The weight unit. Acceptable values are: * "`g`" * "`kg`" * "`oz`" * "`lb`" - `value` number, double — Required. The weight represented as a number. The weight can have a maximum precision of four decimal places. - `includedDestinations` string[] — The list of destinations to include for this target (corresponds to checked check boxes in Merchant Center). Default destinations are always included unless provided in `excludedDestinations`. - `headlineOfferLink` string — Link to the headline offer. - `productTypes` string[] — Categories of the item (formatted as in [products data specification](https://support.google.com/merchants/answer/6324406)). - `maxRating` string, int64 — Maximum rating score of the product. Required if `rating` is provided. This field is for an upcoming feature and is not yet used. - `reviewCount` string, int64 — Number of reviews of the product. Required if `rating` is provided. This field is for an upcoming feature and is not yet used. - `multipack` string, int64 — The number of identical products in a merchant-defined multipack. - `customAttributes` CustomAttribute[] — A list of custom (CSS-provided) attributes. It can also be used for submitting any attribute of the feed specification in its generic form (for example: `{ "name": "size type", "value": "regular" }`). This is useful for submitting attributes not explicitly exposed by the API, such as additional attributes used for Buy on Google. - `name` string — The name of the attribute. - `value` string — The value of the attribute. If `value` is not empty, `group_values` must be empty. - `groupValues` CustomAttribute[] — Subattributes within this attribute group. If `group_values` is not empty, `value` must be empty. - `finalName` string — Output only. The name of the processed CSS Product. Format: `accounts/{account}/cssProducts/{css_product}` " - `contentLanguage` string — Required. The two-letter [ISO 639-1](http://en.wikipedia.org/wiki/ISO_639-1) language code for the CSS Product. ## Response `200` Successful response --- [API](https://skmtc.dev/google/apis/css.md) · [All operations](https://skmtc.dev/google/apis/css/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/css/revisions/22775d1d5e93/schema)