Package google.shopping.merchant.products.v1beta

Index

ProductInputsService

Dienst, für den die ProductInput-Ressource verwendet werden soll. Dieser Dienst funktioniert nur für Produkte mit Onlinekanal.

DeleteProductInput

rpc DeleteProductInput(DeleteProductInputRequest) returns (Empty)

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.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie unter OAuth 2.0 Overview.

InsertProductInput

rpc InsertProductInput(InsertProductInputRequest) returns (ProductInput)

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.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie unter OAuth 2.0 Overview.

ProductsService

Dienst, für den die Produktressource verwendet werden soll. Dieser Dienst funktioniert nur für Produkte mit Onlinekanal.

GetProduct

rpc GetProduct(GetProductRequest) returns (Product)

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.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie unter OAuth 2.0 Overview.

ListProducts

rpc ListProducts(ListProductsRequest) returns (ListProductsResponse)

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.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie unter OAuth 2.0 Overview.

Attribute

Attribute

Felder
expiration_date

Timestamp

Ablaufdatum des Artikels gemäß Eingabe im ISO 8601-Format. Das tatsächliche Ablaufdatum wird in productstatuses als googleExpirationDate angezeigt und kann früher sein, wenn expirationDate zu weit in der Zukunft liegt.

disclosure_date

Timestamp

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_date

Timestamp

Der Tag, an dem ein vorbestelltes Produkt lieferbar ist. Die Angabe erfolgt im ISO 8601-Format.

gtin[]

string

Global Trade Item Numbers (GTIN) des Artikels. Sie können bis zu 10 GTINs angeben.

price

Price

Preis des Artikels.

installment

Installment

Anzahl und Betrag der Raten für einen Artikel.

subscription_cost

SubscriptionCost

Anzahl der Abrechnungsperioden (Monate oder Jahre) und Zahlungsbetrag pro Abrechnungsperiode für einen Artikel mit einem zugehörigen Abovertrag.

loyalty_points

LoyaltyPoints

Treuepunkte, die Nutzer nach dem Kauf des Artikels erhalten. Nur Japan.

loyalty_programs[]

LoyaltyProgram

Eine Liste mit Informationen zum Treuepunkteprogramm, die dem Nutzer dieses Artikels Treuevorteile (z. B. bessere Preise, Punkte usw.) anzeigen.

product_types[]

string

Kategorien des Artikels (formatiert wie in der Produktdatenspezifikation).

sale_price

Price

Beworbener Sonderangebotspreis des Artikels.

sale_price_effective_date

Interval

Zeitraum, in dem der Artikel als Sonderangebot erhältlich ist (siehe Produktdatenspezifikation).

product_height

ProductDimension

Die Höhe des Produkts in den angegebenen Maßeinheiten. Der Wert muss zwischen 0 (ausschließlich) und 3.000 (einschließlich) liegen.

product_length

ProductDimension

Die Länge des Produkts in den angegebenen Einheiten. Der Wert muss zwischen 0 (ausschließlich) und 3.000 (einschließlich) liegen.

product_width

ProductDimension

Die Breite des Produkts in den angegebenen Einheiten. Der Wert muss zwischen 0 (ausschließlich) und 3.000 (einschließlich) liegen.

product_weight

ProductWeight

Das Gewicht des Produkts in den angegebenen Einheiten. Der Wert muss zwischen 0 (ausschließlich) und 2.000 (einschließlich) liegen.

shipping[]

Shipping

Versandregeln

free_shipping_threshold[]

FreeShippingThreshold

Bedingungen, die erfüllt sein müssen, damit ein Produkt kostenlos versendet werden kann.

shipping_weight

ShippingWeight

Gewicht des Artikels für den Versand.

shipping_length

ShippingDimension

Länge des Artikels für den Versand.

shipping_width

ShippingDimension

Breite des Artikels für den Versand.

shipping_height

ShippingDimension

Höhe des Artikels für den Versand.

size_types[]

string

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[]

Tax

Steuerinformationen.

unit_pricing_measure

UnitPricingMeasure

Die Maße und Abmessungen eines Artikels.

unit_pricing_base_measure

UnitPricingBaseMeasure

Die Präferenz des Nenners des Stückpreises.

ads_labels[]

string

Ähnlich wie „ads_grouping“, funktioniert aber nur für CPC.

cost_of_goods_sold

Price

Selbstkosten Wird für Berichte zum Bruttogewinn verwendet.

product_details[]

ProductDetail

Technische Daten oder zusätzliche Produktdetails

product_highlights[]

string

Aufzählungspunkte, in denen die wichtigsten Highlights eines Produkts beschrieben werden.

display_ads_similar_ids[]

string

Vom Werbetreibenden angegebene Empfehlungen.

promotion_ids[]

string

Die eindeutige ID eines Angebots.

included_destinations[]

string

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 excludedDestinations angegeben sind.

excluded_destinations[]

string

Liste der Ziele, die für dieses Ziel ausgeschlossen werden sollen (entspricht nicht markierten Kästchen im Merchant Center).

shopping_ads_excluded_countries[]

string

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.

cloud_export_additional_properties[]

CloudExportAdditionalProperties

Zusätzliche Felder, die in das Cloud Retail-Programm exportiert werden sollen.

certifications[]

Certification

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_pricing_min_price

Price

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_incentives[]

ProductSustainabilityIncentive

Die Liste der Nachhaltigkeits-Anreizprogramme.

identifier_exists

bool

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_bundle

bool

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

string

Bezeichnung des Artikels

description

string

Beschreibung des Artikels.

adult

bool

Legen Sie „true“ fest, wenn der Artikel für Erwachsene vorgesehen ist.

age_group

string

Die Alterszielgruppe des Artikels.

availability

string

Verfügbarkeitsstatus des Artikels.

brand

string

Marke des Artikels.

color

string

Farbe des Artikels.

condition

string

Zustand des Artikels.

gender

string

Geschlecht, für das der Artikel vorgesehen ist.

google_product_category

string

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_group_id

string

Gemeinsame Kennung für alle Varianten desselben Produkts.

material

string

Das Material, aus dem der Artikel besteht.

mpn

string

Die Teilenummer des Herstellers (MPN) des Artikels.

pattern

string

Das Muster des Artikels (z. B. Polka Dots)

sell_on_google_quantity

int64

Die Menge des Produkts, die auf Google zum Verkauf steht. Wird nur für Onlineprodukte unterstützt.

max_handling_time

int64

Maximale Bearbeitungszeit für Produkte (in Arbeitstagen).

min_handling_time

int64

Minimale Bearbeitungszeit für das Produkt (in Arbeitstagen).

shipping_label

string

Das Versandlabel des Produkts, mit dem das Produkt in Versandregeln auf Kontoebene gruppiert wird.

transit_time_label

string

Das Laufzeitlabel des Produkts, mit dem Produkte in Laufzeittabellen auf Kontoebene gruppiert werden.

size

string

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 itemGroupId-Wert ein (siehe [https://support.google.com/merchants/answer/6324492](Definition der Größe)).

size_system

string

System, in dem die Größe angegeben ist. Empfohlen für Bekleidungsartikel.

tax_category

string

Die Steuerkategorie des Produkts.

energy_efficiency_class

string

Die Energieeffizienzklasse gemäß EU-Richtlinie 2010/30/EU.

min_energy_efficiency_class

string

Die Energieeffizienzklasse gemäß EU-Richtlinie 2010/30/EU.

max_energy_efficiency_class

string

Die Energieeffizienzklasse gemäß EU-Richtlinie 2010/30/EU.

multipack

int64

Die Anzahl identischer Produkte in einem händlerdefinierten Multipack.

ads_grouping

string

Dient der Gruppierung von Artikeln auf beliebige Weise. Nur für CPA%, andernfalls nicht empfohlen.

ads_redirect

string

Hiermit können Werbetreibende die Artikel-URL überschreiben, wenn das Produkt im Kontext von Produktanzeigen präsentiert wird.

display_ads_id

string

Eine Kennzeichnung für einen Artikel in dynamischen Remarketing-Kampagnen.

display_ads_title

string

Titel eines Artikels für dynamische Remarketing-Kampagnen.

display_ads_value

double

Angebotsgewinnmarge für dynamische Remarketing-Kampagnen.

pickup_method

string

Die Abholoption für den Artikel.

pickup_sla

string

Zeitfenster für die Abholung des Artikels im Geschäft.

custom_label_0

string

Benutzerdefiniertes Label 0 für die benutzerdefinierte Gruppierung von Artikeln in einer Shopping-Kampagne.

custom_label_1

string

Benutzerdefiniertes Label 1 für die benutzerdefinierte Gruppierung von Artikeln in einer Shopping-Kampagne.

custom_label_2

string

Benutzerdefiniertes Label 2 für die benutzerdefinierte Gruppierung von Artikeln in einer Shopping-Kampagne.

custom_label_3

string

Benutzerdefiniertes Label 3 für die benutzerdefinierte Gruppierung von Artikeln in einer Shopping-Kampagne.

custom_label_4

string

Benutzerdefiniertes Label 4 für die benutzerdefinierte Gruppierung von Artikeln in einer Shopping-Kampagne.

external_seller_id

string

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

string

Die Veröffentlichung dieses Elements wird vorübergehend pausiert.

structured_title

ProductStructuredTitle

„Strukturierter Titel“ für algorithmisch (KI-)generierte Titel.

structured_description

ProductStructuredDescription

„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_authority

string

Die Zertifizierungsstelle, z. B. „European_Commission“. Die maximale Länge beträgt 2.000 Zeichen.

certification_name

string

Der Name der Zertifizierung, z. B. „EPREL“. Die maximale Länge beträgt 2.000 Zeichen.

certification_code

string

Der Zertifizierungscode. Die maximale Länge beträgt 2.000 Zeichen.

certification_value

string

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_value[]

string

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_value[]

int64

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_value[]

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

string

Name der Property. Beispiel: „Bildschirmauflösung“ für ein Fernseherprodukt. Die maximale Stringgröße beträgt 256 Zeichen.

bool_value

bool

Boolescher Wert der angegebenen Property. Beispiel: Bei einem Fernseher „True“ oder „False“, wenn der Bildschirm UHD hat.

min_value

float

Mindestwert der Gleitkommazahl der angegebenen Property. Beispiel: 1.00 für ein Fernsehprodukt.

max_value

float

Maximaler Gleitkommawert der angegebenen Property. Beispiel: 100,00 € für ein Fernsehprodukt.

unit_code

string

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

string

Erforderlich. Der Name der zu löschenden Produkteingaberessource. Format: accounts/{account}/productInputs/{product}, wobei der letzte Abschnitt product aus vier Teilen besteht: channel~content_language~feed_label~offer_id. Beispiel für einen Produktnamen: „accounts/123/productInputs/online~en~US~sku123“

data_source

string

Erforderlich. Die primäre oder zusätzliche Datenquelle, aus der die Produkteingabe gelöscht werden soll. Format: accounts/{account}/dataSources/{datasource}.

FreeShippingThreshold

Bedingungen, die erfüllt sein müssen, damit ein Produkt kostenlos versendet werden kann.

Felder
country

string

Der CLDR-Regionalcode des Landes, in das ein Artikel versendet wird.

price_threshold

Price

Der Mindestproduktpreis, ab dem der Versand kostenlos ist. Wird als Zahl dargestellt.

GetProductRequest

Anfragenachricht für die Methode „GetProduct“.

Felder
name

string

Erforderlich. Der Name des abzurufenden Produkts. Format: accounts/{account}/products/{product}, wobei der letzte Abschnitt product aus vier Teilen besteht: channel~content_language~feed_label~offer_id. Beispiel für einen Produktnamen: „accounts/123/products/online~en~US~sku123“.

InsertProductInputRequest

Anfragenachricht für die Methode „InsertProductInput“.

Felder
parent

string

Erforderlich. Das Konto, in das dieses Produkt eingefügt werden soll. Format: accounts/{account}

product_input

ProductInput

Erforderlich. Die einzufügende Produkteingabe.

data_source

string

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: accounts/{account}/dataSources/{datasource}.

Rate

Eine Nachricht, die eine Rate darstellt.

Felder
months

int64

Die Anzahl der Raten, die der Käufer zahlen muss.

amount

Price

Der Betrag, den der Käufer monatlich zahlen muss.

downpayment

Price

Der Betrag der Anzahlung, die der Käufer vorab zahlen muss.

credit_type

string

Art der Ratenzahlungen. Unterstützte Werte: * „finance“ * „lease

ListProductsRequest

Anfragenachricht für die Methode „ListProducts“.

Felder
parent

string

Erforderlich. Das Konto, für das verarbeitete Produkte aufgeführt werden sollen. Format: accounts/{account}

page_size

int32

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_token

string

Ein Seitentoken, das von einem vorherigen ListProducts-Aufruf empfangen wurde. Geben Sie diese an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für ListProducts bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

ListProductsResponse

Antwortnachricht für die Methode „ListProducts“.

Felder
products[]

Product

Die verarbeiteten Produkte aus dem angegebenen Konto. Das sind Ihre verarbeiteten Produkte nach Anwendung von Regeln und ergänzenden Datenquellen.

next_page_token

string

Ein Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

LoyaltyPoints

Eine Nachricht, die Treuepunkte darstellt.

Felder
name

string

Name des Treuepunkteprogramms. Wir empfehlen, den Namen auf 12 vollbreite Zeichen oder 24 lateinische Buchstaben zu beschränken.

points_value

int64

Die Treuepunkte des Einzelhändlers im absoluten Wert.

ratio

double

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_label

string

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_label

string

Das Label der Stufe im Treuepunkteprogramm. Muss mit einem der Labels im Programm übereinstimmen.

price

Price

Der Preis für Mitglieder der jeweiligen Stufe, also der sofortige Rabattpreis. Muss kleiner oder gleich dem Normalpreis sein.

cashback_for_future_use

Price

Der Cashback, der für zukünftige Käufe verwendet werden kann.

loyalty_points

int64

Die Anzahl der Treuepunkte, die mit einem Kauf gesammelt wurden.

member_price_effective_date

Interval

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_label

string

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

string

Der Name des Produkts. Format: "{product.name=accounts/{account}/products/{product}}", wobei der letzte Abschnitt product aus vier Teilen besteht: channel~content_language~feed_label~offer_id. Beispiel für einen Produktnamen: „accounts/123/products/online~en~US~sku123“.

channel

ChannelEnum

Nur Ausgabe. Der Kanal des Produkts.

offer_id

string

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_language

string

Nur Ausgabe. Der aus zwei Buchstaben bestehende ISO 639-1-Sprachcode für das Produkt.

feed_label

string

Nur Ausgabe. Das Feedlabel für das Produkt.

data_source

string

Nur Ausgabe. Die primäre Datenquelle des Produkts.

attributes

Attributes

Nur Ausgabe. Eine Liste von Produktattributen.

custom_attributes[]

CustomAttribute

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. { "name": "size type", "value": "regular" }). Das ist nützlich, um Attribute einzureichen, die nicht explizit von der API bereitgestellt werden, z. B. zusätzliche Attribute, die für Buy on Google verwendet werden.

product_status

ProductStatus

Nur Ausgabe. Der Status eines Produkts, Probleme mit der Datenvalidierung, d. h. Informationen zu einem Produkt, die asynchron berechnet werden.

version_number

int64

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 version_number erfolgen.

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

string

Die Abschnittsüberschrift, mit der eine Reihe von Produktdetails gruppiert wird.

attribute_name

string

Der Name des Produktdetails.

attribute_value

string

Der Wert des Produktdetails.

ProductDimension

Die Größe des Produkts.

Felder
value

double

Erforderlich. Der Dimensionswert als Zahl. Der Wert kann maximal vier Dezimalstellen haben.

unit

string

Erforderlich. Die Maßeinheiten der Dimension. Zulässige Werte sind: * „in“ * „cm

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

string

Kennung. Der Name der Produkteingabe. Format: "{productinput.name=accounts/{account}/productInputs/{productinput}}", wobei der letzte Abschnitt productinput aus vier Teilen besteht: channel~content_language~feed_label~offer_id. Beispiel für den Namen der Produkteingaben: „accounts/123/productInputs/online~en~US~sku123“.

product

string

Nur Ausgabe. Der Name des verarbeiteten Produkts. Format: "{product.name=accounts/{account}/products/{product}}"

channel

ChannelEnum

Nicht veränderbar. Der Kanal des Produkts.

offer_id

string

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_language

string

Erforderlich. Nicht veränderbar. Der zweistellige ISO 639-1-Sprachcode für das Produkt.

feed_label

string

Erforderlich. Nicht veränderbar. Das Feedlabel für das Produkt.

attributes

Attributes

Optional. Eine Liste von Produktattributen.

custom_attributes[]

CustomAttribute

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. { "name": "size type", "value": "regular" }). Das ist nützlich, um Attribute einzureichen, die nicht explizit von der API bereitgestellt werden, z. B. zusätzliche Attribute, die für Buy on Google verwendet werden. Die maximale Anzahl von Zeichen für jedes benutzerdefinierte Attribut beträgt 10.240 (Summe der Zeichen für Name und Wert). Pro Produkt können maximal 2.500 benutzerdefinierte Attribute mit einer Gesamtgröße von 102, 4 KB festgelegt werden. Unterstriche in benutzerdefinierten Attributnamen werden beim Einfügen durch Leerzeichen ersetzt.

version_number

int64

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 version_number erfolgen.

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_statuses[]

DestinationStatus

Die vorgesehenen Ziele des Produkts

item_level_issues[]

ItemLevelIssue

Eine Liste aller Probleme im Zusammenhang mit dem Produkt.

creation_date

Timestamp

Das Datum, an dem der Artikel erstellt wurde, im ISO 8601-Format.

last_update_date

Timestamp

Datum, an dem der Artikel zuletzt aktualisiert wurde. Die Angabe erfolgt im ISO 8601-Format.

google_expiration_date

Timestamp

Datum, an dem das Element abläuft, im ISO 8601-Format.

DestinationStatus

Der Zielstatus des Produktstatus.

Felder
reporting_context

ReportingContextEnum

Der Name des Berichtskontexts.

approved_countries[]

string

Liste der Ländercodes (ISO 3166-1 alpha-2), in denen das Angebot genehmigt wurde.

pending_countries[]

string

Liste der Ländercodes (ISO 3166-1 alpha-2), für die das Angebot noch nicht genehmigt wurde.

disapproved_countries[]

string

Liste der Ländercodes (ISO 3166-1 alpha-2), in denen das Angebot abgelehnt wurde.

ItemLevelIssue

Das Problem auf Artikelebene des Produktstatus.

Felder
code

string

Der Fehlercode des Problems

severity

Severity

Wie sich dieses Problem auf die Zustellung des Angebots auswirkt.

resolution

string

Ob das Problem vom Händler behoben werden kann.

attribute

string

Der Attributname, falls das Problem durch ein einzelnes Attribut verursacht wird.

reporting_context

ReportingContextEnum

Der Berichtskontext, auf den sich das Problem bezieht.

description

string

Eine kurze Problembeschreibung in Englisch.

detail

string

Ausführliche Problembeschreibung in Englisch.

documentation

string

Die URL einer Webseite, die bei der Lösung des Problems helfen kann.

applicable_countries[]

string

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_source_type

string

Der Typ der digitalen Quelle, z. B. „trained_algorithmic_media“. Sie folgen den IPTC. Maximale Länge: 40 Zeichen.

content

string

Die maximale Länge des Beschreibungstexts beträgt 5.000 Zeichen.

ProductStructuredTitle

„Strukturierter Titel“ für algorithmisch (KI-)generierte Titel.

Felder
digital_source_type

string

Der Typ der digitalen Quelle, z. B. „trained_algorithmic_media“. Sie folgen den IPTC. Maximale Länge: 40 Zeichen.

content

string

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

Price

Der feste Betrag des Incentives.

percentage

double

Der Prozentsatz des Sonderangebotspreises, auf den der Anreiz angewendet wird.

type

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

double

Erforderlich. Die Gewichtung als Zahl. Das Gewicht kann mit einer maximalen Genauigkeit von vier Dezimalstellen angegeben werden.

unit

string

Erforderlich. Die Gewichtseinheit. Zulässige Werte sind: * „g“ * „kg“ * „oz“ * „lb

Versand

Versand des Produkts.

Felder
price

Price

Fester Versandpreis, dargestellt als Zahl.

country

string

Der CLDR-Regionalcode des Landes, in das ein Artikel versendet wird.

region

string

Die geografische Region, für die ein Versandpreis gilt. Weitere Informationen finden Sie unter region.

service

string

Eine kostenlose Beschreibung der Serviceklasse oder Versandgeschwindigkeit.

location_id

int64

Die numerische ID eines Standorts, für den der Versandpreis gilt, wie in der AdWords API definiert.

location_group_name

string

Der Ort, für den der Versand gilt, dargestellt durch einen Standortgruppennamen.

postal_code

string

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_handling_time

int64

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. minHandlingTime kann nur zusammen mit maxHandlingTime vorhanden sein. minHandlingTime ist jedoch nicht erforderlich, wenn maxHandlingTime vorhanden ist.

max_handling_time

int64

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 maxHandlingTime als auch maxTransitTime sind erforderlich, wenn Sie Versandgeschwindigkeiten angeben. minHandlingTime ist optional, wenn maxHandlingTime vorhanden ist.

min_transit_time

int64

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. minTransitTime kann nur zusammen mit maxTransitTime vorhanden sein. minTransitTime ist jedoch nicht erforderlich, wenn maxTransitTime vorhanden ist.

max_transit_time

int64

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 maxHandlingTime als auch maxTransitTime sind erforderlich, wenn Sie Versandgeschwindigkeiten angeben. minTransitTime ist optional, wenn maxTransitTime vorhanden ist.

ShippingDimension

Die Versandabmessung des Produkts.

Felder
value

double

Die Größe des Produkts, die zur Berechnung der Versandkosten des Artikels herangezogen wird.

unit

string

Die Maßeinheit.

ShippingWeight

Das Versandgewicht des Produkts.

Felder
value

double

Das Gewicht des Produkts, das zur Berechnung der Versandkosten des Artikels herangezogen wird.

unit

string

Die Maßeinheit.

SubscriptionCost

Die Abokosten des Produkts.

Felder
period

SubscriptionPeriod

Die Art des Abozeitraums. Unterstützte Werte: * „month“ * „year

period_length

int64

Die Anzahl der Abrechnungsperioden, die der Käufer zahlen muss.

amount

Price

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

double

Der Prozentsatz des Steuersatzes, der auf den Artikelpreis angewendet wird.

country

string

Das Land, in dem der Artikel besteuert wird, als CLDR-Regionalcode angegeben.

region

string

Die geografische Region, für die der Steuersatz gilt.

tax_ship

bool

Legen Sie „true“ fest, wenn für den Versand eine Steuer erhoben wird.

location_id

int64

Die numerische ID eines Standorts, für den der Steuersatz gilt, wie in der AdWords API definiert.

postal_code

string

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

int64

Der Nenner des Stückpreises.

unit

string

Die Einheit des Nenners.

UnitPricingMeasure

Die Maßeinheit für den Stückpreis des Produkts.

Felder
value

double

Die Maßeinheit eines Artikels.

unit

string

Die Maßeinheit.