28 lutego 2026 r. wycofamy i wyłączymy wersję 1 beta interfejsu Merchant API. Instrukcje przejścia na najnowszą stabilną wersję znajdziesz w artykule Migracja z wersji 1 beta do wersji 1.

Ocena produktów

Za pomocą interfejsu Merchant Reports API możesz wyświetlać dane o skuteczności, filtrować produkty według określonych atrybutów i ulepszać ceny.

pomiar wyników,

Za pomocą interfejsu Merchant Reports API możesz pobierać dane o skuteczności na koncie product_performance_view.

Wymagania

Aby uzyskać ten raport, musisz mieć rolę Skuteczność i statystyki.

Aby przypisać rolę Skuteczność i statystyki istniejącemu użytkownikowi, utwórz żądanie patch i przypisz użytkownikowi prawo dostępu PERFORMANCE_REPORTING. Poniższe żądanie pokazuje, jak utworzyć żądanie poprawki, aby przypisać PERFORMANCE_REPORTING prawo dostępu:

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

{
  "accessRights": [
    "PERFORMANCE_REPORTING"
  ]
}

Zastąp następujące elementy:

{ACCOUNT_ID}: unikalny identyfikator konta Merchant Center.
{EMAIL_ID}: adres e-mail użytkownika, któremu chcesz przypisać rolę.

Przykładowe zapytanie

To zapytanie pobiera wartości impressions, clicks i click_through_rate dla wszystkich produktów na Twoim koncie w określonym 30-dniowym okresie. Aby wysłać żądanie, przekaż do metody accounts.reports.search to wyrażenie Merchant Center Query Language:

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

Więcej informacji o raportach skuteczności znajdziesz w przewodniku Raporty skuteczności.

Filtruj usługi

Możesz użyć interfejsu Merchant Reports APIproduct_view, aby wyświetlić przefiltrowany widok danych produktów, w tym ich stanów. Możesz na przykład wysłać zapytanie product_view, aby wyświetlić listę produktów, które mają problemy, lub uzyskać listę nowych produktów i sprawdzić ich wyświetlanie.

W klauzuli SELECT zapytania musisz uwzględnić pole id. idma taką samą wartość jak identyfikator REST produktu.

Możesz filtrować na podstawie wszystkich dostępnych pól z wyjątkiem tych:

status_per_reporting_context
item_issues.

Odpowiedź możesz posortować według wszystkich dostępnych pól z wyjątkiem tych:

gtin
status_per_reporting_context
item_issues

W polu aggregated_reporting_context_status możesz sprawdzić ogólną kwalifikowalność produktu. To pole zawiera zbiorcze stany wszystkich kontekstów raportowania produktu.

Oto przykład, który zwraca produkty ze stanem zbiorczym ELIGIBLE_LIMITED, co oznacza, że kwalifikują się one do wyświetlania w co najmniej 1, ale nie we wszystkich, kontekstach raportowania, na które są kierowane. Możesz poprosić o szczegółowy stan produktu w kontekście raportowania i problemy z produktem, aby dokładniej je zbadać. Aby wysłać żądanie, przekaż to wyrażenie Merchant Center Query Language do metody accounts.reports.search:

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'

Oto przykładowa odpowiedź na powyższe zapytanie:

{
  "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"
          }
        ]
      }
    }
  ]
}

Możesz użyć filtra w klauzuli WHERE w sekcji reporting_context, aby wyświetlić szczegóły produktu w określonym kontekście raportowania. Gdy filtrujesz według reporting_context, wartość aggregated_reporting_context_status jest obliczana tylko na podstawie wybranego kontekstu raportowania, a wartości status_per_reporting_context i item_issues zwracają tylko szczegóły dotyczące tego kontekstu.

Więcej informacji o polach dostępnych w zapytaniu znajdziesz w artykule Pola w tabeli product_view.

Ulepszanie cen

W widoku statystyk dotyczących cen możesz zobaczyć sugerowane ceny promocyjne produktów i prognozy wyników, których możesz się spodziewać, jeśli zaktualizujesz ceny produktów. Raport ze statystykami dotyczącymi cen umożliwia skuteczniejsze wycenianie produktów.

Więcej informacji znajdziesz w artykule Ulepszanie wyceniania produktów za pomocą raportu na temat statystyk dotyczących cen.

Zapytanie price_insights_product_view aby wyświetlić sugerowane ceny promocyjne produktów.

Oto przykład, który możesz wykorzystać, aby wyświetlić sugerowane ceny promocyjne Twoich produktów. Aby wysłać żądanie, przekaż ten komunikat Merchant Center Query Language do metody 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