现在我们来了解一种常见用例:按广告系列汇总帐号在过去 30 天内的效果(按设备细分)。此报告的查询如下所示:
SELECT
campaign.name,
campaign.status,
segments.device,
metrics.impressions,
metrics.clicks,
metrics.ctr,
metrics.average_cpc,
metrics.cost_micros
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
如需发出此请求,请将上面的 Google Ads 查询语言语句传递给 GoogleAdsService.SearchStream
接口。
HTTP 请求网址
该请求包含一个指向以下网址的 Google Ads API 服务器的 HTTP POST:
https://googleads.googleapis.com/v16/customers/{customer_id}/googleAds:searchStream
完整的 HTTP 请求示例
以下是上述报告定义的完整示例,包含在 HTTP POST 请求中。
POST /v16/customers/{customer_id}/googleAds:searchStream HTTP/1.1 Host: googleads.googleapis.com User-Agent: curl Content-Type: application/json Accept: application/json Authorization: Bearer [Enter OAuth 2.0 access token here] developer-token: [Enter developerToken here] Parameters: { "query" : "SELECT campaign.name, campaign.status, segments.device, metrics.impressions, metrics.clicks, metrics.ctr, metrics.average_cpc, metrics.cost_micros FROM campaign WHERE segments.date DURING LAST_30_DAYS" }
代码示例
观看视频演示,了解使用指标搜索过去 7 天内的广告系列的代码示例。视频中的代码示例是用 Java 编写的,但此过程适用于所有语言。