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 offerte speciali per i prodotti che vendi su Google. Per ulteriori informazioni, consulta la panoramica dell'API Merchant Promotions.

Panoramica delle modifiche dall'API Content for Shopping all'API Merchant

Una differenza significativa è che l'API Content for Shopping crea automaticamente l'origine dati al primo inserimento della promozione, cosa che non avviene con l'API Merchant. Per inserire una promozione utilizzando l'API Merchant, devi prima devi creare un'origine dati delle promozioni. Per informazioni sui campi dell'oggetto promotionDataSource nella risorsa accounts.dataSources, consulta PromotionDataSource.

Richieste

Per effettuare le richieste, utilizza il seguente URL.

POST https://merchantapi.googleapis.com/promotions/v1/{ACCOUNT_NAME}/promotions

Eseguire la migrazione dall'API Content for Shopping

Di seguito viene confrontata l'API Content for Shopping con l'API Merchant Promotions per le richieste relative alle promozioni.

URL

Nell'API Content for Shopping:

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

nell'API Merchant diventa:

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

Identificatori

Nell'API Content for Shopping:

{MERCHANT_ID}/promotions/{PROMOTION_ID}

nell'API Merchant diventa:

{NAME}

Metodi

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

  • Inserisci promozioni
  • Ottieni promozioni
  • Elenca promozioni

Di seguito è riportato un confronto della disponibilità dei metodi di promozione nell'API Content for Shopping e nell'API Merchant:

Funzionalità API Content for Shopping API Merchant
URL https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/promotions https://merchantapi.googleapis.com/promotions/v1/{parent=accounts/*}/promotions
Identificatori {MERCHANT_ID}/promotions/{PROMOTION_ID} {NAME}
Metodi
  • insert
  • get
  • list
  • customBatch
  • delete
  • insert
  • get
  • list
  • delete

Modifiche dei campi

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

Per vedere un esempio di riferimento, consulta Local Inventory.

API Content for Shopping API Merchant Descrizione
(non supportata) custom_attributes Un elenco di attributi personalizzati (forniti dall'utente). Puoi
anche utilizzarlo per inviare qualsiasi attributo della specifica del feed
nella sua forma generica.
Ad esempio: 
{
  "name": "size type", "value": "regular"
}
Questa opzione è utile per inviare attributi non esplicitamente
esposti dall'API.
Non supportata data_source La creazione di una promozione richiede un'origine dati esistente.
Non supportata attributes 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 degli ID articolo a cui si applica una promozione viene rinominato.
store_id store_id_inclusion L'elenco degli ID negozio a cui si applica una promozione viene rinominato.
product_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 degli ID gruppo di articoli a cui si applica
una promozione viene rinominato.
brand brand_inclusion L'elenco dei 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 Prezzo è 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 equivale all'unità standard della valuta.

Il nome del campo amount è stato modificato da value a
amountMicros.

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

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