Index
ProductInputsService
(Schnittstelle)ProductsService
(Schnittstelle)Attributes
(Meldung)Certification
(Meldung)CloudExportAdditionalProperties
(Meldung)DeleteProductInputRequest
(Meldung)FreeShippingThreshold
(Meldung)GetProductRequest
(Meldung)InsertProductInputRequest
(Meldung)Installment
(Meldung)ListProductsRequest
(Meldung)ListProductsResponse
(Meldung)LoyaltyPoints
(Meldung)LoyaltyProgram
(Meldung)Product
(Meldung)ProductDetail
(Meldung)ProductDimension
(Meldung)ProductInput
(Meldung)ProductStatus
(Meldung)ProductStatus.DestinationStatus
(Meldung)ProductStatus.ItemLevelIssue
(Meldung)ProductStatus.ItemLevelIssue.Severity
(Aufzählung)ProductStructuredDescription
(Meldung)ProductStructuredTitle
(Meldung)ProductSustainabilityIncentive
(Meldung)ProductSustainabilityIncentive.Type
(Aufzählung)ProductWeight
(Meldung)Shipping
(Meldung)ShippingDimension
(Meldung)ShippingWeight
(Meldung)SubscriptionCost
(Meldung)SubscriptionPeriod
(Aufzählung)Tax
(Meldung)UnitPricingBaseMeasure
(Meldung)UnitPricingMeasure
(Meldung)
ProductInputsService
Dienst, für den die ProductInput-Ressource verwendet werden soll. Dieser Dienst funktioniert nur für Produkte mit Onlinekanal.
DeleteProductInput |
---|
Löscht eine Produkteingabe aus Ihrem Merchant Center-Konto. Nach dem Einfügen, Aktualisieren oder Löschen einer Produkteingabe kann es einige Minuten dauern, bis das verarbeitete Produkt abgerufen werden kann.
|
InsertProductInput |
---|
Hiermit wird eine Produkteingabe in Ihr Merchant Center-Konto hochgeladen. Wenn bereits eine Eingabe mit derselben contentLanguage, offerId und dataSource vorhanden ist, wird dieser Eintrag durch diese Methode ersetzt. Nach dem Einfügen, Aktualisieren oder Löschen einer Produkteingabe kann es einige Minuten dauern, bis das verarbeitete Produkt abgerufen werden kann.
|
ProductsService
Dienst, für den die Produktressource verwendet werden soll. Dieser Dienst funktioniert nur für Produkte mit Onlinekanal.
GetProduct |
---|
Ruft das verarbeitete Produkt aus Ihrem Merchant Center-Konto ab. Nach dem Einfügen, Aktualisieren oder Löschen einer Produkteingabe kann es einige Minuten dauern, bis das aktualisierte Endprodukt abgerufen werden kann.
|
ListProducts |
---|
Hier werden die verarbeiteten Produkte in Ihrem Merchant Center-Konto aufgeführt. Die Antwort enthält möglicherweise weniger Elemente als in „pageSize“ angegeben. Anhand des pageToken kannst du feststellen, ob weitere Elemente angefordert werden müssen. Nach dem Einfügen, Aktualisieren oder Löschen einer Produkteingabe kann es einige Minuten dauern, bis das aktualisierte verarbeitete Produkt abgerufen werden kann.
|
Attribute
Attribute
Felder | |
---|---|
additional_ |
Zusätzliche URLs von Bildern des Artikels. |
expiration_ |
Ablaufdatum des Artikels gemäß Eingabe im ISO 8601-Format. Das tatsächliche Ablaufdatum wird in |
disclosure_ |
Das Datum und die Uhrzeit, ab dem ein Angebot in den Suchergebnissen auf YouTube-Plattformen von Google angezeigt wird. Die Angabe erfolgt im ISO 8601-Format. Weitere Informationen finden Sie unter [Offenlegungsdatum]( https://support.google.com/merchants/answer/13034208). |
availability_ |
Der Tag, an dem ein vorbestelltes Produkt lieferbar ist. Die Angabe erfolgt im ISO 8601-Format. |
gtin[] |
Global Trade Item Numbers (GTIN) des Artikels. Sie können bis zu 10 GTINs angeben. |
price |
Preis des Artikels. |
installment |
Anzahl und Betrag der Raten für einen Artikel. |
subscription_ |
Anzahl der Abrechnungsperioden (Monate oder Jahre) und Zahlungsbetrag pro Abrechnungsperiode für einen Artikel mit einem zugehörigen Abovertrag. |
loyalty_ |
Treuepunkte, die Nutzer nach dem Kauf des Artikels erhalten. Nur Japan. |
loyalty_ |
Eine Liste mit Informationen zum Treuepunkteprogramm, die dem Nutzer dieses Artikels Treuevorteile (z. B. bessere Preise, Punkte usw.) anzeigen. |
product_ |
Kategorien des Artikels (formatiert wie in der Produktdatenspezifikation). |
sale_ |
Beworbener Sonderangebotspreis des Artikels. |
sale_ |
Zeitraum, in dem der Artikel als Sonderangebot erhältlich ist (siehe Produktdatenspezifikation). |
product_ |
Die Höhe des Produkts in den angegebenen Maßeinheiten. Der Wert muss zwischen 0 (ausschließlich) und 3.000 (einschließlich) liegen. |
product_ |
Die Länge des Produkts in den angegebenen Einheiten. Der Wert muss zwischen 0 (ausschließlich) und 3.000 (einschließlich) liegen. |
product_ |
Die Breite des Produkts in den angegebenen Einheiten. Der Wert muss zwischen 0 (ausschließlich) und 3.000 (einschließlich) liegen. |
product_ |
Das Gewicht des Produkts in den angegebenen Einheiten. Der Wert muss zwischen 0 (ausschließlich) und 2.000 (einschließlich) liegen. |
shipping[] |
Versandregeln |
free_ |
Bedingungen, die erfüllt sein müssen, damit ein Produkt kostenlos versendet werden kann. |
shipping_ |
Gewicht des Artikels für den Versand. |
shipping_ |
Länge des Artikels für den Versand. |
shipping_ |
Breite des Artikels für den Versand. |
shipping_ |
Höhe des Artikels für den Versand. |
size_ |
Der Schnitt des Artikels. Er kann verwendet werden, um kombinierte Größentypen für Bekleidungsartikel anzugeben. Es können maximal zwei Größentypen angegeben werden (siehe [https://support.google.com/merchants/answer/6324497](Größentyp)). |
taxes[] |
Steuerinformationen. |
unit_ |
Die Maße und Abmessungen eines Artikels. |
unit_ |
Die Präferenz des Nenners des Stückpreises. |
ads_ |
Ähnlich wie „ads_grouping“, funktioniert aber nur für CPC. |
cost_ |
Selbstkosten Wird für Berichte zum Bruttogewinn verwendet. |
product_ |
Technische Daten oder zusätzliche Produktdetails |
product_ |
Aufzählungspunkte, in denen die wichtigsten Highlights eines Produkts beschrieben werden. |
display_ |
Vom Werbetreibenden angegebene Empfehlungen. |
promotion_ |
Die eindeutige ID eines Angebots. |
included_ |
Liste der Ziele, die für dieses Ziel eingeschlossen werden sollen (entspricht markierten Kästchen im Merchant Center). Standardziele sind immer enthalten, sofern sie nicht unter |
excluded_ |
Liste der Ziele, die für dieses Ziel ausgeschlossen werden sollen (entspricht nicht markierten Kästchen im Merchant Center). |
shopping_ |
Liste der Ländercodes (ISO 3166-1 alpha-2), die das Angebot vom Shopping-Anzeigen-Ziel ausschließen sollen. Länder aus dieser Liste werden aus den in den Datenquelleneinstellungen konfigurierten Ländern entfernt. |
lifestyle_ |
Zusätzliche URLs von Lifestyle-Bildern des Artikels, mit denen Bilder explizit gekennzeichnet werden, die Ihren Artikel in einem realen Kontext zeigen. Weitere Informationen finden Sie in diesem Hilfeartikel. |
cloud_ |
Zusätzliche Felder, die in das Cloud Retail-Programm exportiert werden sollen. |
certifications[] |
Produktzertifizierungen, z. B. für die Energieeffizienzkennzeichnung von Produkten, die in der EU EPREL-Datenbank registriert sind. Weitere Informationen finden Sie in diesem Hilfeartikel. |
auto_ |
Eine Sicherheitsmaßnahme in den Projekten „Automatische Rabatte“ (https://support.google.com/merchants/answer/10295759) und „Dynamische Angebote“ (https://support.google.com/merchants/answer/13949249), die dafür sorgt, dass Rabatte auf Angebote von Händlern nicht unter diesen Wert fallen, wodurch der Wert und die Rentabilität des Angebots erhalten bleiben. |
sustainability_ |
Die Liste der Nachhaltigkeits-Anreizprogramme. |
identifier_ |
Legen Sie diesen Wert auf „falsch“ fest, wenn der Artikel keine eindeutigen Produktkennzeichnungen für seine Kategorie hat, z. B. GTIN, MPN und Marke. Wenn kein Wert angegeben ist, wird standardmäßig „true“ verwendet. |
is_ |
Gibt an, ob es sich bei dem Artikel um ein vom Händler zusammengestelltes Set handelt. Ein Set ist eine benutzerdefinierte Gruppe verschiedener Produkte, die von einem Händler zu einem Gesamtpreis verkauft werden. |
title |
Bezeichnung des Artikels |
description |
Beschreibung des Artikels. |
link |
URL, die direkt auf die Seite des Artikels in Ihrem Onlineshop verweist |
mobile_ |
URL der für Mobilgeräte optimierten Version der Landingpage Ihres Artikels. |
canonical_ |
URL für die kanonische Version der Landingpage des Artikels. |
image_ |
URL eines Bildes des Artikels. |
adult |
Legen Sie „true“ fest, wenn der Artikel für Erwachsene vorgesehen ist. |
age_ |
Die Alterszielgruppe des Artikels. |
availability |
Verfügbarkeitsstatus des Artikels. |
brand |
Marke des Artikels. |
color |
Farbe des Artikels. |
condition |
Zustand des Artikels. |
gender |
Geschlecht, für das der Artikel vorgesehen ist. |
google_ |
Die Google-Kategorie des Artikels (siehe Google-Produkt-Taxonomie). Bei der Abfrage von Produkten enthält dieses Feld den vom Nutzer angegebenen Wert. Derzeit gibt es keine Möglichkeit, die automatisch zugewiesenen Google-Produktkategorien über die API abzurufen. |
item_ |
Gemeinsame Kennung für alle Varianten desselben Produkts. |
material |
Das Material, aus dem der Artikel besteht. |
mpn |
Die Teilenummer des Herstellers (MPN) des Artikels. |
pattern |
Das Muster des Artikels (z. B. Polka Dots) |
sell_ |
Die Menge des Produkts, die auf Google zum Verkauf steht. Wird nur für Onlineprodukte unterstützt. |
max_ |
Maximale Bearbeitungszeit für Produkte (in Arbeitstagen). |
min_ |
Minimale Bearbeitungszeit für das Produkt (in Arbeitstagen). |
shipping_ |
Das Versandlabel des Produkts, mit dem das Produkt in Versandregeln auf Kontoebene gruppiert wird. |
transit_ |
Das Laufzeitlabel des Produkts, mit dem Produkte in Laufzeittabellen auf Kontoebene gruppiert werden. |
size |
Größe des Artikels. Es ist nur ein Wert zulässig. Fügen Sie für Varianten mit unterschiedlichen Größen ein separates Produkt für jede Größe mit demselben |
size_ |
System, in dem die Größe angegeben ist. Empfohlen für Bekleidungsartikel. |
tax_ |
Die Steuerkategorie des Produkts. |
energy_ |
Die Energieeffizienzklasse gemäß EU-Richtlinie 2010/30/EU. |
min_ |
Die Energieeffizienzklasse gemäß EU-Richtlinie 2010/30/EU. |
max_ |
Die Energieeffizienzklasse gemäß EU-Richtlinie 2010/30/EU. |
multipack |
Die Anzahl identischer Produkte in einem händlerdefinierten Multipack. |
ads_ |
Dient der Gruppierung von Artikeln auf beliebige Weise. Nur für CPA%, andernfalls nicht empfohlen. |
ads_ |
Hiermit können Werbetreibende die Artikel-URL überschreiben, wenn das Produkt im Kontext von Produktanzeigen präsentiert wird. |
display_ |
Eine Kennzeichnung für einen Artikel in dynamischen Remarketing-Kampagnen. |
display_ |
Titel eines Artikels für dynamische Remarketing-Kampagnen. |
display_ |
Direkte URL zur Landingpage für dynamische Remarketing-Kampagnen Ihres Artikels. |
display_ |
Angebotsgewinnmarge für dynamische Remarketing-Kampagnen. |
pickup_ |
Die Abholoption für den Artikel. |
pickup_ |
Zeitfenster für die Abholung des Artikels im Geschäft. |
link_ |
Linkvorlage für vom Händler gehostete Verkäuferseite. |
mobile_ |
Linkvorlage für vom Händler gehostete Verkäuferseite, optimiert für Mobilgeräte. |
custom_ |
Benutzerdefiniertes Label 0 für die benutzerdefinierte Gruppierung von Artikeln in einer Shopping-Kampagne. |
custom_ |
Benutzerdefiniertes Label 1 für die benutzerdefinierte Gruppierung von Artikeln in einer Shopping-Kampagne. |
custom_ |
Benutzerdefiniertes Label 2 für die benutzerdefinierte Gruppierung von Artikeln in einer Shopping-Kampagne. |
custom_ |
Benutzerdefiniertes Label 3 für die benutzerdefinierte Gruppierung von Artikeln in einer Shopping-Kampagne. |
custom_ |
Benutzerdefiniertes Label 4 für die benutzerdefinierte Gruppierung von Artikeln in einer Shopping-Kampagne. |
external_ |
Erforderlich für Mehrfachkundenkonten. Verwenden Sie dieses Attribut, wenn Sie ein Marktplatz sind, der Produkte für verschiedene Verkäufer in ein Mehrfachkundenkonto hochlädt. |
pause |
Die Veröffentlichung dieses Elements wird vorübergehend pausiert. |
virtual_ |
URL des 3D‑Bilds des Artikels. Weitere Informationen finden Sie in diesem Hilfeartikel. |
structured_ |
„Strukturierter Titel“ für algorithmisch (KI-)generierte Titel. |
structured_ |
„Strukturierte Beschreibung“ für algorithmisch (KI) generierte Beschreibungen. |
Zertifizierung
Zertifizierung von Produkten, die ursprünglich für die Einhaltung der EU-Verordnung zur Kennzeichnung der Energieeffizienz mithilfe der EPREL-Datenbank eingeführt wurde.
Felder | |
---|---|
certification_ |
Die Zertifizierungsstelle, z. B. „European_Commission“. Die maximale Länge beträgt 2.000 Zeichen. |
certification_ |
Der Name der Zertifizierung, z. B. „EPREL“. Die maximale Länge beträgt 2.000 Zeichen. |
certification_ |
Der Zertifizierungscode. Die maximale Länge beträgt 2.000 Zeichen. |
certification_ |
Der Zertifizierungswert (auch als Klasse, Stufe oder Note bezeichnet), z. B. „A+“, „C“ oder „Gold“. Die maximale Länge beträgt 2.000 Zeichen. |
CloudExportAdditionalProperties
Produkteigenschaft für die Cloud Retail API. Beispiele für Properties für ein Fernseherprodukt sind „Bildschirmauflösung“ oder „Bildschirmgröße“.
Felder | |
---|---|
text_ |
Textwert der angegebenen Property. „8K(UHD)“ könnte beispielsweise ein Textwert für ein Fernsehprodukt sein. Dieser Wert kann maximal 400-mal wiederholt werden. Die Werte werden in einer beliebigen, aber einheitlichen Reihenfolge gespeichert. Die maximale Stringgröße beträgt 256 Zeichen. |
int_ |
Ganzzahlwerte der angegebenen Property. Beispiel: 1080 für die Bildschirmauflösung eines Fernsehers. Dieser Wert kann maximal 400-mal wiederholt werden. Die Werte werden in einer beliebigen, aber einheitlichen Reihenfolge gespeichert. |
float_ |
Gleitkommawerte der angegebenen Property. Beispiel: 1.2345 für ein Fernsehprodukt. Dieser Wert kann maximal 400-mal wiederholt werden. Die Werte werden in einer beliebigen, aber einheitlichen Reihenfolge gespeichert. |
property_ |
Name der Property. Beispiel: „Bildschirmauflösung“ für ein Fernseherprodukt. Die maximale Stringgröße beträgt 256 Zeichen. |
bool_ |
Boolescher Wert der angegebenen Property. Beispiel: Bei einem Fernseher „True“ oder „False“, wenn der Bildschirm UHD hat. |
min_ |
Mindestwert der Gleitkommazahl der angegebenen Property. Beispiel: 1.00 für ein Fernsehprodukt. |
max_ |
Maximaler Gleitkommawert der angegebenen Property. Beispiel: 100,00 € für ein Fernsehprodukt. |
unit_ |
Einheit der angegebenen Unterkunft. Beispiel: „Pixel“ für ein Fernseherprodukt. Die maximale Stringgröße beträgt 256 Byte. |
DeleteProductInputRequest
Anfragenachricht für die Methode „DeleteProductInput“.
Felder | |
---|---|
name |
Erforderlich. Der Name der zu löschenden Produkteingaberessource. Format: accounts/{account}/productInputs/{product}, wobei der letzte Abschnitt |
data_ |
Erforderlich. Die primäre oder zusätzliche Datenquelle, aus der die Produkteingabe gelöscht werden soll. Format: |
FreeShippingThreshold
Bedingungen, die erfüllt sein müssen, damit ein Produkt kostenlos versendet werden kann.
Felder | |
---|---|
country |
Der CLDR-Regionalcode des Landes, in das ein Artikel versendet wird. |
price_ |
Der Mindestproduktpreis, ab dem der Versand kostenlos ist. Wird als Zahl dargestellt. |
GetProductRequest
Anfragenachricht für die Methode „GetProduct“.
Felder | |
---|---|
name |
Erforderlich. Der Name des abzurufenden Produkts. Format: |
InsertProductInputRequest
Anfragenachricht für die Methode „InsertProductInput“.
Felder | |
---|---|
parent |
Erforderlich. Das Konto, in das dieses Produkt eingefügt werden soll. Format: accounts/{account} |
product_ |
Erforderlich. Die einzufügende Produkteingabe. |
data_ |
Erforderlich. Der Name der primären oder ergänzenden Produktdatenquelle. Wenn das Produkt bereits vorhanden ist und die angegebene Datenquelle sich unterscheidet, wird es in eine neue Datenquelle verschoben. Es werden nur API-Datenquellen unterstützt. Format: |
Rate
Eine Nachricht, die eine Rate darstellt.
Felder | |
---|---|
months |
Die Anzahl der Raten, die der Käufer zahlen muss. |
amount |
Der Betrag, den der Käufer monatlich zahlen muss. |
downpayment |
Der Betrag der Anzahlung, die der Käufer vorab zahlen muss. |
credit_ |
Art der Ratenzahlungen. Unterstützte Werte: * „ |
ListProductsRequest
Anfragenachricht für die Methode „ListProducts“.
Felder | |
---|---|
parent |
Erforderlich. Das Konto, für das verarbeitete Produkte aufgeführt werden sollen. Format: accounts/{account} |
page_ |
Die maximale Anzahl der Produkte, die zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Der Höchstwert beträgt 250. Werte über 250 werden auf 250 festgelegt. Wenn nicht angegeben, wird die maximale Anzahl von Produkten zurückgegeben. |
page_ |
Ein Seitentoken, das von einem vorherigen Beim Paginieren müssen alle anderen für |
ListProductsResponse
Antwortnachricht für die Methode „ListProducts“.
Felder | |
---|---|
products[] |
Die verarbeiteten Produkte aus dem angegebenen Konto. Das sind Ihre verarbeiteten Produkte nach Anwendung von Regeln und ergänzenden Datenquellen. |
next_ |
Ein Token, das als |
LoyaltyPoints
Eine Nachricht, die Treuepunkte darstellt.
Felder | |
---|---|
name |
Name des Treuepunkteprogramms. Wir empfehlen, den Namen auf 12 vollbreite Zeichen oder 24 lateinische Buchstaben zu beschränken. |
points_ |
Die Treuepunkte des Einzelhändlers im absoluten Wert. |
ratio |
Das Verhältnis, in dem ein Punkt in reguläres Geld umgerechnet wird. Google verwendet die Währung, die in den Merchant Center-Einstellungen festgelegt ist. Wenn das Verhältnis weggelassen wird, wird standardmäßig 1,0 verwendet. |
LoyaltyProgram
Eine Nachricht, die für das Treuepunkteprogramm steht.
Felder | |
---|---|
program_ |
Das Label des Treuepunkteprogramms. Dies ist ein internes Label, das die Beziehung zwischen einer Händlerentität und einer Treuepunkteprogramm-Entität eindeutig identifiziert. Das Label muss angegeben werden, damit das System die folgenden Assets (z. B. Preis und Punkte) einem Händler zuordnen kann. Das entsprechende Programm muss mit dem Händlerkonto verknüpft sein. |
tier_ |
Das Label der Stufe im Treuepunkteprogramm. Muss mit einem der Labels im Programm übereinstimmen. |
price |
Der Preis für Mitglieder der jeweiligen Stufe, also der sofortige Rabattpreis. Muss kleiner oder gleich dem Normalpreis sein. |
cashback_ |
Der Cashback, der für zukünftige Käufe verwendet werden kann. |
loyalty_ |
Die Anzahl der Treuepunkte, die mit einem Kauf gesammelt wurden. |
member_ |
Ein Zeitraum, in dem der Artikel zum Mitgliederpreis erhältlich ist. Wenn keine Angabe erfolgt, gilt immer der Mitgliederpreis. Der Zeitraum wird durch zwei ISO 8601-Daten dargestellt, die durch ein Leerzeichen, Komma oder einen Schrägstrich getrennt sind. |
shipping_ |
Das Label des Versandvorteils. 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. |
Produkt
Das verarbeitete Produkt, das nach Anwenden von Regeln und zusätzlichen Datenquellen aus mehreren product inputs
erstellt wurde. Dieses verarbeitete Produkt stimmt mit den Angaben in Ihrem Merchant Center-Konto sowie in Shopping-Anzeigen und auf anderen Plattformen auf Google überein. Jedes Produkt wird aus genau einer Produkteingabe der primären Datenquelle und mehreren Eingaben der ergänzenden Datenquelle erstellt. Nach dem Einfügen, Aktualisieren oder Löschen einer Produkteingabe kann es einige Minuten dauern, bis das aktualisierte verarbeitete Produkt abgerufen werden kann.
Alle Felder im verarbeiteten Produkt und in seinen untergeordneten Nachrichten stimmen mit einigen Ausnahmen mit dem Namen des entsprechenden Attributs in der Produktdatenspezifikation überein.
Felder | |
---|---|
name |
Der Name des Produkts. Format: |
channel |
Nur Ausgabe. Der Kanal des Produkts. |
offer_ |
Nur Ausgabe. Ihre eindeutige Kennung für das Produkt. Das gilt sowohl für die Produkteingaben als auch für das verarbeitete Produkt. Vorangehende und nachstehende Leerzeichen werden entfernt und mehrere Leerzeichen werden beim Senden durch ein einzelnes Leerzeichen ersetzt. Weitere Informationen finden Sie in der Produktdatenspezifikation. |
content_ |
Nur Ausgabe. Der aus zwei Buchstaben bestehende ISO 639-1-Sprachcode für das Produkt. |
feed_ |
Nur Ausgabe. Das Feedlabel für das Produkt. |
data_ |
Nur Ausgabe. Die primäre Datenquelle des Produkts. |
attributes |
Nur Ausgabe. Eine Liste von Produktattributen. |
custom_ |
Nur Ausgabe. Eine Liste benutzerdefinierter (vom Händler bereitgestellter) Attribute. Außerdem können Sie damit jedes Attribut der Datenspezifikation in seiner generischen Form einreichen (z. B. |
product_ |
Nur Ausgabe. Der Status eines Produkts, Probleme mit der Datenvalidierung, d. h. Informationen zu einem Produkt, die asynchron berechnet werden. |
version_ |
Nur Ausgabe. Stellt die vorhandene Version (Aktualität) des Produkts dar. Damit kann die richtige Reihenfolge bei mehreren gleichzeitigen Aktualisierungen beibehalten werden. Wenn diese Option festgelegt ist, wird die Einfügung verhindert, wenn die Versionsnummer niedriger als die aktuelle Versionsnummer des vorhandenen Produkts ist. Die erneute Einfügung (z. B. Produktaktualisierung nach 30 Tagen) kann mit der aktuellen Nur für Einfügungen in primäre Datenquellen unterstützt. Wenn der Vorgang verhindert wird, wird die abgebrochene Ausnahme ausgelöst. |
ProductDetail
Die Produktdetails.
Felder | |
---|---|
section_ |
Die Abschnittsüberschrift, mit der eine Reihe von Produktdetails gruppiert wird. |
attribute_ |
Der Name des Produktdetails. |
attribute_ |
Der Wert des Produktdetails. |
ProductDimension
Die Größe des Produkts.
Felder | |
---|---|
value |
Erforderlich. Der Dimensionswert als Zahl. Der Wert kann maximal vier Dezimalstellen haben. |
unit |
Erforderlich. Die Maßeinheiten der Dimension. Zulässige Werte sind: * „ |
ProductInput
Diese Ressource enthält die Eingabedaten, die Sie für ein Produkt einreichen, nicht das verarbeitete Produkt, das Sie im Merchant Center, in Shopping-Anzeigen oder auf Google-Plattformen sehen. Produkteingaben, Regeln und Daten aus zusätzlichen Datenquellen werden kombiniert, um die verarbeiteten Product
zu erstellen.
Die erforderlichen Eingabeattribute für Produkte, die die Datenvalidierungschecks bestehen müssen, sind in erster Linie in der Produktdatenspezifikation definiert.
Die folgenden Attribute sind erforderlich: feedLabel
, contentLanguage
und offerId
.
Nach dem Einfügen, Aktualisieren oder Löschen einer Produkteingabe kann es einige Minuten dauern, bis das verarbeitete Produkt abgerufen werden kann.
Alle Felder in der Produkteingabe und ihren untergeordneten Nachrichten stimmen mit dem englischen Namen des entsprechenden Attributs in der Branchenspezifikation überein, mit einigen Ausnahmen.
Felder | |
---|---|
name |
Kennung. Der Name der Produkteingabe. Format: |
product |
Nur Ausgabe. Der Name des verarbeiteten Produkts. Format: |
channel |
Nicht veränderbar. Der Kanal des Produkts. |
offer_ |
Erforderlich. Nicht veränderbar. Ihre eindeutige Kennung für das Produkt. Das gilt sowohl für die Produktaufnahme als auch für das verarbeitete Produkt. Vorangehende und nachstehende Leerzeichen werden entfernt und mehrere Leerzeichen werden beim Senden durch ein einzelnes Leerzeichen ersetzt. Weitere Informationen finden Sie in der Produktdatenspezifikation. |
content_ |
Erforderlich. Nicht veränderbar. Der zweistellige ISO 639-1-Sprachcode für das Produkt. |
feed_ |
Erforderlich. Nicht veränderbar. Das Feedlabel für das Produkt. |
attributes |
Optional. Eine Liste von Produktattributen. |
custom_ |
Optional. Eine Liste benutzerdefinierter (vom Händler bereitgestellter) Attribute. Außerdem kann es zum Einreichen beliebiger Attribute der Datenspezifikation in ihrer generischen Form verwendet werden (z. B. |
version_ |
Optional. Stellt die vorhandene Version (Aktualität) des Produkts dar. Damit kann die richtige Reihenfolge bei mehreren gleichzeitigen Aktualisierungen beibehalten werden. Wenn diese Option festgelegt ist, wird die Einfügung verhindert, wenn die Versionsnummer niedriger als die aktuelle Versionsnummer des vorhandenen Produkts ist. Die erneute Einfügung (z. B. Produktaktualisierung nach 30 Tagen) kann mit der aktuellen Nur für Einfügungen in primäre Datenquellen unterstützt. Wenn der Vorgang verhindert wird, wird die abgebrochene Ausnahme ausgelöst. |
ProductStatus
Der Status eines Produkts, Probleme mit der Datenvalidierung, d. h. Informationen zu einem Produkt, die asynchron berechnet werden.
Felder | |
---|---|
destination_ |
Die vorgesehenen Ziele des Produkts |
item_ |
Eine Liste aller Probleme im Zusammenhang mit dem Produkt. |
creation_ |
Das Datum, an dem der Artikel erstellt wurde, im ISO 8601-Format. |
last_ |
Datum, an dem der Artikel zuletzt aktualisiert wurde. Die Angabe erfolgt im ISO 8601-Format. |
google_ |
Datum, an dem das Element abläuft, im ISO 8601-Format. |
DestinationStatus
Der Zielstatus des Produktstatus.
Felder | |
---|---|
reporting_ |
Der Name des Berichtskontexts. |
approved_ |
Liste der Ländercodes (ISO 3166-1 alpha-2), in denen das Angebot genehmigt wurde. |
pending_ |
Liste der Ländercodes (ISO 3166-1 alpha-2), für die das Angebot noch nicht genehmigt wurde. |
disapproved_ |
Liste der Ländercodes (ISO 3166-1 alpha-2), in denen das Angebot abgelehnt wurde. |
ItemLevelIssue
Das Problem auf Artikelebene des Produktstatus.
Felder | |
---|---|
code |
Der Fehlercode des Problems |
severity |
Wie sich dieses Problem auf die Zustellung des Angebots auswirkt. |
resolution |
Ob das Problem vom Händler behoben werden kann. |
attribute |
Der Attributname, falls das Problem durch ein einzelnes Attribut verursacht wird. |
reporting_ |
Der Berichtskontext, auf den sich das Problem bezieht. |
description |
Eine kurze Problembeschreibung in Englisch. |
detail |
Ausführliche Problembeschreibung in Englisch. |
documentation |
Die URL einer Webseite, die bei der Lösung des Problems helfen kann. |
applicable_ |
Liste der Ländercodes (ISO 3166-1 alpha-2), auf die das Problem zutrifft. |
Schweregrad
Wie sich das Problem auf die Auslieferung des Produkts auswirkt.
Enums | |
---|---|
SEVERITY_UNSPECIFIED |
Nicht angegeben. |
NOT_IMPACTED |
Dieses Problem ist eine Warnung und hat keine direkten Auswirkungen auf das Produkt. |
DEMOTED |
Das Produkt wird herabgestuft und hat höchstwahrscheinlich eine eingeschränkte Leistung in den Suchergebnissen. |
DISAPPROVED |
Das Produkt wird aufgrund des Problems abgelehnt. |
ProductStructuredDescription
„Strukturierte Beschreibung“ für algorithmisch (KI) generierte Beschreibungen.
Felder | |
---|---|
digital_ |
Der Typ der digitalen Quelle, z. B. „trained_algorithmic_media“. Sie folgen den IPTC. Maximale Länge: 40 Zeichen. |
content |
Die maximale Länge des Beschreibungstexts beträgt 5.000 Zeichen. |
ProductStructuredTitle
„Strukturierter Titel“ für algorithmisch (KI-)generierte Titel.
Felder | |
---|---|
digital_ |
Der Typ der digitalen Quelle, z. B. „trained_algorithmic_media“. Sie folgen den IPTC. Maximale Länge: 40 Zeichen. |
content |
Der Titel darf maximal 150 Zeichen lang sein. |
ProductSustainabilityIncentive
Informationen zu umweltfreundlichen Anreizprogrammen wie Rabatten oder Steuererleichterungen.
Felder | |
---|---|
Union-Feld value . Wert des Nachhaltigkeitsanreizes. Für value ist nur einer der folgenden Werte zulässig: |
|
amount |
Der feste Betrag des Incentives. |
percentage |
Der Prozentsatz des Sonderangebotspreises, auf den der Anreiz angewendet wird. |
type |
Incentive-Programm für Nachhaltigkeit |
Typ
Arten von unterstützten Programmen zur Förderung von Nachhaltigkeit
Enums | |
---|---|
TYPE_UNSPECIFIED |
Nicht angegebener oder unbekannter Nachhaltigkeits-Anreiztyp. |
EV_TAX_CREDIT |
Programm mit Steuererleichterungen für Elektrofahrzeuge und in einigen Ländern auch für Plug-in-Hybride. Diese Rabatte können auf einem bestimmten Betrag oder einem Prozentsatz des Sonderangebotspreises basieren. |
EV_PRICE_DISCOUNT |
Ein Subventionsprogramm, oft als Umweltbonus bezeichnet, bietet einen Kaufzuschuss für Elektrofahrzeuge und in einigen Ländern auch für Plug-in-Hybride. Der Zuschussbetrag kann eine feste Summe oder ein Prozentsatz des Verkaufspreises sein. |
ProductWeight
Das Gewicht des Produkts.
Felder | |
---|---|
value |
Erforderlich. Die Gewichtung als Zahl. Das Gewicht kann mit einer maximalen Genauigkeit von vier Dezimalstellen angegeben werden. |
unit |
Erforderlich. Die Gewichtseinheit. Zulässige Werte sind: * „ |
Versand
Versand des Produkts.
Felder | |
---|---|
price |
Fester Versandpreis, dargestellt als Zahl. |
country |
Der CLDR-Regionalcode des Landes, in das ein Artikel versendet wird. |
region |
Die geografische Region, für die ein Versandpreis gilt. Weitere Informationen finden Sie unter region. |
service |
Eine kostenlose Beschreibung der Serviceklasse oder Versandgeschwindigkeit. |
location_ |
Die numerische ID eines Standorts, für den der Versandpreis gilt, wie in der AdWords API definiert. |
location_ |
Der Ort, für den der Versand gilt, dargestellt durch einen Standortgruppennamen. |
postal_ |
Der Postleitzahlenbereich, auf den sich der Versandpreis bezieht, dargestellt durch eine Postleitzahl, ein Postleitzahlenpräfix gefolgt von einem Platzhalter * oder einem Bereich zwischen zwei Postleitzahlen oder zwei Postleitzahlenpräfixen gleicher Länge. |
min_ |
Die minimale Bearbeitungszeit (inbegriffen) zwischen dem Eingang der Bestellung und dem Versand in Arbeitstagen. „0“ bedeutet, dass die Bestellung am selben Tag versendet wird, an dem sie eingegangen ist, sofern dies vor Annahmeschluss erfolgt. |
max_ |
Maximale Bearbeitungszeit (inbegriffen) zwischen dem Eingang der Bestellung und dem Versand in Arbeitstagen. „0“ bedeutet, dass die Bestellung am selben Tag versendet wird, an dem sie eingegangen ist, sofern dies vor Annahmeschluss erfolgt. Sowohl |
min_ |
Minimale Lieferzeit (einschließlich) zwischen dem Versand der Bestellung und der Zustellung in Arbeitstagen. „0“ bedeutet, dass die Bestellung am selben Tag geliefert wird, an dem sie versendet wird. |
max_ |
Maximale Lieferzeit (einschließlich) zwischen dem Versand der Bestellung und der Zustellung in Arbeitstagen. „0“ bedeutet, dass die Bestellung am selben Tag geliefert wird, an dem sie versendet wird. Sowohl |
ShippingDimension
Die Versandabmessung des Produkts.
Felder | |
---|---|
value |
Die Größe des Produkts, die zur Berechnung der Versandkosten des Artikels herangezogen wird. |
unit |
Die Maßeinheit. |
ShippingWeight
Das Versandgewicht des Produkts.
Felder | |
---|---|
value |
Das Gewicht des Produkts, das zur Berechnung der Versandkosten des Artikels herangezogen wird. |
unit |
Die Maßeinheit. |
SubscriptionCost
Die Abokosten des Produkts.
Felder | |
---|---|
period |
Die Art des Abozeitraums. Unterstützte Werte: * „ |
period_ |
Die Anzahl der Abrechnungsperioden, die der Käufer zahlen muss. |
amount |
Der Betrag, den der Käufer pro Abozeitraum zahlen muss. |
SubscriptionPeriod
Die Abolaufzeit des Produkts.
Enums | |
---|---|
SUBSCRIPTION_PERIOD_UNSPECIFIED |
Gibt an, dass die Abolaufzeit nicht angegeben ist. |
MONTH |
Gibt an, dass die Abolaufzeit ein Monat ist. |
YEAR |
Gibt an, dass die Abolaufzeit ein Jahr beträgt. |
Steuern
Die Steuer für das Produkt.
Felder | |
---|---|
rate |
Der Prozentsatz des Steuersatzes, der auf den Artikelpreis angewendet wird. |
country |
Das Land, in dem der Artikel besteuert wird, als CLDR-Regionalcode angegeben. |
region |
Die geografische Region, für die der Steuersatz gilt. |
tax_ |
Legen Sie „true“ fest, wenn für den Versand eine Steuer erhoben wird. |
location_ |
Die numerische ID eines Standorts, für den der Steuersatz gilt, wie in der AdWords API definiert. |
postal_ |
Der Postleitzahlenbereich, auf den sich der Steuersatz bezieht, dargestellt durch eine Postleitzahl, ein Postleitzahlenpräfix mit dem Platzhalter * oder einen Bereich zwischen zwei Postleitzahlen oder zwei Postleitzahlenpräfixen gleicher Länge. Beispiele: 94114, 94*, 94002–95460, 94*–95*. |
UnitPricingBaseMeasure
Das Einheitsmaß des Grundpreises des Produkts.
Felder | |
---|---|
value |
Der Nenner des Stückpreises. |
unit |
Die Einheit des Nenners. |
UnitPricingMeasure
Die Maßeinheit für den Stückpreis des Produkts.
Felder | |
---|---|
value |
Die Maßeinheit eines Artikels. |
unit |
Die Maßeinheit. |