Google Analytics Management API 可讓您以程式輔助方式存取帳戶、資源和資料檢視。本文說明如何使用各種 API 資源來設定 Google Analytics (分析) 帳戶設定。
簡介
Management API 處理 Google Analytics (分析) 帳戶設定時經常會用到兩種常見用途。您需要先快速取得帳戶摘要,內含帳戶、資源和資料檢視的完整階層樹狀結構。其二是套用特定的「設定」。
帳戶摘要
透過「帳戶摘要」端點,您可以透過快速且快速的要求,輕鬆列出授權使用者的 Google Analytics (分析) 帳戶、資源和資料檢視相關輕量資訊。
可用來建立帳戶階層的索引。與 Google Analytics (分析) 整合的應用程式通常會提供介面,讓使用者選取帳戶、資源和資料檢視。只要對 API 發出單一要求,就能擷取所有相關資訊來建立此類選取器。如需範例,請參閱 Query Explorer 和 GitHub 上的程式碼範例。
如需詳細資訊和程式碼範例,請參閱帳戶摘要資源參考資料和清單方法參考資料。
帳戶設定
相較於使用帳戶、資源和資料檢視資源的清單方法,API 會傳回各資源的完整詳細資料,這點與帳戶摘要不同。
客戶
頂層實體「帳戶」相當重要,因為每個較低層級的 API 要求都必須有帳戶 ID。Management API 僅允許對帳戶執行 list 作業。要注意的是,API 回應中的 childlink
屬性會為所有子項網站資源提供 API 要求。
屬性
第二層實體又稱為「網站資源」,由於所有資料的收集作業都是在這個層級進行,因此第二層實體十分重要。舉例來說,當您在網站或行動應用程式中加入追蹤程式碼時,必須加入類似 UA-XXXXX-Y
的 ID。這個 ID 稱為資源 ID 或追蹤 ID,可用來區別 Google Analytics (分析) 帳戶資料儲存在何處。您可以使用 API 建立或更新屬性。如需詳細資訊和程式碼範例,請參閱資源資源。
觀看次數
在帳戶階層的第三層,資料檢視 (設定檔) 是很重要的,因為這是報表發生的層級。Core Reporting API 會使用資料檢視 (設定檔) ID 做為鍵參數,用於指定要從哪個資料檢視擷取資料。除了報表層級,還有許多其他資源都是已連結或屬於這項資源的子項,例如目標、實驗、未取樣報表和篩選連結。您可以使用 API 建立或更新資料檢視。如需相關詳情和程式碼範例,請參閱資料檢視 (設定檔) 資源。
後續步驟
閱讀本指南後,您應該充分瞭解如何使用 Management API 掃遍及操控各種帳戶設定實體。下一份指南將說明如何使用 API 執行使用者管理。