Die Merchant API v1beta wurde 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 einsehen, Ihre Produkte nach bestimmten Attributen filtern und Ihre Preise verbessern.

Leistung messen

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

Voraussetzungen

Zum Abrufen dieses Berichts 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 erstellen, um das Zugriffsrecht PERFORMANCE_REPORTING zuzuweisen:

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 Werte für impressions, clicks und click_through_rate für alle Produkte in Ihrem Konto in einem bestimmten Zeitraum von 30 Tagen abgerufen. Übergeben Sie dazu die folgende Merchant Center Query Language-Anweisung an die accounts.reports.search Methode:

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 Leistungsberichte Leitfaden.

Produkte filtern

Mit der Merchant Reports API's product_view können Sie eine gefilterte Ansicht Ihrer Produktdaten einschließlich Produktstatus aufrufen. Sie können beispielsweise eine Abfrage für product_view ausführen, 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. Das id hat denselben Wert wie die 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 können Sie die allgemeine Eignung eines Produkts sehen. In diesem Feld werden die Status für alle Berichtskontexte eines Produkts zusammengefasst.

Hier ein Beispiel, bei dem Ihre Produkte mit dem zusammengefassten Status ELIGIBLE_LIMITED zurückgegeben werden. Das bedeutet, dass sie in mindestens einem, aber nicht allen Berichtskontexten ausgeliefert werden können. Sie können den detaillierten Produktstatus pro Berichtskontext und Produktprobleme anfordern, um weitere Informationen zu erhalten. Übergeben Sie dazu die folgende Merchant Center Query Language-Anweisung an die accounts.reports.search Methode:

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 Abfrage:

{
  "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 in der WHERE-Klausel einen Filter für reporting_context verwenden, um Produktdetails für einen bestimmten Berichtskontext aufzurufen. Wenn Sie nach reporting_context filtern, wird aggregated_reporting_context_status nur basierend auf dem ausgewählten Berichtskontext berechnet. status_per_reporting_context und item_issues geben nur Details für diesen Kontext zurück.

Weitere Informationen zu den Feldern, die für Abfragen verfügbar sind, finden Sie unter Felder in der Tabelle.product_view

Preise verbessern

In der Ansicht „Preisstatistiken“ sehen Sie vorgeschlagene Sonderangebotspreise für Ihre Produkte sowie Vorhersagen für die Leistung, 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 finden Sie unter Produktpreise mit dem Bericht zu Preisstatistiken verbessern.

Führen Sie eine Abfrage für price_insights_product_view aus, um vorgeschlagene Sonderangebotspreise für Ihre Produkte aufzurufen.

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

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