在 Google Ads API 中,每份條件報表都由獨立的資源代表。除非有其他必要,否則 *_view
資源只會包含 resource_name
欄位。
如果需要擷取任何特定條件資料,Google Ads API 用戶端必須指定對應的 ad_group_criterion
或 campaign_criterion
欄位。這可讓 Google Ads API 客戶在同一個要求中,向 GoogleAdsService.SearchStream
方法要求 ad_group_criterion
或 campaign_criterion
欄位和 *_view
資源。
查詢要求範例
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
子句中指定相應的檢視資源。例如,在 FROM
子句中使用 keyword_view
,以及在 SELECT
子句中使用部分 metrics
欄位,即可擷取關鍵字指標。
您可以從父項資源選取欄位,一直到從條件檢視畫面選取 customer
為止。舉例來說,選取 FROM
時,您可以要求下列所有資源的欄位:keyword_view
ad_group_criterion
ad_group
campaign
customer
您可以查看參考頁面的「屬性資源」列,瞭解哪些資源可透過這種方式要求。舉例來說,您可以在 keyword_view
的參考資料頁面中找到相關資源。