新版 Search Ads Reporting API 中的新概念

Search Ads 360 Reporting API 以現代化平台為基礎,並引入多項新概念。我們會在以下各節中說明。

資源

資源物件會取代報表類型。除了要求預先定義的報表類型,現在還可使用類似 SQL 的新查詢語言查詢所有資源。詳情請參閱「Search Ads 360 Reporting API 結構」。

搜尋報表

新版 API 提供 Google 搜尋服務專屬服務。搜尋服務會取代舊版報表服務。所有查詢都會經過 SearchAds360Service,後者提供兩種方法 (SearchStreamSearch),用於搜尋及擷取報表資料和指標。這兩種搜尋方法都會傳回符合搜尋查詢的所有 SearchAds360Row 物件。詳情請參閱「建立搜尋報表」。

資源中繼資料

SearchAds360FieldService 可讓您動態要求目錄,以便查看 SearchAds360Service 搜尋方法中可用的資源、資源欄位、區隔鍵和指標。詳情請參閱「擷取資源中繼資料」。

欄位名稱

這個 API 引進了以點號標記法分隔的巢狀欄位名稱。例如 campaign.idad_group.id。您也可以進一步巢狀結構,例如 ad_group.campaign.id。詳情請參閱「Search Ads 360 Reporting API 結構」。

舊版 Search Ads 360 API 中的報表,是根據不同實體的個別欄位來呈現類似概念。舉例來說,campaignadgroup 報表都包含個別的 campaignId 欄位。

查詢語言

這個 API 會引入 Search Ads 360 查詢語言。這是一種靈活的類似 SQL 語言,可讓您定義查詢,擷取最適合貴公司需求的特定報表資料。詳情請參閱 Search Ads 360 查詢語言

取得要求

新版 API 提供專屬服務 (SearchAds360Service),但 GET 要求仍存在於每個實體的特定服務中。舉例來說,您可以從 CustomColumnService 取得自訂欄資訊。詳情請參閱Search Ads 360 Reporting API 的格式異動

自訂欄

在新版 Search Ads 360 中,「公式欄」和「自訂轉換」稱為「自訂欄」進一步瞭解自訂欄。新的 CustomColumnService 可啟用自訂欄。只要您擁有必要權限,即可要求帳戶樹狀結構中任何帳戶擁有的 CustomColumn 資源。

帳戶管理

新版 Search Ads 360 採用階層式架構,將帳戶區分為管理員帳戶、副管理員帳戶和客戶帳戶。管理員帳戶代表代理商帳戶,副管理員帳戶則代表舊版 Search Ads 360 中的廣告客戶帳戶。如需瞭解詳情,請參閱「關於 Search Ads 360 管理員帳戶」。

您可以查詢帳戶樹狀結構,然後針對您想取得報表資料的每個帳戶提交要求。

由於帳戶階層有所變更,我們已將與廣告客戶/代理商概念相關的欄位,替換為適當的替代方案,盡可能提供相同的功能。如需受影響欄位和替代值的清單,請參閱「欄位對應」。

登入客戶 ID 標頭

login-customer-id 是使用管理員帳戶存取副管理員或客戶帳戶時,所需的新標頭。詳情請參閱「登入客戶 ID 標頭」。

版本管理

Search Ads 360 Reporting API 使用語意版本管理。主要和次要版本的格式為 vMAJOR_MINOR。詳情請參閱「版本管理」。