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

Google Ads 查詢語言

在這種情況下，您可以使用 Google Ads 查詢語言查詢 Google Ads API 來取得

使用

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 參考說明文件。

根據查詢結果變動

查詢指定資源時，您可以立即將傳回結果做為物件，進行修改，然後將結果傳回該物件的變更方法資源部分執行以下是範例工作流程：

對目前 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 說明文件。

程式碼範例

用戶端程式庫內有使用 Google Ads 查詢語言GoogleAdsService。「basicoperations」資料夾則包含例如 GetCampaigns、GetKeywords 和 SearchForGoogleAdsFields。 reporting 資料夾包含 GetKeywordStats 範例。

查詢文法