常见使用场景示例

现在，我们来看一个常见的用例：按设备细分的广告系列总结账号在过去 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/v19/customers/{customer_id}/googleAds:searchStream

完整的 HTTP 请求示例

以下完整示例展示了上述包含在 HTTP POST 请求中的报告定义。

POST /v19/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 编写的，但所有语言的过程都类似。

概览

条件指标