A versão v1beta da API Merchant será descontinuada e desativada em 28 de fevereiro de 2026. Para saber como fazer a transição para a versão estável mais recente, consulte Migrar da v1beta para a v1.

Avalie seus produtos

Você pode usar a API Merchant Reports para ver dados de performance, filtrar seus produtos por atributos específicos e melhorar seus preços.

Avaliar o desempenho

Você pode recuperar métricas de performance da sua conta com a API Merchant Reports product_performance_view.

Requisitos

Para acessar esse relatório, você precisa ter a função Performance e insights.

Para atribuir a função "Performance e insights" a um usuário, crie uma solicitação de patch e atribua o direito de acesso PERFORMANCE_REPORTING ao usuário. A solicitação a seguir mostra como criar uma solicitação de patch para atribuir o direito de acesso PERFORMANCE_REPORTING:

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

{
  "accessRights": [
    "PERFORMANCE_REPORTING"
  ]
}

Substitua:

{ACCOUNT_ID}: o identificador exclusivo da conta do Merchant Center.
{EMAIL_ID}: o endereço de e-mail do usuário a quem você quer atribuir o papel.

Amostra de consulta

A consulta a seguir recupera impressions, clicks e click_through_rate de todos os produtos na sua conta durante um período específico de 30 dias. Para fazer a solicitação, transmita a seguinte instrução da Linguagem de consulta do Merchant Center ao método accounts.reports.search:

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

Para mais informações sobre os relatórios de performance, consulte o guia Relatórios de performance.

Filtrar produtos

Você pode usar a product_view da API Merchant Reports para mostrar uma visualização filtrada dos dados de produtos, incluindo os status deles. Por exemplo, você pode consultar product_view para listar produtos com problemas ou receber uma lista dos seus novos produtos e verificar a veiculação.

Você precisa incluir o campo id na cláusula SELECT da consulta. O id tem o mesmo valor que o ID REST do produto.

É possível filtrar com base em todos os campos disponíveis, exceto item_issues. É possível classificar a resposta com base em todos os campos disponíveis, exceto os seguintes:

gtin
item_issues

Confira um exemplo que retorna seus produtos com o status NOT_ELIGIBLE_OR_DISAPPROVED. Para fazer a solicitação, transmita a seguinte instrução da Linguagem de consulta do Merchant Center ao método 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'

Confira um exemplo de resposta da consulta anterior:

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

Para mais informações sobre os campos disponíveis para consulta, consulte Campos na tabela productView.

Melhorar os preços

Use a visualização de informações de preço para conferir os preços promocionais sugeridos para seus produtos e as previsões sobre a performance esperada ao atualizar os preços. Ele ajuda você a definir os preços dos produtos com mais eficiência.

Para mais informações, consulte Melhorar os preços dos produtos com o relatório de informações de preço.

Consulta price_insights_product_view para conferir os preços promocionais sugeridos para seus produtos.

Confira um exemplo que você pode usar para ver os preços promocionais sugeridos para seus produtos. Para fazer a solicitação, transmita a seguinte instrução da Linguagem de consulta do Merchant Center ao método 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