Package google.shopping.merchant.reports.v1beta

Index

ReportService

Dienst zum Abrufen von Berichten und Statistiken zu Ihren Produkten, ihrer Leistung und ihrer Wettbewerbsumgebung bei Google.

Suchen

rpc Search(SearchRequest) returns (SearchResponse)

Ruft einen Bericht ab, der durch eine Suchanfrage definiert ist. Die Antwort kann weniger Zeilen enthalten als in page_size angegeben. Anhand von next_page_token können Sie feststellen, ob weitere Zeilen angefordert werden müssen.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/content

Weitere Informationen finden Sie unter OAuth 2.0 Overview.

BestSellersBrandView

Felder, die in der Tabelle best_sellers_brand_view für Abfragen verfügbar sind.

Bestsellerbericht mit den Top-Marken

Werte werden nur für Felder festgelegt, die in der Suchanfrage der Anfrage explizit angefordert wurden.

Felder
report_date

Date

Datum des Berichts. Der Wert dieses Felds kann nur einer der folgenden sein:

  • Der erste Tag der Woche (Montag) für Wochenberichte,
  • Der erste Tag des Monats für monatliche Berichte.

Erforderlich in der SELECT-Klausel. Wenn in der Abfrage keine WHERE-Bedingung für report_date angegeben ist, wird der jeweils aktuelle Wochen- oder Monatsbericht zurückgegeben.
report_granularity

ReportGranularityEnum

Detaillierungsgrad des Berichts. Das Ranking kann über einen Zeitraum von einer Woche oder einem Monat erfolgen.

Erforderlich in der SELECT-Klausel. In der WHERE-Klausel ist eine Bedingung für report_granularity erforderlich.
report_country_code

string

Land, in dem das Ranking berechnet wird. Muss im ISO 3166-Format angegeben werden.

Erforderlich in der SELECT-Klausel. In der WHERE-Klausel ist eine Bedingung für report_country_code erforderlich.
report_category_id

int64

Die Google-Produktkategorie-ID, für die das Ranking berechnet werden soll, in der Google-Produkt-Taxonomie.

Erforderlich in der SELECT-Klausel. Wenn in der Abfrage keine WHERE-Bedingung für report_category_id angegeben ist, werden Rankings für alle Kategorien der obersten Ebene zurückgegeben.
brand

string

Name der Marke.
rank

int64

Beliebtheit der Marke in Anzeigen und organischen Oberflächen in der ausgewählten Kategorie und im ausgewählten Land. Sie beruht auf der geschätzten Anzahl verkaufter Einheiten.
previous_rank

int64

Beliebtheitsrang in der Vorwoche oder im Vormonat.
relative_demand

RelativeDemandEnum

Geschätzte Nachfrage in Bezug auf die Marke mit dem höchsten Beliebtheitsrang in derselben Kategorie und im selben Land.
previous_relative_demand

RelativeDemandEnum

Geschätzte Nachfrage in Bezug auf die Marke mit dem höchsten Beliebtheitsrang in derselben Kategorie und im selben Land in der Vorwoche oder im Vormonat.
relative_demand_change

RelativeDemandChangeTypeEnum

Änderung der geschätzten Nachfrage. Ob der Wert gestiegen, gesunken oder unverändert geblieben ist.

BestSellersProductClusterView

Felder, die in der Tabelle best_sellers_product_cluster_view für Abfragen verfügbar sind.

Bestsellerbericht mit den Top-Produktclustern Ein Produktcluster ist eine Gruppierung verschiedener Angebote und Varianten, die dasselbe Produkt repräsentieren, z. B. Google Pixel 7.

Werte werden nur für Felder festgelegt, die in der Suchanfrage der Anfrage explizit angefordert wurden.

Felder
report_date

Date

Datum des Berichts. Der Wert dieses Felds kann nur einer der folgenden sein:

  • Der erste Tag der Woche (Montag) für Wochenberichte,
  • Der erste Tag des Monats für monatliche Berichte.

Erforderlich in der SELECT-Klausel. Wenn in der Abfrage keine WHERE-Bedingung für report_date angegeben ist, wird der jeweils aktuelle Wochen- oder Monatsbericht zurückgegeben.
variant_gtins[]

string

GTINs von Beispielvarianten des Produktclusters.
report_granularity

ReportGranularityEnum

Detaillierungsgrad des Berichts. Das Ranking kann über einen Zeitraum von einer Woche oder einem Monat erfolgen.

Erforderlich in der SELECT-Klausel. In der WHERE-Klausel ist eine Bedingung für report_granularity erforderlich.
report_country_code

string

Land, in dem das Ranking berechnet wird. Muss im ISO 3166-Format angegeben werden.

Erforderlich in der SELECT-Klausel. In der WHERE-Klausel ist eine Bedingung für report_country_code erforderlich.
report_category_id

int64

Die Google-Produktkategorie-ID, für die das Ranking berechnet werden soll, in der Google-Produkt-Taxonomie.

Erforderlich in der SELECT-Klausel. Wenn in der Abfrage keine WHERE-Bedingung für report_category_id angegeben ist, werden Rankings für alle Kategorien der obersten Ebene zurückgegeben.
title

string

Titel des Produktclusters.
brand

string

Marke des Produktclusters.
category_l1

string

Produktkategorie (1. Ebene) des Produktclusters, dargestellt in der Google-Produkt-Taxonomie.
category_l2

string

Produktkategorie (2. Ebene) des Produktclusters, dargestellt in der Google-Produkt-Taxonomie.
category_l3

string

Produktkategorie (3. Ebene) des Produktclusters, dargestellt in der Google-Produkt-Taxonomie.
category_l4

string

Produktkategorie (4. Ebene) des Produktclusters, dargestellt in der Google-Produkt-Taxonomie.
category_l5

string

Produktkategorie (5. Ebene) des Produktclusters, dargestellt in der Google-Produkt-Taxonomie.
inventory_status

InventoryStatus

Gibt an, ob der Produktcluster in Ihrer Produktdatenquelle in mindestens einem der Länder IN_STOCK, in allen Ländern OUT_OF_STOCK oder überhaupt NOT_IN_INVENTORY ist.

Bei diesem Feld wird der Länderfilter des Bestsellerberichts nicht berücksichtigt.
brand_inventory_status

InventoryStatus

Gibt an, ob mindestens ein Produkt der Marke derzeit IN_STOCK in Ihrer Produktdatenquelle in mindestens einem der Länder ist, alle Produkte in Ihrer Produktdatenquelle in allen Ländern OUT_OF_STOCK sind oder NOT_IN_INVENTORY.

Bei diesem Feld wird der Länderfilter des Bestsellerberichts nicht berücksichtigt.
rank

int64

Beliebtheit des Produktclusters in Anzeigen und organischen Oberflächen in der ausgewählten Kategorie und im ausgewählten Land. Sie beruht auf der geschätzten Anzahl verkaufter Einheiten.
previous_rank

int64

Beliebtheitsrang in der Vorwoche oder im Vormonat.
relative_demand

RelativeDemandEnum

Geschätzte Nachfrage in Bezug auf den Produktcluster mit dem höchsten Beliebtheitsrang in derselben Kategorie und im selben Land.
previous_relative_demand

RelativeDemandEnum

Geschätzte Nachfrage in Bezug auf den Produktcluster mit dem höchsten Beliebtheitsrang in derselben Kategorie und im selben Land in der Vorwoche oder im Vormonat.
relative_demand_change

RelativeDemandChangeTypeEnum

Änderung der geschätzten Nachfrage. Ob der Wert gestiegen, gesunken oder unverändert geblieben ist.

InventoryStatus

Status des Produktclusters oder der Marke in Ihrem Inventar.

Enums
INVENTORY_STATUS_UNSPECIFIED Nicht angegeben.
IN_STOCK Sie haben ein Produkt für diesen Produktcluster oder diese Marke auf Lager.
OUT_OF_STOCK Sie haben ein Produkt für diesen Produktcluster oder diese Marke auf Lager, das derzeit nicht auf Lager ist.
NOT_IN_INVENTORY Sie haben kein Produkt für diesen Produktcluster oder diese Marke im Inventar.

CompetitiveVisibilityBenchmarkView

Felder, die in der Tabelle competitive_visibility_benchmark_view für Abfragen verfügbar sind.

Bericht Mitbewerber im Blick mit der Benchmark der Kategorie

Werte werden nur für Felder festgelegt, die in der Suchanfrage der Anfrage explizit angefordert wurden.

Felder
date

Date

Das Datum dieser Zeile.

Erforderlich in der SELECT-Klausel. In der WHERE-Klausel ist eine Bedingung für date erforderlich.
report_country_code

string

Land, in dem Impressionen erzielt wurden.

Erforderlich in der SELECT-Klausel. In der WHERE-Klausel ist eine Bedingung für report_country_code erforderlich.
report_category_id

int64

Die Google-Produktkategorie-ID, für die der Bericht berechnet werden soll, in der Google-Produkt-Taxonomie.

Erforderlich in der SELECT-Klausel. In der WHERE-Klausel ist eine Bedingung für report_category_id erforderlich.
traffic_source

TrafficSourceEnum

Zugriffsquelle der Impressionen.

Erforderlich in der SELECT-Klausel.
your_domain_visibility_trend

double

Änderung der Sichtbarkeit basierend auf Impressionen für Ihre Domain im Vergleich zum Beginn des ausgewählten Zeitraums (oder zum ersten Tag mit nicht nullwertigen Impressionen).

Kann nicht in der WHERE-Klausel gefiltert werden.
category_benchmark_visibility_trend

double

Änderung der Sichtbarkeit basierend auf Impressionen im Vergleich zum Beginn des ausgewählten Zeitraums (oder zum ersten Tag mit nicht null Impressionen) für eine Kombination von Händlern mit der höchsten Sichtbarkeit, die dem Markt entspricht.

Kann nicht in der WHERE-Klausel gefiltert werden.

CompetitiveVisibilityCompetitorView

Felder, die in der Tabelle competitive_visibility_competitor_view für Abfragen verfügbar sind.

Bericht Mitbewerber im Blick mit Unternehmen mit ähnlicher Sichtbarkeit

Werte werden nur für Felder festgelegt, die in der Suchanfrage der Anfrage explizit angefordert wurden.

Felder
date

Date

Datum dieser Zeile.

In der WHERE-Klausel ist eine Bedingung für date erforderlich.
domain

string

Domain Ihres Mitbewerbers oder Ihre Domain, wenn „is_your_domain“ wahr ist.

Erforderlich in der SELECT-Klausel. Kann nicht in der WHERE-Klausel gefiltert werden.
is_your_domain

bool

„Wahr“, wenn diese Zeile Daten für Ihre Domain enthält.

Kann nicht in der WHERE-Klausel gefiltert werden.
report_country_code

string

Land, in dem Impressionen erzielt wurden.

Erforderlich in der SELECT-Klausel. In der WHERE-Klausel ist eine Bedingung für report_country_code erforderlich.
report_category_id

int64

Die Google-Produktkategorie-ID, für die der Bericht berechnet werden soll, in der Google-Produkt-Taxonomie.

Erforderlich in der SELECT-Klausel. In der WHERE-Klausel ist eine Bedingung für report_category_id erforderlich.
traffic_source

TrafficSourceEnum

Zugriffsquelle der Impressionen.

Erforderlich in der SELECT-Klausel.
rank

int64

Die Position der Domain im Ranking der ähnlichen Unternehmen für die ausgewählten Schlüssel (date, report_category_id, report_country_code, traffic_source) basierend auf den Impressionen. 1 ist der höchste Wert.

Kann nicht in der WHERE-Klausel gefiltert werden.
ads_organic_ratio

double

Das Verhältnis „Anzeigen / Organisch“ gibt an, wie oft die Domain über Shopping-Anzeigen im Vergleich zu über organische Zugriffe aufgerufen wurde. Die Zahl wird gerundet und in Gruppen zusammengefasst.

Kann nicht in der WHERE-Klausel gefiltert werden.
page_overlap_rate

double

Die Häufigkeit der Platzierung auf gleicher Seite gibt an, wie oft die Angebote von Einzelhändlern zusammen mit Ihren Angeboten auf derselben Seite angezeigt werden.

Kann nicht in der WHERE-Klausel gefiltert werden.
higher_position_rate

double

Mit der Häufigkeit der höheren Platzierung wird angegeben, wie oft das Angebot eines Mitbewerbers an einer höheren Position auf der Seite platziert wurde als Ihr Angebot.

Kann nicht in der WHERE-Klausel gefiltert werden.
relative_visibility

double

Die relative Sichtbarkeit gibt an, wie oft die Angebote Ihrer Mitbewerber im Vergleich zu Ihren Angeboten angezeigt werden. Dieser Wert zeigt also die Anzahl der Impressionen eines Mitbewerbers, geteilt durch die Anzahl der angezeigten Impressionen in einem ausgewählten Zeitraum für die ausgewählte Produktkategorie und das ausgewählte Land.

Kann nicht in der WHERE-Klausel gefiltert werden.

CompetitiveVisibilityTopMerchantView

Felder, die in der Tabelle competitive_visibility_top_merchant_view für Abfragen verfügbar sind.

Bericht Mitbewerber im Blick mit dem Unternehmen mit der höchsten Sichtbarkeit

Werte werden nur für Felder festgelegt, die in der Suchanfrage der Anfrage explizit angefordert wurden.

Felder
date

Date

Das Datum dieser Zeile.

Kann nicht in der SELECT-Klausel ausgewählt werden. In der WHERE-Klausel ist eine Bedingung für date erforderlich.
domain

string

Domain Ihres Mitbewerbers oder Ihre Domain, wenn „is_your_domain“ wahr ist.

Erforderlich in der SELECT-Klausel. Kann nicht in der WHERE-Klausel gefiltert werden.
is_your_domain

bool

„Wahr“, wenn diese Zeile Daten für Ihre Domain enthält.

Kann nicht in der WHERE-Klausel gefiltert werden.
report_country_code

string

Land, in dem Impressionen erzielt wurden.

Erforderlich in der SELECT-Klausel. In der WHERE-Klausel ist eine Bedingung für report_country_code erforderlich.
report_category_id

int64

Die Google-Produktkategorie-ID, für die der Bericht berechnet werden soll, in der Google-Produkt-Taxonomie.

Erforderlich in der SELECT-Klausel. In der WHERE-Klausel ist eine Bedingung für report_category_id erforderlich.
traffic_source

TrafficSourceEnum

Zugriffsquelle der Impressionen.

Erforderlich in der SELECT-Klausel.
rank

int64

Die Position der Domain im Ranking der Top-Händler für die ausgewählten Schlüssel (date, report_category_id, report_country_code, traffic_source) basierend auf Impressionen. 1 ist der höchste Wert.

Kann nicht in der WHERE-Klausel gefiltert werden.
ads_organic_ratio

double

Das Verhältnis „Anzeigen / Organisch“ gibt an, wie oft die Domain über Shopping-Anzeigen im Vergleich zu über organische Zugriffe aufgerufen wurde. Die Zahl wird gerundet und in Gruppen zusammengefasst.

Kann nicht in der WHERE-Klausel gefiltert werden.
page_overlap_rate

double

Die Häufigkeit der Platzierung auf gleicher Seite gibt an, wie oft die Angebote von Einzelhändlern zusammen mit Ihren Angeboten auf derselben Seite angezeigt werden.

Kann nicht in der WHERE-Klausel gefiltert werden.
higher_position_rate

double

Mit der Häufigkeit der höheren Platzierung wird angegeben, wie oft das Angebot eines Mitbewerbers an einer höheren Position auf der Seite platziert wurde als Ihr Angebot.

Kann nicht in der WHERE-Klausel gefiltert werden.

MarketingMethod

Dieser Typ hat keine Felder.

Marketingmethode, mit der Sie Ihre Produkte auf Google bewerben (organisch oder Anzeigen).

MarketingMethodEnum

Werte für Marketingmethoden

Enums
MARKETING_METHOD_ENUM_UNSPECIFIED Nicht angegeben.
ORGANIC Organisches Marketing
ADS Anzeigenbasiertes Marketing

NonProductPerformanceView

Felder, die in der Tabelle non_product_performance_view für Abfragen verfügbar sind.

Leistungsdaten zu Bildern und Onlineshop-Links, die zu nicht produktbezogenen Seiten führen. Dazu gehören Leistungsmesswerte (z. B. clicks) und Dimensionen, nach denen Leistungsmesswerte segmentiert werden (z. B. date).

Segmentfelder können in Abfragen nur ausgewählt werden, wenn mindestens ein Messwertfeld ausgewählt ist.

Werte werden nur für Felder festgelegt, die in der Suchanfrage der Anfrage explizit angefordert wurden.

Felder
date

Date

Datum in der Zeitzone des Händlers, für den die Messwerte gelten. Segment.

In der WHERE-Klausel ist eine Bedingung für date erforderlich.
week

Date

Der erste Tag der Woche (Montag) des Messdatums in der Zeitzone des Händlers. Segment.
clicks

int64

Anzahl der Klicks auf Bilder und Links zu Ihrem Onlineshop, die zu nicht produktbezogenen Seiten führen. Messwert
impressions

int64

Anzahl der Aufrufe von Bildern und Links zu Ihrem Onlineshop, die zu nicht produktbezogenen Seiten führen. Messwert
click_through_rate

double

Klickrate: Die Anzahl der Klicks (clicks) geteilt durch die Anzahl der Impressionen (impressions) von Bildern und Onlineshop-Links, die zu Ihren nicht produktbezogenen Seiten führen. Messwert

PriceCompetitivenessProductView

Felder, die in der Tabelle price_competitiveness_product_view für Abfragen verfügbar sind.

Bericht zur Wettbewerbsfähigkeit von Preisen

Werte werden nur für Felder festgelegt, die in der Suchanfrage der Anfrage explizit angefordert wurden.

Felder
price

Price

Der aktuelle Preis des Produkts.
benchmark_price

Price

Der aktuellste verfügbare Preis-Benchmark für den Katalog des Produkts im Benchmark-Land.
report_country_code

string

Land des Preisvergleichs. Muss im ISO 3166-Format angegeben werden.

Erforderlich in der SELECT-Klausel.
id

string

REST-ID des Produkts im Format channel~languageCode~feedLabel~offerId. Kann verwendet werden, um Daten mit der Tabelle product_view zusammenzuführen.

Erforderlich in der SELECT-Klausel.
offer_id

string

Vom Händler angegebene ID des Produkts.
title

string

Titel des Produkts.
brand

string

Marke des Produkts.
category_l1

string

Produktkategorie (1. Ebene) in der Google-Produkt-Taxonomie.
category_l2

string

Produktkategorie (2. Ebene) in der Google-Produkt-Taxonomie.
category_l3

string

Produktkategorie (3. Ebene) in der Google-Produkt-Taxonomie.
category_l4

string

Produktkategorie (4. Ebene) in der Google-Produkt-Taxonomie.
category_l5

string

Produktkategorie (5. Ebene) in der Google-Produkt-Taxonomie.
product_type_l1

string

Produkttyp (1. Ebene) in der eigenen Produkttaxonomie des Händlers.
product_type_l2

string

Produkttyp (2. Ebene) in der eigenen Produkttaxonomie des Händlers.
product_type_l3

string

Produkttyp (3. Ebene) in der eigenen Produkttaxonomie des Händlers.
product_type_l4

string

Produkttyp (4. Ebene) in der eigenen Produkttaxonomie des Händlers.
product_type_l5

string

Produkttyp (5. Ebene) in der eigenen Produkttaxonomie des Händlers.

PriceInsightsProductView

Felder, die in der Tabelle price_insights_product_view für Abfragen verfügbar sind.

Bericht zu Preisstatistiken

Werte werden nur für Felder festgelegt, die in der Suchanfrage der Anfrage explizit angefordert wurden.

Felder
price

Price

Der aktuelle Preis des Produkts.
suggested_price

Price

Der aktuelle vorgeschlagene Preis für das Produkt.
effectiveness

Effectiveness

Die geschätzte Effektivität der Anwendung des Preisvorschlags, gegliedert.
id

string

REST-ID des Produkts im Format channel~languageCode~feedLabel~offerId. Kann verwendet werden, um Daten mit der Tabelle product_view zusammenzuführen.

Erforderlich in der SELECT-Klausel.
offer_id

string

Vom Händler angegebene ID des Produkts.
title

string

Titel des Produkts.
brand

string

Marke des Produkts.
category_l1

string

Produktkategorie (1. Ebene) in der Google-Produkt-Taxonomie.
category_l2

string

Produktkategorie (2. Ebene) in der Google-Produkt-Taxonomie.
category_l3

string

Produktkategorie (3. Ebene) in der Google-Produkt-Taxonomie.
category_l4

string

Produktkategorie (4. Ebene) in der Google-Produkt-Taxonomie.
category_l5

string

Produktkategorie (5. Ebene) in der Google-Produkt-Taxonomie.
product_type_l1

string

Produkttyp (1. Ebene) in der eigenen Produkttaxonomie des Händlers.
product_type_l2

string

Produkttyp (2. Ebene) in der eigenen Produkttaxonomie des Händlers.
product_type_l3

string

Produkttyp (3. Ebene) in der eigenen Produkttaxonomie des Händlers.
product_type_l4

string

Produkttyp (4. Ebene) in der eigenen Produkttaxonomie des Händlers.
product_type_l5

string

Produkttyp (5. Ebene) in der eigenen Produkttaxonomie des Händlers.
predicted_impressions_change_fraction

double

Geschätzte Änderung der Impressionen als Bruchteil nach Einführung des vorgeschlagenen Preises im Vergleich zum aktuell aktiven Preis. 0, 05 entspricht beispielsweise einer prognostizierten Steigerung der Impressionen um 5 %.
predicted_clicks_change_fraction

double

Geschätzte Änderung der Klicks als Bruchteil nach Einführung des vorgeschlagenen Preises im Vergleich zum aktuellen aktiven Preis. 0, 05 entspricht beispielsweise einer geschätzten Steigerung der Klicks um 5 %.
predicted_conversions_change_fraction

double

Geschätzte Änderung der Conversions als Bruchteil nach Einführung des vorgeschlagenen Preises im Vergleich zum aktuell aktiven Preis. 0, 05 entspricht beispielsweise einer geschätzten Steigerung der Conversions um 5 %).

Wirksamkeit

Gruppe mit prognostizierter Effektivität.

Die Effektivität gibt an, welche Produkte am meisten von Preisänderungen profitieren würden. Bei dieser Bewertung erfolgt die Ermittlung der prognostizierten Leistungssteigerung durch Anpassung des Sonderangebotspreises mithilfe der Differenz zwischen aktuellem und vorgeschlagenem Preis. Bei Preisvorschlägen mit HIGH wird voraussichtlich die größte Leistungssteigerung erzielt.

Enums
EFFECTIVENESS_UNSPECIFIED Wirksamkeit unbekannt.
LOW Die Effektivität ist niedrig.
MEDIUM Die Effektivität ist mittel.
HIGH Die Effektivität ist hoch.

ProductPerformanceView

Felder, die in der Tabelle product_performance_view für Abfragen verfügbar sind.

Produktleistungsdaten für Ihr Konto, einschließlich Leistungsmesswerte (z. B. clicks) und Dimensionen, nach denen Leistungsmesswerte segmentiert werden (z. B. offer_id). Die Werte von Produktdimensionen wie offer_id spiegeln den Zustand eines Produkts zum Zeitpunkt der Impression wider.

Segmentfelder können in Abfragen nur ausgewählt werden, wenn mindestens ein Messwertfeld ausgewählt ist.

Werte werden nur für Felder festgelegt, die in der Suchanfrage der Anfrage explizit angefordert wurden.

Felder
date

Date

Datum in der Zeitzone des Händlers, für den die Messwerte gelten. Segment.

In der WHERE-Klausel ist eine Bedingung für date erforderlich.
week

Date

Der erste Tag der Woche (Montag) des Messdatums in der Zeitzone des Händlers. Segment.
conversion_value

Price

Der Wert der Conversions, die dem Produkt zugeordnet wurden und am Conversion-Datum erfasst wurden. Messwert

Nur für die Zugriffsquelle FREE verfügbar.
marketing_method

MarketingMethodEnum

Marketingmethode, auf die sich die Messwerte beziehen. Segment.
customer_country_code

string

Der Code des Landes, in dem sich der Kunde zum Zeitpunkt des Ereignisses befindet. Muss im ISO 3166-Format angegeben werden. Segment.

Wenn das Land des Kunden nicht ermittelt werden kann, wird ein spezieller Code „ZZ“ zurückgegeben.
offer_id

string

Vom Händler angegebene ID des Produkts. Segment.
title

string

Titel des Produkts. Segment.
brand

string

Marke des Produkts. Segment.
category_l1

string

Produktkategorie (1. Ebene) in der Produkt-Taxonomie von Google. Segment.
category_l2

string

Produktkategorie (2. Ebene) in der Produkt-Taxonomie von Google. Segment.
category_l3

string

Produktkategorie (3. Ebene) in der Produkt-Taxonomie von Google. Segment.
category_l4

string

Produktkategorie (4. Ebene) in der Produkt-Taxonomie von Google. Segment.
category_l5

string

Produktkategorie (5. Ebene) in der Produkt-Taxonomie von Google. Segment.
product_type_l1

string

Produkttyp (1. Ebene) in der Produkttaxonomie des Händlers. Segment.
product_type_l2

string

Produkttyp (2. Ebene) in der eigenen Produkttaxonomie des Händlers. Segment.
product_type_l3

string

Produkttyp (3. Ebene) in der eigenen Produkttaxonomie des Händlers. Segment.
product_type_l4

string

Produkttyp (4. Ebene) in der Produkttaxonomie des Händlers. Segment.
product_type_l5

string

Produkttyp (5. Ebene) in der Produkttaxonomie des Händlers. Segment.
custom_label0

string

Benutzerdefiniertes Label 0 für die benutzerdefinierte Gruppierung von Produkten. Segment.
custom_label1

string

Benutzerdefiniertes Label 1 für die benutzerdefinierte Gruppierung von Produkten. Segment.
custom_label2

string

Benutzerdefiniertes Label 2 für die benutzerdefinierte Gruppierung von Produkten. Segment.
custom_label3

string

Benutzerdefiniertes Label 3 für die benutzerdefinierte Gruppierung von Produkten. Segment.
custom_label4

string

Benutzerdefiniertes Label 4 für die benutzerdefinierte Gruppierung von Produkten. Segment.
clicks

int64

Anzahl der Klicks. Messwert
impressions

int64

Gibt an, wie oft die Produkte eines Händlers angezeigt wurden. Messwert
click_through_rate

double

Klickrate: Die Anzahl der Klicks auf die Produkte eines Händlers (Klicks) geteilt durch die Anzahl der Impressionen (Impressionen). Messwert
conversions

double

Anzahl der Conversions, die dem Produkt zugeordnet wurden und am Conversion-Datum erfasst wurden. Je nach Attributionsmodell kann eine Conversion auf mehrere Klicks verteilt werden, wobei jedem Klick ein eigener Wert zugeordnet wird. Dieser Messwert ist die Summe aller Gutschriften. Messwert

Nur für die Zugriffsquelle FREE verfügbar.
conversion_rate

double

Die Anzahl der Conversions geteilt durch die Anzahl der Klicks, die am Impressionsdatum erfasst wurden. Messwert

Nur für die Zugriffsquelle FREE verfügbar.

ProductView

Felder, die in der Tabelle product_view für Abfragen verfügbar sind.

Produkte im aktuellen Inventar. Die Produkte in dieser Tabelle sind mit denen in der Products-Unter-API identisch. Nicht alle Produktattribute aus der Products-Unter-API können in dieser Tabelle abgefragt werden. Im Gegensatz zur Products-Unter-API können Sie in dieser Tabelle die zurückgegebene Liste der Produkte nach Produktattributen filtern. Wenn Sie ein einzelnes Produkt anhand von id abrufen oder alle Produkte auflisten möchten, sollten Sie die Produkte-Unter-API verwenden.

Werte werden nur für Felder festgelegt, die in der Suchanfrage der Anfrage explizit angefordert wurden.

Felder
price

Price

Produktpreis Fehlt, wenn keine Informationen zum Preis des Produkts verfügbar sind.
gtin[]

string

Liste der Global Trade Item Numbers (GTINs) des Produkts.
creation_time

Timestamp

Der Zeitpunkt, zu dem der Händler das Produkt erstellt hat, als Zeitstempel in Sekunden.
expiration_date

Date

Ablaufdatum des Produkts, das bei der Aufnahme angegeben wurde.
item_issues[]

ItemIssue

Liste der Artikelprobleme für das Produkt.

Dieses Feld kann nicht zum Sortieren der Ergebnisse verwendet werden.

Nur ausgewählte Attribute dieses Felds (z. B. item_issues.severity.aggregated_severity) können zum Filtern der Ergebnisse verwendet werden.
click_potential

ClickPotential

Geschätztes Leistungspotenzial im Vergleich zu den leistungsstärksten Produkten des Händlers.
id

string

REST-ID des Produkts im Format channel~languageCode~feedLabel~offerId. Merchant API-Methoden, die auf Produkte angewendet werden, verwenden diesen als name-Parameter.

Erforderlich in der SELECT-Klausel.
channel

ChannelEnum

Kanal des Produkts. Kann ONLINE oder LOCAL sein.
language_code

string

Sprachcode des Produkts im BCP 47-Format.
feed_label

string

Feedlabel des Produkts.
offer_id

string

Vom Händler angegebene ID des Produkts.
title

string

Titel des Produkts.
brand

string

Marke des Produkts.
category_l1

string

Produktkategorie (1. Ebene) in der Google-Produkt-Taxonomie.
category_l2

string

Produktkategorie (2. Ebene) in der Google-Produkt-Taxonomie.
category_l3

string

Produktkategorie (3. Ebene) in der Google-Produkt-Taxonomie.
category_l4

string

Produktkategorie (4. Ebene) in der Google-Produkt-Taxonomie.
category_l5

string

Produktkategorie (5. Ebene) in der Google-Produkt-Taxonomie.
product_type_l1

string

Produkttyp (1. Ebene) in der eigenen Produkttaxonomie des Händlers.
product_type_l2

string

Produkttyp (2. Ebene) in der eigenen Produkttaxonomie des Händlers.
product_type_l3

string

Produkttyp (3. Ebene) in der eigenen Produkttaxonomie des Händlers.
product_type_l4

string

Produkttyp (4. Ebene) in der eigenen Produkttaxonomie des Händlers.
product_type_l5

string

Produkttyp (5. Ebene) in der eigenen Produkttaxonomie des Händlers.
condition

string

Zustand des Produkts.
availability

string

Verfügbarkeit des Produkts.
shipping_label

string

Normalisiertes Versandlabel, das in der Datenquelle angegeben ist.
item_group_id

string

Die vom Händler angegebene Artikelgruppen-ID, um Varianten zu gruppieren.
aggregated_reporting_context_status

AggregatedReportingContextStatus

Aggregierter Status.
click_potential_rank

int64

Rang des Produkts basierend auf seinem Klickpotenzial. Ein Produkt mit click_potential_rank 1 hat das höchste Klickpotenzial unter den Produkten des Händlers, die die Bedingungen der Suchanfrage erfüllen.

AggregatedReportingContextStatus

Der Status des Produkts, aggregiert für alle Berichtskontexte.

Hier ein Beispiel für die Berechnung des aggregierten Status:

Produkteinträge Shopping-Anzeigen Status
Genehmigt Genehmigt ELIGIBLE
Genehmigt Ausstehend ELIGIBLE
Genehmigt Abgelehnt ELIGIBLE_LIMITED
Ausstehend Ausstehend AUSSTEHEND
Abgelehnt Abgelehnt NOT_ELIGIBLE_OR_DISAPPROVED
Enums
AGGREGATED_REPORTING_CONTEXT_STATUS_UNSPECIFIED Nicht angegeben.
NOT_ELIGIBLE_OR_DISAPPROVED Das Produkt ist für alle Berichtskontexte nicht zulässig oder wurde abgelehnt.
PENDING Der Status des Produkts ist in allen Berichtskontexten ausstehend.
ELIGIBLE_LIMITED Das Produkt ist für einige, aber nicht alle Berichtskontexte geeignet.
ELIGIBLE Das Produkt kann in allen Berichtskontexten verwendet werden.

ClickPotential

Anhand des Klickpotenzials eines Produkts wird das Leistungspotenzial im Vergleich zu den leistungsstärksten Produkten des Händlers geschätzt. So sehen Sie, bei welchen Produkten Handlungsbedarf besteht und wie sie hinsichtlich ihres Potenzials abschneiden.

Enums
CLICK_POTENTIAL_UNSPECIFIED Unbekannte Auswirkungen auf die geschätzten Klicks.
LOW Sie könnten im Vergleich zu den leistungsstärksten Produkten des Händlers eine niedrige Anzahl von Klicks erzielen.
MEDIUM Sie könnten im Vergleich zu den leistungsstärksten Produkten des Händlers eine mittlere Anzahl von Klicks erzielen.
HIGH Sie könnten eine ähnliche Anzahl von Klicks wie die leistungsstärksten Produkte des Händlers erhalten.

ItemIssue

Artikelproblem im Zusammenhang mit dem Produkt.

Felder
type

ItemIssueType

Art des Artikelproblems.
severity

ItemIssueSeverity

Schweregrad des Artikelproblems.
resolution

ItemIssueResolution

Problem mit Artikel behoben

ItemIssueResolution

Problemlösung

Enums
ITEM_ISSUE_RESOLUTION_UNSPECIFIED Nicht angegeben.
MERCHANT_ACTION Der Händler muss das Problem beheben.
PENDING_PROCESSING Das Problem wird automatisch behoben (z. B. durch Bild-Crawling) oder durch eine Google-Überprüfung. Händler müssen derzeit nichts unternehmen. Die Lösung kann zu einem anderen Problem führen, z. B. wenn das Crawling fehlschlägt.

ItemIssueSeverity

Wie sich das Problem auf die Auslieferung des Produkts auswirkt.

Felder
severity_per_reporting_context[]

IssueSeverityPerReportingContext

Schweregrad des Problems pro Berichtskontext.
aggregated_severity

AggregatedIssueSeverity

Die zusammengefasste Schwere des Problems für alle betroffenen Berichtskontexte.

Mit diesem Feld können Sie die Ergebnisse filtern.

AggregatedIssueSeverity

Schweregrad des Problems, zusammengefasst für alle Berichtskontexte.

Enums
AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED Nicht angegeben.
DISAPPROVED Das Problem führt dazu, dass das Produkt in mindestens einem Meldekontext abgelehnt wird.
DEMOTED Das Problem wirkt sich auf alle Berichtskontexte aus, in denen es auftritt.
PENDING Die Problemlösung lautet PENDING_PROCESSING.

IssueSeverityPerReportingContext

Schweregrad des Problems pro Berichtskontext.

Felder
disapproved_countries[]

string

Liste der abgelehnten Länder im Berichtskontext, dargestellt im ISO 3166-Format.
demoted_countries[]

string

Liste der herabgestuften Länder im Berichtskontext, dargestellt im ISO 3166-Format.
reporting_context

ReportingContextEnum

Berichtskontext, auf den sich das Problem bezieht.

ItemIssueType

Art des Problems.

Felder
code

string

Fehlercode des Problems, entspricht der code von Produktproblemen.
canonical_attribute

string

Kanonischer Attributname für attributspezifische Probleme.

RelativeDemand

Dieser Typ hat keine Felder.

Relative Nachfrage eines Produktclusters oder einer Marke im Bestsellerbericht.

RelativeDemandEnum

Werte für die relative Nachfrage.

Enums
RELATIVE_DEMAND_ENUM_UNSPECIFIED Nicht angegeben.
VERY_LOW Die Nachfrage entspricht 0–5% der Nachfrage nach dem Produktcluster oder der Marke mit dem höchsten Rang.
LOW Die Nachfrage entspricht 6–10% der Nachfrage nach dem Produktcluster oder der Marke mit dem höchsten Rang.
MEDIUM Die Nachfrage entspricht 11–20% der Nachfrage nach dem Produktcluster oder der Marke mit dem höchsten Rang.
HIGH Die Nachfrage entspricht 21–50% der Nachfrage nach dem Produktcluster oder der Marke mit dem höchsten Rang.
VERY_HIGH Die Nachfrage entspricht 51–100% der Nachfrage nach dem Produktcluster oder der Marke mit dem höchsten Rang.

RelativeDemandChangeType

Dieser Typ hat keine Felder.

Relative Nachfrage eines Produktclusters oder einer Marke im Bestsellerbericht im Vergleich zum vorherigen Zeitraum.

RelativeDemandChangeTypeEnum

Werte für den Typ „Relative Änderung der Nachfrage“

Enums
RELATIVE_DEMAND_CHANGE_TYPE_ENUM_UNSPECIFIED Nicht angegeben.
SINKER Die relative Nachfrage ist niedriger als im vorherigen Zeitraum.
FLAT Die relative Nachfrage entspricht dem vorherigen Zeitraum.
RISER Die relative Nachfrage ist höher als im vorherigen Zeitraum.

ReportGranularity

Dieser Typ hat keine Felder.

Detaillierungsgrad des Bestsellerberichts Bestsellerberichte werden für einen Zeitraum von einer Woche und einem Monat berechnet.

ReportGranularityEnum

Werte für die Berichtsgranularität

Enums
REPORT_GRANULARITY_ENUM_UNSPECIFIED Nicht angegeben.
WEEKLY Der Bericht wird über einen Zeitraum von einer Woche berechnet.
MONTHLY Der Bericht wird über einen Zeitraum von einem Monat berechnet.

ReportRow

Ergebniszeile, die von der Suchabfrage zurückgegeben wurde.

In der Antwort wird nur die Nachricht eingefügt, die der abgefragten Tabelle entspricht. In der ausgefüllten Nachricht werden nur die Felder ausgefüllt, die in der Abfrage explizit angefordert wurden.

Felder
product_performance_view

ProductPerformanceView

Felder, die in der Tabelle product_performance_view für Abfragen verfügbar sind.
non_product_performance_view

NonProductPerformanceView

Felder, die in der Tabelle non_product_performance_view für Abfragen verfügbar sind.
product_view

ProductView

Felder, die in der Tabelle product_view für Abfragen verfügbar sind.
price_competitiveness_product_view

PriceCompetitivenessProductView

Felder, die in der Tabelle price_competitiveness_product_view für Abfragen verfügbar sind.
price_insights_product_view

PriceInsightsProductView

Felder, die in der Tabelle price_insights_product_view für Abfragen verfügbar sind.
best_sellers_product_cluster_view

BestSellersProductClusterView

Felder, die in der Tabelle best_sellers_product_cluster_view für Abfragen verfügbar sind.
best_sellers_brand_view

BestSellersBrandView

Felder, die in der Tabelle best_sellers_brand_view für Abfragen verfügbar sind.
competitive_visibility_competitor_view

CompetitiveVisibilityCompetitorView

Felder, die in der Tabelle competitive_visibility_competitor_view für Abfragen verfügbar sind.
competitive_visibility_top_merchant_view

CompetitiveVisibilityTopMerchantView

Felder, die in der Tabelle competitive_visibility_top_merchant_view für Abfragen verfügbar sind.
competitive_visibility_benchmark_view

CompetitiveVisibilityBenchmarkView

Felder, die in der Tabelle competitive_visibility_benchmark_view für Abfragen verfügbar sind.

SearchRequest

Anfragenachricht für die Methode ReportService.Search.

Felder
parent

string

Erforderlich. ID des Kontos, das den Aufruf ausführt. Es muss sich um ein eigenständiges Konto oder ein Unterkonto eines Mehrfachkundenkontos handeln. Format: accounts/{account}
query

string

Erforderlich. Abfrage, die einen abzurufenden Bericht definiert.

Weitere Informationen zum Erstellen von Abfragen finden Sie im Leitfaden zur Abfragesprache. Eine vollständige Liste der verfügbaren Tabellen und Felder finden Sie unter „Verfügbare Felder“.
page_size

int32

Optional. Anzahl der ReportRows, die auf einer einzelnen Seite abgerufen werden sollen. Standardeinstellung ist 1.000. Werte über 5.000 werden auf 5.000 festgelegt.
page_token

string

Optional. Token der Seite, die abgerufen werden soll. Wenn keine Angabe erfolgt, wird die erste Ergebnisseite zurückgegeben. Um die nächste Ergebnisseite anzufordern, sollte der Wert verwendet werden, der in der vorherigen Antwort von next_page_token abgerufen wurde.

SearchResponse

Antwortnachricht für die Methode ReportService.Search.

Felder
results[]

ReportRow

Zeilen, die mit der Suchanfrage übereinstimmen.
next_page_token

string

Token, das als page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

TrafficSource

Dieser Typ hat keine Felder.

Besucherquelle der Impressionen im Bericht zur Wettbewerbsposition.

TrafficSourceEnum

Werte für Besucherquellen

Enums
TRAFFIC_SOURCE_ENUM_UNSPECIFIED Nicht angegeben.
ORGANIC Organische Zugriffe
ADS Zugriffe über Anzeigen.
ALL Organische Zugriffe und Anzeigentraffic