Поддержка 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 продукта.

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

status_per_reporting_context
item_issues .

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

gtin
status_per_reporting_context
item_issues

Чтобы понять общую пригодность продукта для участия в программе, вы можете проверить поле aggregated_reporting_context_status . Это поле суммирует статусы по всем контекстам отчетности продукта.

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

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

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

В предложении WHERE можно использовать фильтр по reporting_context , чтобы просмотреть подробные сведения о продукте для конкретного контекста отчетности. При фильтрации по reporting_context , aggregated_reporting_context_status вычисляется только на основе выбранного контекста отчетности, а status_per_reporting_context и item_issues возвращают подробные сведения только для этого контекста.

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

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

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

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

Запросите данные из 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