Migrar o gerenciamento de promoções

Use a API Merchant Promotions para criar e gerenciar promoções no Google. O recurso accounts.promotions permite que você mostre ofertas especiais para os produtos que 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 ocorre 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 no objeto promotionDataSource no recurso accounts.dataSources, consulte PromotionDataSource.

Fontes de dados atuais

Para fontes de dados atuais, se você não souber seu accounts.dataSources.name, use dataSources.list para recuperá-lo.

Como alternativa, é possível identificar a fonte de dados de cada uma das suas promoções usando o método accounts.promotions.get e inspecionando o campo dataSource na resposta de qualquer promoção na sua conta.

Para se referir a eles diretamente em chamadas de API futuras, recomendamos armazenar o accounts.dataSources.name no banco de dados local para cada promoção.

Solicitações

Para fazer solicitações, use o URL a seguir.

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

Migrar da API Content for Shopping

Veja a seguir uma comparação entre 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, se torna:

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

Identificadores

Na API Content for Shopping:

{MERCHANT_ID}/promotions/{PROMOTION_ID}

na API Merchant, se torna:

{NAME}

Métodos

A API Merchant aceita os seguintes métodos para promoções:

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

Confira uma comparação da disponibilidade dos 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
Identifiers {MERCHANT_ID}/promotions/{PROMOTION_ID} {NAME}
Métodos
  • insert
  • get
  • list
  • customBatch
  • delete
  • insert
  • get
  • list

Alterações de campos

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

Para conferir um exemplo de referência, consulte accounts.promotions.

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
usá-lo 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.
Sem suporte data_source Para criar uma promoção, é necessário ter uma fonte de dados.
Sem suporte atributos Atributos específicos da promoção, por exemplo,
long_tile, promotion_effective_timeperiod,
entre outros, fazem parte da mensagem de 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 códigos de loja a que uma promoção se aplica
foi 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
foi renomeada.
brand brand_inclusion A lista de marcas a que uma promoção se aplica
foi renomeada.
store_code store_codes_inclusion A lista de códigos de loja a que uma promoção se aplica
foi renomeada. 
price:
  {
    object (Price)
  }

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

Na API Content for Shopping, o preço
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 equivale à 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 é aceito.
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 em nível granular 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,
    ]
    }
  ]
}
Anterior
Migrate order tracking signals
Avançar
Migrate conversion sources management