Note di rilascio (v2.1)

15 novembre 2024

Servizio prodotti

Per LoyaltyProgram, è stato aggiunto il campo shipping_label per specificare l'idoneità. Se il campo ha un valore, questa offerta prevede il vantaggio della spedizione previsto dal programma fedeltà. Se il valore del campo non viene fornito, l'articolo non è idoneo per la spedizione prevista dal programma fedeltà per il livello di fedeltà specificato.

30 ottobre 2024

Servizi relativi ai pagamenti

Nell'ambito del ritiro delle API relative ai pagamenti, i seguenti servizi sono stati ritirati: - settlementreports - settlementtranscations

L'interruzione delle API relative ai pagamenti è correlata al programma Acquista su Google e alle API relative agli ordini precedentemente chiusi.

Le chiamate ai servizi sopra indicati dovrebbero non riuscire con una risposta Service was not found on the server.

16 ottobre 2024

update_mask in UpdateConversionSourceRequest ora è OPTIONAL. Se non viene specificata alcuna maschera di aggiornamento, vengono aggiornati tutti i campi con un valore non vuoto.

26 agosto 2024 (prima di quanto comunicato in precedenza)

Servizi relativi agli ordini

Nell'ambito del ritiro delle API relative agli ordini, i seguenti servizi sono stati ritirati: - orderinvoices - orderreports - orderreturns - orderreturns.labels - orders

Le chiamate ai servizi sopra indicati dovrebbero non riuscire con una risposta Service was not found on the server.

Il servizio OrderTrackingSignals non è deprecato e continuerà a essere disponibile.

10 agosto 2024

Servizi Acquista su Google

Nell'ambito della disattivazione delle API di Acquista su Google, tutti i metodi all'interno di BuyOnGoogleProgramService non andranno a buon fine con service was not found on the server.

19 luglio 2024

Servizio prodotti

È stato aggiunto il campo member_price_effective_date. Questo aggiornamento ti consente di specificare, se applicabile, l'intervallo di date durante il quale è valido il prezzo per i membri fedeltà. Se il valore del campo non viene fornito, il prezzo per i membri è sempre valido.

20 maggio 2024

Servizio prodotti

LoyaltyPrograms aggiunto. Questo aggiornamento ti consente di fornire più livelli con punti fedeltà, prezzi e così via diversi per un singolo prodotto. Devi utilizzare questo campo al posto del campo singolare LoyaltyProgram.

Servizio di report

Metriche di Acquista su Google ritirate nella tabella MerchantPerformanceView. Dopo questo aggiornamento, il recupero di qualsiasi metrica di Acquista su Google restituisce 0. Questo si applica anche ai valori storici per le date passate.

Per ulteriori informazioni, vedi Ritiro di Acquista su Google.

13 maggio 2024

Servizio prodotti

Risorsa prodotto

Modifiche al campo delle certificazioni: è stato aggiunto certificationValue al ProductCertification per fornire il valore della certificazione (noto anche come classe, livello o voto), che consente agli utenti di caricare informazioni sulla certificazione anche se l'autorità di certificazione non emette il codice o il numero di certificazione.

Per ulteriori informazioni, consulta le nostre guide sui prodotti.

6 maggio 2024

Servizio di report

È stato aggiunto un 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 prodotto

Sono stati aggiunti i campi facoltativi downpayment e creditType per i pagamenti rateizzati:

• downpayment fornisce l'importo che l'acquirente deve pagare in anticipo come pagamento una tantum.
• creditType fornisce il tipo di pagamento rateale (finance o lease). Questo campo è applicabile solo agli annunci di veicoli.

11 aprile 2024

Servizio prodotti

Risorsa prodotto

• È stato 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 per cui il costo di spedizione diventa senza costi.
• È stata modificata la visibilità di LoyaltyPoints

10 aprile 2024

Servizio prodotti

Risorsa prodotto

LoyaltyProgram aggiunto

9 aprile 2024

Servizio prodotti

Risorsa 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, anziché 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 prodotto

È stato aggiunto AutoPricingMinPrice come misura di salvaguardia nei progetti "Sconti automatici" e "Promozioni dinamiche" per garantire che gli sconti sulle offerte dei commercianti non riducano il prezzo del prodotto a un valore inferiore a questo. Mantenendo così inalterati il valore e la redditività dell'offerta.

15 marzo 2024

Ritiro di 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

È stato aggiunto il report TopicTrendsView al servizio Reports.

Per ulteriori informazioni, consulta le nostre guide su come generare report.

6 marzo 2024

Servizio di report

È stato aggiunto il bucket e il ranking del potenziale in termini di clic per i prodotti.

Per ulteriori informazioni, consulta le nostre guide su come generare 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 ne è stata aggiunta una valida di 40.

17 gennaio 2024

Servizio POS

Sono stati aggiunti nuovi valori per il campo matching_status_hint in PosStore, che consente 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 link e servizio rispettivamente per il metodo link. Questi consentono di collegare gli account con lo scopo di gestire i dati di prodotto locali.

29 novembre 2023

Servizio di assistenza ai commercianti

È stato aggiunto il tipo di azione esterna VERIFY_IDENTITY_IN_MERCHANT_CENTER 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 della corrispondenza del negozio POS con il negozio del Profilo dell'attività su Google e il suggerimento per la correzione 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

È stato aggiunto il campo Business Identity che consente ai commercianti di identificarsi autonomamente in base a determinati valori dei consumatori.

10 ottobre 2023

È stato aggiunto Collection Point come nuovo tipo di spedizione del servizio di impostazioni di spedizione. La consegna presso un punto di ritiro è un servizio fornito da terze parti (ad es.non di proprietà del commerciante) per consegnare l'articolo a una sede affiliata di terze parti (ad es. i punti di accesso UPS), anziché direttamente a casa.

18 settembre 2023

Servizio di impostazioni degli annunci di inventario locale

È stato aggiunto il metodo setOmnichannelExperience per consentire agli utenti di impostare la propria esperienza omnicanale (ovvero le impostazioni della vetrina locale e del ritiro). Al momento, questa funzionalità è disponibile solo per gli utenti il cui fornitore POS è attendibile per attivare 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 questo stato.

4 settembre 2023

Servizio di assistenza ai commercianti

È stata aggiunta l'azione integrata FIX_ACCOUNT_ISSUE per i problemi relativi ai prodotti che devono essere risolti a livello di account. È stata aggiunta l'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 da accesso limitato a tutti.

22 agosto 2023

Servizio di assistenza ai commercianti

Abbiamo lanciato il servizio di assistenza ai commercianti. Questo servizio fornisce contenuti di assistenza per problemi relativi all'account e ai prodotti.

4 agosto 2023

Servizio Report

È stato aggiunto il report Scenario competitivo dei concorrenti diretti al servizio Report.

Per ulteriori informazioni, consulta le nostre guide su come generare 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 al loro inventario.

14 luglio 2023

Servizio Report

Sono stati aggiunti i report sullo scenario competitivo al servizio Report.

Per ulteriori informazioni, consulta le nostre guide su come generare report.

7 luglio 2023

Servizio prodotti

Risorsa prodotto

È stato aggiunto virtualModelLink per fornire gli URL all'immagine del modello 3D.

4 luglio 2023

Servizio prodotti

Risorsa prodotto

Aggiungi il campo certifications per fornire le certificazioni dei prodotti, ad esempio per l'etichettatura energetica dei prodotti in base al database EPREL dell'UE.

26 giugno 2023

Servizio Impostazioni di spedizione

Evasione ordini locale

È stato aggiunto il campo no_delivery_post_cutoff per consentire ai commercianti di disattivare la visualizzazione della consegna locale in n+1 giorni se hanno configurato un servizio di spedizione con consegna locale in n giorni.

29 maggio 2023

Servizio Promozioni

È stato aggiunto il metodo list per il servizio Promotions.

Servizio di suggerimenti

Attiva la dismissione dell'interazione nel metodo ReportInteraction del servizio Recommendations.

9 maggio 2023

Destinazione Cloud per la vendita al dettaglio

Proprietà aggiuntive di Cloud per la vendita al dettaglio

Aggiungi il campo delle proprietà aggiuntive per la vendita al dettaglio su cloud. Si tratta di un campo ripetuto destinato all'utilizzo da parte dei clienti che utilizzano la destinazione Cloud Retail. Se viene utilizzato questo campo, sarà disponibile quando utilizzi il programma di vendita al dettaglio su cloud. Questo valore verrà mappato al campo degli attributi nel modello del prodotto Google Cloud per la vendita al dettaglio.

22 maggio 2023

Servizio Promozioni

È stato aggiunto il metodo list per il servizio Promotions.

11 aprile 2023

Servizio Impostazioni di spedizione

Evasione ordini locale

È stata aggiunta l'opzione di evasione degli ordini con consegna locale per i commercianti che creano una nuova impostazione di spedizione. Possono configurare le impostazioni per i negozi locali nel nuovo storeConfig campo. Sono inclusi il raggio di servizio, l'ora limite e i codici identificativi dei negozi che offrono la consegna locale.

3 aprile

Servizio di consigli

È stato lanciato il servizio di suggerimenti. Questo servizio fornisce suggerimenti per migliorare il rendimento del tuo account commerciante e ti consente di segnalare i clic del commerciante su consigli utili.

20 febbraio 2023

Servizio account

Risorsa account

È stata aggiunta una nuova sezione Account.ConversionSettings nella risorsa Account.

Servizio ConversionSources

È stato aggiunto il servizio Origini conversione, che supporta la gestione delle origini conversione (parte della sezione Impostazioni conversioni in Merchant Center).

16 febbraio 2023

Servizio Impostazioni di spedizione

Convalida del codice negozio

Ora i codici negozio vengono convalidati per verificare che appartengano al commerciante prima di aggiornare le impostazioni di spedizione.

Convalida del commerciante per gli annunci di prodotti disponibili localmente

I programmi a cui è registrato un ID commerciante vengono ora convalidati prima che le impostazioni di spedizione vengano aggiornate. 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 a 6 opzioni aggiuntive targetCountry con l'assistenza locale contentLanguage.:

• BR
• ES
• NL
• JP
• IT
• KR

12 gen 2023

Servizio prodotti

Risorsa prodotto

È stato aggiunto lifestyleImageLinks per fornire gli URL delle immagini lifestyle.

24 novembre 2022

Servizio di 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 i report di Market Insights al servizio Report.

Ora puoi eseguire query sul servizio Report per:

• Report Più venduti che utilizzano le tabelle BestSellersProductClusterView e BestSellersBrandView.
• Report sulla competitività del prezzo utilizzando la tabella PriceCompetitivenessProductView.
• Report Approfondimenti sul prezzo utilizzando la tabella PriceInsightsProductView.

Per ulteriori informazioni, consulta le nostre guide su come generare report.

7 novembre 2022

Servizio Feed di dati

È stato aggiunto il supporto di feedLabel per il servizio Datafeed.

14 settembre 2022

È stato aggiornato feedLabel in modo da accettare qualsiasi stringa.

9 agosto 2022

È stato aggiunto feedLabel per i prodotti.

Ora puoi utilizzare feedLabel anziché targetCountry per specificare il paese per gli ID offerta. Gli ID offerta ora vengono costruiti come online:language:feedLabel:offerId.

Per compatibilità con le versioni precedenti, il valore feedLabel è stato completato automaticamente con il valore targetCountry per i feed esistenti.

targetCountry obsoleto.

Per supportare le offerte globali, l'API Content for Shopping ha ritirato il campotargetCountry. Ti consigliamo invece di utilizzare il campo shipping per specificare i paesi di destinazione.

Ora targetCountry viene compilato automaticamente con il valore fornito in feedLabel.

Per ulteriori dettagli, consulta il post del blog L'etichetta del feed sostituisce il paese di destinazione nell'API Content for Shopping.

8 dicembre 2021

Servizio account

Risorsa account

È stata aggiunta una nuova sezione Account.AutomaticImprovements nella risorsa Accounts.

Questa nuova sezione consentirà ai commercianti di aggiornare automaticamente gli articoli, migliorare le immagini e le impostazioni di spedizione.

25 ottobre 2021

Servizio di promozione

Aggiunta di GetPromotion 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 magazzini che possono essere utilizzati in WarehouseBasedDeliveryTime.

Aggiungi un nuovo campo warehouseName in WarehouseBasedDeliveryTime per fare riferimento al magazzino tramite nome del magazzino.

4 ottobre 2021

Servizio account

Risorsa account

È stato aggiunto un nuovo campo "phone_verification_status" nella sezione Accounts.BusinessInformation. Questo è un campo di sola lettura impostato da Accounts.VerifyPhoneNumber.

13 settembre 2021

Servizio BuyOnGooglePrograms

Risorsa BuyOnGoogleProgramStatus

Sono stati aggiunti nuovi campi nella risorsa BuyOnGooglePrograms.BuyOnProgramStatus che rappresentano: canali di vendita online, modelli di business e numero di telefono del servizio clienti.

Nuovo metodo UpdateBuyOnGoogleProgramStatus

È stato aggiunto un nuovo metodo UpdateBuyOnGoogleProgramStatus che consente di aggiornare la risorsa BuyOnGooglePrograms.BuyOnProgramStatus.

6 settembre 2021

Servizio account

Risorsa account

È stato aggiunto un nuovo campo "korean_business_registration_number" nella sezione Accounts.BusinessInformation. Questo campo verrà cancellato solo se impostato esplicitamente su una stringa vuota.

30 agosto 2021

Servizio di promozione

È stato aggiunto un nuovo servizio di promozione con la promozione di inserti.

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 prodotto

Sono stati aggiunti productLength, productHeight, productWidth e productWeight per fornire le dimensioni e il peso del prodotto.

9 agosto 2021

Servizio RepricingRule

Tipo di RepricingRule

Nuovo valore enum per il campo RepricingRuleType.

TYPE_SALES_VOLUME_BASED e TYPE_COMPETITIVE_PRICE aggiunti.

17 maggio 2021

Servizio di etichette per i resi degli ordini

È stato aggiunto un nuovo campo "product_id" in CreateReturnRequest. I commercianti possono specificare o il valore 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 di etichette per i resi degli ordini

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 che calcolano la data di consegna stimata in base alla località del magazzino e al servizio del 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 prodotto

Nuovo campo additionalSizeType per supportare fino a 2 tipi di taglie per prodotto.

Modifiche al campo di spedizione: sono stati aggiunti minHandlingTime, maxHandlingTime, minTransitTime e maxTransitTime a ProductShipping per indicare la velocità di spedizione a livello di offerta.

28 gennaio 2021

Servizio account

È stato aggiunto il supporto delle etichette automatiche alle risorse AccountLabel e Account. Per maggiori informazioni, consulta la sezione Tipi di etichette CSS della 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. Ora la risorsa AccountLabel può essere utilizzata anche per creare ed elencare le etichette a livello di gruppo 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 alcuni paesi.

Risorsa Productstatuses

Nuovi campi approvedCountries, pendingCountries e disapprovedCountries nell'oggetto destinationStatuses che forniscono informazioni sullo stato dell'offerta oltre targetCountry.

Nuovo campo itemLevelIssues.applicableCountries.

10 agosto 2020

Servizio account

È stata aggiunta una nuova risorsa AccountLabel per la gestione delle etichette degli account Merchant Center per CSS Center. Ora gli utenti di CSS Center possono anche elencare i propri account Merchant Center e assegnarvi etichette con i metodi accounts.list, accounts.get e accounts.updatelabels. Per saperne di più, consulta Gestione delle etichette CSS.

19 giugno 2020

Servizio prodotti

Risorsa prodotto

Nuovi campi

Nuovi campi productDetails, productHighlights, subscriptionCost e canonicalLink.

2 giugno 2020

Servizio ordini

Sono stati aggiunti nuovi metodi per avviare i rimborsi senza resi. Con i nuovi orders.refunditem e orders.refundorder, puoi avviare i rimborsi degli ordini anche se non vengono restituiti dal cliente.

27 aprile 2020

Servizio resi degli ordini

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 Settlement Report

È stato aggiunto un nuovo servizio per ricevere report sul regolamento.

9 marzo 2020

API Inventory locale

È stato aggiunto un nuovo servizio per l'invio dei dati dell'inventario locale.

2 marzo 2020

API Impostazioni di notifica Pubsub

È stato aggiunto un nuovo servizio per la gestione delle impostazioni per le notifiche PubSub.

3 dicembre 2019

Servizio prodotti

È stato aggiunto il supporto per i feed dell'API Content supplementari per gli account multi-cliente.

11 settembre 2019

Servizio ordini

È stato aggiunto il supporto per le spedizioni con ritiro negli ordini e le funzionalità della sandbox corrispondenti.

14 agosto 2019

Nuovi servizi

Sono stati aggiunti nuovi servizi Returnpolicy e Returnaddress per Acquista su Google.

Servizio ordini

Risorsa ordine

Nuovo campo

Nuovo campo quantityUndeliverable.

7 agosto 2019

Servizio ordini

Risorsa ordine

Nuovi campi

Sono stati aggiunti nuovi campi loyaltyInfo e invoiceReceivingEmail alla risorsa Ordine.

1° luglio 2019

Servizio prodotti

Supporto per i feed supplementari dell'API Content aggiunti nel servizio Prodotti.

11 giugno 2019

Servizio ordini

Risorse Order e TestOrder

Aggiunta di aggiustamento del prezzo

È stato aggiunto un nuovo campo lineItem[].adjustments contenente l'aggiustamento del prezzo e dell'imposta della voce di riga originale 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 di patch non più supportati

I seguenti servizi non supportano più il metodo patch:

• Account
• Accounttax
• Feed di dati
• Liasettings
• Shippingsettings

Rimozione dei metodi HTTP BATCH

Tutti i metodi HTTP BATCH sono stati rimossi dalla versione 2.1. Utilizza invece customBatch. I servizi interessati sono i seguenti:

• Account
• Accountstatuses
• Feed di dati
• Datafeedstatuses
• Liasettings
• Orderreports
• Pos
• Prodotti
• Productstatuses
• Shippingsettings

Servizio account

Aggiorna

I campi businessInformation e googleMyBusinessLink nella richiesta sono stati introdotti dopo il lancio iniziale della versione 2 dell'API Content. Per questo motivo, esiste un sistema di 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 fornisci un corpo vuoto o se non li fornisci.

Risorsa account

Rebranding di AdWords in Google Ads

Con la nuova denominazione di AdWords in Google Ads, i seguenti campi correlati ad AdWords sono stati rinominati:

1. adwordsLinks -> adsLinks
2. adwordsLinks.adwordsId -> adsLinks.adsId

Rimozione di campi e valori obsoleti

Il campo deprecato reviewsUrl è stato rimosso. Inoltre, lo stato del collegamento inactive è stato rimosso per adsLinks, googleMyBusinessLink e youtubeChannelLinks.

Servizio Accountstatuses

Risorsa AccountStatus

Rimozione di dataQualityIssues

Questi sono stati sostituiti da itemLevelIssues.

Servizio di feed di dati

Risorsa feed di dati

Rimozione dei campi obsoleti

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

Il servizio inventory v2 è stato rimosso e sostituito da due nuove funzionalità nella v2.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 può essere al lordo o al netto delle imposte, a seconda della località dell'ordine.

Rimborso

Questo metodo è stato rimosso. Utilizza invece returnRefundLineItem.

ReturnLineItem

Questo metodo è stato rimosso. Utilizza returnRefundLineItem senza fornire un importo del rimborso.

ReturnRefundLineItem

I campi amountPretax e amountTax sono stati sostituiti rispettivamente da priceAmount e taxAmount. Il campo priceAmount può essere al lordo o al netto delle imposte, a seconda della località dell'ordine.

ShipLineItem

I campi carrier, shipmentId e trackingId nella richiesta sono stati trasferiti in shipmentInfos.

Risorse Order e TestOrder

Nuovo formato della promozione

Nella versione 2.1 è disponibile un nuovo formato della promozione. Non puoi creare ordini di prova con le promozioni.

Rimozione dei campi obsoleti

Il campo paymentMethod è stato rimosso e billingAddress epredefinedBillingAddress ora sono campi di primo livello in Order e TestOrder, rispettivamente.

Inoltre, customer.explicitMarketingPreference è stato rimosso e sostituita da customer.marketingRightsInfo sia in Order che in TestOrder.

Il campo deprecato customer.email è stato rimosso.

Il formato del campo promotions è cambiato nella risorsa Order.

Servizio Orderpayments

Questo servizio è stato rimosso dalla versione 2.1.

Servizio prodotti

La risposta di un insert conterrà solo i seguenti attributi:

• channel
• contentLanguage
• id
• offerId
• targetCountry

Gli avvisi e gli errori non fatali non vengono più restituiti nella risposta. In questo modo, è possibile migliorare l'integrazione con le regole dei feed e con altre funzionalità di gestione dei feed avanzate.

Ora è necessario un ritardo di alcuni minuti prima che un prodotto inserito possa essere recuperato da get o list.

Non è più garantito che l'ID offerta restituito sia uguale all'ID offerta inserito.

Ora i prezzi vengono convalidati prima dell'inserimento del prodotto. Nella stringa del valore sono consentiti solo i seguenti caratteri: +, -, . e cifre (0-9). Le virgole non sono più accettate.

Risorsa prodotto

CustomGroups sostituito da customAttributes ricorsivo

In precedenza, nella versione 2 gli attributi personalizzati potevano essere raggruppati aggiungendoli allo stesso gruppo personalizzato. Gli attributi personalizzati ora sono recursivi nella versione 2.1, quindi non è più necessario creare gruppi personalizzati.

Gli attributi personalizzati ora hanno un campo groupValues aggiuntivo oltre al campo value originale. Deve essere impostato esattamente uno di questi, il che significa che non possono essere impostati o omessi contemporaneamente.

Poiché i commercianti possono passare dalla versione 2 alla versione 2.1, è possibile che i prodotti abbiano attributi personalizzati ricorsivi che non possono essere rappresentati nella versione 2 perché i gruppi personalizzati hanno un massimo di due livelli. In questo caso, il gruppo di attributi personalizzati verrà troncato.

Rimozione di tipo e unità in customAttributes

Nella versione 2.1, gli attributi personalizzati non conterranno più type e unit. Al contrario, le unità devono essere aggiunte a value (se presente) e i tipi devono 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 memorizzati in due campi, con il primo tipo nel campo singolare productType e gli altri nel campo ripetuto additionalProductTypes. Nella versione 2.1, i due campi sono stati sostituiti da un singolo campo ripetuto productTypes.

L'attributo Destinations è stato sostituito da includedDestinations ed excludedDestinations

Nella versione 2, le destinazioni sono state inserite come elenco di coppie di nome e intenzione della destinazione nel campo ripetuto destinations. Questo campo è stato sostituito dai seguenti due campi ripetuti: includedDestinations e excludedDestinations. Le destinazioni attivate per impostazione predefinita non devono essere incluse in includedDestinations.. Questo corrisponderà alla configurazione delle sostituzioni delle destinazioni nei feed.

Rinomina dei campi correlati ad AdWords

Con la nuova denominazione di AdWords in Google Ads, i seguenti campi correlati ad AdWords sono stati rinominati:

• adwordsGrouping -> adsGrouping
• adwordsLabels -> adsLabels
• adwordsRedirect -> adsRedirect

Rimozione dei campi obsoleti

I seguenti campi obsoleti sono stati rimossi:

• aspects
• destinations
• onlineOnly
• validatedDestinations
• warnings

Servizio Productstatuses

Get e List

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 dal fatto che siano validi o meno, il che significa che list ora si comporta come se includeInvalidInsertedItems fosse 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 di dataQualityIssues

Questi sono stati sostituiti da itemLevelIssues.