Migra la administración de promociones

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

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

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 Merchant API. Para insertar una promoción con la API de Merchant Center, primero debes crear una fuente de datos de promociones. Para obtener información sobre los campos del objeto promotionDataSource en el recurso accounts.dataSources, 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 la Content API for Shopping con la API de Merchant Promotions para las solicitudes relacionadas con las promociones.

URL

En Content API for Shopping, haz lo siguiente:

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, haz lo siguiente:

{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
  • Obtén promociones
  • Enumera las promociones

A continuación, se incluye 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 Es una lista de atributos personalizados (proporcionados por el usuario). También puedes usarlo 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
de forma explícita.
No compatible data_source Para crear una promoción, se requiere una fuente de datos existente.
No compatible atributos 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 tienda a los 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 tienda a los que se aplica una promoción. 
price:
  {
    object (Price)
  }

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

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

El importe del precio ahora 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ó el estado de la promoción.
En los problemas, se encuentran disponibles detalles más específicos. 
promotionStatus = {
  destinationStatuses = [
     {
     reportingContext = Enum
     status = Enum
     },
  ],
  itemLevelIssues = [
    {
    code = String
    severity = Enum
    resolution = String
    reportingContext = Enum
    description = String
    detail = String
    documentation = String applicableCountries = [
      String,
    ]
    }
  ]
}