Die Merchant API v1beta wird am 28. Februar 2026 eingestellt. Eine Anleitung zur Umstellung auf die aktuelle stabile Version finden Sie unter Von v1beta zu v1 migrieren.

Produkte bewerten

Mit der Merchant Reports API können Sie Leistungsdaten ansehen, Produkte nach bestimmten Attributen filtern und Ihre Preise optimieren.

Leistung messen

Mit der Merchant Reports API product_performance_view können Sie Leistungsmesswerte für Ihr Konto abrufen.

Voraussetzungen

Um diesen Bericht abzurufen, benötigen Sie die Rolle „Leistung und Statistiken“.

Wenn Sie einem vorhandenen Nutzer die Rolle „Leistung und Statistiken“ zuweisen möchten, erstellen Sie eine PATCH-Anfrage und weisen Sie dem Nutzer das Zugriffsrecht PERFORMANCE_REPORTING zu. Die folgende Anfrage zeigt, wie Sie eine Patch-Anfrage zum Zuweisen des Zugriffsrechts PERFORMANCE_REPORTING erstellen können:

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/users/{EMAIL_ID}

{
  "accessRights": [
    "PERFORMANCE_REPORTING"
  ]
}

Ersetzen Sie Folgendes:

{ACCOUNT_ID}: Die eindeutige Kennung des Merchant Center-Kontos.
{EMAIL_ID}: Die E-Mail-Adresse des Nutzers, dem Sie die Rolle zuweisen möchten.

Beispielabfrage

Mit der folgenden Abfrage werden die Spalten impressions, clicks und click_through_rate für alle Produkte in Ihrem Konto in einem bestimmten Zeitraum von 30 Tagen abgerufen. Übergeben Sie die folgende Merchant Center Query Language-Anweisung an die Methode accounts.reports.search, um die Anfrage zu stellen:

SELECT impressions, clicks, click_through_rate
FROM product_performance_view
WHERE date BETWEEN '2020-12-01' AND '2020-12-30'

Weitere Informationen zu Leistungsberichten finden Sie im Leitfaden Leistungsberichte.

Produkte filtern

Mit der product_view der Merchant Reports API können Sie eine gefilterte Ansicht Ihrer Produktdaten, einschließlich Produktstatus, anzeigen lassen. Sie können beispielsweise product_view abfragen, um Produkte mit Problemen aufzulisten oder eine Liste Ihrer neuen Produkte abzurufen und die Auslieferung zu überprüfen.

Sie müssen das Feld id in die SELECT-Klausel Ihrer Abfrage einfügen. Der Wert id entspricht der REST-ID des Produkts.

Sie können nach allen verfügbaren Feldern filtern, mit Ausnahme der folgenden:

status_per_reporting_context
item_issues.

Sie können die Antwort nach allen verfügbaren Feldern sortieren, mit Ausnahme der folgenden:

gtin
status_per_reporting_context
item_issues

Im Feld aggregated_reporting_context_status sehen Sie die allgemeine Eignung eines Produkts. In diesem Feld werden die Status aller Berichtskontexte eines Produkts zusammengefasst.

Hier ein Beispiel, das Ihre Produkte mit dem aggregierten Status ELIGIBLE_LIMITED zurückgibt. Das bedeutet, dass sie in mindestens einem, aber nicht allen ihrer Zielberichtskontexte präsentiert werden können. Sie können den detaillierten Produktstatus für jeden Berichtskontext und Produktprobleme anfordern, um sie genauer zu untersuchen. Übergeben Sie die folgende Merchant Center Query Language-Anweisung an die Methode accounts.reports.search, um die Anfrage zu stellen:

SELECT
  id,
  offer_id,
  feed_label,
  title,
  aggregated_reporting_context_status,
  status_per_reporting_context,
  item_issues
FROM product_view
WHERE aggregated_reporting_context_status = 'ELIGIBLE_LIMITED'

Hier ist eine Beispielantwort auf die vorherige Anfrage:

{
  "results": [
    {
      "productView": {
        "id": "en~US~id0",
        "offerId": "id0",
        "feedLabel": "US",
        "aggregatedReportingContextStatus": "ELIGIBLE_LIMITED",
        "statusPerReportingContext": [
          {
            "reportingContext": "SHOPPING_ADS",
            "disapprovedCountries": [
              "US"
            ]
          },
          {
            "reportingContext": "FREE_LISTINGS",
            "approvedCountries": [
              "US"
            ]
          }
        ]
        "itemIssues": [
          {
            "type": {
              "code": "invalid_string_value",
              "canonicalAttribute": "n:product_code"
            },
            "severity": {
              "severityPerReportingContext": [
                {
                  "reportingContext": "SHOPPING_ADS",
                  "disapprovedCountries": [
                    "US"
                  ]
                },
                {
                  "reportingContext": "FREE_LISTINGS",
                  "disapprovedCountries": [
                    "US"
                  ]
                }
              ],
              "aggregatedSeverity": "DISAPPROVED"
            },
            "resolution": "MERCHANT_ACTION"
          },
          {
            "type": {
              "code": "apparel_missing_brand",
              "canonicalAttribute": "n:brand"
            },
            "severity": {
              "severityPerReportingContext": [
                {
                  "reportingContext": "SHOPPING_ADS",
                  "disapprovedCountries": [
                    "US"
                  ]
                }
              ],
              "aggregatedSeverity": "DEMOTED"
            },
            "resolution": "MERCHANT_ACTION"
          }
        ]
      }
    }
  ]
}

Sie können einen Filter für reporting_context in der WHERE-Klausel verwenden, um Produktdetails für einen bestimmten Berichtskontext aufzurufen. Wenn Sie nach reporting_context filtern, wird aggregated_reporting_context_status nur auf Grundlage des ausgewählten Berichtskontexts berechnet. status_per_reporting_context und item_issues geben nur Details für diesen Kontext zurück.

Weitere Informationen zu den für Abfragen verfügbaren Feldern finden Sie unter Felder in der Tabelle product_view.

Preise optimieren

In der Ansicht „Preisstatistiken“ können Sie vorgeschlagene Sonderangebotspreise für Ihre Produkte sowie Vorhersagen für die Leistung sehen, die Sie erwarten können, wenn Sie die Preise Ihrer Produkte aktualisieren. Mit dem Bericht „Preisstatistiken“ können Sie Preise Ihrer Produkte effektiver gestalten.

Weitere Informationen

Fragen Sie price_insights_product_view, um Vorschläge für Sonderangebotspreise für Ihre Produkte zu erhalten.

Hier sehen Sie ein Beispiel, mit dem Sie vorgeschlagene Verkaufspreise für Ihre Produkte abrufen können. Übergeben Sie für die Anfrage die folgende Merchant Center Query Language-Anweisung an die Methode accounts.reports.search:

SELECT
  id,
  title,
  brand,
  price,
  suggested_price,
  predicted_impressions_change_fraction,
  predicted_clicks_change_fraction,
  predicted_conversion_change_fraction
FROM price_insights_product_view