什麼是 Metadata API - 總覽

本文件提供 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 開發人員指南