Migra la administración de promociones

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

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 Content API for Shopping con las Promociones API 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

A continuación, presentamos una comparación de la disponibilidad de métodos de promoción en Content API para Shopping y 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 Información Inventario.

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

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

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

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

El nombre del campo amount cambió del valor 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) 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,
    ]
    }
  ]
}