Esegui la migrazione della gestione delle promozioni

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

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 l'API delle promozioni 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 for Shopping e nell'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 Inventario locale.

API Content per Shopping API Merchant Descrizione
(non supportata) custom_attributes Un elenco di attributi personalizzati (forniti dal commerciante). Puoi
anche utilizzarlo per inviare qualsiasi attributo della specifica
del feed nella sua forma generica.
Ad esempio: 
{
  "name": "size type", "value": "regular"
}
Questo è utile per inviare attributi non esposti esplicitamente
dall'API.
Non supportata data_source Per creare una promozione è necessaria un'origine dati esistente.
Non supportata attributi Gli 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
viene rinominato.
store_id store_id_inclusion L'elenco degli ID negozio a cui applica una promozione
viene rinominato.
prduct_type product_type_inclusion L'elenco dei tipi di prodotto a cui si applica una promozione
viene rinominato.
item_group_id item_group_id_inclusion L'elenco di ID gruppo di articoli a cui applica una promozione
viene rinominato.
brand brand_inclusion L'elenco di brand a cui si applica una promozione
viene rinominato.
store_code store_codes_inclusion L'elenco dei codici negozio a cui si applica una promozione
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 all'unità standard
della tua valuta.

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

Il nome del campo currency è stato modificato in
currencyCode. Il formato rimane
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 della promozione 
{
  "destinationStatuses": [
    {
      "destination": string,
      "status": enum (State)
    }
  ],
  "promotionIssue": [
    {
    "code": string,
    "detail": string
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string
}
Lo stato delle promozioni è cambiato.
Nei problemi sono disponibili dettagli a livello più granulare. 
promotionStatus = {
  destinationStatuses = [
     {
     reportingContext = Enum
     status = Enum
     },
  ],
  itemLevelIssues = [
    {
    code = String
    severity = Enum
    resolution = String
    reportingContext = Enum
    description = String
    detail = String
    documentation = String applicableCountries = [
      String,
    ]
    }
  ]
}