Use o serviço Reports
para recuperar métricas de performance da sua conta.
Consulte a documentação do metrics
para a
lista completa de métricas disponíveis.
Requisitos
É necessário ter o papel de administrador de relatórios para recuperar esse relatório.
Para conceder a uma conta o papel "Administrador de relatórios", use accounts.update
para definir o campo reportingManager
como true
. O papel "Gerente de relatórios" é equivalente ao papel "Performance e insights" no Merchant Center.
accounts.update
substitui todo o recurso Account
. Use accounts.get
para
acessar o recurso Account
completo e forneça todos os campos na
solicitação accounts.update
para não perder informações.
Exemplo de consulta
A consulta a seguir recupera o impressions
, clicks
e ctr
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 para o
método reports.search
:
SELECT
metrics.impressions,
metrics.clicks,
metrics.ctr
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-30'
Clique em Executar para testar o exemplo no APIs Explorer. Depois de clicar em Executar, atualize o marcador do ID do comerciante para seu próprio ID no URL da solicitação. É possível modificar a consulta. A consulta completa precisa permanecer em uma única linha para funcionar com o APIs Explorer.
Também é possível segmentar as métricas na consulta para gerar relatórios de desempenho mais granulares.
Consulte o Guia de produtos para saber como recuperar e filtrar produtos com o serviço Reports
.