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 por CSS). Também é possível usar 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 para o 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 para produtos 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 alto 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 como na especificação de dados de produtos).
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 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 (inclusivo).
productLength

object (ProductDimension)

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

object (ProductDimension)

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

object (ProductDimension)

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

string

Tópicos que descrevem os destaques mais relevantes de um produto.
certifications[]

object (Certification)

Uma lista de certificados reivindicados pelo CSS para o produto especificado.
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 distante no futuro. Observação: pode levar mais de dois dias a partir da data de validade para que o item seja excluído.
includedDestinations[]

string

A 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.
excludedDestinations[]

string

A 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 a serem pagas por 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 é 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

A 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 há como 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)

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

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

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 [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 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. Este campo é para um recurso futuro e ainda não é usado.
minRating

string (int64 format)

Pontuação mínima da avaliação do produto. Obrigatório se rating for fornecido. Este campo é para um recurso futuro e ainda não é usado.
maxRating

string (int64 format)

Pontuação máxima da avaliação do produto. Obrigatório se rating for fornecido. Este campo é para um recurso futuro e ainda não é usado.
rating

number

É a pontuação média da classificação do produto. O valor precisa estar no intervalo [minRating, maxRating], inclusive. Quando mostrada na página do produto, essa classificação é normalizada para uma escala de [1, 5] com uma casa decimal. Se fornecidos, reviewCount, minRating e maxRating também são obrigatórios. Este campo é para um recurso futuro e ainda não é usado.

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 de micros).
currencyCode

string

É a moeda do preço usando acrônimos 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 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 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 inicial 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.

Tipos enumerados
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 da assinatura é anual.

CustomAttribute

Uma mensagem que representa atributos personalizados. Exatamente um de 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 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 alpha-2) em que o produto do CSS foi aprovado.
pendingCountries[]

string

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

string

Lista de códigos de países (ISO 3166-1 alpha-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 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 do CSS processado da sua conta do CSS Center.

list

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