您可以使用 Search Ads 360 查詢語言建立搜尋查詢，透過 Search Ads 360 Reporting API 擷取報表資料和資源中繼資料。
搜尋服務
您可以使用 Search Ads 360 查詢語言，透過下列方式查詢 API：
SearchAds360Service您可以使用這項服務查詢資源及其相關屬性、區隔和指標。方法有兩種：
Search和SearchStream。SearchAds360Service查詢會傳回SearchAds360Row例項清單：- 每一列代表一項資源。
- 如果提出要求，資料列會包含屬性和指標欄位。
- 如果您要求區隔，系統會為每個區隔資源元組加入額外資料列。
詳情請參閱「建立搜尋報表」一文。
SearchAds360FieldService您可以使用這項服務查詢可用欄位和資源的中繼資料。 這項服務提供可查詢的欄位目錄，並詳細說明這些欄位的相容性和類型。
SearchAds360FieldService會傳回SearchAds360Field例項清單：- 每個欄位都包含所要求欄位的詳細資料。
詳情請參閱「擷取資源中繼資料」。
基本查詢範例
以下各節提供基本查詢範例，您可以視需要調整，建構自己的查詢。
查詢資源的屬性
這是 campaign 資源屬性的基本查詢，會傳回廣告活動 ID、名稱和狀態：
SELECT
campaign.id,
campaign.name,
campaign.status
FROM campaign
ORDER BY campaign.id
- 每個傳回的
SearchAds360Row都代表一個campaign物件。 系統會根據所選欄位填入資料列 (包括指定廣告活動的
resource_name)。依廣告活動 ID 查詢訂單。
如要瞭解查詢可用的其他欄位，請參閱 campaign。
查詢指標
這是與 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 的廣告活動。每個傳回的
SearchAds360Row都有一個metrics欄位，其中填入所選指標。依廣告活動 ID 查詢訂單。
如要瞭解查詢中可使用的其他指標，請參閱 metrics。
查詢區隔
這是與 campaign 資源屬性相關的區隔基本查詢：
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 的廣告活動。系統會按日期區隔資料。
因此，每個
SearchAds360Row代表廣告活動和日期區隔的元組。依廣告活動 ID 查詢訂單。
如需可在查詢中使用的區隔清單，請參閱 segments。如要進一步瞭解如何區隔報表，請參閱「區隔」。
查詢相關資源的屬性
這是 campaign 資源的基本查詢，會加入 bidding_strategy 資源的屬性 (如有)。這類相關資源稱為「已歸因資源」。
SELECT
campaign.id,
campaign.name,
campaign.status,
bidding_strategy.name
FROM campaign
ORDER BY campaign.id
這項查詢會從所選的每個廣告活動中，選取廣告活動屬性和相關屬性。
每個傳回的
SearchAds360Row都代表一個campaign物件，其中填入所選廣告活動屬性，以及所選出價策略屬性bidding_strategy.name。
如要瞭解廣告活動查詢可用的歸因資源，請參閱 campaign。
查詢欄位中繼資料
您可以使用 SearchAds360FieldService 擷取欄位中繼資料。
這是欄位中繼資料的基本查詢：
SELECT name, category, selectable, filterable, sortable, selectable_with, data_type, is_repeated WHERE name = RESOURCE/FIELD
- 請將 RESOURCE OR FIELD 替換為資源 (例如
customer或campaign) 或欄位 (例如campaign.id、metrics.impressions或ad_group.id)。
如要進一步瞭解如何擷取欄位中繼資料，請參閱「擷取資源中繼資料」。
瞭解詳情
進一步瞭解如何透過 Search Ads 360 報表 API 建立查詢：