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 saperne di più, 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 innanzitutto creare un'origine dati delle promozioni.

Per informazioni sui campi dell'oggetto promotionDataSource nella risorsa accounts.dataSources, consulta PromotionDataSource.

Origini dati esistenti

Per le origini dati esistenti, se non conosci il tuo accounts.dataSources.name, utilizza dataSources.list per recuperarlo.

In alternativa, puoi identificare l'origine dati per ciascuna delle tue promozioni utilizzando il metodo accounts.promotions.get e ispezionando il campo dataSource nella risposta di eventuali promozioni esistenti nel tuo account.

Per fare riferimento direttamente a questi ID nelle chiamate API future, ti consigliamo vivamente di archiviare accounts.dataSources.name nel tuo database locale per ogni promozione.

Richieste

Per effettuare richieste, utilizza il seguente URL.

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

Esegui la migrazione dall'API Content for Shopping

Di seguito viene riportato un confronto tra l'API Content for Shopping e 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

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

Funzionalità API Content per 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

Modifiche dei campi

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

Per un esempio di riferimento, consulta accounts.promotions.

API Content per Shopping API Merchant Descrizione
(non supportata) custom_attributes Un elenco di attributi personalizzati (forniti dall'utente). Puoi
utilizzarlo anche 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 esplicitamente
esposti dall'API.
Non supportata data_source Per creare una promozione è necessaria 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 prodotti 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, Price
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 tua valuta.

Il nome del campo amount è stato modificato da value 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) 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
}
Stato della promozione è cambiato.
Dettagli più granulari 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,
    ]
    }
  ]
}
Indietro
Migrate order tracking signals
Avanti
Migrate conversion sources management