Migra la administración de promociones

Puedes usar la API de Merchant Promotions para crear y administrar promociones en Google. El accounts.promotions recurso te permite mostrar ofertas especiales para los productos que vendes en Google. Para obtener más información, consulta Descripción general de la API de Merchant Promotions.

Descripción general de los cambios de Content API for Shopping a la API de Merchant

Una diferencia significativa es que Content API for Shopping crea automáticamente la fuente de datos cuando se inserta la primera promoción, lo que no ocurre con la API de Merchant. Para insertar una promoción con la API de Merchant, primero debes crear una fuente de datos de promociones. Para obtener información sobre los campos del objeto promotionDataSource en accounts.dataSources recurso, consulta PromotionDataSource.

Solicitudes

Para realizar solicitudes, usa la siguiente URL.

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

Migra desde Content API for Shopping

A continuación, se compara Content API for Shopping con la API de Merchant Promotions para las solicitudes relacionadas con las promociones.

URL

En Content API for Shopping:

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

en la API de Merchant se convierte en lo siguiente:

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

Identificadores

En Content API for Shopping:

{MERCHANT_ID}/promotions/{PROMOTION_ID}

en la API de Merchant se convierte en lo siguiente:

{NAME}

Métodos

La API de Merchant admite los siguientes métodos para las promociones:

  • Insertar promociones
  • Obtener promociones
  • Mostrar lista de promociones

Esta es una comparación de la disponibilidad de los métodos de promoción en Content API for Shopping y la API de Merchant:

Función Content API for Shopping API de 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

Cambios en los campos

En la tabla, se muestran los cambios en las promociones de la API de Merchant Promotions.

Para ver un ejemplo de referencia, consulta Inventario local.

Content API for Shopping API de Merchant Descripción
(no admitido) custom_attributes Una lista de atributos personalizados (proporcionados por el usuario). También puedes
usarla para enviar cualquier atributo de la especificación del feed
en su forma genérica.
Por ejemplo: 
{
  "name": "size type", "value": "regular"
}
Esto es útil para enviar atributos que la API no expone
explícitamente.
No admitido data_source Para crear una promoción, se requiere una fuente de datos existente.
No admitido attributes Los atributos específicos de la promoción, por ejemplo,
long_tile, promotion_effective_timeperiod,
y otros, forman parte del mensaje del atributo.
item_id item_id_inclusion Se cambió el nombre de la lista de IDs de artículos a los que se aplica una
promoción.
store_id store_id_inclusion Se cambió el nombre de la lista de IDs de tiendas a las que se aplica una promoción.
product_type product_type_inclusion Se cambió el nombre de la lista de tipos de productos a los que se aplica
una promoción.
item_group_id item_group_id_inclusion Se cambió el nombre de la lista de IDs de grupos de artículos a los que se aplica una promoción.
brand brand_inclusion Se cambió el nombre de la lista de marcas a las que se aplica una promoción.
store_code store_codes_inclusion Se cambió el nombre de la lista de códigos de tiendas a las que se aplica
una promoción. 
price:
  {
    object (Price)
  }

price:
  {
    object (Price)
  }
Cambió la definición de Precio.

En Content API for Shopping, Precio
era un número decimal en forma de cadena.

Ahora, el importe del Precio se registra en micros,
donde 1 millón de micros equivale a la unidad estándar de tu
moneda.

El nombre del campo amount cambió de value a
amountMicros.

El nombre del campo currency cambió a
currencyCode. El formato sigue siendo
ISO 4217. (Wikipedia)

order_limit (no admitido) No se admite el atributo order_limit.
shippingServiceNames[] (no admitido) No se admite shippingServiceNames[].
money_budget (no admitido) No se admite money_budget.
promotion_destination_ids promotion_destinations Se cambió el nombre de promotionDestinationIds.
Estado de la promoción 
{
  "destinationStatuses": [
    {
      "destination": string,
      "status": enum (State)
    }
  ],
  "promotionIssue": [
    {
    "code": string,
    "detail": string
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string
}
Cambió elEstado de la promoción.
Encontrarás detalles más específicos en los problemas. 
promotionStatus = {
  destinationStatuses = [
     {
     reportingContext = Enum
     status = Enum
     },
  ],
  itemLevelIssues = [
    {
    code = String
    severity = Enum
    resolution = String
    reportingContext = Enum
    description = String
    detail = String
    documentation = String applicableCountries = [
      String,
    ]
    }
  ]
}