Migrar o gerenciamento de promoções

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

Solicitações

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

POST https://merchantapi.googleapis.com/promotions/v1beta/{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/{merchantId}/promotions

na API Merchant se torna:

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

Identificadores

Na API Content for Shopping:

{merchantId}/promotions/{promotionId}

na API Merchant se torna:

{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

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

Método API Content for Shopping API Merchant
inserir Sim Sim
get Sim Sim
list Sim Sim
customBatch Não Não
excluir Não (A ser determinado)

Nome do recurso

A tabela mostra o que muda nas Promoções na API Merchant Promotions.

Para ver um exemplo de referência, consulte Inventário local.

API Content for Shopping API Merchant Descrição
(incompatível) custom_attributes Uma lista de atributos personalizados (fornecidos pelo comerciante). Também é possível
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 foram explicitamente
expostos pela API.
Sem suporte data_source Para criar uma promoção, é necessário ter uma fonte de dados.
Sem suporte atributos Os atributos específicos da promoção, como
long_tile, promotion_effective_timeperiod,
e outros, fazem parte da mensagem do atributo.
item_id item_id_inclusion A lista de IDs de itens aos quais uma promoção se aplica
é renomeada.
store_id store_id_inclusion A lista de IDs das lojas a que uma promoção se aplica
é renomeada.
prduct_type product_type_inclusion A lista de tipos de produtos aos quais uma promoção se aplica
é renomeada.
item_group_id item_group_id_inclusion A lista de IDs do grupo de itens aos quais 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 da loja aos quais 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, Price
era um número decimal na forma de uma string.

O valor de Price agora é registrado em micros,
, em que um 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 foi alterado para
currencyCode. O formato continua 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.
Detalhes mais 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,
    ]
    }
  ]
}