Migrar o gerenciamento de promoções

Você pode usar a API Merchant Promotions para criar e gerenciar promoções no Google. O recurso accounts.promotions permite mostrar ofertas especiais dos produtos que você vende no Google. Para mais informações, consulte Visão geral da API Merchant Promotions.

Visão geral das mudanças da API Content for Shopping para a API Merchant

Uma diferença significativa é que a API Content for Shopping cria automaticamente a fonte de dados na primeira inserção de promoção, o que não acontece com a API Merchant. Para inserir uma promoção usando a API Merchant, primeiro é necessário criar uma fonte de dados de promoções. Para informações sobre os campos do objeto promotionDataSource no recurso accounts.dataSources, consulte PromotionDataSource.

Solicitações

Para fazer solicitações, use o seguinte URL.

POST https://merchantapi.googleapis.com/promotions/v1/{ACCOUNT_NAME}/promotions

Migrar da API Content for Shopping

A comparação a seguir mostra a API Content for Shopping e a API Merchant Promotions para solicitações relacionadas a promoções.

URL

Na API Content for Shopping:

https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/promotions

na API Merchant passa a ser:

https://merchantapi.googleapis.com/promotions/v1/{parent=accounts/*}/promotions

Identificadores

Na API Content for Shopping:

{MERCHANT_ID}/promotions/{PROMOTION_ID}

na API Merchant passa a ser:

{NAME}

Métodos

A API Merchant é compatível com os seguintes métodos para promoções:

  • Inserir promoções
  • Receber promoções
  • Listar promoções

Confira uma comparação da disponibilidade de métodos de promoção na API Content for Shopping e na API Merchant:

Recurso API Content for Shopping API Merchant
URL https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/promotions https://merchantapi.googleapis.com/promotions/v1/{parent=accounts/*}/promotions
Identificadores {MERCHANT_ID}/promotions/{PROMOTION_ID} {NAME}
Métodos
  • insert
  • get
  • list
  • customBatch
  • delete
  • insert
  • get
  • list
  • delete

Alterações de campos

A tabela mostra o que muda para as promoções na API Merchant Promotions.

Para conferir um exemplo, consulte Inventário local.

API Content for Shopping API Merchant Descrição
(incompatível) custom_attributes Uma lista de atributos personalizados (fornecidos pelo usuário). Você também pode
usar esse atributo para enviar qualquer especificação
do feed no formato genérico.
Por exemplo: 
{
  "name": "size type", "value": "regular"
}
Isso é útil para enviar atributos não
expostos explicitamente pela API.
Sem suporte data_source Para criar uma promoção, é preciso ter uma fonte de dados.
Sem suporte atributos Atributos específicos da promoção, por exemplo,
long_tile, promotion_effective_timeperiod,
e outros, fazem parte da mensagem do atributo.
item_id item_id_inclusion A lista de IDs de itens a que uma promoção se aplica
é renomeada.
store_id store_id_inclusion A lista de IDs de loja a que uma promoção se aplica
é renomeada.
product_type product_type_inclusion A lista de tipos de produtos a que uma promoção se aplica
foi renomeada.
item_group_id item_group_id_inclusion A lista de IDs de grupos de itens a que uma promoção se aplica
é renomeada.
brand brand_inclusion A lista de marcas a que uma promoção se aplica
é renomeada.
store_code store_codes_inclusion A lista de códigos de loja a que uma promoção se aplica
é renomeada. 
price:
  {
    object (Price)
  }

price:
  {
    object (Price)
  }
A definição de Preço mudou.

Na API Content for Shopping, Price
era um número decimal na forma de uma string.

O valor do preço agora é registrado em micros,
, em que 1 milhão de micros é equivalente à unidade padrão
da sua moeda.

O nome do campo amount mudou de value para
amountMicros.

O nome do campo currency mudou para
currencyCode. O formato permanece como
ISO 4217. (Wikipédia)

order_limit (incompatível) O atributo order_limit não é compatível.
shippingServiceNames[] (incompatível) shippingServiceNames[] não é compatível.
money_budget (incompatível) money_budget não é compatível.
promotion_destination_ids promotion_destinations promotionDestinationIds foi renomeado.
Status da promoção 
{
  "destinationStatuses": [
    {
      "destination": string,
      "status": enum (State)
    }
  ],
  "promotionIssue": [
    {
    "code": string,
    "detail": string
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string
}
O status da promoção mudou.
Mais detalhes granulares estão disponíveis nos problemas. 
promotionStatus = {
  destinationStatuses = [
     {
     reportingContext = Enum
     status = Enum
     },
  ],
  itemLevelIssues = [
    {
    code = String
    severity = Enum
    resolution = String
    reportingContext = Enum
    description = String
    detail = String
    documentation = String applicableCountries = [
      String,
    ]
    }
  ]
}