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
El importe de Price ahora se registra en micros,
El nombre del campo amount cambió del valor a
El nombre del campo currency cambió a
|
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, ] } ] } |