Migrar o gerenciamento de promoções

Você pode usar a API Merchant Promotions para criar e gerenciar promoções no Google. O accounts.promotions recurso 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 no promotionDataSource objeto no accounts.dataSources recurso, consulte PromotionDataSource.

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

A tabela a seguir compara a API Content for Shopping com 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 oferece suporte aos 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

Mudanças de campo

A tabela mostra as mudanças nas promoções da API Merchant Promotions.

Para conferir um exemplo de referência, consulte Local Inventory.

API Content for Shopping API Merchant Descrição
indisponível custom_attributes Uma lista de atributos personalizados (fornecidos pelo usuário). Também é possível
usá-la 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.
Indisponível data_source A criação de uma promoção exige uma fonte de dados.
Indisponível attributes Atributos específicos da promoção, por exemplo,
long_tile, promotion_effective_timeperiod,
e 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
foi renomeada.
store_id store_id_inclusion A lista de IDs de lojas 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 lojas a que uma promoção se aplica
foi renomeada. 
price:
  {
    object (Price)
  }

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

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

O valor de Price 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 indisponível O atributo order_limit não é compatível.
shippingServiceNames[] indisponível shippingServiceNames[] não é compatível.
money_budget indisponí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,
    ]
    }
  ]
}