20 maggio 2024
Servizio prodotti
Aggiunto LoyaltyPrograms
. Questo aggiornamento ti consente di fornire più livelli con diversi punti fedeltà, prezzi e così via per un singolo prodotto.
Dovresti utilizzare questo campo al posto del campo singolare LoyaltyProgram
.
Servizio di report
Metriche di Acquista su Google deprecate nella tabella MerchantPerformanceView
. Dopo questo aggiornamento, se recuperate qualsiasi metrica di Acquista su Google verrà restituito un valore pari a 0. Questo vale anche per i valori storici per date passate.
Per saperne di più, consulta la sezione Ritiro di Acquista su Google.
13 maggio 2024
Servizio prodotti
Risorsa del prodotto
Modifiche al campo delle certificazioni: è stato aggiunto
certificationValue
al campo
ProductCertification
per fornire un valore della certificazione (chiamato anche corso, livello o voto),
che consente agli utenti di caricare
informazioni sulla certificazione
anche se l'autorità di certificazione non rilascia codice o numero di certificazione.
Per ulteriori informazioni, consulta le nostre guide ai prodotti.
6 maggio 2024
Servizio di report
Aggiunto bucket di efficacia alla tabella PriceInsightsProductView
.
L'efficacia indica quali prodotti trarrebbero vantaggio dalle variazioni di prezzo. Questa valutazione tiene conto dell'incremento del rendimento previsto modificando il prezzo scontato e la differenza tra il prezzo attuale e quello suggerito.
24 aprile 2024
Servizio prodotti
Risorsa del prodotto
Sono stati aggiunti i campi facoltativi downpayment
e creditType
per i Pagamenti rateali:
downpayment
indica l'importo che l'acquirente deve pagare in anticipo con un pagamento una tantum.creditType
indica il tipo di pagamento rateale (finance
olease
). Questo campo è applicabile solo agli annunci di veicoli.
11 aprile 2024
Servizio prodotti
Risorsa del prodotto
- Aggiunto l'attributo soglia di spedizione gratuita (
FreeShippingThreshold
) per la spedizione a livello di offerta. Questo attributo consente ai commercianti di inserire un prezzo minimo del prodotto affinché il costo di spedizione diventi senza costi. - È stata modificata la visibilità di
LoyaltyPoints
10 aprile 2024
Servizio prodotti
Risorsa del prodotto
Hai aggiunto LoyaltyProgram
9 aprile 2024
Servizio prodotti
Risorsa del prodotto
Sono stati aggiunti structuredTitle
e structuredDescription
per fornire titoli e descrizioni dei prodotti creati con l'IA.
3 aprile 2024
Servizio di assistenza ai commercianti
È stato aggiunto il campo user_input_action_option
che consente ai partner di richiedere un nuovo
tipo di azione: BuiltInUserInputAction
. Questa azione consente ai partner di creare
funzionalità self-service complesse per i commercianti, direttamente nella loro applicazione
invece di reindirizzarli a Merchant Center.
È stato aggiunto un nuovo metodo TriggerAction
per BuiltInUserInputAction
. Per accedere a questo metodo, invia una richiesta tramite questo modulo.
27 marzo 2024
Servizio prodotti
Risorsa del prodotto
È stato aggiunto AutoPricingMinPrice
come salvaguardia nei progetti "Sconti automatici" e "Promozioni dinamiche", affinché gli sconti sulle offerte dei commercianti non riducano il prezzo del prodotto a un valore inferiore a questo valore. Ciò consente di preservare il valore
e la redditività dell'offerta.
15 marzo 2024
Sunset Acquista su Google per la rete di ricerca e Shopping. Puoi continuare a visualizzare gli ordini esistenti fino al 31 ottobre 2024 utilizzando orders.list
e orders.get
.
8 marzo 2024
Servizio di report
Il report TopicTrendsView
è stato aggiunto al servizio Reports
.
Per ulteriori informazioni, consulta le nostre Guide ai report.
6 marzo 2024
Servizio di report
Aggiunti bucket sul potenziale in termini di clic e ranking per i prodotti.
Per ulteriori informazioni, consulta le nostre Guide ai report.
19 febbraio 2024
Servizio ConversionSources
Sono stati rimossi i seguenti valori come origini conversione valide:
CROSS_CHANNEL_FIRST_CLICK
CROSS_CHANNEL_LINEAR
CROSS_CHANNEL_POSITION_BASED
CROSS_CHANNEL_TIME_DECAY
Sono state rimosse le opzioni 60 e 90 come giorni della finestra temporale e sono state aggiunte 40 come opzione valida.
17 gennaio 2024
Servizio POS
Sono stati aggiunti nuovi valori per il campo matching_status_hint
in PosStore, che consentono agli utenti di avere maggiori dettagli sul motivo per cui la corrispondenza del negozio non è riuscita.
11 gennaio 2024
Servizio account
Sono stati aggiunti localProductManager
e localProductManagement
come tipo di collegamento e
servizio rispettivamente per il metodo link
. che consentono di collegare gli account
al fine di gestire i dati di prodotto locali.
29 novembre 2023
Servizio di assistenza ai commercianti
È stato aggiunto VERIFY_IDENTITY_IN_MERCHANT_CENTER
tipo di azione esterna per la verifica
dell'identità che deve essere eseguita in Merchant Center.
Servizio POS
Sono stati aggiunti i campi matching_status
e matching_status_hint
a PosStore per consentire agli utenti di conoscere lo stato di corrispondenza del negozio con Profilo dell'attività su Google e un suggerimento da risolvere in caso di problemi.
15 novembre 2023
Gli endpoint repricingrules
e repricingrules.repricingreports
non sono più supportati.
1° novembre 2023
Servizio Impostazioni di spedizione
shipment_type=pickup
non è più supportato.
18 ottobre 2023
Servizio account
Aggiunto campo Business Identity
che consente ai commercianti di identificarsi in base a
determinati valori dei consumatori.
10 ottobre 2023
Collection Point
aggiunto come nuovo tipo di spedizione del servizio per le impostazioni di spedizione. La consegna a un punto di ritiro è un servizio fornito da una terza parte (ad es. non di proprietà del commerciante) per consegnare l'articolo a una località affiliata di terze parti (come i punti di accesso UPS), invece di consegnarlo direttamente a casa.
18 settembre 2023
Servizio per le impostazioni degli annunci di inventario locale
È stato aggiunto il metodo setOmnichannelExperience
per consentire agli utenti di impostare la propria esperienza omnicanale (ovvero vetrina locale e impostazioni di ritiro). Al momento, questa opzione è disponibile solo per gli utenti il cui fornitore POS è autorizzato ad abilitare queste impostazioni.
7 settembre 2023
Ritiro di Acquista su Google
Aggiunta di un nuovo stato DEPRECATED
al metodo GetBuyOnGoogleProgramStastus
.
Non è possibile riattivare o mettere in pausa il programma da uno stato di questo tipo.
4 settembre 2023
Servizio di assistenza ai commercianti
È stata aggiunta un'azione integrata FIX_ACCOUNT_ISSUE
per i problemi del prodotto che devono essere risolti a livello di account. È stata aggiunta un'azione integrata SHOW_ADDITIONAL_CONTENT
che verrà utilizzata per fornire una giustificazione da parte di un'autorità nazionale.
28 agosto 2023
Servizio Promozioni
Apri il metodo list
nel servizio Promotions
dall'accesso limitato a tutti.
22 agosto 2023
Servizio di assistenza ai commercianti
Lanciato il servizio di assistenza per i commercianti. Questo servizio fornisce contenuti di assistenza per problemi relativi all'account e ai prodotti.
4 agosto 2023
Servizio di report
Aggiunto il report sullo scenario competitivo con i concorrenti ravvicinati al servizio Report.
Per ulteriori informazioni, consulta le nostre Guide ai report.
25 luglio 2023
Servizio POS
Risorsa di inventario
Aggiungi i campi pickup_method
e pickup_sla
per consentire ai commercianti
di inviare informazioni sul ritiro insieme all'inventario.
14 luglio 2023
Servizio di report
Sono stati aggiunti i report sullo scenario competitivo per i report.
Per ulteriori informazioni, consulta le nostre Guide ai report.
7 luglio 2023
Servizio prodotti
Risorsa del prodotto
È stato aggiunto virtualModelLink
per fornire gli URL dell'immagine del modello 3D.
4 luglio 2023
Servizio prodotti
Risorsa del prodotto
Aggiungi il campo certifications
per fornire le certificazioni di prodotto, ad esempio per l'etichettatura dell'efficienza energetica dei prodotti in base al database EPREL dell'UE.
26 giugno 2023
Servizio Impostazioni di spedizione
Distribuzione locale
È stato aggiunto il campo no_delivery_post_cutoff
per consentire ai commercianti di disattivare la visualizzazione della consegna locale in più giorni se hanno un servizio di spedizione configurato sulla consegna locale in n giorni.
29 maggio 2023
Servizio Promozioni
Metodo list
aggiunto per il servizio Promotions
.
Servizio suggerimenti
Abilita l'ignoramento dell'interazione nel metodo ReportInteraction
del
servizio di suggerimenti.
9 maggio 2023
Destinazione per la vendita al dettaglio Cloud
Proprietà aggiuntive Cloud Retail
Aggiungi il campo delle proprietà aggiuntive per la vendita al dettaglio di Cloud. Si tratta di un campo ripetuto pensato per essere utilizzato dai clienti che utilizzano la destinazione Cloud Retail. Quando questo campo viene utilizzato, sarà disponibile quando si utilizza il programma cloud per la vendita al dettaglio. Verrà mappato al campo degli attributi nel modello del prodotto Google Cloud per la vendita al dettaglio.
22 maggio 2023
Servizio Promozioni
Metodo list
aggiunto per il servizio Promotions
.
11 aprile 2023
Servizio Impostazioni di spedizione
Distribuzione locale
È stata aggiunta l'opzione per l'evasione della consegna locale per i commercianti che hanno creato una nuova impostazione di spedizione. Può configurare le impostazioni per i negozi locali nel nuovo campo storeConfig
. Sono inclusi il raggio del servizio, l'orario limite e i codici negozio per i negozi che offrono la consegna locale.
3 aprile
Servizio suggerimenti
Lanciato il servizio Recommendations. Questo servizio fornisce suggerimenti su come migliorare le prestazioni del tuo account commerciante e ti consente di registrare i clic dei commercianti su consigli utili.
20 feb 2023
Servizio account
Risorsa dell'account
È stata aggiunta una nuova sezione Account.ConversionSettings nella risorsa Accounts.
Servizio ConversionSources
Aggiunto il servizio Origini conversione, che supporta la gestione delle origini conversione (parte della sezione Impostazioni conversioni in Merchant Center).
16 feb 2023
Servizio Impostazioni di spedizione
Convalida del codice negozio
Ora i codici negozio vengono convalidati per verificare che appartengano al commerciante prima dell'aggiornamento delle impostazioni di spedizione.
Convalida degli annunci di inventario locale (LIA) da parte dei commercianti
I programmi a cui è registrato un ID commerciante vengono ora convalidati prima dell'aggiornamento delle impostazioni di spedizione. I commercianti devono partecipare a uno dei seguenti programmi:
LOCAL_INVENTORY_ON_SURFACES_ACROSS_GOOGLE
LOCAL_INVENTORY_ADS
9 febbraio 2023
Servizio Promozioni
Espandi il servizio Promozioni ad altre 6 opzioni di targetCountry
con assistenza locale per contentLanguage
:
BR
ES
NL
JP
IT
KR
12 gen 2023
Servizio prodotti
Risorsa del prodotto
È stato aggiunto lifestyleImageLinks
per fornire URL di immagini lifestyle.
24 novembre 2022
Servizio promozione
È stato aggiunto un nuovo campo "promotionStatus" nella sezione Promotions.PromotionStatus. Questo è un campo di sola lettura.
15 novembre 2022
Servizio di report
Sono stati aggiunti report di Market Insights al servizio Report.
Ora puoi eseguire query sul servizio Reports per i seguenti elementi:
- Report Più venduti utilizzando le tabelle
BestSellersProductClusterView
eBestSellersBrandView
. - Report sulla competitività del prezzo utilizzando la tabella
PriceCompetitivenessProductView
. - Il report Approfondimenti sul prezzo
utilizzando la tabella
PriceInsightsProductView
.
Per ulteriori informazioni, consulta le nostre Guide ai report.
7 novembre 2022
Servizio Datafeeds
Aggiunto il supporto feedLabel
per il servizio Datafeeds.
14 set 2022
Aggiornato
feedLabel
per accettare qualsiasi stringa.
9 agosto 2022
Aggiunto feedLabel
per i prodotti.
Ora puoi utilizzare feedLabel
anziché targetCountry
per specificare il paese per gli ID offerta. Gli ID offerta ora vengono creati come online:language:feedLabel:offerId
.
feedLabel
è stato compilato automaticamente con il valore targetCountry
per i feed esistenti per la compatibilità con le versioni precedenti.
Deprecato targetCountry
.
Per supportare le offerte globali, l'API Content for Shopping ha ritirato il campo targetCountry
. Ti consigliamo invece di utilizzare il campo shipping
per specificare i paesi di destinazione.
targetCountry
viene ora compilato automaticamente con il valore che fornisci in
feedLabel
.
Per maggiori dettagli, consulta il post del blog L'etichetta del feed sostituisce il paese di destinazione nell'API Content for Shopping.
8 dic 2021
Servizio account
Risorsa dell'account
È stata aggiunta una nuova sezione Account.AutomaticImprovements nella risorsa Accounts.
Questa nuova sezione consentirà ai commercianti di aggiornare automaticamente gli articoli e di migliorare le immagini e le impostazioni di spedizione.
25 ottobre 2021
Servizio promozione
Aggiunta di Get Promotion all'API Promotion.
11 ottobre 2021
API Shipping Settings
È stato aggiunto un nuovo campo warehouse
nella risorsa ShippingSettings
per consentire ai commercianti di gestire i warehouse che possono essere utilizzati in
WarehouseBasedDeliveryTime.
Aggiungi un nuovo campo warehouseName
in
WarehouseBasedDeliveryTime
per fare riferimento a
warehouse in base
al nome del magazzino.
4 ott 2021
Servizio account
Risorsa dell'account
È stato aggiunto un nuovo campo "phone_verification_status" nella sezione Accounts.BusinessInformation. Questo è un campo di sola lettura, impostato da Accounts.VerifyPhoneNumber
13 set 2021
Servizio AcquistaOnGooglePrograms
Risorsa BuyOnGoogleProgramStatus
Sono stati aggiunti nuovi campi nel report delle risorse BuyOnGooglePrograms.BuyOnProgramStatus: canali di vendita online, modelli di business e telefono dell'assistenza clienti.
Nuovo metodo UpdateBuyOnGoogleProgramStatus
È stato aggiunto un nuovo metodo UpdateBuyOnGoogleProgramStatus che consente di aggiornare la risorsa BuyOnGooglePrograms.BuyOnProgramStatus estesa.
6 set 2021
Servizio account
Risorsa dell'account
È stato aggiunto un nuovo campo "korean_business_enroll_number" nella sezione Accounts.BusinessInformation. Questo campo viene cancellato solo se è impostato esplicitamente su una stringa vuota.
30 agosto 2021
Servizio promozione
È stato aggiunto un nuovo servizio promozionale con l'opzione Inserisci promozione disponibile.
Servizio ordini
È stato aggiunto un nuovo metodo orders/captureOrder
per acquisire i fondi prima della spedizione.
Motivo dell'annullamento del nuovo ordine: FAILED_TO_CAPTURE_FUNDS
Servizio prodotti
Risorsa del prodotto
Sono stati aggiunti productLength
, productHeight
, productWidth
e productWeight
per
fornire dimensioni e peso dei prodotti.
9 ago 2021
Servizio RepricingRule
Tipo di regola di ricalcolo dei prezzi
Nuovo valore enum per il campo RepricingRuleType
.
TYPE_SALES_VOLUME_BASED
e TYPE_COMPETITIVE_PRICE
aggiunti.
17 maggio 2021
Servizio etichette di reso dell'ordine
È stato aggiunto un nuovo campo "product_id" in CreateReturnRequest. I commercianti possono specificare product_id o line_item_id per identificare l'articolo da restituire.
Servizio prodotti
È stato aggiunto un nuovo metodo per aggiornare i prodotti esistenti. Puoi aggiornare un prodotto fornendo solo i campi che devono essere aggiornati, anziché l'intero prodotto.
3 maggio 2021
Servizio etichette di reso dell'ordine
Sono stati aggiunti nuovi metodi per caricare le etichette per i resi gestiti dal commerciante (MMR). Con il
nuovo orderreturns.labels.create
, puoi caricare le etichette di reso per condividerle
con il cliente.
26 aprile 2021
API Shipping Settings
Nuovo campo warehouseBasedDeliveryTimes
in
DeliveryTime
per supportare i servizi di spedizione nel calcolo della data di consegna stimata in base
alla località del magazzino e al servizio di corriere scelto.
Nuovo campo eddServices
nell'oggetto CarriersCarrier per restituire i nomi dei servizi applicabili per il calcolo della data di consegna stimata.
12 aprile 2021
Servizio prodotti
Risorsa del prodotto
Nuovo campo additionalSizeType
per supportare fino a due tipi di taglia per prodotto.
Modifiche al campo Spedizione: sono stati aggiunti minHandlingTime
, maxHandlingTime
, minTransitTime
e maxTransitTime
a ProductShipping
per fornire la velocità di spedizione a livello di offerta.
28 gennaio 2021
Servizio account
È stato aggiunto il supporto delle etichette automatiche a AccountLabel
e Account
risorse. Per
ulteriori informazioni, consulta la sezione Tipi di etichette CSS nella
guida alla gestione delle etichette CSS.
5 ottobre 2020
Servizio CSSES
Risorsa CSS
È stato aggiunto un nuovo servizio csses
per recuperare informazioni sui domini CSS e assegnare loro etichette. La risorsa AccountLabel
può ora essere utilizzata anche per
creare e elencare le etichette a livello di gruppo di CSS. Per ulteriori informazioni, consulta Gestione delle etichette CSS.
24 agosto 2020
Servizio prodotti
Risorsa prodotti
Nuovo campo shoppingAdsExcludedCountries
per escludere le offerte dalla pubblicità in determinati paesi.
Risorsa Productstatuses
Nuovi campi approvedCountries
, pendingCountries
e disapprovedCountries
nell'oggetto destinationStatuses
che forniscono informazioni sullo stato dell'offerta oltre il giorno targetCountry
.
Nuovo campo itemLevelIssues.applicableCountries
.
10 agosto 2020
Servizio account
È stata aggiunta una nuova risorsa AccountLabel
per la gestione delle etichette dell'account Merchant Center per CSS Center. Gli utenti di CSS Center possono ora anche elencare i propri account Merchant Center
e assegnare loro etichette con i metodi accounts.list
, accounts.get
e
accounts.updatelabels
. Per maggiori informazioni, consulta Gestione
delle etichette CSS.
19 giugno 2020
Servizio prodotti
Risorsa del prodotto
Nuovi campi
Nuovi campi productDetails
, productHighlights
, subscriptionCost
e
canonicalLink
.
2 giugno 2020
Servizio ordini
Sono stati aggiunti nuovi metodi per avviare rimborsi senza resi. Con i nuovi
orders.refunditem
e orders.refundorder
, puoi avviare rimborsi per gli ordini
anche se non sono stati restituiti dal cliente.
27 aprile 2020
Servizio Orderreturns
Sono stati aggiunti i nuovi metodi acknowledge
e process
, nonché nuovi filtri e campi per
i metodi di lettura (list
, get
).
Collegamento a GMB
È stata aggiunta la possibilità di collegare gli account Merchant Center a un account GMB utilizzando l'ID account GMB.
14 aprile 2020
API per i rapporti sulle transazioni
È stato aggiunto un nuovo servizio per ricevere i report sui pagamenti.
9 marzo 2020
API Local Inventory
È stato aggiunto un nuovo servizio per l'invio dei dati dell'inventario locale.
2 marzo 2020
API Pub/Sub notifiche impostazioni
È stato aggiunto un nuovo servizio per la gestione delle impostazioni delle notifiche Pub/Sub.
3 dicembre 2019
Servizio prodotti
Aggiunto il supporto per i feed supplementari di Content API degli account multi-cliente.
11 settembre 2019
Servizio ordini
Aggiunto il supporto per le spedizioni con ritiro negli ordini e le corrispondenti funzionalità sandbox.
14 agosto 2019
Nuovi servizi
Sono stati aggiunti nuovi servizi relativi alle norme sui resi e all'indirizzo di reso per Acquista su Google.
Servizio ordini
Risorsa dell'ordine
Nuovo campo
Nuovo campo quantityUndeliverable
.
7 agosto 2019
Servizio ordini
Risorsa dell'ordine
Nuovi campi
Sono stati aggiunti nuovi campi loyaltyInfo
e invoiceReceivingEmail
alla risorsa dell'ordine.
1 luglio 2019
Servizio prodotti
Supporto di feed supplementari di Content API aggiunti al servizio Prodotti.
11 giugno 2019
Servizio ordini
Risorse su Order and TestOrder
Aggiunta dell'aggiustamento del prezzo
È stato aggiunto un nuovo campo lineItem[].adjustments
che contiene l'aggiustamento del prezzo e delle tasse dell'elemento pubblicitario originali causato dall'applicazione delle promozioni.
14 febbraio 2019
Modifiche introdotte in questa versione
Le prove non sono più supportate
Il parametro dryRun
è stato rimosso dalla versione 2.1. Questo vale per tutte le chiamate
API.
Metodi patch non più supportati
I seguenti servizi non supportano più il metodo patch
:
- Account
- Imposte
- Feed di dati
- Impostazioni Lia
- Impostazioni di spedizione
Rimozione dei metodi BATCH HTTP
Tutti i metodi HTTP BATCH
sono stati rimossi dalla versione 2.1. Usa invece il criterio customBatch
.
I servizi interessati sono i seguenti:
- Account
- Stati dell'account
- Feed di dati
- Stati del feed di dati
- Impostazioni Lia
- Report sugli ordini
- Pos.
- Prodotti
- Stati del prodotto
- Impostazioni di spedizione
Servizio account
Aggiornamento
I campi businessInformation
e googleMyBusinessLink
nella richiesta sono stati
introdotti dopo il lancio iniziale dell'API Content v2. Per questo motivo, viene applicata una protezione che impedisce ai commercianti di eliminare involontariamente le informazioni in questi due campi con update
, se non vengono fornite.
Nella versione 2, i commercianti devono fornire esplicitamente questi campi con un corpo vuoto ( {}
) per eliminarli. Nella versione 2.1, i campi vengono eliminati se si fornisce un corpo vuoto o se non li fornisci.
Risorsa dell'account
AdWords -> rebranding di Google Ads
Con AdWords che diventa Google Ads, i seguenti campi relativi ad AdWords sono stati rinominati:
adwordsLinks
->adsLinks
adwordsLinks.adwordsId
->adsLinks.adsId
Rimozione di campi e valori deprecati
Il campo obsoleto reviewsUrl
è stato rimosso. Inoltre, lo stato del collegamento inactive
è stato rimosso per adsLinks
, googleMyBusinessLink
e youtubeChannelLinks
.
Servizio Accountstatuses
Risorsa AccountStatus
Rimozione dei problemi di qualità dei dati
Questi valori sono stati sostituiti da itemLevelIssues
.
Servizio feed dati
Risorsa feed di dati
Rimozione dei campi deprecati
I campi contentLanguage
, targetCountry
e intendedDestinations
sono stati
rimossi e sostituiti da country
, language
, includedDestinations
e
excludedDestinations
in targets
.
Rimozione dell'aggiornamento dell'inventario dei prodotti
I feed di tipo product inventory update
sono stati rimossi.
Servizio di inventario
La versione 2 del servizio inventory
è stata rimossa e sostituita da due nuove funzionalità nella versione 2.1:
- Utilizza i nuovi feed supplementari per gli aggiornamenti parziali dei prodotti.
- Utilizza il nuovo servizio
localinventory
per gli aggiornamenti dei prodotti locali.
Servizio ordini
CancelLineItem
I campi amount
, amountPretax
e amountTax
nella richiesta sono stati
rimossi. L'importo rimborsato viene ora calcolato automaticamente.
CustomBatch
CustomBatch
è stato rimosso dalla versione 2.1.
InStoreRefundLineItem
I campi amountPretax
e amountTax
sono stati sostituiti rispettivamente da priceAmount
e taxAmount
. Il campo priceAmount
potrebbe essere al lordo delle imposte o al netto delle imposte, a seconda della località dell'ordine.
Rimborso
Questo metodo è stato rimosso. Usa invece il criterio returnRefundLineItem
.
ReturnLineItem
Questo metodo è stato rimosso. Utilizza invece returnRefundLineItem
senza fornire
un importo del rimborso.
ReturnRefundLineItem
I campi amountPretax
e amountTax
sono stati sostituiti rispettivamente da priceAmount
e taxAmount
. Il campo priceAmount
potrebbe essere al lordo delle imposte o al netto delle imposte, a seconda della località dell'ordine.
ShipLineItem
I campi carrier
, shipmentId
e trackingId
della richiesta sono stati spostati in shipmentInfos
.
Risorse su Order and TestOrder
Nuovo formato promozionale
È disponibile un nuovo formato di promozione nella versione 2.1. Non puoi creare ordini di prova con le promozioni.
Rimozione dei campi deprecati
Il campo paymentMethod
è stato rimosso e billingAddress
e predefinedBillingAddress
ora sono campi di primo livello rispettivamente in Order
e TestOrder
.
Inoltre, customer.explicitMarketingPreference
è stato rimosso e sostituito da customer.marketingRightsInfo
sia in Order
che in TestOrder
.
Il campo obsoleto customer.email
è stato rimosso.
Il formato del campo promotions
è stato modificato nella risorsa Order
.
Servizio pagamenti ordini
Questo servizio è stato rimosso dalla versione 2.1.
Servizio prodotti
La risposta da insert
conterrà solo i seguenti attributi:
channel
contentLanguage
id
offerId
targetCountry
Nella risposta non vengono più restituiti avvisi ed errori non irreversibili. Ciò consente una migliore integrazione con le regole del feed e altre funzionalità avanzate di gestione dei feed.
Esiste un ritardo di qualche minuto prima che un prodotto inserito possa essere recuperato da get
o list
.
Non è più garantito che l'ID offerta restituito corrisponda all'ID offerta inserito.
Ora i prezzi vengono convalidati prima dell'inserimento dei prodotti. Nella stringa del valore sono consentiti solo i seguenti caratteri: +
, -
, .
e cifre (0
-9
). Le virgole non sono più accettate.
Risorsa del prodotto
CustomGroups sostituiti da customAttributes ricorrenti
In precedenza, gli attributi personalizzati potevano essere raggruppati aggiungendo attributi personalizzati nello stesso gruppo personalizzato nella versione 2. Gli attributi personalizzati ora sono ricorrenti nella versione 2.1, quindi non sono più necessari gruppi personalizzati.
Gli attributi personalizzati ora hanno un campo groupValues
aggiuntivo oltre al campo value
originale. È necessario impostare esattamente uno di questi campi, il che significa che non possono essere impostati o esclusi contemporaneamente.
Poiché i commercianti possono passare dalla versione 2 alla versione 2.1 e viceversa, i prodotti possono avere attributi personalizzati ricorrenti che non possono essere rappresentati nella versione 2, in quanto i gruppi personalizzati hanno un massimo di due livelli. In questo caso, il gruppo di attributi personalizzati verrà troncato.
Rimozione del tipo e dell'unità in customAttributes
Nella versione 2.1, gli attributi personalizzati non conterranno più un type
e un unit
. Le unità devono invece essere aggiunte a value
(se presente) e i tipi dovrebbero essere rilevati automaticamente. Ad esempio, utilizza "1,23 EUR" o "5,6 cm" come value
nella versione 2.1.
ProductTypes sostituisce productType e additionalProductTypes
In precedenza, i tipi di prodotto venivano archiviati in due campi, il primo nel campo singolare productType
e il resto nel campo ripetuto additionalProductTypes
. Nella versione 2.1, i due campi sono stati sostituiti da un singolo campo ripetuto productTypes
.
Attributo destinations sostituito da inclusioni e destinazioni escluse
Le destinazioni sono state inserite come elenco di coppie di nomi e intenzioni nella versione 2
nel campo ripetuto destinations
. Questo campo è stato sostituito dai seguenti due campi ripetuti: includedDestinations
e excludedDestinations
. Le destinazioni abilitate per impostazione predefinita non devono essere incluse in
includedDestinations.
. Questa operazione corrisponderà alla configurazione degli override delle destinazioni nei feed.
Ridenominazione dei campi correlati ad AdWords
Con AdWords che diventa Google Ads, i seguenti campi relativi ad AdWords sono stati rinominati:
adwordsGrouping
->adsGrouping
adwordsLabels
->adsLabels
adwordsRedirect
->adsRedirect
Rimozione dei campi deprecati
I seguenti campi deprecati sono stati rimossi:
aspects
destinations
onlineOnly
validatedDestinations
warnings
Servizio per gli stati dei prodotti
Scarica ed elenca
L'attributo product
è stato rimosso, insieme al
parametro includeAttributes
. Per recuperare gli attributi del prodotto corrispondenti a uno stato, utilizza il servizio Products
e il valore del nuovo campo productId
.
Elenco
Il parametro includeInvalidInsertedItems
è stato rimosso. Ora tutti i prodotti vengono
restituiti indipendentemente dalla loro validità, il che significa che list
ora si comporta come
se includeInvalidInsertedItems
sia sempre impostato su true
.
Risorsa ProductStatus
DestinationsStatuses
I campi intention
, approvalStatus
e approvalPending
in destinationStatuses
sono stati sostituiti da status
, che è una stringa che può essere approved
, disapproved
o pending
.
Rimozione dei problemi di qualità dei dati
Questi valori sono stati sostituiti da itemLevelIssues
.