Package google.shopping.merchant.reports.v1beta

Index

• ReportService (Benutzeroberfläche)
• BestSellersBrandView (Meldung)
• BestSellersProductClusterView (Meldung)
• BestSellersProductClusterView.InventoryStatus (Aufzählung)
• CompetitiveVisibilityBenchmarkView (Meldung)
• CompetitiveVisibilityCompetitorView (Meldung)
• CompetitiveVisibilityTopMerchantView (Meldung)
• MarketingMethod (Meldung)
• MarketingMethod.MarketingMethodEnum (Aufzählung)
• NonProductPerformanceView (Meldung)
• PriceCompetitivenessProductView (Meldung)
• PriceInsightsProductView (Meldung)
• PriceInsightsProductView.Effectiveness (Aufzählung)
• ProductPerformanceView (Meldung)
• ProductView (Meldung)
• ProductView.AggregatedReportingContextStatus (Option)
• ProductView.ClickPotential (Option)
• ProductView.ItemIssue (Meldung)
• ProductView.ItemIssue.ItemIssueResolution (Aufzählung)
• ProductView.ItemIssue.ItemIssueSeverity (Meldung)
• ProductView.ItemIssue.ItemIssueSeverity.AggregatedIssueSeverity (Aufzählung)
• ProductView.ItemIssue.ItemIssueSeverity.IssueSeverityPerReportingContext (Meldung)
• ProductView.ItemIssue.ItemIssueType (Meldung)
• RelativeDemand (Meldung)
• RelativeDemand.RelativeDemandEnum (Aufzählung)
• RelativeDemandChangeType (Meldung)
• RelativeDemandChangeType.RelativeDemandChangeTypeEnum (Aufzählung)
• ReportGranularity (Meldung)
• ReportGranularity.ReportGranularityEnum (Aufzählung)
• ReportRow (Meldung)
• SearchRequest (Meldung)
• SearchResponse (Meldung)
• TrafficSource (Meldung)
• TrafficSource.TrafficSourceEnum (Aufzählung)

ReportService

Dienst zum Abrufen von Berichten und Statistiken zu Ihren Produkten, ihrer Leistung und ihrer Wettbewerbsumgebung auf 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 in der OAuth 2.0-Übersicht.

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. In der SELECT-Klausel erforderlich. 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. In der SELECT-Klausel erforderlich. 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 er angestiegen, gesunken oder flach 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 darstellen, 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. In der SELECT-Klausel erforderlich. 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. Eine Bedingung für report_country_code ist in der WHERE-Klausel 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 Produkt-Taxonomie von Google.
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 Unabhängig davon, ob in mindestens einem der Länder derzeit mindestens ein Produkt der Marke „IN_STOCK“ in Ihrer Produktdatenquelle vorhanden ist, haben alle Produkte in allen Ländern den Status „OUT_OF_STOCK“ 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 Die geschätzte Nachfrage in Bezug auf den Produktcluster mit dem höchsten Beliebtheitsrang in derselben Kategorie und im selben Land.
previous_relative_demand	RelativeDemandEnum Die geschätzte Nachfrage in Bezug auf den Produktcluster mit dem höchsten Beliebtheitsrang in derselben Kategorie und im selben Land in der vorherigen Woche oder im gleichen Monat.
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 im Inventar, es ist aber derzeit nicht auf Lager.
NOT_IN_INVENTORY	Sie haben kein Produkt für diesen Produktcluster oder diese Marke im Inventar.

CompetitiveVisibilityBenchmarkView

Für die Abfrage in Tabelle „competitive_visibility_benchmark_view“ verfügbare Felder.

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. In der SELECT-Klausel erforderlich. 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, angegeben in der Produkt-Taxonomie von Google. In der SELECT-Klausel erforderlich. In der WHERE-Klausel ist eine Bedingung für report_category_id erforderlich.
traffic_source	TrafficSourceEnum Zugriffsquelle von Impressionen. In der SELECT-Klausel erforderlich.
your_domain_visibility_trend	double Änderung der Sichtbarkeit basierend auf den Impressionen für Ihre Domain in Bezug auf den Beginn des ausgewählten Zeitraums (oder den ersten Tag mit Impressionen ungleich null). Kann nicht in der WHERE-Klausel gefiltert werden.
category_benchmark_visibility_trend	double Änderung der Sichtbarkeit basierend auf Impressionen in Bezug auf den Beginn des ausgewählten Zeitraums (oder den ersten Tag mit Impressionen ungleich null) für eine kombinierte Gruppe von Händlern mit der annähernd höchsten Sichtbarkeit. Kann nicht in der WHERE-Klausel gefiltert werden.

CompetitiveVisibilityCompetitorView

Für die Abfrage in Tabelle „competitive_visibility_competitor_view“ verfügbare Felder.

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 Das 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 Dieser Wert ist auf „True“ gesetzt, 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 von Impressionen. In der SELECT-Klausel erforderlich.
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 von Anzeigen / organisch gibt an, wie oft die Domain Impressionen über Shopping-Anzeigen im Vergleich zu organischen Zugriffen erhält. Die Zahl wird gerundet und gruppiert. 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 ausdrücklich in der Suchanfrage der Anfrage angefordert werden.

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 Dieser Wert ist auf „True“ gesetzt, 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 von Impressionen. In der SELECT-Klausel erforderlich.
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 Kategorien unterteilt. 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 Höhere Positionsrate gibt an, 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 die Leistungsmesswerte segmentiert sind (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 Erster Wochentag (Montag) des Messwertdatums in der Händlerzeitzone. 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 ausdrücklich in der Suchanfrage der Anfrage angefordert werden.

Felder
price	Price Der aktuelle Preis des Produkts.
benchmark_price	Price Neueste verfügbare Preisvergleiche für den Katalog des Produkts im Benchmarkland.
report_country_code	string Land des Preisvergleichs. Wird im ISO 3166-Format dargestellt. 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 Produkt-Taxonomie von Google.
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 händlereigenen Produkt-Taxonomie.
product_type_l2	string Produkttyp (2. Ebene) in der händlereigenen Produkt-Taxonomie.
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

Für die Abfrage in Tabelle „price_insights_product_view“ verfügbare Felder.

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 Neueste Preisvorstellung 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 Produkt-Taxonomie von Google.
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 Anteil nach Einführung des vorgeschlagenen Preises im Vergleich zum aktuellen aktiven Preis. 0, 05 entspricht beispielsweise einer prognostizierten Steigerung der Impressionen um 5 %.
predicted_clicks_change_fraction	double Geschätzte Änderung der Klicks als Bruchzahl 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. Beispielsweise bedeutet 0, 05 eine prognostizierte Steigerung der Conversions von 5 %.

Wirksamkeit

Bucket für prognostizierte Effektivität.

Die Effektivität gibt an, welche Produkte am meisten von Preisänderungen profitieren würden. Bei dieser Bewertung wird die prognostizierte Leistungssteigerung berücksichtigt, indem der Sonderangebotspreis und die Differenz zwischen dem aktuellen und dem vorgeschlagenen Preis angepasst werden. 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

Für die Abfrage in Tabelle „product_performance_view“ verfügbare Felder.

Produktleistungsdaten für Ihr Konto, einschließlich Leistungsmesswerte (z. B. clicks) und Dimensionen, nach denen die Leistungsmesswerte segmentiert sind (z. B. offer_id). Die Werte von Produktdimensionen wie offer_id spiegeln den Status 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, für die die Messwerte gelten. Segment.
customer_country_code	string Der Code des Landes, in dem sich der Kunde zum Zeitpunkt des Ereignisses befindet. Wird im ISO 3166-Format dargestellt. Segment. Wenn das Land des Kunden nicht ermittelt werden kann, wird ein spezieller Code „ZZ“ zurückgegeben.
offer_id	string Vom Händler bereitgestellte 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 Produkt-Taxonomie des Händlers. Segment.
product_type_l2	string Produkttyp (2. Ebene) in der Produkt-Taxonomie des Händlers. Segment.
product_type_l3	string Produkttyp (3. Ebene) in der Produkttaxonomie des Händlers. Segment.
product_type_l4	string Produkttyp (4. Ebene) in der Produkt-Taxonomie des Händlers. Segment.
product_type_l5	string Produkttyp (5. Ebene) in der eigenen 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 Sub-API „Products“ kann in dieser Tabelle die zurückgegebene Liste von Produkten nach Produktattributen gefiltert werden. 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 bereitgestellte 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 händlereigenen Produkt-Taxonomie.
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.
thumbnail_link	string Link zum verarbeiteten Bild des Produkts, das in der Google-Infrastruktur gehostet wird.
aggregated_reporting_context_status	AggregatedReportingContextStatus Zusammengefasster 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. Sie müssen nichts weiter tun. Die Lösung kann zu einem anderen Problem führen, z. B. wenn das Crawling fehlschlägt.

ItemIssueSeverity

Wie sich das Problem auf die Bereitstellung 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 für alle Berichtskontexte zusammengefasst.

Enums
AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED	Nicht angegeben.
DISAPPROVED	Das Problem führt dazu, dass das Produkt in mindestens einem Meldekontext abgelehnt wird.
DEMOTED	Das Produkt wird in allen Berichtskontexten, in denen es betroffen ist, herabgestuft.
PENDING	Das Problem wurde am PENDING_PROCESSING behoben.

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

Relative Nachfragewerte

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 Bestseller-Berichte werden für einen Zeitraum von einer Woche und einem Monat erstellt.

ReportGranularityEnum

Detaillierungsgrad von Berichten

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

Die von der Suchanfrage zurückgegebene Ergebniszeile.

In der Antwort wird nur die Nachricht eingefügt, die der abgefragten Tabelle entspricht. Innerhalb der ausgefüllten Nachricht werden nur die Felder ausgefüllt, die ausdrücklich in der Abfrage 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 Für die Abfrage in Tabelle „product_view“ verfügbare Felder.
price_competitiveness_product_view	PriceCompetitivenessProductView Für die Abfrage in Tabelle „price_competitiveness_product_view“ verfügbare Felder.
price_insights_product_view	PriceInsightsProductView Für die Abfrage in Tabelle „price_insights_product_view“ verfügbare Felder.
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 Für die Abfrage in Tabelle „competitive_visibility_benchmark_view“ verfügbare Felder.

SearchRequest

Anfragenachricht für die Methode ReportService.Search.

Felder
parent	string Erforderlich. Die ID des Kontos, das den Anruf durchführt. Muss ein eigenständiges Konto oder ein MCA-Unterkonto sein. Format: accounts/{account}
query	string Erforderlich. Abfrage, die einen abzurufenden Bericht definiert. Weitere Informationen zum Erstellen einer Abfrage finden Sie im Query Language-Handbuch. 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 in 5.000 umgewandelt.
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.

Zugriffsquelle von Impressionen im Bericht „Mitbewerber im Blick“.

TrafficSourceEnum

Werte für Besucherquellen

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