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)ProductWeight(Meldung)Shipping(Meldung)ShippingDimension(Meldung)ShippingWeight(Meldung)SubscriptionCost(Meldung)SubscriptionPeriod(Aufzählung)Tax(Meldung)UnitPricingBaseMeasure(Meldung)UnitPricingMeasure(Meldung)
ProductInputsService
Dienst zur Verwendung der ProductInput-Ressource. Dieser Dienst funktioniert nur für Produkte mit Onlinekanälen.
| 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 |
|---|
|
Lädt eine Produkteingabe in Ihr Merchant Center-Konto hoch. Wenn bereits eine Eingabe mit denselben Werten für 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 zur Verwendung der Produktressource. Dieser Dienst funktioniert nur für Produkte mit Onlinekanälen.
| 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 |
|---|
|
Listet die verarbeiteten Produkte in Ihrem Merchant Center-Konto auf. Die Antwort enthält möglicherweise weniger Elemente als durch pageSize angegeben. Mithilfe von pageToken können Sie feststellen, ob weitere Elemente angefordert werden können. 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_image_links[] |
Zusätzliche URLs von Bildern des Artikels |
expiration_date |
Das Datum, an dem der Artikel wie bei der Eingabe angegeben abläuft. Die Angabe erfolgt im ISO 8601-Format. Das tatsächliche Ablaufdatum wird in |
disclosure_date |
Der Zeitpunkt, an dem ein Angebot in den Suchergebnissen auf allen YouTube-Plattformen von Google erscheint. Die Angabe erfolgt im ISO 8601-Format. Weitere Informationen finden Sie unter [Datum der Bekanntgabe]( https://support.google.com/merchants/answer/13034208). |
availability_date |
Der Tag, an dem ein vorbestelltes Produkt lieferbar wird. Die Angabe erfolgt im ISO 8601-Format. |
price |
Preis des Artikels. |
installment |
Anzahl und Betrag der für einen Artikel zu zahlenden Raten. |
subscription_cost |
Anzahl der Perioden (Monate oder Jahre) und Zahlungsbetrag pro Periode für einen Artikel mit einem zugehörigen Abovertrag. |
loyalty_points |
Treuepunkte, die Nutzer nach dem Kauf des Artikels erhalten. Nur Japan. |
loyalty_programs[] |
Eine Liste mit Informationen zum Treuepunkteprogramm, die verwendet werden, um dem Nutzer dieses Artikels Treuepunkte (z. B. bessere Preise oder Punkte) zu präsentieren. |
product_types[] |
Kategorien des Artikels im Format der Produktdatenspezifikation. |
sale_price |
Der beworbene Sonderangebotspreis für den Artikel. |
sale_price_effective_date |
Zeitraum, in dem der Artikel im Angebot ist (siehe Produktdatenspezifikation). |
product_height |
Die Höhe des Produkts in den angegebenen Einheiten. Der Wert muss zwischen 0 (ausschließlich) und 3.000 (einschließlich) liegen. |
product_length |
Die Länge des Produkts in den angegebenen Einheiten. Der Wert muss zwischen 0 (ausschließlich) und 3.000 (einschließlich) liegen. |
product_width |
Die Breite des Produkts in den angegebenen Einheiten. Der Wert muss zwischen 0 (ausschließlich) und 3.000 (einschließlich) liegen. |
product_weight |
Das Gewicht des Produkts in den angegebenen Einheiten. Der Wert muss zwischen 0 (ausschließlich) und 2.000 (einschließlich) liegen. |
shipping[] |
Versandregeln. |
free_shipping_threshold[] |
Bedingungen, die für einen kostenlosen Versand eines Produkts erfüllt werden müssen. |
shipping_weight |
Versandgewicht des Artikels. |
shipping_length |
Länge des Artikels für den Versand. |
shipping_width |
Breite des Artikels für den Versand. |
shipping_height |
Höhe des Artikels für den Versand |
size_types[] |
Der Schnitt des Artikels. Sie können damit kombinierte Größentypen für Bekleidungsartikel darstellen. Es können maximal zwei Größentypen angegeben werden (siehe [https://support.google.com/merchants/answer/6324497](Größentyp)). |
taxes[] |
Steuerinformationen. |
unit_pricing_measure |
Maß und Abmessungen eines Artikels. |
unit_pricing_base_measure |
Die Präferenz des Nenners des Stückpreises. |
ads_labels[] |
Ähnlich wie „ads_grouping“, funktioniert aber nur in Verbindung mit CPC. |
cost_of_goods_sold |
Selbstkosten Wird für Berichte zum Bruttogewinn verwendet. |
product_details[] |
Technische Spezifikationen oder zusätzliche Produktdetails. |
product_highlights[] |
Aufzählungspunkte, mit denen die wichtigsten Highlights eines Produkts beschrieben werden. |
display_ads_similar_ids[] |
Vom Werbetreibenden angegebene Empfehlungen |
promotion_ids[] |
Die eindeutige ID eines Angebots. |
included_destinations[] |
Die Liste der Ziele, die für dieses Ziel eingeschlossen werden sollen (entspricht den angeklickten Kästchen im Merchant Center). Standardziele sind immer eingeschlossen, sofern sie nicht in |
excluded_destinations[] |
Die Liste der Ziele, die für dieses Ziel ausgeschlossen werden sollen (entspricht nicht Häkchen im Merchant Center). |
shopping_ads_excluded_countries[] |
Liste der Ländercodes (ISO 3166-1 alpha-2), mit denen das Angebot von der Zielanwendung von Shopping-Anzeigen ausgeschlossen werden soll. Länder aus dieser Liste werden aus den Ländern entfernt, die in den Einstellungen der Datenquelle konfiguriert wurden. |
lifestyle_image_links[] |
Zusätzliche URLs von Lifestyle-Bildern des Artikels, mit denen explizit Bilder identifiziert werden können, die Ihren Artikel in einem realen Kontext zeigen. Weitere Informationen finden Sie in diesem Hilfeartikel. |
cloud_export_additional_properties[] |
Zusätzliche Felder zum Exportieren in das Cloud Retail-Programm. |
certifications[] |
Produktzertifizierungen, z. B. für die Energieeffizienzkennzeichnung von Produkten, die in der EU EPREL-Datenbank aufgezeichnet wurden Weitere Informationen finden Sie in diesem Hilfeartikel. |
auto_pricing_min_price |
Eine Absicherung 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 Händlerangebote nicht unter diesen Wert fallen, wodurch der Wert und die Rentabilität des Angebots gewahrt werden. |
identifier_exists |
Setzen Sie diesen Wert auf „false“, wenn der Artikel keine eindeutigen Produktkennzeichnungen wie GTIN, MPN oder Marke hat. Wenn kein Wert angegeben wird, ist die Standardeinstellung „true“. |
is_bundle |
Gibt an, ob es sich bei dem Artikel um ein vom Händler zusammengestelltes Set handelt. Ein Set ist eine benutzerdefinierte Gruppierung verschiedener Produkte, die von einem Händler zu einem einzigen Preis verkauft werden. |
title |
Titel des Artikels. |
description |
Beschreibung des Artikels. |
link |
URL, die direkt auf die Artikelseite in Ihrem Onlineshop verweist. |
mobile_link |
URL der für Mobilgeräte optimierten Version der Landingpage Ihres Artikels. |
canonical_link |
URL für die kanonische Version der Landingpage Ihres Artikels. |
image_link |
URL eines Bilds des Artikels. |
adult |
Legen Sie den Wert auf „true“ fest, wenn das Element auf Erwachsene ausgerichtet ist. |
age_group |
Die Altersgruppe des Artikels. |
availability |
Verfügbarkeitsstatus des Artikels |
brand |
Marke des Artikels. |
color |
Farbe des Artikels. |
condition |
Zustand des Artikels. |
gender |
Geschlecht, auf das der Artikel ausgerichtet ist. |
google_product_category |
Kategorie des Artikels von Google (siehe Google-Produkt-Taxonomie) Bei der Abfrage von Produkten enthält dieses Feld den vom Nutzer bereitgestellten Wert. Es ist derzeit nicht möglich, die automatisch zugewiesenen Google-Produktkategorien über die API wiederherzustellen. |
gtin |
Global Trade Item Number (GTIN) des Artikels. |
item_group_id |
Gemeinsame Kennzeichnung für alle Varianten desselben Produkts. |
material |
Das Material, aus dem der Artikel hergestellt ist. |
mpn |
Teilenummer des Herstellers (MPN) für den Artikel |
pattern |
Das Muster des Artikels (z. B. ein Punktmuster). |
sell_on_google_quantity |
Die Menge des Produkts, die zum Verkauf auf Google verfügbar ist. Wird nur für Onlineprodukte unterstützt. |
max_handling_time |
Maximale Bearbeitungszeit für Produkte (in Werktagen). |
min_handling_time |
Minimale Bearbeitungszeit für Produkte (in Werktagen). |
shipping_label |
Das Versandlabel des Produkts, mit dem das Produkt in Versandregeln auf Kontoebene gruppiert wird. |
transit_time_label |
Das Laufzeitlabel des Produkts, mit dem das Produkt in Laufzeittabellen auf Kontoebene gruppiert wird. |
size |
Größe des Artikels. Es ist nur ein Wert zulässig. Geben Sie bei Varianten mit unterschiedlichen Größen für jede Größe ein separates Produkt mit demselben |
size_system |
System, in dem die Größe angegeben wird. Empfohlen für Bekleidungsartikel. |
tax_category |
Die Steuerkategorie des Produkts, mit der in den Steuereinstellungen auf Kontoebene detaillierte Angaben zum Steuer-Nexus konfiguriert werden. |
energy_efficiency_class |
Die Energieeffizienzklasse gemäß EU-Richtlinie 2010/30/EU. |
min_energy_efficiency_class |
Die Energieeffizienzklasse gemäß EU-Richtlinie 2010/30/EU. |
max_energy_efficiency_class |
Die Energieeffizienzklasse gemäß EU-Richtlinie 2010/30/EU. |
multipack |
Die Anzahl identischer Produkte in einem händlerdefinierten Multipack. |
ads_grouping |
Werden verwendet, um Elemente auf beliebige Weise zu gruppieren. Nur für CPA in Prozent, nichts anderes empfohlen. |
ads_redirect |
Ermöglicht Werbetreibenden, die Artikel-URL zu überschreiben, wenn das Produkt im Kontext von Produktanzeigen zu sehen ist. |
display_ads_id |
Eine Kennzeichnung für einen Artikel in dynamischen Remarketing-Kampagnen. |
display_ads_title |
Titel eines Artikels für dynamische Remarketing-Kampagnen. |
display_ads_link |
Für dynamische Remarketing-Kampagnen führen Sie eine direkte URL zur Landingpage des Artikels aus. |
display_ads_value |
Angebotsgewinnmarge für dynamische Remarketing-Kampagnen |
pickup_method |
Die Abholoption für den Artikel. |
pickup_sla |
Zeitlicher Ablauf für die Abholung des Artikels im Geschäft. |
link_template |
Linkvorlage für vom Händler gehostete Verkäuferseite. |
mobile_link_template |
Linkvorlage für vom Händler gehostete Verkäuferseiten, die für Mobilgeräte optimiert sind. |
custom_label_0 |
Benutzerdefiniertes Label 0 für die benutzerdefinierte Gruppierung von Artikeln in einer Shopping-Kampagne |
custom_label_1 |
Benutzerdefiniertes Label 1 für die benutzerdefinierte Gruppierung von Artikeln in einer Shopping-Kampagne |
custom_label_2 |
Benutzerdefiniertes Label 2 für die benutzerdefinierte Gruppierung von Artikeln in einer Shopping-Kampagne |
custom_label_3 |
Benutzerdefiniertes Label 3 für die benutzerdefinierte Gruppierung von Artikeln in einer Shopping-Kampagne |
custom_label_4 |
Benutzerdefiniertes Label 4 für die benutzerdefinierte Gruppierung von Artikeln in einer Shopping-Kampagne |
external_seller_id |
Erforderlich für Mehrfachkundenkonten. Verwenden Sie dieses Attribut, wenn Sie ein Marktplatz sind, der Produkte für verschiedene Verkäufer in Ihr Mehrfachkundenkonto hochlädt. |
pause |
Die Veröffentlichung dieses Artikels wird vorübergehend pausiert. |
virtual_model_link |
URL des 3D-Bilds des Artikels. Weitere Informationen finden Sie in diesem Hilfeartikel. |
structured_title |
Strukturierter Titel für durch Algorithmen (KI) generierte Titel. |
structured_description |
Strukturierte Beschreibung für algorithmisch (KI) generierte Beschreibungen. |
Zertifizierung
Die Produktzertifizierung wurde ursprünglich für die Einhaltung der Energieeffizienzklasse der EU mithilfe der EPREL-Datenbank der EU eingeführt.
| Felder | |
|---|---|
certification_authority |
Die Zertifizierungsstelle, z. B. „European_Commission“. Die maximale Länge beträgt 2.000 Zeichen. |
certification_name |
Der Name der Zertifizierung, z. B. „EPREL“. Die maximale Länge beträgt 2.000 Zeichen. |
certification_code |
Der Zertifizierungscode. Die maximale Länge beträgt 2.000 Zeichen. |
certification_value |
Der Zertifizierungswert (auch als Klasse, Stufe oder Stufe bezeichnet), z. B. „A+“, „C“, „Gold“. Die maximale Länge beträgt 2.000 Zeichen. |
CloudExportAdditionalProperties
Produkteigenschaft für die Cloud Retail API. Eigenschaften für ein TV-Produkt können beispielsweise "Bildschirmauflösung" oder "Bildschirmgröße" sein.
| Felder | |
|---|---|
text_value[] |
Textwert der angegebenen Property. "8K(UHD)" könnte beispielsweise ein Textwert für ein TV-Produkt sein. Maximale Wiederholung dieses Werts ist 400. Werte werden in einer willkürlichen, aber konsistenten Reihenfolge gespeichert. Der String darf maximal 256 Zeichen lang sein. |
int_value[] |
Ganzzahlwerte der angegebenen Property. Beispiel: 1080 für die Bildschirmauflösung eines TV-Produkts. Maximale Wiederholung dieses Werts ist 400. Werte werden in einer willkürlichen, aber konsistenten Reihenfolge gespeichert. |
float_value[] |
Gleitkommawerte der angegebenen Eigenschaft. Beispiel: für das TV-Produkt 1.2345. Maximale Wiederholung dieses Werts ist 400. Werte werden in einer willkürlichen, aber konsistenten Reihenfolge gespeichert. |
property_name |
Name der angegebenen Property. Beispiel: „Bildschirmauflösung“ für ein TV-Produkt. Der String darf maximal 256 Zeichen lang sein. |
bool_value |
Boolescher Wert der angegebenen Eigenschaft. Bei einem TV-Produkt beispielsweise „Wahr“ oder „Falsch“, wenn der Bildschirm in UHD ist. |
min_value |
Minimaler Gleitkommawert der angegebenen Eigenschaft. Beispiel: TV-Produkt 1.00. |
max_value |
Maximaler Gleitkommawert der angegebenen Eigenschaft. Beispiel: für das TV-Produkt „100.00“. |
unit_code |
Einheit der angegebenen Property. Beispiel: „Pixel“ für ein TV-Produkt. Die maximale Stringgröße beträgt 256 B. |
DeleteProductInputRequest
Anfragenachricht für die Methode DeleteProductInput.
| Felder | |
|---|---|
name |
Erforderlich. Der Name der zu löschenden Produkteingaberessource. Format: accounts/{account}/productInputs/{product} |
data_source |
Erforderlich. Die primäre oder ergänzende Datenquelle, aus der die Produkteingabe gelöscht werden soll. Format: |
FreeShippingThreshold
Bedingungen, die für einen kostenlosen Versand eines Produkts erfüllt werden müssen.
| Felder | |
|---|---|
country |
Der CLDR-Gebietscode des Landes, in das ein Artikel versendet wird. |
price_threshold |
Der minimale Produktpreis, mit dem die Versandkosten kostenlos werden. 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 wird. Format: accounts/{account} |
product_input |
Erforderlich. Die einzufügende Produkteingabe. |
data_source |
Erforderlich. Der Name der primären oder ergänzenden Produktdatenquelle. Wenn das Produkt bereits vorhanden ist und die angegebene Datenquelle nicht übereinstimmt, wird das Produkt in eine neue Datenquelle verschoben. Format: |
Rate
Eine Nachricht, die für die Rate steht.
| Felder | |
|---|---|
months |
Die Anzahl der Raten, die der Käufer zahlen muss. |
amount |
Der Betrag, den der Käufer monatlich zahlen muss. |
downpayment |
Der vom Käufer zu zahlende Vorauszahlungsbetrag. |
credit_type |
Die Art der Ratenzahlungen. Unterstützte Werte: * „ |
ListProductsRequest
Anfragenachricht für die Methode „ListProducts“.
| Felder | |
|---|---|
parent |
Erforderlich. Das Konto, für das verarbeitete Produkte aufgelistet werden sollen. Format: accounts/{account} |
page_size |
Die maximale Anzahl von Produkten, die zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Der Höchstwert beträgt 1.000. Werte über 1.000 werden implizit auf 1.000 umgewandelt. Wenn nicht angegeben, wird die maximale Anzahl von Produkten zurückgegeben. |
page_token |
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. Dies sind die verarbeiteten Produkte, nachdem Regeln und zusätzliche Datenquellen angewendet wurden. |
next_page_token |
Ein Token, das als |
LoyaltyPoints
Eine Nachricht, die Treuepunkte darstellt.
| Felder | |
|---|---|
name |
Name des Treuepunkteprogramms. Es wird empfohlen, den Namen auf 12 Zeichen normaler Breite oder 24 lateinische Zeichen zu beschränken. |
points_value |
Die Treuepunkte des Händlers als absoluter Wert. |
ratio |
Das Verhältnis eines Punkts bei der Währungsumrechnung. Google verwendet die Währung aus den Merchant Center-Einstellungen. Wird kein Verhältnis angegeben, wird standardmäßig 1,0 verwendet. |
LoyaltyProgram
Eine Nachricht, die für das Treuepunkteprogramm steht.
| Felder | |
|---|---|
program_label |
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 unten aufgeführten Assets (z. B. Preis und Punkte) einem Händler zuordnen kann. Das entsprechende Programm muss mit dem Händlerkonto verknüpft sein. |
tier_label |
Das Label der Stufe innerhalb des Treuepunkteprogramms. Muss mit einem der Labels im Programm übereinstimmen. |
price |
Der Preis für Mitglieder der angegebenen Stufe, d. h. der Sofortrabatt. Muss kleiner oder gleich dem regulären Preis sein. |
cashback_for_future_use |
Cashback, das für zukünftige Käufe verwendet werden kann. |
loyalty_points |
Die Anzahl der Treuepunkte, die Sie bei einem Kauf erhalten haben. |
Produkt
Das verarbeitete Produkt, das aus mehreren [Produkteingaben][[google.shopping.content.bundles.Products.ProductInput] erstellt wurde, nachdem Regeln und zusätzliche Datenquellen angewendet wurden. Dieses verarbeitete Produkt entspricht dem, was in Ihrem Merchant Center-Konto, in Shopping-Anzeigen und auf anderen Google-Plattformen zu sehen ist. Jedes Produkt besteht aus genau einer primären Datenquelle für das Produkt und mehreren zusätzlichen Datenquelleneingaben. 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 des verarbeiteten Produkts und dessen Untermeldungen stimmen bis auf einige 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_id |
Nur Ausgabe. Ihre eindeutige Kennzeichnung für das Produkt. Dies gilt auch für die Produkteingabe und das verarbeitete Produkt. Voran- und nachgestellte Leerzeichen werden entfernt und mehrere Leerzeichen beim Senden durch ein einzelnes Leerzeichen ersetzt. Weitere Informationen finden Sie in der Produktdatenspezifikation. |
content_language |
Nur Ausgabe. Der zweistellige ISO 639-1-Sprachcode für das Produkt. |
feed_label |
Nur Ausgabe. Das Feedlabel für das Produkt. |
data_source |
Nur Ausgabe. Die primäre Datenquelle des Produkts. |
attributes |
Nur Ausgabe. Eine Liste von Produktattributen. |
custom_attributes[] |
Nur Ausgabe. Eine Liste benutzerdefinierter (vom Händler bereitgestellt) Attribute. Außerdem können Sie damit jedes Attribut der Datenspezifikation in seiner generischen Form einreichen (z. B. |
product_status |
Nur Ausgabe. Der Status eines Produkts, Probleme mit der Datenvalidierung, d. h. Informationen zu einem asynchron berechneten Produkt. |
version_number |
Nur Ausgabe. Die vorhandene Version (Aktualität) des Produkts, mit der die richtige Reihenfolge beibehalten werden kann, wenn mehrere Updates gleichzeitig vorgenommen werden. Wenn diese Richtlinie konfiguriert ist, wird das Einfügen verhindert, wenn die Versionsnummer niedriger als die aktuelle Versionsnummer des vorhandenen Produkts ist. Mit dem aktuellen Wird 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_name |
Mit der Abschnittsüberschrift können mehrere Produktdetails gruppiert werden. |
attribute_name |
Der Name des Produktdetails. |
attribute_value |
Der Wert des Produktdetails. |
ProductDimension
Die Abmessungen des Produkts.
| Felder | |
|---|---|
value |
Erforderlich. Der als Zahl dargestellte Dimensionswert. Der Wert kann eine maximale Genauigkeit von vier Dezimalstellen haben. |
unit |
Erforderlich. Die Dimensionseinheiten. Zulässige Werte sind: * " |
ProductInput
Diese Ressource bezieht sich auf die Eingabedaten, die Sie für ein Produkt einreichen, nicht für das verarbeitete Produkt, das Sie im Merchant Center, in Shopping-Anzeigen oder auf Google-Plattformen sehen. Produkteingaben, Regeln und ergänzende Datenquellendaten werden kombiniert, um das verarbeitete [Produkt][google.shopping.content.bundles.Products.Product] zu erstellen.
Die erforderlichen Produkteingabeattribute zum Bestehen von Datenvalidierungsprüfungen werden hauptsächlich in der Produktdatenspezifikation definiert.
Die folgenden Attribute sind erforderlich: [feedLabel][google.shopping.content.bundles.Products.feed_label], [contentLanguage][google.shopping.content.bundles.Products.content_language] und [offerId][google.shopping.content.bundles.Products.offer_id].
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 den zugehörigen Untermitteilungen stimmen bis auf einige Ausnahmen mit dem englischen Namen des entsprechenden Attributs in der Branchenspezifikation überein.
| Felder | |
|---|---|
name |
Kennung. Der Name der Produkteingabe. Format: |
product |
Nur Ausgabe. Der Name des verarbeiteten Produkts. Format: |
channel |
Erforderlich. Nicht veränderbar. Der Kanal des Produkts. |
offer_id |
Erforderlich. Nicht veränderbar. Ihre eindeutige Kennzeichnung für das Produkt. Dies gilt auch für die Produkteingabe und das verarbeitete Produkt. Voran- und nachgestellte Leerzeichen werden entfernt und mehrere Leerzeichen beim Senden durch ein einzelnes Leerzeichen ersetzt. Weitere Informationen finden Sie in der Produktdatenspezifikation. |
content_language |
Erforderlich. Nicht veränderbar. Der zweistellige ISO 639-1-Sprachcode für das Produkt. |
feed_label |
Erforderlich. Nicht veränderbar. Das Feedlabel für das Produkt. |
attributes |
Optional. Eine Liste von Produktattributen. |
custom_attributes[] |
Optional. Eine Liste benutzerdefinierter (vom Händler bereitgestellt) Attribute. Sie können damit auch Attribute der Datenspezifikation in generischer Form einreichen (z. B. |
version_number |
Optional. Die vorhandene Version (Aktualität) des Produkts, mit der die richtige Reihenfolge beibehalten werden kann, wenn mehrere Updates gleichzeitig vorgenommen werden. Wenn diese Richtlinie konfiguriert ist, wird das Einfügen verhindert, wenn die Versionsnummer niedriger als die aktuelle Versionsnummer des vorhandenen Produkts ist. Mit dem aktuellen Wird 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 asynchron berechneten Produkt.
| Felder | |
|---|---|
destination_statuses[] |
Die vorgesehenen Ziele für das Produkt. |
item_level_issues[] |
Eine Liste aller Probleme im Zusammenhang mit dem Produkt. |
creation_date |
Das Datum, an dem der Artikel erstellt wurde. Die Angabe erfolgt im ISO 8601-Format. |
last_update_date |
Datum der letzten Aktualisierung des Artikels. Die Angabe erfolgt im ISO 8601-Format. |
google_expiration_date |
Ablaufdatum des Artikels. Die Angabe erfolgt im ISO 8601-Format. |
DestinationStatus
Der Zielstatus des Produktstatus.
| Felder | |
|---|---|
reporting_context |
Der Name des Berichtskontexts. |
approved_countries[] |
Liste der Ländercodes (ISO 3166-1 alpha-2), für die das Angebot genehmigt wurde. |
pending_countries[] |
Liste der Ländercodes (ISO 3166-1 alpha-2), bei denen die Genehmigung des Angebots aussteht. |
disapproved_countries[] |
Liste der Ländercodes (ISO 3166-1 alpha-2), die für das Angebot abgelehnt wurden. |
ItemLevelIssue
„ItemLevelIssue“ des Produktstatus.
| Felder | |
|---|---|
code |
Der Fehlercode des Problems. |
severity |
Wie sich dieses Problem auf die Auslieferung des Angebots auswirkt. |
resolution |
Gibt an, ob das Problem vom Händler behoben werden kann. |
attribute |
Der Name des Attributs, wenn das Problem durch ein einzelnes Attribut verursacht wird. |
reporting_context |
Der Berichtskontext, auf den sich das Problem bezieht. |
description |
Eine kurze Problembeschreibung auf Englisch. |
detail |
Eine detaillierte Problembeschreibung auf Englisch. |
documentation |
Die URL einer Webseite, die bei der Lösung dieses Problems hilfreich ist. |
applicable_countries[] |
Liste der Ländercodes (ISO 3166-1 alpha-2), bei denen das Problem auf das Angebot zutrifft. |
Schweregrad
Wie sich das Problem auf die Bereitstellung des Produkts auswirkt.
| Enums | |
|---|---|
SEVERITY_UNSPECIFIED |
Nicht angegeben. |
NOT_IMPACTED |
Bei diesem Problem handelt es sich um eine Warnung, die keine direkten Auswirkungen auf das Produkt hat. |
DEMOTED |
Das Produkt wurde abgewertet und die Leistung in den Suchergebnissen ist höchstwahrscheinlich eingeschränkt |
DISAPPROVED |
Aufgrund des Problems wird das Produkt abgelehnt. |
ProductStructuredDescription
Strukturierte Beschreibung für algorithmisch (KI) generierte Beschreibungen.
| Felder | |
|---|---|
digital_source_type |
Der Typ der digitalen Quelle, z. B. "trained_algorithmic_media". Folge IPTC. Die maximale Länge beträgt 40 Zeichen. |
content |
Der Beschreibungstext. Die maximale Länge beträgt 5.000 Zeichen. |
ProductStructuredTitle
Strukturierter Titel für durch Algorithmen (KI) generierte Titel.
| Felder | |
|---|---|
digital_source_type |
Der Typ der digitalen Quelle, z. B. "trained_algorithmic_media". Folge IPTC. Die maximale Länge beträgt 40 Zeichen. |
content |
Der Titeltext. Die maximale Länge beträgt 150 Zeichen. |
ProductWeight
Das Gewicht des Produkts.
| Felder | |
|---|---|
value |
Erforderlich. Die als Zahl dargestellte Gewichtung. Die Gewichtung kann eine maximale Genauigkeit von vier Dezimalstellen haben. |
unit |
Erforderlich. Die Gewichtseinheit. Zulässige Werte sind: * " |
Versand
Der Versand des Produkts.
| Felder | |
|---|---|
price |
Feste Versandkosten, dargestellt als Zahl. |
country |
Der CLDR-Gebietscode des Landes, in das ein Artikel versendet wird. |
region |
Die geografische Region, für die bestimmte Versandkosten gelten. Weitere Informationen finden Sie unter Region. |
service |
Eine kostenlose Beschreibung der Serviceklasse oder Liefergeschwindigkeit. |
location_id |
Die numerische ID eines Standorts, für den die Versandkosten gelten (definiert in der AdWords API). |
location_group_name |
Der Standort, an dem der Versand gilt, angegeben durch den Namen einer Standortgruppe. |
postal_code |
Der Postleitzahlenbereich, für den die Versandkosten gelten, dargestellt durch eine Postleitzahl, ein Postleitzahlenpräfix gefolgt von einem Platzhalter *, einen Bereich zwischen zwei Postleitzahlen oder zwei Postleitzahlenpräfixen gleicher Länge. |
min_handling_time |
Minimale Bearbeitungszeit (einschließlich) zwischen dem Erhalt und dem Versand der Bestellung innerhalb von Werktagen. 0 bedeutet, dass die Bestellung am selben Tag versendet wird, an dem sie eingegangen ist, wenn dies vor dem Annahmeschluss erfolgt. [minHandlingTime][google.shopping.content.bundles.Products.Shipping.min_handling_time] kann nur zusammen mit [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] vorhanden sein. Es ist jedoch nicht erforderlich, wenn [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] vorhanden ist. |
max_handling_time |
Maximale Bearbeitungszeit (einschließlich) zwischen dem Erhalt und dem Versand der Bestellung innerhalb von Werktagen. 0 bedeutet, dass die Bestellung am selben Tag versendet wird, an dem sie eingegangen ist, wenn dies vor dem Annahmeschluss erfolgt. [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] und [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] sind für die Angabe von Versandgeschwindigkeiten erforderlich. [minHandlingTime][google.shopping.content.bundles.Products.Shipping.min_handling_time] ist optional, wenn [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] vorhanden ist. |
min_transit_time |
Minimale Laufzeit (einschließlich) zwischen dem Versand der Bestellung und deren Lieferung in Werktagen. 0 bedeutet, dass die Bestellung am Versanddatum geliefert wird. [minTransitTime][google.shopping.content.bundles.Products.Shipping.min_transit_time] kann nur zusammen mit [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] angegeben werden. Es ist jedoch nicht erforderlich, wenn [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] vorhanden ist. |
max_transit_time |
Maximale Laufzeit (einschließlich) zwischen dem Versand der Bestellung und deren Lieferung in Werktagen. 0 bedeutet, dass die Bestellung am Versanddatum geliefert wird. [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] und [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] sind für die Angabe von Versandgeschwindigkeiten erforderlich. [minTransitTime][google.shopping.content.bundles.Products.Shipping.min_transit_time] ist optional, wenn [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] vorhanden ist. |
ShippingDimension
Die ShippingDimension (Versanddimension) des Produkts.
| Felder | |
|---|---|
value |
Die Dimension des Produkts, die zur Berechnung der Versandkosten des Artikels verwendet wird. |
unit |
Die Werteinheit. |
ShippingWeight
Das ShippingWeight (Versandgewicht) des Produkts.
| Felder | |
|---|---|
value |
Das Gewicht des Produkts, das zur Berechnung der Versandkosten des Artikels herangezogen wird. |
unit |
Die Werteinheit. |
SubscriptionCost
Die Abokosten des Produkts.
| Felder | |
|---|---|
period |
Die Art des Abozeitraums. Unterstützte Werte: * „ |
period_length |
Die Anzahl der Abozeiträume, die der Käufer zahlen muss. |
amount |
Der Betrag, den der Käufer pro Abolaufzeit zahlen muss. |
SubscriptionPeriod
Der Abozeitraum des Produkts.
| Enums | |
|---|---|
SUBSCRIPTION_PERIOD_UNSPECIFIED |
Gibt an, dass der Abozeitraum nicht angegeben ist. |
MONTH |
Gibt an, dass es sich bei dem Abozeitraum um einen Monat handelt. |
YEAR |
Gibt an, dass der Abozeitraum ein Jahr ist. |
Steuer
Die Steuer des Produkts.
| Felder | |
|---|---|
rate |
Der Prozentsatz des Steuersatzes, der auf den Artikelpreis angewendet wird. |
country |
Das Land, in dem der Artikel versteuert wird, angegeben als CLDR-Gebietscode. |
region |
Die geografische Region, für die der Steuersatz gilt. |
tax_ship |
Setzen Sie diesen Wert auf „true“, wenn beim Versand Steuern berechnet wird. |
location_id |
Die numerische ID eines Standorts, für den der Steuersatz gilt, wie in der AdWords API definiert. |
postal_code |
Der Postleitzahlenbereich, für den der Steuersatz gilt, angegeben durch eine Postleitzahl, ein Postleitzahlenpräfix mit * als Platzhalter, einen Bereich zwischen zwei Postleitzahlen oder zwei Postleitzahlenpräfixen gleicher Länge. Beispiele: 94114, 94*, 94002–95460, 94*–95*. |
UnitPricingBaseMeasure
Der UnitPricingBaseMeasure des Produkts.
| Felder | |
|---|---|
value |
Der Nenner des Stückpreises. |
unit |
Die Einheit des Nenners. |
UnitPricingMeasure
Das UnitPricingMeasure des Produkts.
| Felder | |
|---|---|
value |
Das Maß eines Artikels. |
unit |
Die Maßeinheit. |