Migra la administración de promociones

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

Solicitudes

Para realizar solicitudes, usa la siguiente URL.

POST https://merchantapi.googleapis.com/promotions/v1beta/{account_name}/promotions

Cómo migrar desde Content API for Shopping

A continuación, se compara la API de Content para Shopping con la API de Promociones para solicitudes relacionadas con promociones.

URL

En Content API for Shopping, haz lo siguiente:

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

en la API de Merchant Center se convierte en lo siguiente:

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

Identificadores

En Content API for Shopping, haz lo siguiente:

{merchantId}/promotions/{promotionId}

en la API de Merchant Center se convierte en lo siguiente:

{name}

Métodos

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

  • Insertar promociones
  • Obtener promociones
  • Mostrar promociones

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

Método Content API for Shopping API de Merchant Center
insertar Sí Sí
get Sí Sí
list Sí Sí
customBatch No No
borrar No (Por determinar)

Nombre del recurso

En la tabla, se muestran los cambios de las Promociones en la API de Merchant Surveys.

Para ver un ejemplo de referencia, consulta Inventario local.

Content API for Shopping API de Merchant Center Descripción
(no admitido) custom_attributes Una lista de atributos personalizados (proporcionados por el comercio). También puedes
usarlo para enviar cualquier atributo de la especificación
del feed en su formato genérico.
Por ejemplo: 
{
  "name": "size type", "value": "regular"
}
Esto es útil para enviar atributos que la API no expone de forma explícita
.
No se permite data_source Para crear una promoción, se necesita una fuente de datos existente.
No se permite atributos Los atributos específicos de la promoción, como
long_tile, promotion_effective_timeperiod,
y otros, son parte del mensaje del atributo.
item_id item_id_inclusion Se cambia el nombre de la lista de IDs de artículos a los que se aplica una promoción
.
store_id store_id_inclusion Se cambia el nombre de la lista de IDs de tienda a los que se aplica una promoción
.
prduct_type product_type_inclusion Se cambia 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 cambia el nombre de la lista de IDs de grupo de artículos a los que se aplica una promoción
.
brand brand_inclusion Se cambia el nombre de la lista de marcas a las que se aplica una promoción
.
store_code store_codes_inclusion Se cambia el nombre de la lista de códigos de tienda a la que se aplica una promoción
. 
price: {
  object (Price)
}

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

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

El importe de Price ahora se registra en micros,
, en el que 1 millón de micros equivale a la unidad estándar
de tu moneda.

El nombre del campo amount cambió del valor a
amountMicros.

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

order_limit (no admitido) No se admite el atributo order_limit.
shippingServiceNames[] (no admitido) shippingServiceNames[] no es compatible.
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.
Hay detalles más detallados disponibles 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,
    ]
    }
  ]
}