REST Resource: accounts.cssProducts

Ressource: CssProduct

Das verarbeitete Preisvergleichsportal-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 mit Produktattributen.
customAttributes[]

object (CustomAttribute)

Nur Ausgabe. Eine Liste benutzerdefinierter (CSS-bereitgestellter) Attribute. Sie kann auch verwendet werden, um ein beliebiges Attribut der Feedspezifikation in seiner generischen Form einzureichen (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. Informationen zu einem Produkt, die asynchron berechnet werden.

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 Preisvergleichsportal-Produkts.
highPrice

object (Price)

Hoher Preis des Preisvergleichsportal-Produkts.
headlineOfferPrice

object (Price)

Hauptangebotspreis des Produkts im Preisvergleichsportal.
headlineOfferShippingPrice

object (Price)

Hauptangebotspreis des Produkts im Preisvergleichsportal.
productTypes[]

string

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

string

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

object (ProductDetail)

Technische Spezifikationen oder zusätzliche Produktdetails.
productWeight

object (ProductWeight)

Das Gewicht des Produkts in den angegebenen Einheiten. Der Wert muss größer als 0 und kleiner oder gleich 2.000 sein.
productLength

object (ProductDimension)

Die Länge des Produkts in den angegebenen Einheiten. Der Wert muss zwischen 0 (exklusiv) und 3.000 (inklusiv) liegen.
productWidth

object (ProductDimension)

Die Breite des Produkts in den angegebenen Einheiten. Der Wert muss zwischen 0 (exklusiv) und 3.000 (inklusiv) liegen.
productHeight

object (ProductDimension)

Die Höhe des Produkts in den angegebenen Einheiten. Der Wert muss zwischen 0 (exklusiv) und 3.000 (inklusiv) 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 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. Hinweis: Es kann zwei oder mehr Tage nach dem Ablaufdatum dauern, bis das Element tatsächlich gelöscht wird.
includedDestinations[]

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

string

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

object (HeadlineOfferInstallment)

Anzahl und Betrag der Raten, die für einen Artikel zu zahlen sind.
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 es 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

Die MPN (Manufacturer Part Number, MPN) für den Artikel.
gtin

string

Global Trade Item Number (GTIN) des Artikels.
googleProductCategory

string

Die Kategorie des Artikels bei Google (siehe Google-Produkt-Taxonomie). Bei der Abfrage von Produkten enthält dieses Feld den vom Nutzer angegebenen Wert. Derzeit ist es nicht möglich, die automatisch zugewiesenen Google-Produktkategorien über die API abzurufen.
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 Gruppe 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. Bei Varianten mit unterschiedlichen Größen müssen Sie für jede Größe ein separates Produkt mit demselben itemGroupId-Wert einfügen (siehe [https://support.google.com/merchants/answer/6324492](Größendefinition)).
sizeSystem

string

System, in dem die Größe angegeben wird. 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 bei einer Shopping-Kampagne.
customLabel1

string

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

string

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

string

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

string

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

string (int64 format)

Anzahl der Rezensionen des Produkts. Erforderlich, wenn rating angegeben ist. Dieses Feld ist für eine zukünftige Funktion vorgesehen und wird noch nicht verwendet.
minRating

string (int64 format)

Mindestbewertung des Produkts. Erforderlich, wenn rating angegeben ist. Dieses Feld ist für eine zukünftige Funktion vorgesehen und wird noch nicht verwendet.
maxRating

string (int64 format)

Maximale Bewertung des Produkts. Erforderlich, wenn rating angegeben ist. Dieses Feld ist für eine zukünftige Funktion vorgesehen und wird noch nicht verwendet.
rating

number

Die durchschnittliche Bewertung des Produkts. Der Wert muss im Bereich [minRating, maxRating] liegen (einschließlich). Wenn diese Bewertung auf der Produktseite angezeigt wird, wird sie auf eine Skala von [1, 5] mit einer Dezimalstelle normalisiert. Falls angegeben, sind auch reviewCount, minRating und maxRating erforderlich. Dieses Feld ist für eine zukünftige Funktion vorgesehen und wird noch nicht verwendet.

Preis

Der Preis als Zahl und Währung.

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

string (int64 format)

Der Preis als Zahl in Mikros (1 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 Format gemäß ISO 4217.

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. Das Gewicht als Zahl. Das Gewicht kann maximal vier Dezimalstellen haben.
unit

string

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

ProductDimension

Die Dimension des Produkts.

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

number

Erforderlich. Der als Zahl dargestellte Dimensionswert. Der Wert darf maximal vier Dezimalstellen haben.
unit

string

Erforderlich. Die Dimensionseinheiten. Zulässige Werte: * „in“ * „cm“

Zertifizierung

Die Zertifizierung für das Produkt. Verwenden Sie dieses Attribut, um 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 häufigste 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 „EC“ oder „European_Commission“ für Energielabel in der EU.
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 der Käufer zahlen muss.
amount

object (Price)

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

object (Price)

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

HeadlineOfferSubscriptionCost

Die SubscriptionCost 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 Abrechnungszeiträume, die der Käufer bezahlen muss.
amount

object (Price)

Der Betrag, den der Käufer pro Abrechnungszeitraum 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 ist.

CustomAttribute

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

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

object (CustomAttribute)

Unterattribute in 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 Preisvergleichsportal-Produkts, Probleme bei der Datenvalidierung, d. h. Informationen zum Preisvergleichsportal-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 Probleme, die mit dem Produkt verknüpft sind.
creationDate

string (Timestamp format)

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

string (Timestamp format)

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

string (Timestamp format)

Das Ablaufdatum des Artikels 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), in denen das CSS-Produkt genehmigt ist.
pendingCountries[]

string

Liste der Ländercodes (ISO 3166-1 alpha-2), in denen das CSS-Produkt noch nicht genehmigt wurde.
disapprovedCountries[]

string

Liste der Ländercodes (ISO 3166-1 alpha-2), in denen das CSS-Produkt 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 Auslieferung des Preisvergleichsportals 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), in denen das Problem für das CSS-Produkt gilt.

Methoden

get

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

list

 Hier werden die verarbeiteten Preisvergleichsportal-Produkte in Ihrem CSS Center-Konto aufgeführt.