REST Resource: accounts.products

Ressource: 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.

JSON-Darstellung 
{
  "name": string,
  "channel": enum (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "dataSource": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "productStatus": {
    object (ProductStatus)
  },
  "versionNumber": string
}
Felder
name

string

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

enum (ChannelEnum)

Nur Ausgabe. Der Kanal des Produkts.
offerId

string

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.
contentLanguage

string

Nur Ausgabe. Der zweistellige ISO 639-1-Sprachcode für das Produkt.
feedLabel

string

Nur Ausgabe. Das Feedlabel für das Produkt.
dataSource

string

Nur Ausgabe. Die primäre Datenquelle des Produkts.
attributes

object (Attributes)

Nur Ausgabe. Eine Liste von Produktattributen.
customAttributes[]

object (CustomAttribute)

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

object (ProductStatus)

Nur Ausgabe. Der Status eines Produkts, Probleme mit der Datenvalidierung, d. h. Informationen zu einem asynchron berechneten Produkt.
versionNumber

string (int64 format)

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 versionNumber kann das Produkt wieder eingefügt werden (z. B. eine Produktaktualisierung nach 30 Tagen).

Wird nur für Einfügungen in primäre Datenquellen unterstützt.

Wenn der Vorgang verhindert wird, wird die abgebrochene Ausnahme ausgelöst.

Attribute

Attribute.

JSON-Darstellung 
{
  "additionalImageLinks": [
    string
  ],
  "expirationDate": string,
  "disclosureDate": string,
  "availabilityDate": string,
  "price": {
    object (Price)
  },
  "installment": {
    object (Installment)
  },
  "subscriptionCost": {
    object (SubscriptionCost)
  },
  "loyaltyPoints": {
    object (LoyaltyPoints)
  },
  "loyaltyPrograms": [
    {
      object (LoyaltyProgram)
    }
  ],
  "productTypes": [
    string
  ],
  "salePrice": {
    object (Price)
  },
  "salePriceEffectiveDate": {
    object (Interval)
  },
  "productHeight": {
    object (ProductDimension)
  },
  "productLength": {
    object (ProductDimension)
  },
  "productWidth": {
    object (ProductDimension)
  },
  "productWeight": {
    object (ProductWeight)
  },
  "shipping": [
    {
      object (Shipping)
    }
  ],
  "freeShippingThreshold": [
    {
      object (FreeShippingThreshold)
    }
  ],
  "shippingWeight": {
    object (ShippingWeight)
  },
  "shippingLength": {
    object (ShippingDimension)
  },
  "shippingWidth": {
    object (ShippingDimension)
  },
  "shippingHeight": {
    object (ShippingDimension)
  },
  "sizeTypes": [
    string
  ],
  "taxes": [
    {
      object (Tax)
    }
  ],
  "unitPricingMeasure": {
    object (UnitPricingMeasure)
  },
  "unitPricingBaseMeasure": {
    object (UnitPricingBaseMeasure)
  },
  "adsLabels": [
    string
  ],
  "costOfGoodsSold": {
    object (Price)
  },
  "productDetails": [
    {
      object (ProductDetail)
    }
  ],
  "productHighlights": [
    string
  ],
  "displayAdsSimilarIds": [
    string
  ],
  "promotionIds": [
    string
  ],
  "includedDestinations": [
    string
  ],
  "excludedDestinations": [
    string
  ],
  "shoppingAdsExcludedCountries": [
    string
  ],
  "lifestyleImageLinks": [
    string
  ],
  "cloudExportAdditionalProperties": [
    {
      object (CloudExportAdditionalProperties)
    }
  ],
  "certifications": [
    {
      object (Certification)
    }
  ],
  "autoPricingMinPrice": {
    object (Price)
  },
  "identifierExists": boolean,
  "isBundle": boolean,
  "title": string,
  "description": string,
  "link": string,
  "mobileLink": string,
  "canonicalLink": string,
  "imageLink": string,
  "adult": boolean,
  "ageGroup": string,
  "availability": string,
  "brand": string,
  "color": string,
  "condition": string,
  "gender": string,
  "googleProductCategory": string,
  "gtin": string,
  "itemGroupId": string,
  "material": string,
  "mpn": string,
  "pattern": string,
  "sellOnGoogleQuantity": string,
  "maxHandlingTime": string,
  "minHandlingTime": string,
  "shippingLabel": string,
  "transitTimeLabel": string,
  "size": string,
  "sizeSystem": string,
  "taxCategory": string,
  "energyEfficiencyClass": string,
  "minEnergyEfficiencyClass": string,
  "maxEnergyEfficiencyClass": string,
  "multipack": string,
  "adsGrouping": string,
  "adsRedirect": string,
  "displayAdsId": string,
  "displayAdsTitle": string,
  "displayAdsLink": string,
  "displayAdsValue": number,
  "pickupMethod": string,
  "pickupSla": string,
  "linkTemplate": string,
  "mobileLinkTemplate": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "externalSellerId": string,
  "pause": string,
  "virtualModelLink": string,
  "structuredTitle": {
    object (ProductStructuredTitle)
  },
  "structuredDescription": {
    object (ProductStructuredDescription)
  }
}
Felder
expirationDate

string (Timestamp format)

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 productstatuses als googleExpirationDate angezeigt und kann früher sein, wenn expirationDate zu weit in der Zukunft liegt.
disclosureDate

string (Timestamp format)

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).
availabilityDate

string (Timestamp format)

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

object (Price)

Preis des Artikels.
installment

object (Installment)

Anzahl und Betrag der für einen Artikel zu zahlenden Raten.
subscriptionCost

object (SubscriptionCost)

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

object (LoyaltyPoints)

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

object (LoyaltyProgram)

Eine Liste mit Informationen zum Treuepunkteprogramm, die verwendet werden, um dem Nutzer dieses Artikels Treuepunkte (z. B. bessere Preise oder Punkte) zu präsentieren.
productTypes[]

string

Kategorien des Artikels im Format der Produktdatenspezifikation.
salePrice

object (Price)

Der beworbene Sonderangebotspreis für den Artikel.
salePriceEffectiveDate

object (Interval)

Zeitraum, in dem der Artikel im Angebot ist (siehe Produktdatenspezifikation).
productHeight

object (ProductDimension)

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

object (ProductDimension)

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

object (ProductDimension)

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

object (ProductWeight)

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

object (Shipping)

Versandregeln.
freeShippingThreshold[]

object (FreeShippingThreshold)

Bedingungen, die für einen kostenlosen Versand eines Produkts erfüllt werden müssen.
shippingWeight

object (ShippingWeight)

Versandgewicht des Artikels.
shippingLength

object (ShippingDimension)

Länge des Artikels für den Versand.
shippingWidth

object (ShippingDimension)

Breite des Artikels für den Versand.
shippingHeight

object (ShippingDimension)

Höhe des Artikels für den Versand
sizeTypes[]

string

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

object (Tax)

Steuerinformationen.
unitPricingMeasure

object (UnitPricingMeasure)

Maß und Abmessungen eines Artikels.
unitPricingBaseMeasure

object (UnitPricingBaseMeasure)

Die Präferenz des Nenners des Stückpreises.
adsLabels[]

string

Ähnlich wie adsGrouping, jedoch nur mit CPC.
costOfGoodsSold

object (Price)

Selbstkosten Wird für Berichte zum Bruttogewinn verwendet.
productDetails[]

object (ProductDetail)

Technische Spezifikationen oder zusätzliche Produktdetails.
productHighlights[]

string

Aufzählungspunkte, mit denen die wichtigsten Highlights eines Produkts beschrieben werden.
displayAdsSimilarIds[]

string

Vom Werbetreibenden angegebene Empfehlungen
promotionIds[]

string

Die eindeutige ID eines Angebots.
includedDestinations[]

string

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

string

Die Liste der Ziele, die für dieses Ziel ausgeschlossen werden sollen (entspricht nicht Häkchen im Merchant Center).
shoppingAdsExcludedCountries[]

string

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

object (CloudExportAdditionalProperties)

Zusätzliche Felder zum Exportieren in das Cloud Retail-Programm.
certifications[]

object (Certification)

Produktzertifizierungen, z. B. für die Energieeffizienzkennzeichnung von Produkten, die in der EU EPREL-Datenbank aufgezeichnet wurden Weitere Informationen finden Sie in diesem Hilfeartikel.
autoPricingMinPrice

object (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.
identifierExists

boolean

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“.
isBundle

boolean

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

string

Titel des Artikels.
description

string

Beschreibung des Artikels.
adult

boolean

Legen Sie den Wert auf „true“ fest, wenn das Element auf Erwachsene ausgerichtet ist.
ageGroup

string

Die Altersgruppe 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, auf das der Artikel ausgerichtet ist.
googleProductCategory

string

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

string

Global Trade Item Number (GTIN) des Artikels.
itemGroupId

string

Gemeinsame Kennzeichnung für alle Varianten desselben Produkts.
material

string

Das Material, aus dem der Artikel hergestellt ist.
mpn

string

Teilenummer des Herstellers (MPN) für den Artikel
pattern

string

Das Muster des Artikels (z. B. ein Punktmuster).
sellOnGoogleQuantity

string (int64 format)

Die Menge des Produkts, die zum Verkauf auf Google verfügbar ist. Wird nur für Onlineprodukte unterstützt.
maxHandlingTime

string (int64 format)

Maximale Bearbeitungszeit für Produkte (in Werktagen).
minHandlingTime

string (int64 format)

Minimale Bearbeitungszeit für Produkte (in Werktagen).
shippingLabel

string

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

string

Das Laufzeitlabel des Produkts, mit dem das Produkt in Laufzeittabellen auf Kontoebene gruppiert wird.
size

string

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

string

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

string

Die Steuerkategorie des Produkts, mit der in den Steuereinstellungen auf Kontoebene detaillierte Angaben zum Steuer-Nexus konfiguriert werden.
energyEfficiencyClass

string

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

string

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

string

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

string (int64 format)

Die Anzahl identischer Produkte in einem händlerdefinierten Multipack.
adsGrouping

string

Werden verwendet, um Elemente auf beliebige Weise zu gruppieren. Nur für CPA in Prozent, nichts anderes empfohlen.
adsRedirect

string

Ermöglicht Werbetreibenden, die Artikel-URL zu überschreiben, wenn das Produkt im Kontext von Produktanzeigen zu sehen ist.
displayAdsId

string

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

string

Titel eines Artikels für dynamische Remarketing-Kampagnen.
displayAdsValue

number

Angebotsgewinnmarge für dynamische Remarketing-Kampagnen
pickupMethod

string

Die Abholoption für den Artikel.
pickupSla

string

Zeitlicher Ablauf für die Abholung des Artikels im Geschäft.
customLabel0

string

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

string

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

string

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

string

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

string

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

string

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

string

Die Veröffentlichung dieses Artikels wird vorübergehend pausiert.
structuredTitle

object (ProductStructuredTitle)

Strukturierter Titel für durch Algorithmen (KI) generierte Titel.
structuredDescription

object (ProductStructuredDescription)

Strukturierte Beschreibung für algorithmisch (KI) generierte Beschreibungen.

Rate

Eine Nachricht, die für die Rate steht.

JSON-Darstellung 
{
  "months": string,
  "amount": {
    object (Price)
  },
  "downpayment": {
    object (Price)
  },
  "creditType": string
}
Felder
months

string (int64 format)

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

object (Price)

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

object (Price)

Der vom Käufer zu zahlende Vorauszahlungsbetrag.
creditType

string

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

SubscriptionCost

Die Abokosten des Produkts.

JSON-Darstellung 
{
  "period": enum (SubscriptionPeriod),
  "periodLength": string,
  "amount": {
    object (Price)
  }
}
Felder
period

enum (SubscriptionPeriod)

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

string (int64 format)

Die Anzahl der Abozeiträume, die der Käufer zahlen muss.
amount

object (Price)

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.

LoyaltyPoints

Eine Nachricht, die Treuepunkte darstellt.

JSON-Darstellung 
{
  "name": string,
  "pointsValue": string,
  "ratio": number
}
Felder
name

string

Name des Treuepunkteprogramms. Es wird empfohlen, den Namen auf 12 Zeichen normaler Breite oder 24 lateinische Zeichen zu beschränken.
pointsValue

string (int64 format)

Die Treuepunkte des Händlers als absoluter Wert.
ratio

number

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.

JSON-Darstellung 
{
  "programLabel": string,
  "tierLabel": string,
  "price": {
    object (Price)
  },
  "cashbackForFutureUse": {
    object (Price)
  },
  "loyaltyPoints": string
}
Felder
programLabel

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 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.
tierLabel

string

Das Label der Stufe innerhalb des Treuepunkteprogramms. Muss mit einem der Labels im Programm übereinstimmen.
price

object (Price)

Der Preis für Mitglieder der angegebenen Stufe, d. h. der Sofortrabatt. Muss kleiner oder gleich dem regulären Preis sein.
cashbackForFutureUse

object (Price)

Cashback, das für zukünftige Käufe verwendet werden kann.
loyaltyPoints

string (int64 format)

Die Anzahl der Treuepunkte, die Sie bei einem Kauf erhalten haben.

ProductDimension

Die Abmessungen des Produkts.

JSON-Darstellung 
{
  "value": number,
  "unit": string
}
Felder
value

number

Erforderlich. Der als Zahl dargestellte Dimensionswert. Der Wert kann eine maximale Genauigkeit von vier Dezimalstellen haben.
unit

string

Erforderlich. Die Dimensionseinheiten. Zulässige Werte sind: * "in" * "cm"

ProductWeight

Das Gewicht des Produkts.

JSON-Darstellung 
{
  "value": number,
  "unit": string
}
Felder
value

number

Erforderlich. Die als Zahl dargestellte Gewichtung. Die Gewichtung kann eine maximale Genauigkeit von vier Dezimalstellen haben.
unit

string

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

Versand

Der Versand des Produkts.

JSON-Darstellung 
{
  "price": {
    object (Price)
  },
  "country": string,
  "region": string,
  "service": string,
  "locationId": string,
  "locationGroupName": string,
  "postalCode": string,
  "minHandlingTime": string,
  "maxHandlingTime": string,
  "minTransitTime": string,
  "maxTransitTime": string
}
Felder
price

object (Price)

Feste Versandkosten, dargestellt als Zahl.
country

string

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

string

Die geografische Region, für die bestimmte Versandkosten gelten. Weitere Informationen finden Sie unter Region.
service

string

Eine kostenlose Beschreibung der Serviceklasse oder Liefergeschwindigkeit.
locationId

string (int64 format)

Die numerische ID eines Standorts, für den die Versandkosten gelten (definiert in der AdWords API).
locationGroupName

string

Der Standort, an dem der Versand gilt, angegeben durch den Namen einer Standortgruppe.
postalCode

string

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.
minHandlingTime

string (int64 format)

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.
maxHandlingTime

string (int64 format)

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.
minTransitTime

string (int64 format)

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.
maxTransitTime

string (int64 format)

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.

FreeShippingThreshold

Bedingungen, die für einen kostenlosen Versand eines Produkts erfüllt werden müssen.

JSON-Darstellung 
{
  "country": string,
  "priceThreshold": {
    object (Price)
  }
}
Felder
country

string

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

object (Price)

Der minimale Produktpreis, mit dem die Versandkosten kostenlos werden. Als Zahl dargestellt.

ShippingWeight

Das ShippingWeight (Versandgewicht) des Produkts.

JSON-Darstellung 
{
  "value": number,
  "unit": string
}
Felder
value

number

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

string

Die Werteinheit.

ShippingDimension

Die ShippingDimension (Versanddimension) des Produkts.

JSON-Darstellung 
{
  "value": number,
  "unit": string
}
Felder
value

number

Die Dimension des Produkts, die zur Berechnung der Versandkosten des Artikels verwendet wird.
unit

string

Die Werteinheit.

Steuer

Die Steuer des Produkts.

JSON-Darstellung 
{
  "rate": number,
  "country": string,
  "region": string,
  "taxShip": boolean,
  "locationId": string,
  "postalCode": string
}
Felder
rate

number

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

string

Das Land, in dem der Artikel versteuert wird, angegeben als CLDR-Gebietscode.
region

string

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

boolean

Setzen Sie diesen Wert auf „true“, wenn beim Versand Steuern berechnet wird.
locationId

string (int64 format)

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

string

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*.

UnitPricingMeasure

Das UnitPricingMeasure des Produkts.

JSON-Darstellung 
{
  "value": number,
  "unit": string
}
Felder
value

number

Das Maß eines Artikels.
unit

string

Die Maßeinheit.

UnitPricingBaseMeasure

Der UnitPricingBaseMeasure des Produkts.

JSON-Darstellung 
{
  "value": string,
  "unit": string
}
Felder
value

string (int64 format)

Der Nenner des Stückpreises.
unit

string

Die Einheit des Nenners.

ProductDetail

Die Produktdetails.

JSON-Darstellung 
{
  "sectionName": string,
  "attributeName": string,
  "attributeValue": string
}
Felder
sectionName

string

Mit der Abschnittsüberschrift können mehrere Produktdetails gruppiert werden.
attributeName

string

Der Name des Produktdetails.
attributeValue

string

Der Wert des Produktdetails.

CloudExportAdditionalProperties

Produkteigenschaft für die Cloud Retail API. Eigenschaften für ein TV-Produkt können beispielsweise "Bildschirmauflösung" oder "Bildschirmgröße" sein.

JSON-Darstellung 
{
  "textValue": [
    string
  ],
  "intValue": [
    string
  ],
  "floatValue": [
    number
  ],
  "propertyName": string,
  "boolValue": boolean,
  "minValue": number,
  "maxValue": number,
  "unitCode": string
}
Felder
textValue[]

string

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

string (int64 format)

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

number

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.
propertyName

string

Name der angegebenen Property. Beispiel: „Bildschirmauflösung“ für ein TV-Produkt. Der String darf maximal 256 Zeichen lang sein.
boolValue

boolean

Boolescher Wert der angegebenen Eigenschaft. Bei einem TV-Produkt beispielsweise „Wahr“ oder „Falsch“, wenn der Bildschirm in UHD ist.
minValue

number

Minimaler Gleitkommawert der angegebenen Eigenschaft. Beispiel: TV-Produkt 1.00.
maxValue

number

Maximaler Gleitkommawert der angegebenen Eigenschaft. Beispiel: für das TV-Produkt „100.00“.
unitCode

string

Einheit der angegebenen Property. Beispiel: „Pixel“ für ein TV-Produkt. Die maximale Stringgröße beträgt 256 B.

Zertifizierung

Die Produktzertifizierung wurde ursprünglich für die Einhaltung der Energieeffizienzklasse der EU mithilfe der EPREL-Datenbank der EU eingeführt.

JSON-Darstellung 
{
  "certificationAuthority": string,
  "certificationName": string,
  "certificationCode": string,
  "certificationValue": string
}
Felder
certificationAuthority

string

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

string

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

string

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

string

Der Zertifizierungswert (auch als Klasse, Stufe oder Stufe bezeichnet), z. B. „A+“, „C“, „Gold“. Die maximale Länge beträgt 2.000 Zeichen.

ProductStructuredTitle

Strukturierter Titel für durch Algorithmen (KI) generierte Titel.

JSON-Darstellung 
{
  "digitalSourceType": string,
  "content": string
}
Felder
digitalSourceType

string

Der Typ der digitalen Quelle, z. B. "trained_algorithmic_media". Folge IPTC. Die maximale Länge beträgt 40 Zeichen.
content

string

Der Titeltext. Die maximale Länge beträgt 150 Zeichen.

ProductStructuredDescription

Strukturierte Beschreibung für algorithmisch (KI) generierte Beschreibungen.

JSON-Darstellung 
{
  "digitalSourceType": string,
  "content": string
}
Felder
digitalSourceType

string

Der Typ der digitalen Quelle, z. B. "trained_algorithmic_media". Folge IPTC. Die maximale Länge beträgt 40 Zeichen.
content

string

Der Beschreibungstext. Die maximale Länge beträgt 5.000 Zeichen.

ProductStatus

Der Status eines Produkts, Probleme mit der Datenvalidierung, d. h. Informationen zu einem asynchron berechneten Produkt.

JSON-Darstellung 
{
  "destinationStatuses": [
    {
      object (DestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ItemLevelIssue)
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string,
  "googleExpirationDate": string
}
Felder
destinationStatuses[]

object (DestinationStatus)

Die vorgesehenen Ziele für das Produkt.
itemLevelIssues[]

object (ItemLevelIssue)

Eine Liste aller Probleme im Zusammenhang mit dem Produkt.
creationDate

string (Timestamp format)

Das Datum, an dem der Artikel erstellt wurde. Die Angabe erfolgt im ISO 8601-Format.
lastUpdateDate

string (Timestamp format)

Datum der letzten Aktualisierung des Artikels. Die Angabe erfolgt im ISO 8601-Format.
googleExpirationDate

string (Timestamp format)

Ablaufdatum des Artikels. Die Angabe erfolgt im ISO 8601-Format.

DestinationStatus

Der Zielstatus des Produktstatus.

JSON-Darstellung 
{
  "reportingContext": enum (ReportingContextEnum),
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
Felder
reportingContext

enum (ReportingContextEnum)

Der Name des Berichtskontexts.
approvedCountries[]

string

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

string

Liste der Ländercodes (ISO 3166-1 alpha-2), bei denen die Genehmigung des Angebots aussteht.
disapprovedCountries[]

string

Liste der Ländercodes (ISO 3166-1 alpha-2), die für das Angebot abgelehnt wurden.

ItemLevelIssue

„ItemLevelIssue“ des Produktstatus.

JSON-Darstellung 
{
  "code": string,
  "severity": enum (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
Felder
code

string

Der Fehlercode des Problems.
severity

enum (Severity)

Wie sich dieses Problem auf die Auslieferung des Angebots auswirkt.
resolution

string

Gibt an, ob das Problem vom Händler behoben werden kann.
attribute

string

Der Name des Attributs, wenn das Problem durch ein einzelnes Attribut verursacht wird.
reportingContext

enum (ReportingContextEnum)

Der Berichtskontext, auf den sich das Problem bezieht.
description

string

Eine kurze Problembeschreibung auf Englisch.
detail

string

Eine detaillierte Problembeschreibung auf Englisch.
documentation

string

Die URL einer Webseite, die bei der Lösung dieses Problems hilfreich ist.
applicableCountries[]

string

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.

Methoden

get

 Ruft das verarbeitete Produkt aus Ihrem Merchant Center-Konto ab.

list

 Listet die verarbeiteten Produkte in Ihrem Merchant Center-Konto auf.