Migrar o gerenciamento de promoções

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

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

A tabela a seguir compara a API Content for Shopping com as Promoções API 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

Veja uma comparação da disponibilidade dos métodos de promoção na API Content para Shopping e a API Merchant:

Método API Content for Shopping API Merchant
inserir Sim Sim
get Sim Sim
list Sim Sim
customBatch Não Não
delete 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 Local Inventário.

API Content for Shopping API Merchant Descrição
(incompatível) custom_attributes Uma lista de atributos personalizados (fornecidos pelo comerciante). Você pode
use-o para enviar os atributos do feed
específica na forma genérica.
Por exemplo: 
{
  "name": "size type", "value": "regular"
}
Isso é útil para enviar atributos que não são
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, como
long_tile, promotion_effective_timeperiod,
e outros, fazem parte da mensagem do atributo.
item_id item_id_inclusion Lista de IDs de itens aos quais uma promoção se aplica
to foi renomeado.
store_id store_id_inclusion Lista de IDs de loja aos quais uma promoção se aplica
é renomeada.
prduct_type product_type_inclusion A lista de tipos de produto aos quais uma promoção se aplica
é renomeada.
item_group_id item_group_id_inclusion 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 Lista de códigos da loja aos quais uma promoção se aplica
é renomeada. 
price: {
  object (Price)
}

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

Na API Content for Shopping, Preço
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 ao valor da sua moeda
unidade padrão.

O nome do campo amount mudou de value para
amountMicros.

O nome do campo currency foi alterado 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.
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,
    ]
    }
  ]
}