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 Promozioni.

Panoramica delle modifiche apportate 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, vedi PromotionDataSource.

Richieste

Per effettuare 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:

  • Inserire promozioni
  • Ricevere promozioni
  • Elenco 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
  • delete

Modifiche ai campi

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

Per vedere un esempio di riferimento, consulta Inventario locale.

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 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 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
è stato 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 ora viene registrato in micro,
dove 1 milione di micro equivale all'unità standard
della tua valuta.

Il nome del campo importo è stato modificato 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) 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.
Nei problemi sono disponibili dettagli più granulari. 
promotionStatus = {
  destinationStatuses = [
     {
     reportingContext = Enum
     status = Enum
     },
  ],
  itemLevelIssues = [
    {
    code = String
    severity = Enum
    resolution = String
    reportingContext = Enum
    description = String
    detail = String
    documentation = String applicableCountries = [
      String,
    ]
    }
  ]
}