REST Resource: accounts.cssProducts

Recurso: CssProduct

O produto do CSS processado.

Representação JSON 
{
  "name": string,
  "rawProvidedId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "cssProductStatus": {
    object (CssProductStatus)
  }
}
Campos
name

string

O nome do produto do CSS. Formato: "accounts/{account}/cssProducts/{css_product}"
rawProvidedId

string

Apenas saída. Seu identificador bruto exclusivo do produto.
contentLanguage

string

Apenas saída. O código de idioma ISO 639-1 de duas letras do produto.
feedLabel

string

Apenas saída. O rótulo do feed do produto.
attributes

object (Attributes)

Apenas saída. Uma lista de atributos do produto.
customAttributes[]

object (CustomAttribute)

Apenas saída. Uma lista de atributos personalizados (fornecidos pelo CSS). Ela também pode ser usada para enviar qualquer atributo da especificação do feed na forma genérica (por exemplo, { "name": "size type", "value": "regular" }). Isso é útil para enviar atributos que não são explicitamente expostos pela API, como os adicionais usados no Comprar com o Google.
cssProductStatus

object (CssProductStatus)

Apenas saída. O status de um produto, problemas de validação de dados, ou seja, informações sobre um produto calculadas de forma assíncrona.

Atributos

Atributos do produto do CSS.

Representação JSON 
{
  "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,
  "reviewCount": string,
  "minRating": string,
  "maxRating": string,
  "rating": number
}
Campos
lowPrice

object (Price)

Preço mínimo do produto do CSS.
highPrice

object (Price)

Preço máximo do produto do CSS.
headlineOfferPrice

object (Price)

Preço principal do produto do CSS.
headlineOfferShippingPrice

object (Price)

Preço principal do produto do CSS.
productTypes[]

string

Categorias do item (formatadas como na especificação dos dados do produto).
sizeTypes[]

string

O corte do item. Ele pode ser usado para representar tipos de tamanho combinados para itens de vestuário. É possível informar até dois tipos de tamanho (consulte tipo de tamanho).
productDetails[]

object (ProductDetail)

Especificações técnicas ou outros detalhes do produto.
productWeight

object (ProductWeight)

O peso do produto nas unidades fornecidas. O valor precisa estar entre 0 (exclusivo) e 2.000 (inclusive).
productLength

object (ProductDimension)

O comprimento do produto nas unidades fornecidas. O valor precisa estar entre 0 (exclusivo) e 3.000 (inclusive).
productWidth

object (ProductDimension)

A largura do produto nas unidades fornecidas. O valor precisa estar entre 0 (exclusivo) e 3.000 (inclusive).
productHeight

object (ProductDimension)

A altura do produto nas unidades fornecidas. O valor precisa estar entre 0 (exclusivo) e 3.000 (inclusive).
productHighlights[]

string

Marcadores que descrevem os destaques mais relevantes de um produto.
certifications[]

object (Certification)

Uma lista de certificados reivindicados pelo CSS para o produto em questão.
expirationDate

string (Timestamp format)

Data em que o item deve expirar, conforme especificado no momento da inserção, no formato ISO 8601. A data de validade real é exposta em productstatuses como googleExpirationDate e pode ser anterior se expirationDate estiver muito no futuro. Observação: pode levar mais de dois dias após a data de validade para que o item seja realmente excluído.
includedDestinations[]

string

Lista de destinos que serão incluídos nesta segmentação (corresponde às caixas de seleção marcadas no Merchant Center). Os destinos padrão são sempre incluídos, a menos que sejam fornecidos em excludedDestinations.

Os valores compatíveis são: - css_ads_experiences - css_organic_experiences
excludedDestinations[]

string

A lista de destinos a serem excluídos dessa segmentação (corresponde às caixas de seleção desmarcadas no Merchant Center).

Os valores compatíveis são: - css_ads_experiences - css_organic_experiences
headlineOfferInstallment

object (HeadlineOfferInstallment)

Número e valor das parcelas para pagar um item.
headlineOfferSubscriptionCost

object (HeadlineOfferSubscriptionCost)

Número de períodos (meses ou anos) e valor do pagamento por período para um item com um contrato de assinatura associado.
cppAdsRedirect

string

Permite que os anunciantes substituam o URL do item quando o produto é mostrado no contexto dos anúncios de produtos.
numberOfOffers

string (int64 format)

O número de produtos do CSS.
headlineOfferCondition

string

Condição do item principal.
title

string

Título do item.
description

string

Descrição do item.
brand

string

Atributos relacionados ao produto.[14-36] Marca do item.
mpn

string

Número de peça do fabricante (MPN) do item.
gtin

string

Número global do item comercial (GTIN) do item.
googleProductCategory

string

Categoria do item no Google (consulte a taxonomia de produtos do Google). Ao consultar produtos, esse campo vai conter o valor fornecido pelo usuário. No momento, não é possível recuperar as categorias Google do produto atribuídas automaticamente pela API.
adult

boolean

Definido como "true" se o item for voltado a adultos.
multipack

string (int64 format)

O número de produtos idênticos em um multipack definido pelo comerciante.
isBundle

boolean

Se o item é um pacote definido pelo comerciante. Um pacote é um agrupamento personalizado de diferentes produtos vendidos por um comerciante por um preço único.
ageGroup

string

Idade-alvo do item.
color

string

Cor do item.
gender

string

Gênero do público-alvo do item.
material

string

O material de que o item é feito.
pattern

string

A estampa do item (por exemplo, bolinhas).
size

string

Tamanho do item. Apenas um valor é permitido. Para variantes com tamanhos diferentes, insira um produto separado para cada tamanho com o mesmo valor de itemGroupId (consulte a [definição de tamanho](https://support.google.com/merchants/answer/6324492)).
sizeSystem

string

Sistema em que o tamanho é especificado. Recomendado para itens de vestuário.
itemGroupId

string

Identificador compartilhado por todas as variantes do mesmo produto.
pause

string

A publicação deste item será pausada temporariamente.
customLabel0

string

Rótulo personalizado 0 para agrupamento personalizado de itens em uma campanha do Shopping.
customLabel1

string

Rótulo personalizado 1 para agrupamento personalizado de itens em uma campanha do Shopping.
customLabel2

string

Rótulo personalizado 2 para agrupamento personalizado de itens em uma campanha do Shopping.
customLabel3

string

Rótulo personalizado 3 para agrupamento personalizado de itens em uma campanha do Shopping.
customLabel4

string

Rótulo personalizado 4 para agrupamento personalizado de itens em uma campanha do Shopping.
reviewCount

string (int64 format)

Número de avaliações do produto. Obrigatório se rating for fornecido.
minRating

string (int64 format)

A pontuação mínima de classificação do produto. Obrigatório se rating for fornecido.
maxRating

string (int64 format)

Pontuação máxima de classificação do produto. Obrigatório se rating for fornecido.
rating

number

A classificação média do produto. O valor precisa estar no intervalo de [minRating, maxRating], inclusive. Quando exibida na página do produto, essa classificação é normalizada em uma escala de [1, 5] com uma casa decimal. Se fornecido, reviewCount, minRating e maxRating também serão obrigatórios.

Preço

O preço representado como um número e uma moeda.

Representação JSON 
{
  "amountMicros": string,
  "currencyCode": string
}
Campos
amountMicros

string (int64 format)

O preço representado como um número em micros (1 milhão de micros equivale a uma unidade padrão da moeda, por exemplo, 1 USD = 1.000.000 de micros).
currencyCode

string

A moeda do preço usando siglas de três letras de acordo com a ISO 4217.

ProductDetail

Os detalhes do produto.

Representação JSON 
{
  "sectionName": string,
  "attributeName": string,
  "attributeValue": string
}
Campos
sectionName

string

O cabeçalho da seção usado para agrupar um conjunto de detalhes do produto.
attributeName

string

O nome do detalhe do produto.
attributeValue

string

O valor dos detalhes do produto.

ProductWeight

O peso do produto.

Representação JSON 
{
  "value": number,
  "unit": string
}
Campos
value

number

Obrigatório. O peso representado como um número. A ponderação pode ter uma precisão máxima de quatro casas decimais.
unit

string

Obrigatório. A unidade de peso. Os valores aceitáveis são: * "g" * "kg" * "oz" * "lb"

ProductDimension

A dimensão do produto.

Representação JSON 
{
  "value": number,
  "unit": string
}
Campos
value

number

Obrigatório. O valor da dimensão representado como um número. O valor pode ter uma precisão máxima de quatro casas decimais.
unit

string

Obrigatório. As unidades de dimensão. Os valores aceitáveis são: * "in" * "cm"

Certificação

A certificação do produto. Use esse atributo para descrever certificações associadas a um produto, como classificações de eficiência energética.

Representação JSON 
{
  "name": string,
  "authority": string,
  "code": string
}
Campos
name

string

É o nome da certificação. No momento, o valor mais comum é "EPREL", que representa as certificações de eficiência energética no banco de dados do Registro Europeu de Produtos para a Etiquetagem Energética (EPREL) da UE.
authority

string

O órgão ou a autoridade responsável pela emissão da certificação. No momento, o valor mais comum é "EC" ou "European_Commission" para selos de eficiência energética na UE.
code

string

É o código da certificação. Por exemplo, para o certificado EPREL com o link https://eprel.ec.europa.eu/screen/product/dishwashers2019/123456, o código é 123456. Ele é necessário para os selos de eficiência energética europeus.

HeadlineOfferInstallment

Uma mensagem que representa a parcela.

Representação JSON 
{
  "months": string,
  "amount": {
    object (Price)
  },
  "downpayment": {
    object (Price)
  }
}
Campos
months

string (int64 format)

O número de parcelas que o comprador precisa pagar.
amount

object (Price)

O valor que o comprador tem que pagar por mês.
downpayment

object (Price)

O valor da entrada que o comprador precisa pagar.

HeadlineOfferSubscriptionCost

O SubscriptionCost do produto.

Representação JSON 
{
  "period": enum (SubscriptionPeriod),
  "periodLength": string,
  "amount": {
    object (Price)
  }
}
Campos
period

enum (SubscriptionPeriod)

O tipo de período de assinatura. Os valores compatíveis são: * "month" * "year"
periodLength

string (int64 format)

O número de períodos de assinatura que o comprador precisa pagar.
amount

object (Price)

O valor que o comprador precisa pagar por período de assinatura.

SubscriptionPeriod

O período de assinatura do produto.

Tipos enumerados
SUBSCRIPTION_PERIOD_UNSPECIFIED Indica que o período da assinatura não foi especificado.
MONTH Indica que o período da assinatura é mensal.
YEAR Indica que o período da assinatura é de um ano.

CustomAttribute

Uma mensagem que representa atributos personalizados. Exatamente um dos campos value ou groupValues não pode estar vazio.

Representação JSON 
{
  "groupValues": [
    {
      object (CustomAttribute)
    }
  ],
  "name": string,
  "value": string
}
Campos
groupValues[]

object (CustomAttribute)

Subatributos dentro desse grupo de atributos. Se groupValues não estiver vazio, value precisará estar vazio.
name

string

O nome do atributo.
value

string

O valor do atributo. Se value não estiver vazio, groupValues precisará estar vazio.

CssProductStatus

O status do produto do CSS, problemas de validação de dados, ou seja, informações sobre o produto do CSS calculadas de forma assíncrona.

Representação JSON 
{
  "destinationStatuses": [
    {
      object (DestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ItemLevelIssue)
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string,
  "googleExpirationDate": string
}
Campos
destinationStatuses[]

object (DestinationStatus)

Os destinos pretendidos do produto.
itemLevelIssues[]

object (ItemLevelIssue)

Uma lista de todos os problemas associados ao produto.
creationDate

string (Timestamp format)

Data em que o item foi criado, no formato ISO 8601.
lastUpdateDate

string (Timestamp format)

Data em que o item foi atualizado pela última vez, no formato ISO 8601.
googleExpirationDate

string (Timestamp format)

Data em que o item expira, no formato ISO 8601.

DestinationStatus

O status de destino do status do produto.

Representação JSON 
{
  "destination": string,
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
Campos
destination

string

O nome do destino
approvedCountries[]

string

Lista de códigos de países (ISO 3166-1 alfa-2) em que o produto do CSS foi aprovado.
pendingCountries[]

string

Lista de códigos de países (ISO 3166-1 alfa-2) em que o produto do CSS está com aprovação pendente.
disapprovedCountries[]

string

Lista de códigos de país (ISO 3166-1 alfa-2) em que o produto do CSS foi reprovado.

ItemLevelIssue

O ItemLevelIssue do status do produto.

Representação JSON 
{
  "code": string,
  "servability": string,
  "resolution": string,
  "attribute": string,
  "destination": string,
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
Campos
code

string

O código de erro do problema.
servability

string

Como esse problema afeta a veiculação do produto do CSS.
resolution

string

Se o problema pode ser resolvido pelo comerciante.
attribute

string

O nome do atributo, se o problema for causado por um único atributo
destination

string

O destino a que o problema se aplica.
description

string

Uma descrição resumida do problema em inglês.
detail

string

Uma descrição detalhada do problema em inglês.
documentation

string

O URL de uma página da Web para ajudar a resolver esse problema.
applicableCountries[]

string

Lista de códigos de países (ISO 3166-1 alfa-2) em que o problema se aplica ao produto do CSS.

Métodos

get

 Recupera o produto do CSS processado da sua conta do CSS Center.

list

 Lista os produtos de CSS processados na sua conta do CSS Center.