本文件提供 Google Analytics (分析) Metadata API 的概略總覽。如需 API 的詳細參考資料,請參閱 API 參考資料。
簡介
Metadata API 會傳回在 Google Analytics (分析) 報表 API 中公開的資料欄 (也就是維度和指標) 清單和屬性。傳回的屬性包括 UI 名稱、說明、區隔支援等。
您可以使用 Metadata API 執行下列操作:
- 自動探索新資料欄
- 存取 Google Analytics (分析) 報表 API 的所有維度和指標屬性
請查看 即時中繼資料 API 回應,並參閱開發人員指南來瞭解如何使用。
概念總覽
Metadata API 的基本概念如下:
欄
Metadata API 中的欄資源代表單一維度或指標,內含該欄的 Id
和其他屬性等資訊。一組 Column
資源代表報表 API 的所有維度和指標。
使用 API
查詢 API 時,您必須指定要擷取中繼資料的報表類型。API 送出的回應會包含該報表類型的所有可用資料欄 (例如維度和指標)。如要進一步瞭解 API 回應和 程式碼範例,請參閱 Metadata API 參考指南;如要進一步瞭解如何使用 API,請參閱 Metadata API 開發人員指南。
API 存取權
Metadata API 不需要驗證和授權。唯一需要注意的是,您的應用程式每次傳送要求給 Analytics (分析) API 時,都能自行辨識。如要進一步瞭解操作方法,請參閱開發人員指南的「API 存取權」一節。
配額和廢止政策
Metadata API 可處理數百萬筆作業。為防止系統接收的作業超過系統可處理的作業量,為確保系統資源能平等分配,您必須使用配額系統。詳情請參閱 限制與配額指南。
如要深入瞭解報表 API 資料欄 (即維度和指標) 的變更處理方式,請參閱 資料淘汰政策。如要瞭解如何使用 Metadata API 檢查已淘汰的資料欄,請參閱 Metadata API 開發人員指南。