REST Resource: accounts.cssProducts

Resource: CssProduct

The processed CSS Product.

JSON representation 
{
  "name": string,
  "rawProvidedId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "cssProductStatus": {
    object (CssProductStatus)
  }
}
Fields
name

string

The name of the CSS Product. Format: "accounts/{account}/cssProducts/{css_product}"
rawProvidedId

string

Output only. Your unique raw identifier for the product.
contentLanguage

string

Output only. The two-letter ISO 639-1 language code for the product.
feedLabel

string

Output only. The feed label for the product.
attributes

object (Attributes)

Output only. A list of product attributes.
customAttributes[]

object (CustomAttribute)

Output only. A list of custom (CSS-provided) attributes. It can also be used to submit 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.
cssProductStatus

object (CssProductStatus)

Output only. The status of a product, data validation issues, that is, information about a product computed asynchronously.

Attributes

Attributes for CSS Product.

JSON representation 
{
  "lowPrice": {
    object (Price)
  },
  "highPrice": {
    object (Price)
  },
  "headlineOfferPrice": {
    object (Price)
  },
  "headlineOfferShippingPrice": {
    object (Price)
  },
  "additionalImageLinks": [
    string
  ],
  "productTypes": [
    string
  ],
  "sizeTypes": [
    string
  ],
  "productDetails": [
    {
      object (ProductDetail)
    }
  ],
  "productWeight": {
    object (ProductWeight)
  },
  "productLength": {
    object (ProductDimension)
  },
  "productWidth": {
    object (ProductDimension)
  },
  "productHeight": {
    object (ProductDimension)
  },
  "productHighlights": [
    string
  ],
  "certifications": [
    {
      object (Certification)
    }
  ],
  "expirationDate": string,
  "includedDestinations": [
    string
  ],
  "excludedDestinations": [
    string
  ],
  "headlineOfferInstallment": {
    object (HeadlineOfferInstallment)
  },
  "headlineOfferSubscriptionCost": {
    object (HeadlineOfferSubscriptionCost)
  },
  "cppLink": string,
  "cppMobileLink": string,
  "cppAdsRedirect": string,
  "numberOfOffers": string,
  "headlineOfferCondition": string,
  "headlineOfferLink": string,
  "headlineOfferMobileLink": string,
  "title": string,
  "imageLink": string,
  "description": string,
  "brand": string,
  "mpn": string,
  "gtin": string,
  "googleProductCategory": string,
  "adult": boolean,
  "multipack": string,
  "isBundle": boolean,
  "ageGroup": string,
  "color": string,
  "gender": string,
  "material": string,
  "pattern": string,
  "size": string,
  "sizeSystem": string,
  "itemGroupId": string,
  "pause": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string
}
Fields
lowPrice

object (Price)

Low Price of the CSS Product.
highPrice

object (Price)

High Price of the CSS Product.
headlineOfferPrice

object (Price)

Headline Price of the CSS Product.
headlineOfferShippingPrice

object (Price)

Headline Price of the CSS Product.
productTypes[]

string

Categories of the item (formatted as in products data specification).
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 [https://support.google.com/merchants/answer/6324497](size type)).
productDetails[]

object (ProductDetail)

Technical specification or additional product details.
productWeight

object (ProductWeight)

The weight of the product in the units provided. The value must be between 0 (exclusive) and 2000 (inclusive).
productLength

object (ProductDimension)

The length of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive).
productWidth

object (ProductDimension)

The width of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive).
productHeight

object (ProductDimension)

The height of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive).
productHighlights[]

string

Bullet points describing the most relevant highlights of a product.
certifications[]

object (Certification)

A list of certificates claimed by the CSS for the given product.
expirationDate

string (Timestamp format)

Date on which the item should expire, as specified upon insertion, in ISO 8601 format. The actual expiration date is exposed in productstatuses as googleExpirationDate 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.
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.
excludedDestinations[]

string

The list of destinations to exclude for this target (corresponds to unchecked check boxes in Merchant Center).
headlineOfferInstallment

object (HeadlineOfferInstallment)

Number and amount of installments to pay for an item.
headlineOfferSubscriptionCost

object (HeadlineOfferSubscriptionCost)

Number of periods (months or years) and amount of payment per period for an item with an associated subscription contract.
cppAdsRedirect

string

Allows advertisers to override the item URL when the product is shown within the context of Product Ads.
numberOfOffers

string (int64 format)

The number of CSS Products.
headlineOfferCondition

string

Condition of the headline offer.
title

string

Title of the item.
description

string

Description of the item.
brand

string

Product Related Attributes.[14-36] Brand of the item.
mpn

string

Manufacturer Part Number (MPN) of the item.
gtin

string

Global Trade Item Number (GTIN) of the item.
googleProductCategory

string

Google's category of the item (see Google product taxonomy). 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.
adult

boolean

Set to true if the item is targeted towards adults.
multipack

string (int64 format)

The number of identical products in a merchant-defined multipack.
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.
ageGroup

string

Target age group of the item.
color

string

Color of the item.
gender

string

Target gender of the item.
material

string

The material of which the item is made.
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)).
sizeSystem

string

System in which the size is specified. Recommended for apparel items.
itemGroupId

string

Shared identifier for all variants of the same product.
pause

string

Publication of this item will be temporarily paused.
customLabel0

string

Custom label 0 for custom grouping of items in a Shopping campaign.
customLabel1

string

Custom label 1 for custom grouping of items in a Shopping campaign.
customLabel2

string

Custom label 2 for custom grouping of items in a Shopping campaign.
customLabel3

string

Custom label 3 for custom grouping of items in a Shopping campaign.
customLabel4

string

Custom label 4 for custom grouping of items in a Shopping campaign.

Price

The price represented as a number and currency.

JSON representation 
{
  "amountMicros": string,
  "currencyCode": string
}
Fields
amountMicros

string (int64 format)

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.

ProductDetail

The product details.

JSON representation 
{
  "sectionName": string,
  "attributeName": string,
  "attributeValue": string
}
Fields
sectionName

string

The section header used to group a set of product details.
attributeName

string

The name of the product detail.
attributeValue

string

The value of the product detail.

ProductWeight

The weight of the product.

JSON representation 
{
  "value": number,
  "unit": string
}
Fields
value

number

Required. The weight represented as a number. The weight can have a maximum precision of four decimal places.
unit

string

Required. The weight unit. Acceptable values are: * "g" * "kg" * "oz" * "lb"

ProductDimension

The dimension of the product.

JSON representation 
{
  "value": number,
  "unit": string
}
Fields
value

number

Required. The dimension value represented as a number. The value can have a maximum precision of four decimal places.
unit

string

Required. The dimension units. Acceptable values are: * "in" * "cm"

Certification

The certification for the product. Use the this attribute to describe certifications, such as energy efficiency ratings, associated with a product.

JSON representation 
{
  "name": string,
  "authority": string,
  "code": string
}
Fields
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.
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.

HeadlineOfferInstallment

A message that represents installment.

JSON representation 
{
  "months": string,
  "amount": {
    object (Price)
  },
  "downpayment": {
    object (Price)
  }
}
Fields
months

string (int64 format)

The number of installments the buyer has to pay.
amount

object (Price)

The amount the buyer has to pay per month.
downpayment

object (Price)

The up-front down payment amount the buyer has to pay.

HeadlineOfferSubscriptionCost

The SubscriptionCost of the product.

JSON representation 
{
  "period": enum (SubscriptionPeriod),
  "periodLength": string,
  "amount": {
    object (Price)
  }
}
Fields
period

enum (SubscriptionPeriod)

The type of subscription period. Supported values are: * "month" * "year"
periodLength

string (int64 format)

The number of subscription periods the buyer has to pay.
amount

object (Price)

The amount the buyer has to pay per subscription period.

SubscriptionPeriod

The subscription period of the product.

Enums
SUBSCRIPTION_PERIOD_UNSPECIFIED Indicates that the subscription period is unspecified.
MONTH Indicates that the subscription period is month.
YEAR Indicates that the subscription period is year.

CustomAttribute

A message that represents custom attributes. Exactly one of value or groupValues must not be empty.

JSON representation 
{
  "groupValues": [
    {
      object (CustomAttribute)
    }
  ],
  "name": string,
  "value": string
}
Fields
groupValues[]

object (CustomAttribute)

Subattributes within this attribute group. If groupValues is not empty, value must be empty.
name

string

The name of the attribute.
value

string

The value of the attribute. If value is not empty, groupValues must be empty.

CssProductStatus

The status of the Css Product, data validation issues, that is, information about the Css Product computed asynchronously.

JSON representation 
{
  "destinationStatuses": [
    {
      object (DestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ItemLevelIssue)
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string,
  "googleExpirationDate": string
}
Fields
destinationStatuses[]

object (DestinationStatus)

The intended destinations for the product.
itemLevelIssues[]

object (ItemLevelIssue)

A list of all issues associated with the product.
creationDate

string (Timestamp format)

Date on which the item has been created, in ISO 8601 format.
lastUpdateDate

string (Timestamp format)

Date on which the item has been last updated, in ISO 8601 format.
googleExpirationDate

string (Timestamp format)

Date on which the item expires, in ISO 8601 format.

DestinationStatus

The destination status of the product status.

JSON representation 
{
  "destination": string,
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
Fields
destination

string

The name of the destination
approvedCountries[]

string

List of country codes (ISO 3166-1 alpha-2) where the CSS Product is approved.
pendingCountries[]

string

List of country codes (ISO 3166-1 alpha-2) where the CSS Product is pending approval.
disapprovedCountries[]

string

List of country codes (ISO 3166-1 alpha-2) where the CSS Product is disapproved.

ItemLevelIssue

The ItemLevelIssue of the product status.

JSON representation 
{
  "code": string,
  "servability": string,
  "resolution": string,
  "attribute": string,
  "destination": string,
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
Fields
code

string

The error code of the issue.
servability

string

How this issue affects serving of the CSS Product.
resolution

string

Whether the issue can be resolved by the merchant.
attribute

string

The attribute's name, if the issue is caused by a single attribute.
destination

string

The destination the issue applies to.
description

string

A short issue description in English.
detail

string

A detailed issue description in English.
documentation

string

The URL of a web page to help with resolving this issue.
applicableCountries[]

string

List of country codes (ISO 3166-1 alpha-2) where issue applies to the CSS Product.

Methods

get

 Retrieves the processed CSS Product from your CSS Center account.

list

 Lists the processed CSS Products in your CSS Center account.