REST Resource: accounts.cssProducts

Ressource: CssProduct

Das verarbeitete CSS-Produkt.

JSON-Darstellung 
{
  "name": string,
  "rawProvidedId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "cssProductStatus": {
    object (CssProductStatus)
  }
}
Felder
name

string

Der Name des CSS-Produkts. Format: "accounts/{account}/cssProducts/{css_product}"
rawProvidedId

string

Nur Ausgabe. Ihre eindeutige Rohkennung für das Produkt.
contentLanguage

string

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

string

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

object (Attributes)

Nur Ausgabe. Eine Liste von Produktattributen.
customAttributes[]

object (CustomAttribute)

Nur Ausgabe. Eine Liste benutzerdefinierter (vom Preisvergleichsportal bereitgestellter) Attribute. Sie können damit auch jedes Attribut der Feedspezifikation 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.
cssProductStatus

object (CssProductStatus)

Nur Ausgabe. Der Status eines Produkts, Probleme bei der Datenvalidierung, d. h. asynchron berechnete Informationen zu einem Produkt.

Attribute

Attribute für Preisvergleichsportal-Produkte.

JSON-Darstellung 
{
  "lowPrice": {
    object (Price)
  },
  "highPrice": {
    object (Price)
  },
  "headlineOfferPrice": {
    object (Price)
  },
  "headlineOfferShippingPrice": {
    object (Price)
  },
  "additionalImageLinks": [
    string
  ],
  "productTypes": [
    string
  ],
  "sizeTypes": [
    string
  ],
  "productDetails": [
    {
      object (ProductDetail)
    }
  ],
  "productWeight": {
    object (ProductWeight)
  },
  "productLength": {
    object (ProductDimension)
  },
  "productWidth": {
    object (ProductDimension)
  },
  "productHeight": {
    object (ProductDimension)
  },
  "productHighlights": [
    string
  ],
  "certifications": [
    {
      object (Certification)
    }
  ],
  "expirationDate": string,
  "includedDestinations": [
    string
  ],
  "excludedDestinations": [
    string
  ],
  "headlineOfferInstallment": {
    object (HeadlineOfferInstallment)
  },
  "headlineOfferSubscriptionCost": {
    object (HeadlineOfferSubscriptionCost)
  },
  "cppLink": string,
  "cppMobileLink": string,
  "cppAdsRedirect": string,
  "numberOfOffers": string,
  "headlineOfferCondition": string,
  "headlineOfferLink": string,
  "headlineOfferMobileLink": string,
  "title": string,
  "imageLink": string,
  "description": string,
  "brand": string,
  "mpn": string,
  "gtin": string,
  "googleProductCategory": string,
  "adult": boolean,
  "multipack": string,
  "isBundle": boolean,
  "ageGroup": string,
  "color": string,
  "gender": string,
  "material": string,
  "pattern": string,
  "size": string,
  "sizeSystem": string,
  "itemGroupId": string,
  "pause": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "reviewCount": string,
  "minRating": string,
  "maxRating": string,
  "rating": number
}
Felder
lowPrice

object (Price)

Tiefstpreis des Produkts des Preisvergleichsportals.
highPrice

object (Price)

Höchstpreis des CSS-Produkts.
headlineOfferPrice

object (Price)

Hauptpreis des CSS-Produkts.
headlineOfferShippingPrice

object (Price)

Hauptpreis des CSS-Produkts.
productTypes[]

string

Kategorien des Artikels (formatiert wie in der Produktdatenspezifikation).
sizeTypes[]

string

Der Schnitt des Artikels. Er kann verwendet werden, um kombinierte Größentypen für Bekleidungsartikel darzustellen. Es können maximal zwei Größentypen angegeben werden (siehe Größentyp).
productDetails[]

object (ProductDetail)

Technische Daten oder zusätzliche Produktdetails.
productWeight

object (ProductWeight)

Das Gewicht des Produkts in den angegebenen Einheiten. Der Wert muss zwischen 0 (exklusiv) und 2.000 (inklusive) liegen.
productLength

object (ProductDimension)

Die Länge des Produkts in den angegebenen Maßeinheiten. Der Wert muss zwischen 0 (exklusiv) und 3.000 (inklusive) liegen.
productWidth

object (ProductDimension)

Die Breite des Produkts in der angegebenen Maßeinheit. Der Wert muss zwischen 0 (exklusiv) und 3.000 (inklusive) liegen.
productHeight

object (ProductDimension)

Die Höhe des Produkts in den angegebenen Einheiten. Der Wert muss zwischen 0 (exklusiv) und 3.000 (inklusive) liegen.
productHighlights[]

string

Aufzählungspunkte, die die wichtigsten Highlights eines Produkts beschreiben.
certifications[]

object (Certification)

Eine Liste der Zertifikate, die vom Preisvergleichsportal für das angegebene Produkt beansprucht werden.
expirationDate

string (Timestamp format)

Das Ablaufdatum des Artikels, wie beim Einfügen angegeben, im Format ISO 8601. Das tatsächliche Ablaufdatum wird in productstatuses als googleExpirationDate angezeigt und kann früher sein, wenn expirationDate zu weit in der Zukunft liegt. Hinweis: Es kann nach dem Ablaufdatum noch zwei oder mehr Tage dauern, bis das Element tatsächlich gelöscht wird.
includedDestinations[]

string

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

Unterstützte Werte sind: - css_ads_experiences - css_organic_experiences
excludedDestinations[]

string

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

Unterstützte Werte sind: - css_ads_experiences - css_organic_experiences
headlineOfferInstallment

object (HeadlineOfferInstallment)

Anzahl und Höhe der Raten für einen Artikel.
headlineOfferSubscriptionCost

object (HeadlineOfferSubscriptionCost)

Anzahl der Zeiträume (Monate oder Jahre) und Zahlungsbetrag pro Zeitraum für einen Artikel mit einem zugehörigen Abovertrag.
cppAdsRedirect

string

Ermöglicht Werbetreibenden, die Artikel-URL zu überschreiben, wenn das Produkt im Kontext von Produktanzeigen präsentiert wird.
numberOfOffers

string (int64 format)

Die Anzahl der Preisvergleichsportal-Produkte.
headlineOfferCondition

string

Zustand des Hauptangebots.
title

string

Bezeichnung des Artikels
description

string

Beschreibung des Artikels.
brand

string

Produktbezogene Attribute.[14-36] Marke des Artikels.
mpn

string

Teilenummer des Herstellers (MPN) für den Artikel.
gtin

string

Global Trade Item Number (GTIN) des Artikels.
googleProductCategory

string

Die Google-Kategorie des Artikels (siehe Google-Produkt-Taxonomie). Beim Abfragen 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 wiederherzustellen.
adult

boolean

Auf „true“ (wahr) setzen, wenn der Artikel für Erwachsene vorgesehen ist.
multipack

string (int64 format)

Die Anzahl identischer Produkte in einem händlerdefinierten Multipack.
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.
ageGroup

string

Alterszielgruppe des Artikels.
color

string

Farbe des Artikels.
gender

string

Geschlecht, für das der Artikel vorgesehen ist.
material

string

Das Material, aus dem der Artikel besteht.
pattern

string

Das Muster des Artikels (z.B. gepunktet).
size

string

Größe des Artikels. Es ist nur ein Wert zulässig. Fügen Sie bei Varianten mit unterschiedlichen Größen für jede Größe ein separates Produkt mit demselben Wert für itemGroupId ein (siehe [https://support.google.com/merchants/answer/6324492](Größendefinition)).
sizeSystem

string

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

string

Gemeinsame Kennung für alle Varianten desselben Produkts.
pause

string

Die Veröffentlichung dieses Artikels wird vorübergehend pausiert.
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.
reviewCount

string (int64 format)

Anzahl der Rezensionen des Produkts. Erforderlich, wenn rating angegeben ist.
minRating

string (int64 format)

Mindestbewertung des Produkts. Erforderlich, wenn rating angegeben ist.
maxRating

string (int64 format)

Maximale Bewertung des Produkts. Erforderlich, wenn rating angegeben ist.
rating

number

Durchschnittliche Bewertung des Produkts. Der Wert muss im Bereich von [minRating, maxRating] (einschließlich) liegen. Wenn die Bewertung auf der Produktseite angezeigt wird, wird sie auf eine Skala von [1, 5] mit einer Dezimalstelle normalisiert. Wenn angegeben, sind auch reviewCount, minRating und maxRating erforderlich.

Preis

Der Preis als Zahl und Währung.

JSON-Darstellung 
{
  "amountMicros": string,
  "currencyCode": string
}
Felder
amountMicros

string (int64 format)

Der Preis wird als Zahl in Mikros angegeben. Eine Million Mikros entspricht einer Standardeinheit der Währung, z. B. 1 USD = 1.000.000 Mikros.
currencyCode

string

Die Währung des Preises im dreistelligen ISO 4217-Format.

ProductDetail

Die Produktdetails.

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

string

Die Abschnittsüberschrift, die zum Gruppieren einer Reihe von Produktdetails verwendet wird.
attributeName

string

Der Name des Produktdetails.
attributeValue

string

Der Wert des Produktdetails.

ProductWeight

Das Gewicht des Produkts.

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

number

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

string

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

ProductDimension

Die Abmessungen des Produkts.

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

number

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

string

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

Zertifizierung

Die Zertifizierung für das Produkt. Verwenden Sie dieses Attribut, um damit Zertifizierungen wie Energieeffizienzbewertungen eines Produkts zu beschreiben.

JSON-Darstellung 
{
  "name": string,
  "authority": string,
  "code": string
}
Felder
name

string

Der Name der Zertifizierung. Derzeit ist der gängigste Wert „EPREL“, der für Energieeffizienzzertifikate in der EU-Datenbank „European Registry for Energy Labelling“ (EPREL) steht.
authority

string

Die zuständige Zertifizierungsstelle. Derzeit ist der häufigste Wert für Energielabel in der EU „EC“ oder „European_Commission“.
code

string

Der Code der Zertifizierung. Für das EPREL-Zertifikat mit dem Link https://eprel.ec.europa.eu/screen/product/dishwashers2019/123456 lautet der Code beispielsweise 123456. Der Code ist für europäische Energielabels erforderlich.

HeadlineOfferInstallment

Eine Nachricht, die eine Rate darstellt.

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

string (int64 format)

Die Anzahl der Raten, die die Käuferin oder der Käufer leisten muss.
amount

object (Price)

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

object (Price)

Der Betrag, den der Käufer vorab als Anzahlung leisten muss.

HeadlineOfferSubscriptionCost

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 sind: * „month“ * „year“
periodLength

string (int64 format)

Die Anzahl der Abrechnungsperioden, die der Käufer bezahlen muss.
amount

object (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 der Abozeitraum ein Monat ist.
YEAR Gibt an, dass der Abozeitraum ein Jahr beträgt.

CustomAttribute

Eine Nachricht, die benutzerdefinierte Attribute darstellt. Genau eines von value und groupValues darf nicht leer sein.

JSON-Darstellung 
{
  "groupValues": [
    {
      object (CustomAttribute)
    }
  ],
  "name": string,
  "value": string
}
Felder
groupValues[]

object (CustomAttribute)

Unterattribute innerhalb dieser Attributgruppe. Wenn groupValues nicht leer ist, muss value leer sein.
name

string

Der Name des Attributs.
value

string

Der Wert des Attributs. Wenn value nicht leer ist, muss groupValues leer sein.

CssProductStatus

Der Status des CSS-Produkts, Probleme bei der Datenvalidierung, d. h. Informationen zum CSS-Produkt, die asynchron berechnet werden.

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

object (DestinationStatus)

Die vorgesehenen Ziele des Produkts
itemLevelIssues[]

object (ItemLevelIssue)

Eine Liste aller mit dem Produkt verbundenen Probleme.
creationDate

string (Timestamp format)

Datum, an dem das Element erstellt wurde, im ISO 8601-Format.
lastUpdateDate

string (Timestamp format)

Datum, an dem der Artikel zuletzt aktualisiert wurde, im ISO 8601-Format.
googleExpirationDate

string (Timestamp format)

Datum, an dem der Artikel abläuft, im ISO 8601-Format.

DestinationStatus

Der Zielstatus des Produktstatus.

JSON-Darstellung 
{
  "destination": string,
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
Felder
destination

string

Der Name des Ziels
approvedCountries[]

string

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

string

Liste der Ländercodes (ISO 3166-1 alpha-2), für die die Genehmigung des Produkts des Preisvergleichsportals noch aussteht.
disapprovedCountries[]

string

Liste der Ländercodes (ISO 3166-1 alpha-2), für die das Produkt des Preisvergleichsportals abgelehnt wurde.

ItemLevelIssue

Das ItemLevelIssue des Produktstatus.

JSON-Darstellung 
{
  "code": string,
  "servability": string,
  "resolution": string,
  "attribute": string,
  "destination": string,
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
Felder
code

string

Der Fehlercode des Problems
servability

string

Wie sich dieses Problem auf die Zustellung des Produkts im Preisvergleichsportal 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.
destination

string

Das Ziel, das von dem Problem betroffen ist.
description

string

Eine kurze Problembeschreibung in Englisch.
detail

string

Eine ausführliche Problembeschreibung in Englisch.
documentation

string

Die URL einer Webseite als Hilfestellung zur Lösung des Problems.
applicableCountries[]

string

Liste der Ländercodes (ISO 3166-1 Alpha-2), für die das Problem beim Produkt des Preisvergleichsportals gilt.

Methoden

get

 Ruft das verarbeitete Produkt des Preisvergleichsportals aus Ihrem CSS Center-Konto ab.

list

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