本頁面由 Cloud Translation API 翻譯而成。

Google Ads 查詢語言

Google Ads 查詢語言可以查詢

資源及其相關資源、區隔和指標

GoogleAdsService 搜尋或 SearchStream

GoogleAdsService 查詢結果是 GoogleAdsRow 執行個體的清單，其中每個 GoogleAdsRow 都代表一個資源。如果要求了任何屬性或指標，該列也會包含這些欄位。如已要求任何區段，回應也會針對各個區隔資源組合顯示額外的資料列。

關於可用欄位與資源的中繼資料

GoogleAdsFieldService

這項服務提供一組可查詢的欄位，其中包含與相容性和類型相關的明確資訊。

GoogleAdsFieldService 查詢的結果為 GoogleAdsField 執行個體清單，每個 GoogleAdsField 都包含要求欄位的詳細資料。

查詢資源屬性

以下是廣告活動資源屬性的基本查詢，說明如何傳回廣告活動 ID、名稱和狀態：

SELECT
  campaign.id,
  campaign.name,
  campaign.status
FROM campaign
ORDER BY campaign.id

這項查詢會按照廣告活動 ID 排序。每個產生的 GoogleAdsRow 都代表一個填入所選欄位的 campaign 物件 (包括指定廣告活動的 resource_name)。

如要瞭解其他可用於廣告活動查詢的欄位，請參閱 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 次的廣告活動，同時按廣告活動 ID 排序。每個產生的 GoogleAdsRow 都會有一個 metrics 欄位，其中會填入所選指標。

如需可查詢的指標清單，請參閱 Metrics 說明文件。

查詢區隔

除了指定資源的屬性以外，您也可以查詢相關區隔：

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 次的廣告活動；不過，這項查詢會按照日期區隔資料。這就會導致每個產生的 GoogleAdsRow 代表廣告活動組合和 Segment 的日期。請特別注意，區隔會劃分所選指標，並依照 SELECT 子句中的每個區隔進行分組。

如需可查詢的區隔清單，請參閱 Segments 說明文件。

查詢相關資源的屬性

在查詢特定資源時，您可以彙整其他相關資源 (如果有的話)。這些相關資源稱為「歸因資源」。只要在查詢中選取屬性，就能隱含地合併屬性。

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  bidding_strategy.name
FROM campaign
ORDER BY campaign.id

這項查詢不僅會選取廣告活動屬性，還會從各個所選廣告活動中擷取相關屬性。每個產生的 GoogleAdsRow 代表一個 campaign 物件，其中填入所選的廣告活動屬性和一個出價策略屬性 bidding_strategy.name。

如要瞭解可用的廣告活動查詢可用的歸因資源，請參閱 Campaign 參考說明文件。

依據查詢結果進行排列

查詢特定資源時，您可以立即將傳回的結果視為物件進行修改，然後將結果傳回該資源的服務中的不同 google 方法。以下是工作流程範例：

針對目前 PAUSED 且曝光次數大於 1000 的所有廣告活動執行查詢。
從回應的每個 GoogleAdsRow 的 campaign 欄位中，取得 Campaign 物件。
將每個廣告活動的狀態從「PAUSED」改為「ENABLED」。
呼叫 CampaignService.MutateCampaigns 並修改修改過的廣告活動，以更新廣告活動。

欄位中繼資料

傳送至 GoogleAdsFieldService 的查詢是用於擷取欄位中繼資料。這些資訊可用來瞭解可在查詢中並用的欄位。由於資料可從 API 取得，且可提供驗證或建構查詢所需的中繼資料，因此開發人員可透過程式進行這項操作。以下是中繼資料查詢的一般查詢：

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name = "<INSERT_RESOURCE_OR_FIELD>"

您可以將此查詢中的 <INSERT_RESOURCE_OR_FIELD> 替換為資源 (例如 customer 或 campaign) 或欄位 (例如 campaign.id、metrics.impressions 或 ad_group.id)。

如需可查詢的欄位清單，請參閱 GoogleAdsField 說明文件。

程式碼範例

用戶端程式庫提供範例，示範如何在 GoogleAdsService 中使用 Google Ads 查詢語言。基本作業資料夾提供 GetCampaigns、GetKeywords 和 SearchForGoogleAdsFields 等範例。reporting 資料夾有 GetKeywordStats 範例。

查詢文法