常見用途範例

這個用途是依據裝置細分，彙整帳戶過去 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 要求。建議您使用用戶端程式庫，在自己的應用程式中提交要求。

HTTP 要求網址

這項要求會透過 HTTP POST 傳送至下列網址的 Google Ads API 伺服器：

https://googleads.googleapis.com/v20/customers/{customer_id}/googleAds:searchStream

完整的 HTTP 要求範例

以下是這份報表定義的完整範例，以 HTTP POST 要求封裝。

POST /v20/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 撰寫，但所有語言的程序都類似。