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). Ele também pode ser usado 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 não expostos explicitamente pela API, como atributos 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 calculado de forma assíncrona.

Atributos

Atributos para o 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
}
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 do item principal do produto do CSS.

headlineOfferShippingPrice

object (Price)

Preço do item principal do produto do CSS.

productTypes[]

string

Categorias do item (formatadas conforme a especificação dos dados do produto).

sizeTypes[]

string

O corte do item. Ele pode ser usado para representar tipos de tamanhos combinados para itens de vestuário. É possível informar no máximo dois tipos de tamanho (consulte [https://support.google.com/merchants/answer/6324497](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)

A duração 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

Pontos 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 mais cedo se expirationDate estiver muito distante. Observação: pode levar mais de dois dias a partir da data de expiração para que o item seja excluído.

includedDestinations[]

string

Lista de destinos a serem incluídos nessa 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.

excludedDestinations[]

string

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

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 de um item com um contrato de assinatura associado.

cppAdsRedirect

string

Permite que os anunciantes substituam o URL do item quando o produto for 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 de produtos do Google atribuídas automaticamente pela API.

adult

boolean

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

multipack

string (int64 format)

Número de produtos idênticos em um multipack definido pelo comerciante.

isBundle

boolean

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

ageGroup

string

Faixa etária do público-alvo do item.

color

string

Cor do item.

gender

string

Gênero a que o item é voltado.

material

string

Material de que o item é feito.

pattern

string

O padrão 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 itemGroupId (consulte [https://support.google.com/merchants/answer/6324492](definição de tamanho)).

sizeSystem

string

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

itemGroupId

string

Identificador compartilhado para todas as variantes do mesmo produto.

pause

string

A publicação desse item será temporariamente pausada.

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.

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 é equivalente a uma unidade padrão da moeda, por exemplo, 1 USD = 1.000.000 micros).

currencyCode

string

A moeda do preço usando abreviações 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 do detalhe 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. O peso 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 rótulos de energia 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 uma 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 precisa 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 aceitos 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.

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

CustomAttribute

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

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

object (CustomAttribute)

Subatributos dentro deste grupo de atributos. Se groupValues não estiver vazio, value precisa estar vazio.

name

string

O nome do atributo.

value

string

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

CssProductStatus

O status do produto do CSS, problemas de validação de dados, ou seja, informações sobre o produto do CSS computado 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 da última atualização do item, no formato ISO 8601.

googleExpirationDate

string (Timestamp format)

Data de expiração do item, no formato ISO 8601.

DestinationStatus

O status de destino 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 é aprovado.

pendingCountries[]

string

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

disapprovedCountries[]

string

Lista de códigos de países (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 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 breve descrição 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 CSS processado da sua conta do CSS Center.

list

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