Esegui la migrazione della gestione delle promozioni

Puoi utilizzare l'API Merchant Promotions per creare e gestire le promozioni su in tutti i canali Google. La accounts.promotions ti consente di mostrare offerte speciali per i prodotti che vendi su Google. Per ulteriori informazioni, consulta la Panoramica delle Promozioni tramite Google Cloud.

Richieste

Per effettuare le richieste, utilizza l'URL seguente.

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

Eseguire la migrazione dall'API Content for Shopping

Di seguito mette a confronto l'API Content for Shopping con le promozioni API per le richieste relative alle promozioni.

URL

Nell'API Content for Shopping:

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

nell'API Merchant diventa:

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

Identificatori

Nell'API Content for Shopping:

{merchantId}/promotions/{promotionId}

nell'API Merchant diventa:

{name}

Metodi

L'API Merchant supporta i seguenti metodi per le promozioni:

  • Inserisci promozioni
  • Ricevi promozioni
  • Elenco promozioni

Ecco un confronto della disponibilità dei metodi di promozione nell'API Content per Shopping e l'API Merchant:

Metodo API Content per Shopping API Merchant
inserisci Sì Sì
trova Sì Sì
list Sì Sì
customBatch No No
elimina No (Da stabilire)

Nome risorsa

La tabella mostra le modifiche relative alle promozioni nell'API Merchant Promotions.

Per un esempio di riferimento, consulta la sezione Locale Inventario.

API Content per Shopping API Merchant Descrizione
(non supportata) custom_attributes Un elenco di attributi personalizzati (forniti dal commerciante). Puoi
usalo anche per inviare eventuali attributi del feed
nella sua forma generica.
Ad esempio: 
{
  "name": "size type", "value": "regular"
}
Ciò è utile per inviare attributi non esplicitamente
esposto dall'API.
Non supportata data_source Per creare una promozione è necessaria un'origine dati esistente.
Non supportata attributi Attributi specifici della promozione, ad esempio
long_tile, promotion_effective_timeperiod,
e altri, fanno parte del messaggio dell'attributo.
item_id item_id_inclusion L'elenco di ID articolo a cui si applica una promozione
a è stato rinominato.
store_id store_id_inclusion L'elenco degli ID negozio a cui si applica una promozione
in viene rinominato.
prduct_type product_type_inclusion L'elenco dei tipi di prodotto a cui si applica una promozione
in viene rinominato.
item_group_id item_group_id_inclusion L'elenco di ID gruppo di articoli a cui si applica una promozione
in viene rinominato.
brand brand_inclusion L'elenco di brand a cui si applica una promozione
in viene rinominato.
store_code store_codes_inclusion L'elenco dei codici negozio a cui si applica una promozione
in viene rinominato. 
price: {
  object (Price)
}

price: {
  object (Price)
}
La definizione di Price è cambiata.

Nell'API Content for Shopping, Prezzo
era un numero decimale sotto forma di stringa.

L'importo del Prezzo viene ora registrato in micro,
dove 1 milione di micro è equivalente al valore della valuta
standard.

Il nome del campo amount è cambiato da valore a
amountMicros.

Il nome del campo currency è stato modificato in
currencyCode. Il formato rimane invariato
ISO 4217. (Wikipedia)

order_limit (non supportata) L'attributo order_limit non è supportato.
shippingServiceNames[] (non supportata) L'attributo shippingServiceNames[] non è supportato.
money_budget (non supportata) money_budget non è supportato.
promotion_destination_ids promotion_destinations promotionDestinationIds viene rinominato.
Stato delle promozioni 
{
  "destinationStatuses": [
    {
      "destination": string,
      "status": enum (State)
    }
  ],
  "promotionIssue": [
    {
    "code": string,
    "detail": string
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string
}
Lo stato della promozione è cambiato.
Nei problemi sono disponibili dettagli a livello più dettagliato. 
promotionStatus = {
  destinationStatuses = [
     {
     reportingContext = Enum
     status = Enum
     },
  ],
  itemLevelIssues = [
    {
    code = String
    severity = Enum
    resolution = String
    reportingContext = Enum
    description = String
    detail = String
    documentation = String applicableCountries = [
      String,
    ]
    }
  ]
}