Na API Google Ads, cada relatório de critérios é representado por um recurso diferente.
A menos que seja necessário, os recursos *_view
contêm apenas um campo
resource_name
.
Os clientes da Google Ads API precisam especificar os campos ad_group_criterion
ou campaign_criterion
correspondentes se for preciso buscar dados específicos de critérios.
Dessa forma, os clientes da API Google Ads podem solicitar campos ad_group_criterion
ou campaign_criterion
e o recurso *_view
na mesma solicitação para o método GoogleAdsService.SearchStream
.
Exemplo de solicitação de consulta
SELECT
ad_group_criterion.keyword.text,
ad_group.name,
campaign.name,
metrics.impressions,
metrics.clicks,
metrics.ctr,
metrics.average_cpc
FROM keyword_view
WHERE segments.date DURING LAST_30_DAYS
Para recuperar dados de desempenho (métricas) de um tipo de critério específico, especifique o
recurso de visualização correspondente na cláusula FROM
. Por exemplo, use keyword_view
na cláusula FROM
e alguns campos metrics
na cláusula SELECT
para recuperar métricas de palavras-chave.
É possível selecionar campos de recursos pai até customer
em uma
visualização de critérios. Por exemplo, ao selecionar FROM
(keyword_view
), você pode
solicitar campos de todos estes recursos:
ad_group_criterion
ad_group
campaign
customer
Para descobrir os recursos que podem ser solicitados dessa maneira para um determinado
recurso, verifique a linha Recursos de atributo na página de referência. Por
exemplo, para keyword_view
, você pode encontrar os recursos na página de
referência.