新版 Search Ads Reporting API 中的新概念

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

資源

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

搜尋報表

新版 API 中有專屬服務。Search 服務會取代舊版「報表」服務。所有查詢都會經歷 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。詳情請參閱「版本管理」一文。