Package google.shopping.css.v1

string

Der Name der Labelressource. Format: accounts/{account}

string

Nur Ausgabe. Nicht veränderbar. Der vollständige Name des Preisvergleichsportal-/Händlercenter-Kontos.

int64

Manuell erstellte Label-IDs, die dem Preisvergleichsportal-/Marktplatzkonto von einem übergeordneten Preisvergleichsportal-Konto zugewiesen wurden.

int64

Automatisch erstellte Label-IDs, die dem MC-Konto vom CSS Center zugewiesen wurden.

AccountType

Nur Ausgabe. Der Typ dieses Kontos.

string

Der kurze Anzeigename des Preisvergleichsportal-/Marktplatzkontos.

string

Nur Ausgabe. Nicht veränderbar. Die Startseite des Preisvergleichsportal-/Marktplatzkontos.

string

Die übergeordnete Ressource des Preisvergleichsportal-/Marktplatz-Kontos. Preisvergleichsportal-Gruppe für Preisvergleichsportal-Domains; Preisvergleichsportal-Domain für MC-Konten. Wird nur zurückgegeben, wenn der Nutzer Zugriff auf das übergeordnete Konto hat. Hinweis: Bei MC-Unterkonten ist dies auch die Preisvergleichsportal-Domain, die die übergeordnete Ressource des Mehrfachkundenkontos ist, da wir die Hierarchie effektiv flach gestalten.

string

Kennung. Der Ressourcenname des Labels. Format: accounts/{account}/labels/{label}

int64

Nur Ausgabe. Die ID des Labels.

int64

Nur Ausgabe. Die ID des Kontos, zu dem dieses Label gehört.

LabelType

Nur Ausgabe. Der Typ dieses Labels.

string

Der Anzeigename dieses Labels.

string

Die Beschreibung dieses Labels.

Price

Tiefstpreis des Produkts im Preisvergleichsportal

Price

Höchstpreis des Preisvergleichsportal-Produkts

Price

Der Hauptpreis des Produkts im Preisvergleichsportal.

Price

Der Hauptpreis des Produkts im Preisvergleichsportal.

string

Zusätzliche URL von Bildern des Artikels.

string

Kategorien des Artikels (formatiert wie in der Produktdatenspezifikation)

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

ProductDetail

Technische Daten oder zusätzliche Produktdetails

ProductWeight

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

ProductDimension

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

ProductDimension

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

ProductDimension

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

string

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

Certification

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

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. Hinweis: Es kann nach Ablauf des Gültigkeitszeitraums mehr als zwei Tage dauern, bis der Artikel tatsächlich gelöscht wird.

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.

string

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

HeadlineOfferInstallment

Anzahl und Betrag der Raten für einen Artikel.

HeadlineOfferSubscriptionCost

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

string

URL, die direkt auf die Produktdetailseite des Preisvergleichsportals verweist.

string

URL der für Mobilgeräte optimierten Version der Produktdetailseite des Preisvergleichsportals.

string

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

int64

Die Anzahl der Preisvergleichsportal-Produkte.

string

Zustand des Hauptangebots.

string

Link zum Hauptangebot.

string

Mobiler Link zum Hauptangebot.

string

Bezeichnung des Artikels

string

URL eines Bildes des Artikels.

string

Beschreibung des Artikels.

string

Produktbezogene Attribute [14–36] Marke des Artikels.

string

Die Teilenummer des Herstellers (MPN) des Artikels.

string

Die Global Trade Item Number (GTIN) des Artikels.

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.

bool

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

int64

Die Anzahl identischer Produkte in einem händlerdefinierten Multipack.

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.

string

Alterszielgruppe des Artikels.

string

Farbe des Artikels.

string

Geschlecht, für das der Artikel vorgesehen ist.

string

Das Material, aus dem der Artikel besteht.

string

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

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

string

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

string

Gemeinsame Kennung für alle Varianten desselben Produkts.

string

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

string

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

string

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

string

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

string

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

string

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

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.

string

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

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.

string

Erforderlich. Das übergeordnete Konto. Format: accounts/{account}

AccountLabel

Erforderlich. Das zu erstellende Label.

string

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

string

Nur Ausgabe. Ihre eindeutige Roh-ID für das Produkt.

string

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

string

Nur Ausgabe. Das Feedlabel für das Produkt.

Attributes

Nur Ausgabe. Eine Liste von Produktattributen.

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

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

string

Kennung. Der Name der CSS-Produkteingabe. Format: accounts/{account}/cssProductInputs/{css_product_input}, wobei der letzte Abschnitt css_product_input aus drei Teilen besteht: contentLanguage~feedLabel~offerId. Beispiel: accounts/123/cssProductInputs/de~DE~rawProvidedId123

string

Nur Ausgabe. Der Name des verarbeiteten Preisvergleichsportal-Produkts. Format: accounts/{account}/cssProducts/{css_product} "

string

Erforderlich. Ihre eindeutige Kennung für das Preisvergleichsportal-Produkt. Das gilt sowohl für die Eingabe des Preisvergleichsportal-Produkts als auch für das verarbeitete Preisvergleichsportal-Produkt. Es sind nur IDs mit alphanumerischen Zeichen, Unterstrichen und Bindestriche zulässig. Weitere Informationen finden Sie in der Produktfeedspezifikation.

string

Erforderlich. Der zweistellige Sprachcode ISO 639-1 für das CSS-Produkt.

string

Erforderlich. Das Feedlabel für das Produkt des Preisvergleichsportals. Das Feedlabel ist mit „Zielland“ identisch und sollte daher immer ein gültiger Regionscode sein. Beispiel: „DE“ für Deutschland, „FR“ für Frankreich.

Timestamp

VERWORFEN. Verwenden Sie stattdessen „expiration_date“. Stellt die vorhandene Version (Aktualität) des Preisvergleichsportal-Produkts dar. Damit kann die richtige Reihenfolge bei mehreren gleichzeitigen Aktualisierungen beibehalten werden.

Dieses Feld darf nicht auf eine Zeit in der Zukunft festgelegt sein.

Wenn diese Option festgelegt ist, wird die Aktualisierung verhindert, wenn bereits eine neuere Version des Artikels in unserem System vorhanden ist. Das bedeutet, dass das letzte Aktualisierungsdatum der vorhandenen Produkte des Preisvergleichsportals später als das im Update festgelegte Datum für die Aktualität ist. Wenn die Aktualisierung erfolgt, wird die letzte Aktualisierungszeit auf diesen Zeitpunkt festgelegt.

Wenn das Attribut nicht festgelegt ist, wird das Update nicht verhindert und die letzte Aktualisierungszeit ist standardmäßig der Zeitpunkt, zu dem diese Anfrage von der CSS API empfangen wurde.

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

Attributes

Eine Liste der Produktattribute für Preisvergleichsportale.

CustomAttribute

Eine Liste benutzerdefinierter (CSS-eigener) Attribute. Außerdem kann es verwendet werden, um beliebige Attribute der Feedspezifikation in ihrer 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.

DestinationStatus

Die vorgesehenen Ziele des Produkts

ItemLevelIssue

Eine Liste aller Probleme im Zusammenhang mit dem Produkt.

Timestamp

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

Timestamp

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

Timestamp

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

string

Der Name des Ziels

string

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

string

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

string

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

string

Der Fehlercode des Problems

string

Wie sich dieses Problem auf die Auslieferung des Preisvergleichsportal-Produkts auswirkt.

string

Ob das Problem vom Händler behoben werden kann.

string

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

string

Das Ziel, das von dem Problem betroffen ist.

string

Eine kurze Problembeschreibung in Englisch.

string

Ausführliche Problembeschreibung in Englisch.

string

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

string

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

string

Erforderlich. Der Name des zu löschenden Labels. Format: accounts/{account}/labels/{label}

string

Erforderlich. Der Name der zu löschenden Eingaberessource für das Preisvergleichsportal-Produkt. Format: accounts/{account}/cssProductInputs/{css_product_input}, wobei der letzte Abschnitt css_product_input aus drei Teilen besteht: contentLanguage~feedLabel~offerId. Beispiel: accounts/123/cssProductInputs/de~DE~rawProvidedId123

int64

Die ID des Content API-Subfeeds. Das Feld darf nicht festgelegt werden, wenn sich die Aktion auf einen Hauptfeed bezieht. Wenn das Feld festgelegt ist, gilt die Produktaktion für einen Subfeed anstelle des Haupt-Content API-Feeds.

string

Erforderlich. Der Name des verwalteten Preisvergleichsportal-/Marktplatzkontos. Format: accounts/{account}

string

Optional. Nur erforderlich, wenn MC-Kontoinformationen abgerufen werden. Die Preisvergleichsportal-Domain, die die übergeordnete Ressource des MC-Kontos ist. Format: accounts/{account}

string

Erforderlich. Der Name des abzurufenden CSS-Produkts.

int64

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

Price

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

Price

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

SubscriptionPeriod

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

int64

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

Price

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

string

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

CssProductInput

Erforderlich. Die einzufügende CSS-Produkteigabe.

int64

Optional. VERWORFEN. Für Produkte im Preisvergleichsportal ist keine Feed-ID erforderlich. Die ID des Haupt- oder Subfeeds. Wenn das Produkt im Preisvergleichsportal bereits vorhanden ist und die angegebene Feed-ID abweicht, wird das Produkt in einen neuen Feed verschoben. Hinweis: Derzeit müssen Preisvergleichsportale keine Feed-IDs angeben, da wir Feeds direkt erstellen. Derzeit wird die Unterstützung von ergänzenden Feeds für Produkte des Preisvergleichsportals nicht angeboten.

string

Erforderlich. Das übergeordnete Konto. Format: accounts/{account}

int32

Die maximale Anzahl der zurückzugebenden Labels. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 50 Labels zurückgegeben. Der Höchstwert beträgt 1.000. Werte über 1.000 werden implizit auf 1.000 umgewandelt.

string

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

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

AccountLabel

Die Labels aus dem angegebenen Konto.

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.

string

Erforderlich. Das übergeordnete Konto. Es muss sich um eine Preisvergleichsportal-Gruppe oder -Domain handeln. Format: accounts/{account}

int32

Optional. Die maximale Anzahl der Konten, die zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Wenn nicht angegeben, werden maximal 50 Konten zurückgegeben. Der Höchstwert beträgt 100. Werte über 100 werden auf 100 festgelegt.

string

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

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

int64

Wenn festgelegt, werden nur die MC-Konten mit der angegebenen Label-ID zurückgegeben.

string

Wenn festgelegt, werden nur die MC-Konten mit dem angegebenen Namen zurückgegeben (bei Groß- und Kleinschreibung unterscheidend).

Account

Die Preisvergleichsportal-/Marktplatzkonten, die für das angegebene übergeordnete Preisvergleichsportal-Konto zurückgegeben wurden.

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.

string

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

int32

Die maximale Anzahl der zurückzugebenden CSS-Produkte. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Der Höchstwert beträgt 1.000. Werte über 1.000 werden implizit auf 1.000 umgewandelt. Wenn nicht angegeben, wird die maximale Anzahl von CSS-Produkten zurückgegeben.

string

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

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

CssProduct

Die verarbeiteten Preisvergleichsportal-Produkte aus dem angegebenen Konto. Dies sind Ihre verarbeiteten Produkte des Preisvergleichsportals nach Anwendung von Regeln und Subfeeds.

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.

string

Erforderlich. Das Preisvergleichsportal-Konto, zu dem die Methodenkontingente und ‑ressourcen gehören. In den meisten Fällen ist dies die CSS-Domain. Format: accounts/{account}

int32

Optional. Die maximale Anzahl der Kontingente, die in der Antwort zurückgegeben werden sollen. Wird für die Paginierung verwendet. Der Standardwert ist 500. Werte über 1.000 werden auf 1.000 festgelegt.

string

Optional. Token (falls angegeben), um die nachfolgende Seite abzurufen. Alle anderen Parameter müssen mit dem ursprünglichen Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

QuotaGroup

Die Methoden, die aktuelle Kontingentnutzung und die Limits für jede Gruppe. Das Kontingent wird auf alle Methoden in der Gruppe aufgeteilt. Die Gruppen werden nach quota_usage in absteigender Reihenfolge sortiert.

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.

string

Nur Ausgabe. Der Name der Methode, z. B. cssproductsservice.listcssproducts.

string

Nur Ausgabe. Die API-Version, zu der die Methode gehört.

string

Nur Ausgabe. Die untergeordnete API, zu der die Methode gehört. In der CSS API ist das immer css.

string

Nur Ausgabe. Der Pfad für die Methode, z. B. v1/cssproductsservice.listcssproducts.

string

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

string

Der Name des Produktdetails.

string

Der Wert des Produktdetails.

double

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

string

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

double

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

string

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

string

Kennung. Der Ressourcenname der Kontingentgruppe. Format: accounts/{account}/quotas/{group} Beispiel: accounts/12345678/quotas/css-products-insert Hinweis: Der Teil {group} folgt nicht unbedingt einem bestimmten Muster.

int64

Nur Ausgabe. Die aktuelle Kontingentnutzung, also die Anzahl der Aufrufe, die an einem bestimmten Tag bereits an die Methoden in der Gruppe gesendet wurden. Die Tageskontingente werden um 12:00 Uhr (UTC) zurückgesetzt.

int64

Nur Ausgabe. Die maximal zulässige Anzahl von Anrufen pro Tag für die Gruppe.

int64

Nur Ausgabe. Die maximal zulässige Anzahl von Anrufen pro Minute für die Gruppe.

MethodDetails

Nur Ausgabe. Liste aller Methoden, auf die das Gruppenkontingent angewendet wird.

AccountLabel

Erforderlich. Das aktualisierte Label. Alle Felder müssen ausgefüllt sein.

string

Erforderlich. Der Name der Labelressource. Format: accounts/{account}

int64

Die Liste der Label-IDs, mit denen die vorhandenen Konto-Label-IDs überschrieben werden sollen. Wenn die Liste leer ist, werden alle derzeit zugewiesenen Label-IDs gelöscht.

string

Optional. Nur erforderlich, wenn MC-Kontolabels aktualisiert werden. Die Preisvergleichsportal-Domain, die die übergeordnete Ressource des MC-Kontos ist. Format: accounts/{account}

CssProductInput

Erforderlich. Die zu aktualisierende CSS-Produkteingabenressource. Die von Ihnen eingereichten Informationen werden auch auf das verarbeitete Produkt im Preisvergleichsportal angewendet.

FieldMask

Die Liste der zu aktualisierenden Produktattribute im Preisvergleichsportal.

Wenn die Aktualisierungsmaske weggelassen wird, wird sie als implizite Feldmaske für alle ausgefüllten Felder (mit einem nicht leeren Wert) behandelt.

Attribute, die in der Aktualisierungsmaske angegeben sind, für die aber im Text kein Wert angegeben ist, werden aus dem Preisvergleichsportal-Produkt gelöscht.

Die Aktualisierungsmaske kann nur für Felder der obersten Ebene in Attributen und benutzerdefinierten Attributen angegeben werden.

Wenn Sie die Aktualisierungsmaske für benutzerdefinierte Attribute angeben möchten, müssen Sie das Präfix custom_attribute. hinzufügen.

Der spezielle Wert „*“ für den vollständigen Produktersatz im Preisvergleichsportal wird nicht unterstützt.