30. Oktober 2024
Dienstleistungen im Zusammenhang mit Vergleichsrechten
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)
Bestellbezogene Dienste
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
oderlease
). 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:
- Bestsellerberichte mit den Tabellen
BestSellersProductClusterView
undBestSellersBrandView
- Bericht zur Wettbewerbsfähigkeit von Preisen mit Tabelle
PriceCompetitivenessProductView
- Bericht zu Preisstatistiken mit der Tabelle
PriceInsightsProductView
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:
adwordsLinks
->adsLinks
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 (0
–9
). 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.
Umbenennung von AdWords-Feldern
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.