Note di rilascio (v2.1)

18 agosto 2025

L'API Content è deprecata e verrà disattivata ad agosto 2026. Esegui la migrazione all'API Merchant

19 giugno 2025

Servizio prodotti

Risorsa prodotto

È stato aggiunto il campo maximum_retail_price per consentire la specifica del prezzo di vendita al dettaglio massimo (MRP) in India.

Servizio di assistenza ai commercianti

26 maggio 2025

Servizio account

Ora è possibile aggiungere utenti di sola lettura agli account.

Apr 14, 2025

Servizio account

Poiché in futuro non sarà più un requisito, il servizio accounttax è stato ritirato.

Mar 17, 2025

Nell'ambito della chiusura delle API correlate agli ordini, i seguenti servizi sono stati ritirati:

  • accounts.verifyphonenumber
  • returnpolicy

Altri servizi

Questo endpoint non è più necessario e può essere ritirato:

  • pubsubnotificationsettings

10 febbraio 2025

Aggiunta dei campi prerendered_out_of_court_dispute_settlement a ProductIssue e a AccountIssue.

Campi alternate_dispute_resolution deprecati da RenderProductIssuesResponse e RenderAccountIssuesResponse.

12 dic 2024

Servizio prodotti

È stato aggiunto il campo sustainability_incentives per specificare incentivi alla sostenibilità come il credito d'imposta o lo sconto sul prezzo per i tuoi prodotti. Se il valore del campo non viene fornito, l'articolo non è idoneo per eventuali incentivi per la sostenibilità.

15 nov 2024

Servizio prodotti

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

30 ottobre 2024

Nell'ambito della chiusura delle API relative ai pagamenti, i seguenti servizi sono ritirati:

  • settlementreports
  • settlementtranscations

La chiusura delle API relative ai pagamenti è correlata al programma Acquista su Google e alle API relative agli ordini, precedentemente chiusi.

È previsto che le chiamate ai servizi sopra menzionati non vadano a buon fine con una risposta Service was not found on the server.

16 ottobre 2024

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

26 agosto 2024 (prima di quanto comunicato inizialmente)

Nell'ambito della chiusura delle API correlate agli ordini, i seguenti servizi sono stati ritirati:

  • orderinvoices
  • orderreports
  • orderreturns
  • orderreturns.labels
  • orders

È previsto che le chiamate ai servizi sopra menzionati non vadano a buon fine con una risposta Service was not found on the server.

Il servizio OrderTrackingSignals non è ritirato e continua a essere disponibile.

10 agosto 2024

Servizi Acquista su Google

Nell'ambito della chiusura delle API 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

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 del programma fedeltà. Se il valore del campo non viene fornito, il prezzo per i membri è sempre valido.

20 maggio 2024

Servizio prodotti

Aggiunta di LoyaltyPrograms. 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 Acquista su Google restituisce 0. Ciò vale anche per i valori storici delle date passate.

Per saperne di più, vedi Ritiro di Acquista su Google.

13 maggio 2024

Servizio prodotti

Risorsa prodotto

Modifiche al campo Certificazioni: è stato aggiunto certificationValue al campo ProductCertification per fornire il valore della certificazione (noto anche come classe, livello o grado), che consente agli utenti di caricare informazioni sulla certificazione anche se l'ente di certificazione non rilascia un codice o un numero di certificazione.

Per saperne di più, 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 prodotto

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

  • downpayment indica l'importo che l'acquirente deve versare in anticipo come pagamento una tantum.
  • creditType indica 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 affinché il costo di spedizione diventi senza costi.
  • Ha modificato la visibilità di LoyaltyPoints

10 aprile 2024

Servizio prodotti

Risorsa prodotto

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'AI.

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 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. preservando così 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

Aggiunta della segnalazione TopicTrendsView al servizio Reports.

Per saperne di più, consulta le nostre guide sulle segnalazioni.

6 marzo 2024

Servizio di report

Sono stati aggiunti il bucket e il ranking del potenziale di clic per i prodotti.

Per saperne di più, consulta le nostre guide sulle segnalazioni.

19 febbraio 2024

Servizio ConversionSources

Sono stati rimossi i seguenti valori come origini di 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 ed è stata aggiunta l'opzione 40 come 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 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 agli account di collegarsi 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 che consentono agli utenti di conoscere lo stato di corrispondenza del negozio POS con il negozio del Profilo dell'attività su Google e di ricevere suggerimenti per risolvere eventuali problemi.

15 novembre 2023

Gli endpoint repricingrules e repricingrules.repricingreports non sono più supportati.

1° novembre 2023

Servizio Impostazioni di spedizione

L'elemento shipment_type=pickup non è più supportato.

18 ottobre 2023

Servizio account

È stato aggiunto il campo Business Identity che consente ai commercianti di identificarsi 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 una terza parte (ad es. non di proprietà del commerciante) per consegnare l'articolo in una sede affiliata di terze parti (come i punti di accesso UPS), anziché direttamente a domicilio.

18 settembre 2023

Servizio di impostazioni LIA

È stato aggiunto il metodo setOmnichannelExperience per consentire agli utenti di impostare la propria esperienza omnicanale (ovvero le impostazioni del negozio locale e del ritiro). A questo punto, questa opzione è disponibile solo per gli utenti il cui fornitore di POS è considerato attendibile per l'attivazione di 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 problemi relativi all'account e al prodotto.

4 agosto 2023

Servizio di report

È stato aggiunto il report sullo scenario competitivo dei concorrenti più vicini al servizio Report.

Per saperne di più, consulta le nostre guide sulle segnalazioni.

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 all'inventario.

14 luglio 2023

Servizio di report

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

Per saperne di più, consulta le nostre guide sulle segnalazioni.

7 luglio 2023

Servizio prodotti

Risorsa prodotto

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

4 luglio 2023

Servizio prodotti

Risorsa prodotto

Aggiungi il campo certifications per fornire le certificazioni di prodotto, ad esempio per l'etichettatura di efficienza 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 quando hanno configurato un servizio di spedizione per la consegna locale in n giorni.

29 maggio 2023

Servizio Promozioni

È stato aggiunto il metodo list per il servizio Promotions.

Servizio di suggerimenti

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

9 maggio 2023

Destinazione Cloud Retail

Proprietà aggiuntive di Cloud Retail

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

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 campo storeConfig. Sono inclusi il raggio di servizio, l'orario limite e i codici negozio per i negozi che offrono la consegna locale.

3 aprile

Servizio di consigli

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

20 feb 2023

Servizio account

Risorsa 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 delle conversioni in Merchant Center).

16 feb 2023

Servizio Impostazioni di spedizione

Convalida del codice negozio

I codici negozio vengono ora convalidati per assicurarsi che appartengano al commerciante prima che le impostazioni di spedizione vengano aggiornate.

Convalida del commerciante LIA

I programmi a cui è registrato un ID commerciante vengono ora convalidati prima dell'aggiornamento delle impostazioni di spedizione. I commercianti devono far parte di uno dei seguenti programmi:

  • LOCAL_INVENTORY_ON_SURFACES_ACROSS_GOOGLE
  • LOCAL_INVENTORY_ADS

9 feb 2023

Servizio Promozioni

Espandi il servizio Promozioni a 6 opzioni targetCountry aggiuntive con assistenza contentLanguage locale:

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

12 gen 2023

Servizio prodotti

Risorsa prodotto

È stato aggiunto lifestyleImageLinks per fornire URL a 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

Aggiunti i report Market Insights al servizio Report.

Ora puoi eseguire query sul servizio Report per:

Per saperne di più, consulta le nostre guide sulle segnalazioni.

7 novembre 2022

Servizio Datafeeds

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

14 settembre 2022

Aggiornato feedLabel per accettare qualsiasi stringa.

9 agosto 2022

Aggiunta di feedLabel per i prodotti.

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

feedLabel è stato compilato automaticamente con il valore di targetCountry per i feed esistenti per la compatibilità con le versioni precedenti.

targetCountry deprecato.

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

targetCountry ora viene compilato automaticamente con il valore che fornisci in feedLabel.

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

8 dicembre 2021

Servizio account

Risorsa account

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

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 il nuovo campo warehouseName in WarehouseBasedDeliveryTime per fare riferimento al magazzino in base al nome del magazzino.

4 ott 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 telefono del servizio clienti.

Nuovo metodo UpdateBuyOnGoogleProgramStatus

È stato aggiunto un nuovo metodo UpdateBuyOnGoogleProgramStatus che consentirà di aggiornare la risorsa BuyOnGooglePrograms.BuyOnProgramStatus estesa.

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 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 prodotto

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

9 ago 2021

RepricingRule Service

Tipo di RepricingRule

Nuovo valore enum per il campo RepricingRuleType.

Aggiunta di TYPE_SALES_VOLUME_BASED e TYPE_COMPETITIVE_PRICE.

17 maggio 2021

Servizio di etichette per i resi degli ordini

È stato aggiunto un nuovo campo "product_id" in CreateReturnRequest. I commercianti possono specificare l'attributo 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 e 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 posizione 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 prodotto

Nuovo campo additionalSizeType per supportare fino a due tipi di taglie 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 alle risorse AccountLabel e Account. Per maggiori 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 ora può essere utilizzata anche per creare ed elencare le etichette a livello di gruppo CSS. Per saperne di più, consulta la pagina 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 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. Gli utenti di CSS Center ora 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 Orderreturns

Sono stati aggiunti 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 report sui pagamenti

È stato aggiunto un nuovo servizio per ottenere 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 delle impostazioni di notifica Pub/Sub

È stato aggiunto un nuovo servizio per la gestione delle impostazioni delle notifiche pub/sub.

3 dicembre 2019

Servizio prodotti

È stato aggiunto il supporto per i feed di Content API supplementari degli account multi-cliente.

11 settembre 2019

Servizio ordini

È stato aggiunto il supporto per le spedizioni con ritiro negli ordini e le funzionalità 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 di Content API supplementari aggiunto nel servizio Prodotti.

11 giugno 2019

Servizio ordini

Risorse Order e TestOrder

Aggiunta dell'aggiustamento del prezzo

È stato aggiunto un nuovo campo lineItem[].adjustments che contiene l'aggiustamento al prezzo e all'imposta della voce di ordine 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 si applica a tutte le chiamate API.

Metodi 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
  • Stati del prodotto
  • Shippingsettings

Servizio account

Aggiorna

I campi businessInformation e googleMyBusinessLink nella richiesta sono stati introdotti dopo il lancio iniziale della Content API v2. Per questo motivo, esiste una salvaguardia 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 -> Google Ads

Con la trasformazione 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 ritirati

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

Servizio Accountstatuses

Risorsa AccountStatus

Rimozione di dataQualityIssues

Questi sono stati sostituiti da itemLevelIssues.

Servizio Datafeed

Risorsa Datafeed

Rimozione dei campi ritirati

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 v2 inventory è stato rimosso e sostituito 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 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 spostati in shipmentInfos.

Risorse Order e TestOrder

Nuovo formato della promozione

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

Rimozione dei campi ritirati

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 sostituito da customer.marketingRightsInfo sia in Order che in TestOrder.

Il campo ritirato 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 errori e gli avvisi non fatali non vengono più restituiti nella risposta. Ciò consente una migliore integrazione con le regole dei feed e altre funzionalità avanzate di gestione dei feed.

Ora è previsto 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 di input.

I prezzi vengono ora convalidati prima dell'inserimento del prodotto. Nella stringa di valori 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, gli attributi personalizzati potevano essere raggruppati aggiungendo attributi personalizzati nello stesso gruppo personalizzato nella versione 2. Gli attributi personalizzati sono ora ricorsivi nella versione 2.1, quindi non sono più necessari gruppi personalizzati.

Ora gli attributi personalizzati hanno un campo groupValues aggiuntivo oltre al campo value originale; deve essere impostato esattamente uno dei due, il che significa che non possono essere impostati contemporaneamente o omessi.

Poiché i commercianti possono passare dalla versione 2 alla 2.1, è possibile che i prodotti abbiano attributi personalizzati ricorsivi 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 di tipo e unità in customAttributes

Nella versione 2.1, gli attributi personalizzati non conterranno più type e unit. Invece, 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 archiviati in due campi: il primo tipo nel campo singolare productType e i rimanenti nel campo ripetuto additionalProductTypes. Nella versione 2.1, i due campi sono stati sostituiti da un unico campo ripetuto productTypes.

Attributo Destinazioni sostituito da includedDestinations ed excludedDestinations

Le destinazioni sono state inserite come un elenco di coppie di nomi di destinazione e intent nella versione 2 nel campo ripetuto destinations. Questo campo è stato sostituito dai due campi ripetuti seguenti: includedDestinations e excludedDestinations. Le destinazioni attivate per impostazione predefinita non devono essere incluse in includedDestinations.. In questo modo, la configurazione degli override delle destinazioni nei feed corrisponderà.

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

  • adwordsGrouping -> adsGrouping
  • adwordsLabels -> adsLabels
  • adwordsRedirect -> adsRedirect
Rimozione dei campi ritirati

Sono stati rimossi i seguenti campi ritirati:

  • aspects
  • destinations
  • onlineOnly
  • validatedDestinations
  • warnings

Servizio Productstatuses

Get and 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, una stringa che può essere approved, disapproved o pending.

Rimozione di dataQualityIssues

Questi sono stati sostituiti da itemLevelIssues.