Note di rilascio (v2.1)

30 ottobre 2024

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

La chiusura delle API relative alla liquidazione è correlata al programma BuyOnGoogle e alle API relative agli ordini precedentemente disattivati.

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 che hanno un valore non vuoto.

26 agosto 2024 (prima di quanto comunicato in precedenza)

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 chiusura delle API di Acquista su Google, tutti i metodi in BuyOnGoogleProgramService non riusciranno 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 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: aggiunto certificationValue al campo 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 rilascia un codice o 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 del 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

Hai aggiunto LoyaltyProgram

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

Report TopicTrendsView aggiunto al servizio Reports.

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

6 marzo 2024

Servizio di report

Sono stati aggiunti bucket e ranking potenziali di clic 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 consente agli utenti di avere maggiori dettagli sul motivo della mancata corrispondenza del loro negozio.

11 gennaio 2024

Servizio account

localProductManager e localProductManagement aggiunti rispettivamente come tipo di collegamento e servizio per il metodo link. Consentono di collegare gli account allo 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. Una 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 sede affiliata di terze parti (come i punti di accesso UPS), anziché consegnarlo 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 opzione è disponibile solo per gli utenti il cui fornitore di POS si fida di 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

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

4 agosto 2023

Servizio di report

È stato aggiunto il report sullo scenario competitivo associato alla concorrenza nel 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 le informazioni sul ritiro insieme al loro inventario.

14 luglio 2023

Servizio di 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. Questo è un campo ripetuto destinato a essere utilizzato dai 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

Lanciato il servizio per i 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 conversione in Merchant Center).

16 feb 2023

Servizio Impostazioni di spedizione

Convalida del codice negozio

I codici negozio vengono ora convalidati per garantire che appartengano al commerciante prima dell'aggiornamento delle 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

Estendi il servizio Promozioni ad altre 6 opzioni di targetCountry con l'assistenza contentLanguage locale.:

  • 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 nov 2022

Servizio di generazione di report

Sono stati aggiunti i report di Market Insights al servizio Report.

Ora puoi eseguire query sul servizio Report per i seguenti elementi:

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

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 ott 2021

Servizio di 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 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 dell'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 ago 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 raccogliere 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 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 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 al posto dell'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 la nuova funzionalità 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 del 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

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 delle offerte 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 assegnare loro 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 notifiche Pubsub

È stato aggiunto un nuovo servizio per la gestione delle impostazioni relative alle 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

Aggiunto il supporto per il ritiro degli ordini e le corrispondenti funzionalità sandbox.

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 su ordini e testOrder

Aggiunta di un 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
  • Imposta account
  • Feed di dati
  • Impostazioni di Lia
  • 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
  • Stati dei feed di dati
  • Liasettings
  • Orderreports
  • Pos
  • Prodotti
  • Productstatuses
  • Impostazioni di spedizione

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 una protezione che impedisce ai commercianti di eliminare involontariamente 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 dell'account

Rebranding di AdWords in Google Ads

Con Google Ads che diventa Google Ads, i seguenti campi relativi ad AdWords sono stati rinominati:

  1. adwordsLinks -> adsLinks
  2. adwordsLinks.adwordsId -> adsLinks.adsId
Rimozione dei campi e dei valori ritirati

Il campo ritirato 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 ritirato customer.email è stato rimosso.

Il formato del campo promotions è stato modificato 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 integrare meglio le regole del feed e altre funzionalità di gestione del 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 del prodotto

CustomGroups sostituito da customAttributes ricorsivo

In precedenza, gli attributi personalizzati potevano essere raggruppati aggiungendo attributi personalizzati nello stesso gruppo personalizzato della versione 2. 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

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 opzione corrisponderà alla configurazione delle sostituzioni delle destinazioni nei feed.

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 dalla loro validità, 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 uno dei seguenti: approved, disapproved o pending.

Rimozione di dataQualityIssues

Questi sono stati sostituiti da itemLevelIssues.