В API Google Ads каждый отчёт по критериям представлен отдельным ресурсом. Если не указано иное, ресурсы *_view
содержат только поле resource_name
.
Клиенты API Google Ads должны указать соответствующие поля ad_group_criterion
или campaign_criterion
, если требуется получить данные, относящиеся к определённым критериям. Это позволяет клиентам API Google Ads запрашивать поля ad_group_criterion
или campaign_criterion
, а также ресурс *_view
в одном запросе к методу GoogleAdsService.SearchStream
.
Пример запроса
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
Чтобы получить данные об эффективности (метрики) для определенного типа критерия, укажите соответствующий ресурс представления в предложении FROM
. Например, используйте keyword_view
в предложении FROM
и некоторые поля metrics
в предложении SELECT
для получения метрик ключевых слов.
Вы можете выбрать поля из родительских ресурсов вплоть до customer
из представления критериев. Например, при выборе FROM
the keyword_view
вы можете запросить поля из всех следующих ресурсов:
-
ad_group_criterion
-
ad_group
-
campaign
-
customer
Чтобы узнать, какие ресурсы можно запросить таким образом для данного ресурса, проверьте строку «Ресурсы атрибутов» на его странице справки. Например, для keyword_view
его ресурсы можно найти на странице справки .