什麼是 Core Reporting API - 總覽

本文件提供 Google Analytics (分析) Core Reporting API 3.0 版本的概略總覽。如需 API 的詳細參考資料，請參閱參考指南。

簡介

您可以透過 Google Analytics Core Reporting API 存取 Google Analytics (分析) 中的大部分報表資料。透過 Core Reporting API，您可以：

我們最近推出了新版 Core Reporting API。

想要立即開始使用嗎？參閱 Hello Analytics API 教學課程。

每個使用該 API 的應用程式都必須完成幾個步驟，才能註冊、授權使用者，並搭配 API 使用。本教學課程將逐步引導您完成每個步驟，並在最後建立可自訂的使用中應用程式。

Core Reporting API 會傳回報表資料，其中包含從 Google Analytics (分析) 追蹤程式碼所收集的資料衍生的統計資料。每份報表都會整理成維度和指標。 Core Reporting API 可讓您查詢維度和指標，以便建立自訂報表。

Core Reporting API 的 3 個基本概念：

如要為使用者要求報表資料，應用程式必須識別使用者，並指定要擷取資料的檢視畫面 (設定檔)。使用者可以透過取得授權憑證來識別，並針對每個 API 要求傳送這些憑證。資料檢視 (設定檔) 是 Google Analytics (分析) 設定階層的一部分，以資料檢視 (設定檔) ID 表示。

查看資料檢視 (設定檔) ID 的方法有兩種。

應用程式可以使用 Management API 週遊管理設定階層，取得檢視表 (設定檔) ID。
在 Google Analytics (分析) 中每份報表的網址中。

螢幕擷取畫面。
在 Google Analytics (分析) 中，按一下選單列的「管理」。選取資料檢視所屬的帳戶和資源。按一下「資料檢視」欄中的「資料檢視設定」，取得資料檢視 ID。

螢幕擷取畫面。

您會查詢 API 以取得 Google Analytics (分析) 報表資料 (當中包含維度和指標)。指標則是您資源上使用者活動的個別測量結果，例如工作階段和網頁瀏覽量。維度會依國家/地區或瀏覽器等常見條件細分指標。建立查詢時，您可以指定要在報表資料中納入哪些維度和指標。

您可以參閱互動式維度和指標參考指南，探索透過 API 公開的所有維度和指標。另請參閱 Core Reporting API 參考指南，瞭解如何在 API 查詢中指定維度和指標。

API 傳回的資料可視為含有標頭和列清單的資料表。每個 API 回應都包含一個標頭，用於說明每個資料欄的名稱和資料類型。回應也會包含資料列清單，其中每一列都是一個儲存格清單，資料順序與標題相同。您可以使用標頭中的資訊來判斷每個儲存格中的資料類型。

如要進一步瞭解 API 回應，請參閱 Core Reporting API 參考指南。

Google Analytics (分析) API 可處理數百萬筆作業，為避免系統接收的作業數量超過系統可處理的作業量，並確保系統資源能平等分配，您必須使用配額系統。如要瞭解特定限制，請參閱限制與配額指南。

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

現在您已瞭解 API 的運作方式，我們提供了許多資源，可協助您開始使用：