REST Resource: accounts.cssProducts

Ressource: CssProduct

Das verarbeitete Produkt des Preisvergleichsportals.

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 Preisvergleichsportal-Produkts. Format: "accounts/{account}/cssProducts/{css_product}"
rawProvidedId

string

Nur Ausgabe. Ihre eindeutige Roh-ID 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 (CSS-eigener) Attribute. Außerdem können Sie damit 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 mit 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
}
Felder
lowPrice

object (Price)

Tiefstpreis des Produkts im Preisvergleichsportal
highPrice

object (Price)

Höchstpreis des Preisvergleichsportal-Produkts
headlineOfferPrice

object (Price)

Der Hauptpreis des Produkts im Preisvergleichsportal.
headlineOfferShippingPrice

object (Price)

Der Hauptpreis 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ößentypen für Bekleidungsartikel anzugeben. Es können maximal zwei Größentypen angegeben werden (siehe [https://support.google.com/merchants/answer/6324497](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 (ausschließlich) und 2.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.
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.
productHighlights[]

string

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

object (Certification)

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

string (Timestamp format)

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 nach Ablauf des Gültigkeitszeitraums mehr als zwei Tage dauern, bis der Artikel 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 unter 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 für einen Artikel.
headlineOfferSubscriptionCost

object (HeadlineOfferSubscriptionCost)

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

string

Damit können Werbetreibende die Artikel-URL ü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 Teilenummer des Herstellers (MPN) des Artikels.
gtin

string

Die Global Trade Item Number (GTIN) des Artikels.
googleProductCategory

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

boolean

Legen Sie „true“ fest, 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 Gesamtpreis 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. Polka Dots)
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 von Größen)).
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.

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. Eine Million Mikros entspricht einer Währungseinheit, z. B. 1 € = 1.000.000 Mikros.
currencyCode

string

Die Währung des Preises mit dreistelligen Akronymen gemäß ISO 4217.

ProductDetail

Die Produktdetails.

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

string

Die Abschnittsüberschrift, mit der eine Reihe von Produktdetails gruppiert 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. 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“

ProductDimension

Die Größe des Produkts.

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

number

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“

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 häufigste Wert „EPREL“, der für Energieeffizienzzertifikate in der EU-Datenbank „European Registry for Energy Labeling“ (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 monatlich zahlen muss.
downpayment

object (Price)

Der Betrag der Anzahlung, die der Käufer im Voraus zahlen 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: * „month“ * „year“
periodLength

string (int64 format)

Die Anzahl der Abrechnungsperioden, die der Käufer zahlen 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 die Abolaufzeit ein Monat ist.
YEAR Gibt an, dass die Abolaufzeit ein Jahr beträgt.

CustomAttribute

Eine Nachricht, die benutzerdefinierte Attribute darstellt. Genau eine von value oder 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 Preisvergleichsportal-Produkts, Probleme mit 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 im Zusammenhang mit dem Produkt.
creationDate

string (Timestamp format)

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

string (Timestamp format)

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

string (Timestamp format)

Das Datum, an dem das Element 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), in denen das Preisvergleichsportal-Produkt genehmigt ist.
pendingCountries[]

string

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

string

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

ItemLevelIssue

Das Problem auf Artikelebene 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 Preisvergleichsportal-Produkts 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

Ausführliche Problembeschreibung in Englisch.
documentation

string

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

string

Liste der Ländercodes (ISO 3166-1 alpha-2), für die das Problem auf das Preisvergleichsportal-Produkt zutrifft.

Methoden

get

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

list

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