新版 Search Ads Reporting API 中的新概念

Search Ads 360 Reporting API 以現代化平台為基礎,並引入多項新概念。以下各節將說明這些項目。

資源

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

搜尋報表

新版 API 的搜尋功能有專屬服務。搜尋服務會取代舊版報表服務。所有查詢都會經過 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。詳情請參閱「版本管理」。