Поддержка Merchant API v1beta будет прекращена и отключена 28 февраля 2026 года. Инструкции по переходу на последнюю стабильную версию см. в разделе «Миграция с v1beta на v1» .

Эта страница переведена с помощью Cloud Translation API.

Оцените свою продукцию

Вы можете использовать API отчетов для продавцов, чтобы просматривать данные о производительности , фильтровать товары по определенным атрибутам и улучшать ценообразование .

Измерение производительности

Вы можете получить показатели эффективности для своей учетной записи с помощью API отчетов для продавцов: product_performance_view .

Требования

Для получения этого отчета вам потребуется роль «Производительность и аналитика» .

Чтобы назначить существующему пользователю роль «Производительность и аналитика», создайте запрос на исправление и предоставьте пользователю право доступа PERFORMANCE_REPORTING . Следующий запрос показывает, как создать запрос на исправление для предоставления права доступа PERFORMANCE_REPORTING :

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

{
  "accessRights": [
    "PERFORMANCE_REPORTING"
  ]
}

Замените следующее:

{ACCOUNT_ID} : Уникальный идентификатор учетной записи в Merchant Center.
{EMAIL_ID} : Адрес электронной почты пользователя, которому вы хотите назначить роль.

Пример запроса

Следующий запрос извлекает данные impressions , clicks и click_through_rate для всех товаров в вашем аккаунте за определенный 30-дневный период. Для выполнения запроса передайте методу accounts.reports.search следующее выражение языка запросов Merchant Center :

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

Для получения более подробной информации об отчетах о результатах работы см. руководство по отчетам о результатах работы .

Фильтры

Вы можете использовать функцию ` product_view API отчетов для продавцов, чтобы отобразить отфильтрованное представление данных о ваших товарах, включая статусы товаров. Например, вы можете запросить product_view , чтобы получить список товаров, у которых есть проблемы, или получить список ваших новых товаров и проверить их доступность.

В оператор SELECT вашего запроса необходимо включить поле id . Поле id имеет то же значение, что и REST ID продукта.

Вы можете фильтровать данные по всем доступным полям , кроме item_issues . Вы можете сортировать ответы по всем доступным полям, кроме следующих:

gtin
item_issues

Вот пример, который возвращает ваши товары со статусом NOT_ELIGIBLE_OR_DISAPPROVED . Чтобы выполнить запрос, передайте следующее выражение языка запросов Merchant Center методу accounts.reports.search :

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

Вот пример ответа на предыдущий запрос:

{
  "results": [
    {
      "productView": {
        "id": "en~US~id0",
        "offerId": "id0",
        "feedLabel": "US",
        "aggregatedReportingContextStatus": "NOT_ELIGIBLE_OR_DISAPPROVED",
        "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"
          }
        ]
      }
    }
  ]
}

Для получения дополнительной информации о полях, доступных для запроса, см. раздел «Поля в таблице productView .

Улучшить ценообразование

В разделе «Анализ цен» вы можете увидеть рекомендуемые цены продажи ваших товаров, а также прогнозы ожидаемой эффективности после обновления цен. Использование отчета «Анализ цен» поможет вам более эффективно устанавливать цены на вашу продукцию.

Для получения дополнительной информации см. раздел «Улучшение ценообразования продукции с помощью отчета об анализе цен» .

Запросите данные из price_insights_product_view , чтобы просмотреть рекомендуемые цены продажи ваших товаров.

Вот пример, который вы можете использовать для просмотра рекомендуемых цен на ваши товары. Чтобы отправить запрос, передайте следующее выражение языка запросов Merchant Center методу 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