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" } 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
L'importo del Prezzo viene ora registrato in micro,
Il nome del campo amount è cambiato da valore a
Il nome del campo currency è stato modificato in
|
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, ] } ] } |