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