借助 Search Ads 360 查询语言，您可以使用 Search Ads 360 Reporting API 构建搜索查询来检索报告数据和资源元数据。
搜索服务
您可以使用 Search Ads 360 查询语言通过以下方式查询 API：
SearchAds360Service您可以使用此服务查询资源及其相关属性、细分和指标。有两种方法：
Search和SearchStream。SearchAds360Service查询会返回SearchAds360Row实例的列表：- 每行代表一个资源。
- 如果请求了属性和指标字段，则行中会包含这些字段。
- 如果您请求细分，则会针对每个细分资源元组添加额外的行。
如需了解详情，请参阅创建搜索报告。
SearchAds360FieldService使用此服务查询有关可用字段和资源的元数据。 此服务提供可查询字段的目录，其中包含有关其兼容性和类型的详细信息。
SearchAds360FieldService返回SearchAds360Field实例的列表：- 每个字段都包含有关所请求字段的详细信息。
如需了解详情，请参阅检索资源元数据。
基本查询示例
以下部分提供了基本查询示例，您可以根据这些示例构建自己的查询。
查询资源的属性
以下是针对 campaign 资源的属性的基本查询，可返回广告系列 ID、名称和状态：
SELECT
campaign.id,
campaign.name,
campaign.status
FROM campaign
ORDER BY campaign.id
- 返回的每个
SearchAds360Row都表示一个campaign对象。 系统会使用所选字段（包括指定广告系列的
resource_name）填充行。按广告系列 ID 排序的查询。
如需了解可在查询中使用的其他可用字段，请参阅 campaign。
查询指标
以下是针对与 campaign 资源属性相关的指标的基本查询：
SELECT
campaign.id,
campaign.name,
campaign.status,
metrics.impressions
FROM campaign
WHERE campaign.status = 'PAUSED'
AND metrics.impressions > 1000
ORDER BY campaign.id
该查询会返回状态为
PAUSED且展示次数超过 1000 的广告系列。每个返回的
SearchAds360Row都有一个metrics字段，其中填充了所选指标。按广告系列 ID 排序的查询。
如需了解可在查询中使用的其他可用指标，请参阅 metrics。
查询细分
以下是针对与 campaign 资源属性相关的细分的简单查询：
SELECT
campaign.id,
campaign.name,
campaign.status,
metrics.impressions,
segments.date,
FROM campaign
WHERE campaign.status = 'PAUSED'
AND metrics.impressions > 1000
AND segments.date during LAST_30_DAYS
ORDER BY campaign.id
该查询会返回状态为
PAUSED且展示次数超过 1000 的广告系列。它会按日期细分数据。
细分后，每个
SearchAds360Row都表示一个广告系列和日期段的元组。按广告系列 ID 排序的查询。
如需查看可在查询中使用的细分列表，请参阅 segments；如需详细了解如何细分报告，请参阅细分。
查询相关资源的属性
这是对 campaign 资源的基本查询，用于联接 bidding_strategy 资源的属性（如果可用）。这种类型的相关资源称为“提供方信息资源”。
SELECT
campaign.id,
campaign.name,
campaign.status,
bidding_strategy.name
FROM campaign
ORDER BY campaign.id
该查询从所选的每个广告系列中选择广告系列属性和相关属性。
返回的每个
SearchAds360Row都表示一个campaign对象，其中填充了所选的广告系列属性以及所选的出价策略属性bidding_strategy.name。
如需了解哪些归因资源可用于广告系列查询，请参阅 campaign。
查询字段元数据
您可以使用 SearchAds360FieldService 检索字段元数据。
以下是有关字段元数据的基本查询：
SELECT name, category, selectable, filterable, sortable, selectable_with, data_type, is_repeated WHERE name = RESOURCE/FIELD
- 将 RESOURCE OR FIELD 替换为资源（例如
customer或campaign）或字段（例如campaign.id、metrics.impressions或ad_group.id）。
如需详细了解如何检索字段元数据，请参阅检索资源元数据。
了解详情
详细了解如何在 Search Ads 360 Reporting API 中构建查询：