15. Nov. 2024
Produkte – Service
Für LoyaltyProgram wurde das Feld shipping_label hinzugefügt, um die Berechtigung anzugeben. Wenn das Feld einen Wert hat, bietet dieses Angebot Versandvorteile für das Treuepunkteprogramm. Wenn der Feldwert nicht angegeben ist, kommt der Artikel für den mit dem Treuepunkteprogramm verbundenen Versand für die angegebene Treuepunktestufe nicht infrage.
30. Oktober 2024
Abrechnungsbezogene Dienstleistungen
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 dem zuvor eingestellten BuyOnGoogle-Programm und den APIs für Bestellungen zusammen.
Aufrufe der oben genannten Dienste sollten mit einer Service was not found on the server-Antwort 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 wird nicht eingestellt 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
Produkte – Service
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
Produkte – Service
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.
Berichtsservice
In der Tabelle MerchantPerformanceView sind die eingestellten Buy on Google-Messwerte aufgeführt. Nach diesem Update wird beim Abrufen von Buy on Google-Messwerten der Wert 0 zurückgegeben. Dies gilt auch für Verlaufswerte für vergangene Zeiträume.
Weitere Informationen finden Sie unter Einstellung von Buy on Google.
13. Mai 2024
Produkte – Service
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
Berichtsservice
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:
downpaymentgibt den Betrag an, den der Käufer vorab einmalig zahlen muss.creditTypegibt die Art der Ratenzahlung an (financeoderlease). 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 Mindestproduktpreis eingeben, ab dem der Versand kostenlos ist. - Sichtbarkeit von
LoyaltyPointsgeändert
10. April 2024
Produkte – Service
Produktressource
LoyaltyProgram wurde hinzugefügt
9. April 2024
Produkte – Service
Produktressource
Die Schaltflächen structuredTitle und structuredDescription wurden hinzugefügt, um KI-generierte Produkttitel und ‑beschreibungen anzugeben.
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. Mit dieser Aktion 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
Berichtsservice
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_CLICKCROSS_CHANNEL_LINEARCROSS_CHANNEL_POSITION_BASEDCROSS_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
Den Feldern matching_status und matching_status_hint im PosStore wurde hinzugefügt, damit Nutzer den Abgleichsstatus des POS-Geschäfts mit dem Google Unternehmensprofil-Geschäft sehen und bei Problemen eine entsprechende Fehlerbehebung erhalten.
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 den Versandeinstellungen-Dienst 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 Funktion nur für Nutzer verfügbar, deren POS-Anbieter vertrauenswürdig ist und diese Einstellungen aktivieren kann.
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
Händlersupport
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
Die list-Methode im Promotions-Dienst wurde von „eingeschränkt“ zu „alle“ geändert.
22. August 2023
Händlersupport
Einführung des Händler-Supports. Dieser Dienst bietet Supportinhalte zu Konto- und Produktproblemen.
4. August 2023
Berichtsservice
Der Bericht „Mitbewerber im Blick“ wurde dem Berichtsservice hinzugefügt.
Weitere Informationen finden Sie in unseren Leitfäden zu Berichten.
25. Juli 2023
POS-Dienst
Inventarressource
Fügen Sie die Felder pickup_method und pickup_sla hinzu, damit Händler Informationen zur Abholung zusammen mit ihrem Inventar einreichen können.
14. Juli 2023
Berichtsservice
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 Anzeige der Lieferung innerhalb von n+1 Tagen deaktivieren können, wenn sie einen Versandservice für die Lieferung innerhalb 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 ist für Kunden gedacht, die das Cloud Retail-Ziel verwenden. Wenn dieses Feld verwendet wird, ist es bei der Nutzung des Cloud Retail-Programms verfügbar. Dieser Wert 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
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
Validierung 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_GOOGLELOCAL_INVENTORY_ADS
9. Feb. 2023
Angebotsdienst
Erweitern Sie den Angebotsdienst auf 6 zusätzliche targetCountry-Optionen mit lokalem contentLanguage-Support:
BRESNLJPITKR
12. Jan. 2023
Produkte – Service
Produktressource
lifestyleImageLinks hinzugefügt, um URLs zu Lifestyle-Bildern anzugeben.
24. November 2022
Angebotsdienst
Im Bereich Promotions.PromotionStatus wurde das neue Feld „promotionStatus“ hinzugefügt. Dieses Feld ist schreibgeschützt.
15. November 2022
Berichtsservice
Market Insights-Berichte wurden dem Berichtstool hinzugefügt.
Sie können den Berichtsservice jetzt zu folgenden Themen abfragen:
- Bestsellerberichte mit den Tabellen
BestSellersProductClusterViewundBestSellersBrandView - Bericht zur Wettbewerbsfähigkeit von Preisen mit Tabelle
PriceCompetitivenessProductView - Bericht zu Preisstatistiken mit der Tabelle
PriceInsightsProductView
Weitere Informationen finden Sie in unseren Leitfäden zu Berichten.
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 werden jetzt als online:language:feedLabel:offerId erstellt.
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.
targetCountry wird jetzt automatisch mit dem Wert ausgefüllt, 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
Shipping Settings 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 Onlinevertriebskanäle, Geschäftsmodelle und die Telefonnummer des Kundenservice darstellen.
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 Bereich 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-Typ
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 der neuen orderreturns.labels.create können Sie die Rücksendelabels hochladen, um sie mit dem Kunden zu teilen.
26. April 2021
Shipping Settings API
Neues Feld warehouseBasedDeliveryTimes in DeliveryTime zur Unterstützung von Versandservices, bei denen das voraussichtliche Lieferdatum basierend auf dem Standort des Lagers und dem ausgewählten Transportunternehmen berechnet wird.
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
Produkte – Service
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
Produkte – Service
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 einzuleiten. Mit den neuen orders.refunditem und orders.refundorder können Sie Erstattungen für Bestellungen veranlassen, auch wenn sie nicht vom Kunden zurückgesendet werden.
27. April 2020
Orderreturns Service
Es wurden die neuen Methoden acknowledge und process sowie neue Filter und Felder für Lesemethoden (list, get) hinzugefügt.
Google Unternehmensprofil verknüpfen
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
Pubsub Notification Settings API
Es wurde ein neuer Dienst zum Verwalten der Einstellungen für PubSub-Benachrichtigungen hinzugefügt.
3. Dezember 2019
Produkte – Service
Es wurde Unterstützung für Content API-Subfeeds für Mehrfachkundenkonten hinzugefügt.
11. September 2019
Bestelldienst
Unterstützung für Abholbestellungen und entsprechende Sandbox-Funktionen hinzugefügt.
14. August 2019
Neue Dienste
Es wurden neue Rückgabebedingungen und Rücksendeadressen für Buy on Google hinzugefügt.
Bestelldienst
Bestellressource
Neues Feld
Neues quantityUndeliverable-Feld.
7. August 2019
Bestelldienst
Bestellressource
Neue Felder
Der Bestellressource wurden die neuen Felder loyaltyInfo und invoiceReceivingEmail hinzugefügt.
1. Juli 2019
Produkte – Service
Unterstützung für Subfeeds der Content API, die im Produkte-Dienst hinzugefügt wurden.
11. Juni 2019
Bestelldienst
Ressourcen für „Order“ und „TestOrder“
Preisanpassung hinzufügen
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
Umbenennung von AdWords in Google Ads
AdWords heißt jetzt Google Ads. Die folgenden AdWords-Felder wurden umbenannt:
adwordsLinks->adsLinksadwordsLinks.adwordsId->adsLinks.adsId
Nicht mehr unterstützte Felder und Werte werden 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 von nicht mehr unterstützten Feldern
Die Felder contentLanguage, targetCountry und intendedDestinations wurden entfernt und in targets durch country, language, includedDestinations und excludedDestinations ersetzt.
Entfernung der Aktualisierung des Inventars
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
localinventoryfü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 vor oder nach Steuern angegeben werden.
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 von nicht mehr unterstützten Feldern
Das Feld paymentMethod wurde entfernt und billingAddress und predefinedBillingAddress sind jetzt Top-Level-Felder 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-Dienst
Dieser Dienst wurde aus Version 2.1 entfernt.
Produkte – Service
Die Antwort von einem insert enthält nur die folgenden Attribute:
channelcontentLanguageidofferIdtargetCountry
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. Benutzerdefinierte Gruppen sind daher nicht 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 gekürzt.
Entfernen von „Typ“ und „Einheit“ aus „customAttributes“
In Version 2.1 enthalten benutzerdefinierte Attribute keine type und unit mehr. Stattdessen müssen Einheiten an value angehängt werden (falls vorhanden) und die 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 Feld Singular productType und die restlichen im Feld „Wiederkehrend“ additionalProductTypes gespeichert wurden. In Version 2.1 wurden die beiden Felder durch ein einzelnes wiederkehrendes Feld productTypes ersetzt.
Das Attribut „Ziele“ wurde 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.
Umbenennen von AdWords-bezogenen Feldern
AdWords heißt jetzt Google Ads. Die folgenden AdWords-Felder wurden umbenannt:
adwordsGrouping->adsGroupingadwordsLabels->adsLabelsadwordsRedirect->adsRedirect
Entfernen nicht mehr unterstützter Felder
Die folgenden nicht mehr unterstützten Felder wurden entfernt:
aspectsdestinationsonlineOnlyvalidatedDestinationswarnings
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.
Entfernung von „dataQualityIssues“
Diese wurden durch itemLevelIssues ersetzt.