什麼是 Metadata API - 總覽

本文件將概略說明 Google Analytics Metadata API。如需 API 的詳細參考資料,請參閱 API 參考資料

引言

Metadata API 會傳回 Google Analytics (分析) 報表 API 中顯示的資料欄清單和屬性 (即維度和指標)。傳回的屬性包括 UI 名稱、說明、區隔支援等。

中繼資料 API 的用途如下:

  • 自動探索新的資料欄
  • 存取 Google Analytics (分析) 報表 API 的所有維度和指標屬性

請查看 即時中繼資料 API 回應,並參閱開發人員指南,瞭解實際做法。

概念總覽

Metadata API 的基礎基本概念如下:

Metadata API 中的資料欄資源代表單一維度或指標,內含該資料欄的 Id 和其他屬性等資訊。Column 資源集合代表報表 API 的所有維度和指標。

使用 API

查詢 API 時,您必須指定要擷取中繼資料的報表類型。API 回應會包含該報表類型可用的所有欄 (即維度和指標)。如要進一步瞭解 API 回應,請參閱 中繼資料 API 參考指南 程式碼範例,以及《 Metadata API 開發指南》以進一步瞭解 API 的使用方式。

API 存取權

Metadata API 不需要驗證和授權。唯一的規定是,每當應用程式傳送要求至 Analytics (分析) API 時,用來識別自己。詳情請參閱開發指南的「API 存取權」一節。

配額和廢止政策

Metadata API 可處理數百萬項作業。為了防止系統收到超過系統可處理的作業,並確保系統資源能以公平的方式發布,就必須使用配額系統。詳情請參閱 限制與配額指南。

如要進一步瞭解報表 API 欄 (例如維度和指標) 的處理方式變更,請參閱 資料淘汰政策。如要瞭解如何使用 Metadata API 檢查已淘汰的資料欄,請參閱 Metadata API 開發人員指南