Versionshinweise (v2.1)

30. Oktober 2024

Im Rahmen der Einstellung der APIs für Abrechnungen werden die folgenden Dienste eingestellt: settlementreports settlementtranscations

Die Einstellung der APIs für die Abrechnung hängt mit der Einstellung des Buy on Google-Programms und der APIs für Bestellungen zusammen.

Bei Aufrufen der oben genannten Dienste wird erwartet, dass sie mit der Antwort Service was not found on the server fehlschlagen.

16. Oktober 2024

update_mask in UpdateConversionSourceRequest ist jetzt OPTIONAL. Wenn keine Aktualisierungsmaske angegeben ist, werden alle Felder mit einem nicht leeren Wert aktualisiert.

26. August 2024 (früher als ursprünglich angekündigt)

Im Rahmen der Einstellung der bestellungsbezogenen APIs wurden die folgenden Dienste eingestellt: orderinvoices orderreports orderreturns orderreturns.labels orders

Aufrufe der oben genannten Dienste sollten mit einer Service was not found on the server-Antwort fehlschlagen.

Der Dienst OrderTrackingSignals wurde nicht verworfen und ist weiterhin verfügbar.

10. August 2024

Buy on Google-Dienste

Im Rahmen der Einstellung der Buy on Google APIs schlagen alle Methoden in BuyOnGoogleProgramService mit service was not found on the server fehl.

19. Juli 2024

Produktfeed

Das Feld member_price_effective_date wurde hinzugefügt. Mit dieser Aktualisierung können Sie gegebenenfalls den Zeitraum angeben, in dem der Preis für das Treuepunkteprogramm gilt. Wenn der Feldwert nicht angegeben ist, gilt der Mitgliedspreis immer.

20. Mai 2024

Produktfeed

LoyaltyPrograms wurde hinzugefügt. Mit diesem Update können Sie für ein einzelnes Produkt mehrere Stufen mit unterschiedlichen Treuepunkten, Preisen usw. angeben. Sie sollten dieses Feld anstelle des Felds LoyaltyProgram im Singular verwenden.

Berichtsdienst

In der Tabelle MerchantPerformanceView sind die eingestellten Buy on Google-Messwerte aufgeführt. Nach diesem Update wird beim Abrufen eines Buy on Google-Messwerts 0 zurückgegeben. Dies gilt auch für Verlaufsdaten für Zeiträume in der Vergangenheit.

Weitere Informationen finden Sie unter Einstellung von Buy on Google.

13. Mai 2024

Produktfeed

Produktressource

Änderungen am Feld „Zertifizierungen“: Im Feld ProductCertification wurde das Zeichen certificationValue hinzugefügt, um einen Zertifizierungswert (auch als Klasse, Stufe oder Note bezeichnet) anzugeben. So können Nutzer Zertifizierungsinformationen hochladen, auch wenn die Zertifizierungsstelle keinen Zertifizierungscode oder keine Zertifizierungsnummer ausstellt.

Weitere Informationen finden Sie in unseren Produktleitfäden.

6. Mai 2024

Berichtsdienst

Der Tabelle PriceInsightsProductView wurde ein Effizienzbereich hinzugefügt. Die Effektivität gibt an, welche Produkte am meisten von Preisänderungen profitieren würden. Bei dieser Bewertung erfolgt die Ermittlung der prognostizierten Leistungssteigerung durch Anpassung des Sonderangebotspreises mithilfe der Differenz zwischen aktuellem und vorgeschlagenem Preis.

24. April 2024

Produkte – Service

Produktressource

Optionale Felder downpayment und creditType für Ratenzahlungen hinzugefügt:

  • downpayment gibt den Betrag an, den der Käufer vorab einmalig zahlen muss.
  • creditType gibt die Art der Ratenzahlung an (finance oder lease). Dieses Feld gilt nur für Fahrzeuganzeigen.

11. April 2024

Produkte – Service

Produktressource

  • Das Attribut „Mindestbetrag für kostenlosen Versand“ (FreeShippingThreshold) wurde für den Versand auf Angebotsebene hinzugefügt. Mit diesem Attribut können Händler einen minimalen Produktpreis angeben, damit die Versandkosten kostenlos sind.
  • Sichtbarkeit von LoyaltyPoints geändert

10. April 2024

Produkte – Service

Produktressource

LoyaltyProgram wurde hinzugefügt

9. April 2024

Produktfeed

Produktressource

structuredTitle und structuredDescription wurden hinzugefügt, um KI-generierte Produkttitel und -beschreibungen bereitzustellen.

3. April 2024

Händlersupport

Das Feld user_input_action_option wurde hinzugefügt, mit dem Partner eine neue Art von Aktion anfordern können: BuiltInUserInputAction. So können Partner komplexe Self-Serve-Funktionen für Händler direkt in ihrer Anwendung erstellen, anstatt sie zum Merchant Center weiterzuleiten.

Es wurde eine neue TriggerAction-Methode für BuiltInUserInputAction hinzugefügt. Wenn Sie diese Methode nutzen möchten, füllen Sie bitte dieses Formular aus.

27. März 2024

Produkte – Service

Produktressource

In den Projekten „Automatische Rabatte“ und „Dynamische Angebote“ wurde AutoPricingMinPrice als Schutzmaßnahme hinzugefügt, damit Rabatte auf Angebote von Händlern den Produktpreis nicht unter diesen Wert senken. So bleiben der Wert und die Rentabilität des Angebots erhalten.

15. März 2024

Buy on Google für die Google Suche und Google Shopping wird eingestellt. Sie können sich bestehende Bestellungen noch bis zum 31. Oktober 2024 mit orders.list und orders.get ansehen.

8. März 2024

Berichtsdienst

Dem Reports-Dienst wurde der TopicTrendsView-Bericht hinzugefügt.

Weitere Informationen finden Sie in unseren Leitfäden zu Berichten.

6. März 2024

Berichtsdienst

Es wurden eine Gruppe für das Klickpotenzial und ein Rang für Produkte hinzugefügt.

Weitere Informationen finden Sie in unseren Leitfäden zu Berichten.

19. Februar 2024

ConversionSources-Dienst

Die folgenden Werte wurden als gültige Conversion-Quellen entfernt:

  • CROSS_CHANNEL_FIRST_CLICK
  • CROSS_CHANNEL_LINEAR
  • CROSS_CHANNEL_POSITION_BASED
  • CROSS_CHANNEL_TIME_DECAY

Die Optionen „60“ und „90“ als Lookback-Window-Tage wurden entfernt und „40“ als gültige Option hinzugefügt.

17. Januar 2024

POS-Dienst

Es wurden neue Werte für das Feld matching_status_hint in PosStore hinzugefügt. So erhalten Nutzer mehr Details dazu, warum die Zuordnung des Geschäfts fehlgeschlagen ist.

11. Januar 2024

Kontodienst

localProductManager und localProductManagement wurden der link-Methode als Linktyp bzw. Dienst hinzugefügt. So können Konten verknüpft werden, um lokale Produktdaten zu verwalten.

29. November 2023

Händlersupport

Der externe Aktionstyp VERIFY_IDENTITY_IN_MERCHANT_CENTER für die Identitätsbestätigung wurde hinzugefügt, die im Merchant Center durchgeführt werden muss.

POS-Dienst

Dem PosStore wurden die Felder matching_status und matching_status_hint hinzugefügt, damit Nutzer den Abgleichsstatus von PosStore und Google Unternehmensprofil-Store sehen und einen Hinweis erhalten, wie sie im Fall eines Problems behoben werden müssen.

15. Nov. 2023

Die Endpunkte repricingrules und repricingrules.repricingreports werden nicht mehr unterstützt.

1. November 2023

Dienst „Versandeinstellungen“

shipment_type=pickup wird nicht mehr unterstützt.

18. Oktober 2023

Kontodienst

Das Feld Business Identity wurde hinzugefügt, damit Händler bestimmte Werte für Verbraucher angeben können.

10. Oktober 2023

Collection Point wurde als neuer Versandtyp für Versandeinstellungen hinzugefügt. Die Lieferung an eine Abholstelle ist ein Dienst, der von einem Drittanbieter (z. B. nicht vom Händler) erbracht wird. Dabei werden Artikel anstatt direkt an die Adresse des Kunden an bestimmte Abholstellen wie UPS-Zugangspunkte geliefert.

18. September 2023

Dienst für LIA-Einstellungen

Die Methode setOmnichannelExperience wurde hinzugefügt, damit Nutzer ihre Omni-Channel-Umgebung (d. h. Einstellungen für Ladengeschäfte und Abholung) festlegen können. Derzeit ist diese Option nur für Nutzer verfügbar, deren POS-Anbieter diese Einstellungen als vertrauenswürdig aktiviert hat.

7. September 2023

Einstellung von Buy on Google

Fügen Sie der Methode GetBuyOnGoogleProgramStastus einen neuen DEPRECATED-Status hinzu. In diesem Status kann das Programm nicht wieder aktiviert oder pausiert werden.

4. September 2023

Support für Händler

Es wurde die integrierte Aktion FIX_ACCOUNT_ISSUE für Produktprobleme hinzugefügt, die auf Kontoebene behoben werden müssen. Es wurde eine integrierte SHOW_ADDITIONAL_CONTENT-Aktion hinzugefügt, mit der eine Begründung einer nationalen Behörde übermittelt werden kann.

28. August 2023

Angebotsdienst

Methode list im Dienst Promotions für eingeschränkten Zugriff auf alle öffnen.

22. August 2023

Support für Händler

Einführung des Supports für Händler Dieser Dienst bietet Supportinhalte zu Konto- und Produktproblemen.

4. August 2023

Berichtsservice

Der Berichtsdienst wurde um den Bericht „Mitbewerber schließen“ ergänzt.

Weitere Informationen finden Sie in unseren Leitfäden zur Berichterstellung.

25. Juli 2023

POS-Dienst

Inventarressource

Füge die Felder pickup_method und pickup_sla hinzu, damit Händler neben ihrem Inventar Abholinformationen einreichen können.

14. Juli 2023

Berichtsdienst

Dem Berichtsservice wurden Berichte zur Wettbewerbsposition hinzugefügt.

Weitere Informationen finden Sie in unseren Leitfäden zu Berichten.

7. Juli 2023

Produkte – Service

Produktressource

virtualModelLink wurde hinzugefügt, um URLs zu 3D‑Modellbildern anzugeben.

4. Juli 2023

Produkte – Service

Produktressource

Fügen Sie das Feld certifications hinzu, um Produktzertifikate anzugeben, z. B. für die Energieeffizienzkennzeichnung von Produkten auf Grundlage der EU-Datenbank EPREL.

26. Juni 2023

Versandeinstellungen

Lokale Ausführung

Das Feld no_delivery_post_cutoff wurde hinzugefügt, damit Händler die lokale Lieferung innerhalb von n Tagen deaktivieren können, wenn sie einen Versandservice für eine lokale Lieferung von n Tagen konfiguriert haben.

29. Mai 2023

Angebotsdienst

Die Methode list wurde für den Dienst Promotions hinzugefügt.

Empfehlungsdienst

Aktivieren Sie das Schließen von Interaktionen in der ReportInteraction-Methode des Empfehlungsdienstes.

9. Mai 2023

Cloud Retail-Ziel

Zusätzliche Cloud Retail-Properties

Fügen Sie das Feld „Zusätzliche Properties für Cloud Retail“ hinzu. Dieses wiederholte Feld richtet sich an Kunden, die das Cloud Retail-Ziel verwenden. Wenn dieses Feld verwendet wird, ist es bei Verwendung des Cloud Retail-Programms verfügbar. Dies wird dem Attributfeld im Google Cloud Retail-Produktmodell zugeordnet.

22. Mai 2023

Angebotsdienst

Die Methode list wurde für den Dienst Promotions hinzugefügt.

11. April 2023

Dienst „Versandeinstellungen“

Lokale Ausführung

Die Option für die lokale Lieferung wurde für Händler hinzugefügt, die eine neue Versandeinstellung erstellen. Sie können ihre Einstellungen für lokale Geschäfte im neuen Feld storeConfig konfigurieren. Dazu gehören der Lieferradius, die Annahmeschlusszeit und die Geschäftscodes für die Geschäfte, die lokale Lieferungen anbieten.

3. April

Empfehlungsdienst

Der Empfehlungsdienst wurde eingeführt. Dieser Dienst enthält Vorschläge zur Leistungssteigerung Ihres Händlerkontos und ermöglicht es Ihnen, Händlerklicks auf hilfreiche Empfehlungen zu melden.

20. Februar 2024

Kontodienst

Kontoressource

Neuer Abschnitt Account.ConversionSettings in der Ressource Konten

ConversionSources-Dienst

Der Dienst „Conversion-Quellen“ wurde hinzugefügt. Er unterstützt die Verwaltung von Conversion-Quellen und ist im Merchant Center im Bereich „Conversion-Einstellungen“ zu finden.

16. Februar 2023

Versandeinstellungen

Überprüfung des Geschäftscodes

Bevor die Versandeinstellungen aktualisiert werden, wird jetzt geprüft, ob die Geschäftscodes zum Händler gehören.

Händlerüberprüfung für Anzeigen für lokales Inventar

Programme, für die eine Händler-ID registriert ist, werden jetzt überprüft, bevor die Versandeinstellungen aktualisiert werden. Händler müssen an einem der folgenden Programme teilnehmen:

  • LOCAL_INVENTORY_ON_SURFACES_ACROSS_GOOGLE
  • LOCAL_INVENTORY_ADS

9. Feb. 2023

Angebotsdienst

Erweitern Sie den Angebotsdienst auf 6 zusätzliche targetCountry-Optionen mit lokalem contentLanguage-Support:

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

12. Jan. 2023

Produkte – Service

Produktressource

lifestyleImageLinks wurde hinzugefügt, um URLs zu Lifestyle-Bildern bereitzustellen.

24. Nov. 2022

Angebotsdienst

Im Abschnitt Promotions.PromotionStatus wurde das neue Feld „promotionStatus“ hinzugefügt. Dieses Feld ist schreibgeschützt.

15. Nov. 2022

Berichtsservice

Berichte mit Markteinblicken wurden zum Berichtsdienst hinzugefügt.

Sie können den Berichtsdienst jetzt für Folgendes abfragen:

Weitere Informationen finden Sie in unseren Leitfäden zur Berichterstellung.

7. November 2022

Datafeeds-Dienst

Unterstützung für feedLabel für den Datafeed-Dienst hinzugefügt

14. September 2022

feedLabel wurde aktualisiert, um jeden String zu akzeptieren.

9. August 2022

Wir haben feedLabel für Produkte hinzugefügt.

Sie können jetzt feedLabel anstelle von targetCountry verwenden, um das Land für Angebots-IDs anzugeben. Angebots-IDs haben jetzt die Form online:language:feedLabel:offerId.

feedLabel wurde für vorhandene Feeds aus Gründen der Abwärtskompatibilität automatisch mit Ihrem targetCountry-Wert ausgefüllt.

targetCountry wurde eingestellt.

Zur Unterstützung globaler Angebote wurde das Feld targetCountry in der Content API for Shopping eingestellt. Wir empfehlen stattdessen, das Feld shipping zu verwenden, um Ihre Zielländer anzugeben.

Für targetCountry wird jetzt automatisch der Wert verwendet, den Sie in feedLabel angeben.

Weitere Informationen finden Sie im Blogpost Feedlabel ersetzt Zielland in der Content API for Shopping.

8. Dezember 2021

Kontodienst

Kontoressource

In der Ressource Konten wurde der neue Abschnitt Account.AutomaticImprovements hinzugefügt.

In diesem neuen Bereich können Händler Artikel automatisch aktualisieren, Bilder und Versandeinstellungen verbessern.

25. Oktober 2021

Angebotsdienst

„Get Promotion“ wurde der Promotion API hinzugefügt.

11. Oktober 2021

Versandeinstellungen-API

In der Ressource „ShippingSettings“ wurde das neue Feld warehouse hinzugefügt, damit Händler die Lager verwalten können, die in WarehouseBasedDeliveryTime verwendet werden können.

Fügen Sie in WarehouseBasedDeliveryTime ein neues Feld vom Typ warehouseName hinzu, um sich auf das Lager anhand des Lagernamens zu beziehen.

4. Oktober 2021

Kontodienst

Kontoressource

Im Bereich Accounts.BusinessInformation wurde das neue Feld „phone_verification_status“ hinzugefügt. Dieses Feld ist schreibgeschützt und wird von Accounts.VerifyPhoneNumber festgelegt.

13. September 2021

BuyOnGooglePrograms-Dienst

BuyOnGoogleProgramStatus-Ressource

In der Ressource BuyOnGooglePrograms.BuyOnProgramStatus wurden neue Felder hinzugefügt, die für Onlinevertriebskanäle, Geschäftsmodelle und Telefonnummern des Kundenservice stehen.

Neue UpdateBuyOnGoogleProgramStatus-Methode

Es wurde eine neue Methode „UpdateBuyOnGoogleProgramStatus“ hinzugefügt, mit der die erweiterte Ressource BuyOnGooglePrograms.BuyOnProgramStatus aktualisiert werden kann.

6. September 2021

Kontodienst

Kontoressource

Im Abschnitt Accounts.BusinessInformation wurde das neue Feld "korean_business_registration_number" hinzugefügt. Dieses Feld wird nur gelöscht, wenn es explizit auf einen leeren String gesetzt wird.

30. August 2021

Angebotsdienst

Neuer Angebotsdienst mit „Angebot einfügen“ hinzugefügt.

Bestelldienst

Es wurde eine neue Methode orders/captureOrder hinzugefügt, um Zahlungen vor dem Versand abzuwickeln.

Grund für die Stornierung einer neuen Bestellung FAILED_TO_CAPTURE_FUNDS

Produkte – Service

Produktressource

productLength, productHeight, productWidth und productWeight wurden hinzugefügt, um Produktabmessungen und ‑gewicht anzugeben.

9. August 2021

RepricingRule-Dienst

RepricingRule Type

Neuer Enumerationswert für das Feld RepricingRuleType.

TYPE_SALES_VOLUME_BASED und TYPE_COMPETITIVE_PRICE wurden hinzugefügt.

17. Mai 2021

Rücksendelabel-Service

Im CreateReturnRequest-Objekt wurde das neue Feld „product_id“ hinzugefügt. Händler können entweder die „product_id“ oder die „line_item_id“ angeben, um den Artikel zu identifizieren, der zurückgegeben werden soll.

Produkte – Service

Es wurde eine neue Methode zum Aktualisieren vorhandener Produkte hinzugefügt. Sie können ein Produkt aktualisieren, indem Sie nur die Felder angeben, die aktualisiert werden müssen, anstatt das gesamte Produkt.

3. Mai 2021

Rücksendelabel-Service

Es wurden neue Methoden zum Hochladen von Labels für vom Händler verwaltete Rücksendungen hinzugefügt. Mit dem neuen orderreturns.labels.create kannst du die Rücksendelabels hochladen, um sie mit dem Kunden zu teilen.

26. April 2021

Shipping Settings API

Neues Feld warehouseBasedDeliveryTimes in DeliveryTime, um Versandservices bei der Berechnung des voraussichtlichen Liefertermins basierend auf dem Lagerort und dem ausgewählten Transportunternehmen zu unterstützen.

Neues Feld eddServices im Objekt CarriersCarrier, um die Namen der Dienste zurückzugeben, die für die Berechnung des voraussichtlichen Liefertermins relevant sind.

12. April 2021

Produkte – Service

Produktressource

Neues additionalSizeType-Feld, das bis zu zwei Größentypen pro Produkt unterstützt.

Änderungen am Versandfeld: minHandlingTime, maxHandlingTime, minTransitTime und maxTransitTime wurden zu ProductShipping hinzugefügt, um die Versandgeschwindigkeit auf Angebotsebene anzugeben.

28. Januar 2021

Kontodienst

Für AccountLabel- und Account-Ressourcen wird jetzt die automatische Labelzuweisung unterstützt. Weitere Informationen finden Sie im Abschnitt CSS-Labeltypen der Anleitung zur Verwaltung von CSS-Labels.

5. Oktober 2020

CSSES-Dienst

CSS-Ressource

Es wurde ein neuer csses-Dienst zum Abrufen von Informationen zu Preisvergleichsportal-Domains und zum Zuweisen von Labels hinzugefügt. Die AccountLabel-Ressource kann jetzt auch zum Erstellen und Auflisten von Labels auf Ebene der Preisvergleichsportal-Gruppe verwendet werden. Weitere Informationen finden Sie unter CSS-Labelverwaltung.

24. August 2020

Produktfeed

Ressourcen zu Produkten

Neues Feld shoppingAdsExcludedCountries, mit dem Angebote von der Werbung in bestimmten Ländern ausgeschlossen werden können.

Ressource „Productstatuses“

Neue Felder approvedCountries, pendingCountries und disapprovedCountries im destinationStatuses-Objekt, die zusätzliche Informationen zum Angebotsstatus über targetCountry hinaus bereitstellen.

Neues itemLevelIssues.applicableCountries-Feld.

10. August 2020

Kontodienst

Es wurde eine neue AccountLabel-Ressource zum Verwalten von Merchant Center-Kontolabels für das CSS Center hinzugefügt. CSS Center-Nutzer können jetzt auch ihre Merchant Center-Konten auflisten und ihnen mit den Methoden accounts.list, accounts.get und accounts.updatelabels Labels zuweisen. Weitere Informationen finden Sie unter Verwaltung von CSS-Labels.

19. Juni 2020

Produktfeed

Produktressource

Neue Felder

Neue Felder productDetails, productHighlights, subscriptionCost und canonicalLink

2. Juni 2020

Bestelldienst

Es wurden neue Methoden hinzugefügt, um Erstattungen ohne Rücksendungen zu veranlassen. Mit den neuen orders.refunditem und orders.refundorder können Sie Erstattungen für Bestellungen veranlassen, auch wenn diese nicht vom Kunden zurückgegeben werden.

27. April 2020

Orderreturns-Dienst

Es wurden die neuen Methoden acknowledge und process sowie neue Filter und Felder für Lesemethoden (list, get) hinzugefügt.

Google Unternehmensprofil-Verknüpfung

Merchant Center-Konten können jetzt über die GMB-Konto-ID mit einem GMB-Konto verknüpft werden.

14. April 2020

APIs für Abrechnungsberichte

Es wurde ein neuer Dienst zum Abrufen von Berichten zu Abrechnungen hinzugefügt.

9. März 2020

Local Inventory API

Es wurde ein neuer Dienst zum Einreichen von Daten zu lokalem Inventar hinzugefügt.

2. März 2020

API für Pub/Sub-Benachrichtigungseinstellungen

Es wurde ein neuer Dienst zum Verwalten der Einstellungen für PubSub-Benachrichtigungen hinzugefügt.

3. Dezember 2019

Produkte – Service

Zusätzliche Content API-Feeds für Mehrfachkundenkonten werden jetzt unterstützt.

11. September 2019

Bestelldienst

Unterstützung für Lieferungen zur Abholung in Bestellungen und entsprechende Sandbox-Funktionen wurde hinzugefügt.

14. August 2019

Neue Dienste

Für Buy on Google wurden neue Rückgabebedingungen und Rücksendeadressen hinzugefügt.

Bestelldienst

Bestellressource

Neues Feld

Neues quantityUndeliverable-Feld.

7. August 2019

Bestelldienst

Ressource bestellen

Neue Felder

Der Bestellungsressource wurden die neuen Felder loyaltyInfo und invoiceReceivingEmail hinzugefügt.

1. Juli 2019

Produkte – Service

Unterstützung für Content API-Subfeeds, die dem Produktfeed hinzugefügt werden

11. Juni 2019

Orders Service

Ressourcen für „Order“ und „TestOrder“

Preisanpassung hinzugefügt

Das neue Feld lineItem[].adjustments enthält die Anpassung des ursprünglichen Preises und der Steuer für die Position aufgrund von Angeboten.

14. Februar 2019

Änderungen in dieser Version

Probeläufe werden nicht mehr unterstützt

Der Parameter dryRun wurde aus Version 2.1 entfernt. Das gilt für alle API-Aufrufe.

Patchmethoden werden nicht mehr unterstützt

Die folgenden Dienste unterstützen die Methode patch nicht mehr:

  • Konten
  • Accounttax
  • Datenfeeds
  • Liasettings
  • Versandeinstellungen

Entfernung von HTTP-BATCH-Methoden

Alle HTTP-BATCH-Methoden wurden aus Version 2.1 entfernt. Verwenden Sie stattdessen customBatch. Folgende Dienste sind betroffen:

  • Konten
  • Accountstatuses
  • Datenfeeds
  • Datafeedstatuses
  • Liasettings
  • Orderreports
  • Pos
  • Produkte
  • Produktstatus
  • Versandeinstellungen

Kontodienst

Aktualisieren

Die Felder businessInformation und googleMyBusinessLink in der Anfrage wurden nach der Erstveröffentlichung der Content API v2 eingeführt. Aus diesem Grund gibt es eine Sicherheitsmaßnahme, die verhindert, dass Händler Informationen in diesen beiden Feldern versehentlich mit update löschen, wenn sie nicht angegeben wurden.

In Version 2 müssen Händler diese Felder explizit mit einem leeren Textkörper ( {}) angeben, um sie zu löschen. In Version 2.1 werden Felder gelöscht, wenn Sie einen leeren Textkörper angeben oder keine Felder angeben.

Kontoressource

AdWords -> Google Ads-Rebranding

AdWords heißt jetzt Google Ads. Die folgenden AdWords-Felder wurden umbenannt:

  1. adwordsLinks -> adsLinks
  2. adwordsLinks.adwordsId -> adsLinks.adsId
Nicht mehr unterstützte Felder und Werte wurden entfernt

Das nicht mehr unterstützte Feld reviewsUrl wurde entfernt. Außerdem wurde der Verknüpfungsstatus inactive für adsLinks, googleMyBusinessLink und youtubeChannelLinks entfernt.

Accountstatuses Service

AccountStatus-Ressource

Entfernung von „dataQualityIssues“

Diese wurden durch itemLevelIssues ersetzt.

Datenfeed-Dienst

Datafeed-Ressource

Entfernen verworfener Felder

Die Felder contentLanguage, targetCountry und intendedDestinations wurden entfernt und in targets durch country, language, includedDestinations und excludedDestinations ersetzt.

Entfernen der Aktualisierung des Produktinventars

Feeds vom Typ product inventory update wurden entfernt.

Inventardienst

Der inventory-Dienst der Version 2 wurde entfernt und in Version 2.1 durch zwei neue Funktionen ersetzt:

  • Verwenden Sie neue Subfeeds für teilweise Produktaktualisierungen.
  • Verwenden Sie den neuen Dienst localinventory für Aktualisierungen lokal erhältlicher Produkte.

Bestelldienst

CancelLineItem

Die Felder amount, amountPretax und amountTax in der Anfrage wurden entfernt. Der erstattete Betrag wird jetzt automatisch berechnet.

CustomBatch

CustomBatch wurde aus Version 2.1 entfernt.

InStoreRefundLineItem

Die Felder amountPretax und amountTax wurden durch priceAmount bzw. taxAmount ersetzt. Das Feld priceAmount kann je nach Standort der Bestellung den Wert vor Steuern oder nach Abzug der Steuern enthalten.

Erstattung

Diese Methode wurde entfernt. Verwenden Sie stattdessen returnRefundLineItem.

ReturnLineItem

Diese Methode wurde entfernt. Verwenden Sie stattdessen returnRefundLineItem, ohne einen Erstattungsbetrag anzugeben.

ReturnRefundLineItem

Die Felder amountPretax und amountTax wurden durch priceAmount bzw. taxAmount ersetzt. Das Feld priceAmount kann je nach Standort der Bestellung vor oder nach Steuern angegeben werden.

ShipLineItem

Die Felder carrier, shipmentId und trackingId in der Anfrage wurden zu shipmentInfos verschoben.

Ressourcen für „Order“ und „TestOrder“

Neues Angebotsformat

In Version 2.1 gibt es ein neues Angebotsformat. Sie können keine Testbestellungen mit Angeboten erstellen.

Entfernen nicht mehr unterstützter Felder

Das Feld paymentMethod wurde entfernt und billingAddress und predefinedBillingAddress sind jetzt Felder der obersten Ebene in Order bzw. TestOrder.

Außerdem wurde customer.explicitMarketingPreference sowohl in Order als auch in TestOrder entfernt und durch customer.marketingRightsInfo ersetzt.

Das nicht mehr unterstützte Feld customer.email wurde entfernt.

Das Format des Felds promotions in der Ressource Order hat sich geändert.

Orderpayments Service

Dieser Dienst wurde aus Version 2.1 entfernt.

Produkte – Service

Die Antwort von einem insert enthält nur die folgenden Attribute:

  • channel
  • contentLanguage
  • id
  • offerId
  • targetCountry

Nicht kritische Warnungen und Fehler werden nicht mehr in der Antwort zurückgegeben. So lassen sich Feedregeln und andere erweiterte Feedverwaltungsfunktionen besser integrieren.

Es dauert jetzt einige Minuten, bis ein eingefügtes Produkt über get oder list abgerufen werden kann.

Die zurückgegebene Angebots-ID ist nicht mehr garantiert mit der eingegebenen Angebots-ID identisch.

Preise werden jetzt vor dem Einfügen von Produkten validiert. Im Wertstring sind nur die folgenden Zeichen zulässig: +, -, . und Ziffern (09). Kommas sind nicht mehr zulässig.

Produktressource

„CustomGroups“ durch rekursive „customAttributes“ ersetzt

Bisher konnten benutzerdefinierte Attribute in Version 2 gruppiert werden, indem sie derselben benutzerdefinierten Gruppe hinzugefügt wurden. Benutzerdefinierte Attribute sind in Version 2.1 jetzt rekursiv. Daher sind keine benutzerdefinierten Gruppen mehr erforderlich.

Benutzerdefinierte Attribute haben jetzt zusätzlich zum ursprünglichen value-Feld ein zusätzliches groupValues-Feld. Es muss genau eines davon festgelegt werden. Sie können also nicht gleichzeitig festgelegt oder ausgelassen werden.

Da Händler zwischen Version 2 und Version 2.1 wechseln können, ist es möglich, dass Produkte rekursive benutzerdefinierte Attribute haben, die in Version 2 nicht dargestellt werden können, da benutzerdefinierte Gruppen maximal zwei Ebenen haben. In diesem Fall wird die Gruppe mit benutzerdefinierten Attributen abgeschnitten.

Entfernung von Typ und Einheit in customAttributes

In Version 2.1 enthalten benutzerdefinierte Attribute keine type und unit mehr. Stattdessen werden Einheiten an das value angehängt (falls vorhanden) und Typen sollten automatisch erkannt werden. Verwenden Sie in Version 2.1 beispielsweise „1,23 €“ oder „5,6 cm“ als value.

„ProductTypes“ ersetzt „productType“ und „additionalProductTypes“

Bisher wurden Produkttypen in zwei Feldern gespeichert, wobei der erste Typ im einzelnen Feld productType und der Rest im wiederkehrenden Feld additionalProductTypes gespeichert wurde. In Version 2.1 wurden die beiden Felder durch ein einzelnes wiederkehrendes Feld productTypes ersetzt.

Attribut „Ziele“ durch „includedDestinations“ und „excludedDestinations“ ersetzt

In Version 2 wurden Ziele im wiederholten Feld destinations als Liste von Paaren aus Zielnamen und Absichten eingegeben. Dieses Feld wurde durch die folgenden beiden wiederkehrenden Felder ersetzt: includedDestinations und excludedDestinations. Standardmäßig aktivierte Ziele müssen nicht in includedDestinations. enthalten sein. Dies entspricht der Konfiguration der Zielüberschreibungen in Feeds.

AdWords heißt jetzt Google Ads. Die folgenden AdWords-Felder wurden umbenannt:

  • adwordsGrouping -> adsGrouping
  • adwordsLabels -> adsLabels
  • adwordsRedirect -> adsRedirect
Entfernen verworfener Felder

Die folgenden nicht mehr unterstützten Felder wurden entfernt:

  • aspects
  • destinations
  • onlineOnly
  • validatedDestinations
  • warnings

Productstatuses Service

Abrufen und auflisten

Das product-Attribut wurde zusammen mit dem includeAttributes-Parameter entfernt. Wenn Sie Attribute des Produkts abrufen möchten, die einem Status entsprechen, verwenden Sie den Dienst Products und den Wert des neuen Felds productId.

Liste

Der Parameter includeInvalidInsertedItems wurde entfernt. Alle Produkte werden jetzt zurückgegeben, unabhängig davon, ob sie gültig sind. Das bedeutet, dass sich list jetzt so verhält, als wäre includeInvalidInsertedItems immer auf true festgelegt.

ProductStatus-Ressource

DestinationsStatuses

Die Felder intention, approvalStatus und approvalPending in destinationStatuses wurden durch status ersetzt. Dies ist ein String, der einen der Werte approved, disapproved oder pending haben kann.

Entfernen von dataQualityIssues

Diese wurden durch itemLevelIssues ersetzt.