什麼是 Core Reporting API - 總覽

本文件概要說明 Google Analytics (分析) Core Reporting API 3.0 版。如需 API 的詳細參考資料,請參閱參考指南

引言

您可以透過 Google Analytics Core Reporting API 存取 Google Analytics (分析) 中的大部分報表資料。您可以透過 Core Reporting API 執行下列操作:

  • 建立自訂資訊主頁來顯示 Google Analytics (分析) 資料。
  • 自動執行複雜的報表工作,節省寶貴時間。
  • 將 Google Analytics (分析) 資料與其他商業應用程式整合。

選擇版本

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

  • 如要建立新的應用程式,– 建議您使用 3.0 版最新版本。
  • 您使用的是舊版 2.3 版嗎?– 請參閱 遷移指南,進一步瞭解如何更新應用程式以使用新版本。

入門課程

是否要立即開始使用?閱讀 Hello Analytics API 教學課程

每個使用該 API 的應用程式都必須完成幾個步驟,才能註冊、授權使用者,以及使用 API。本教學課程將逐步引導您完成每個步驟,最後您將會產生可自訂的有效應用程式。

概念總覽

Core Reporting API 傳回的報表資料包含 Google Analytics (分析) 追蹤程式碼所收集的資料。每份報表都是以維度和指標分類。 您可以使用 Core Reporting API 查詢維度和指標,以便建立自訂報表。

Core Reporting API 有 3 個基本概念:

  1. 報表與使用者和資料檢視 (設定檔) 之間的關係。
  2. 報表的結構及查詢建立方式
  3. 使用 API 回應

報表、使用者和資料檢視 (設定檔)

如要要求使用者的報表資料,應用程式必須識別使用者,並指定要擷取資料的資料檢視 (設定檔)。當使用者取得 授權憑證並在每個 API 要求中傳送憑證時,就可以識別使用者。資料檢視 (設定檔) 是 Google Analytics (分析) 設定階層的一部分,以資料檢視 (設定檔) ID 識別。

您可以透過幾種方式找出資料檢視 (設定檔) ID。

  • 應用程式可以使用 Management API 進行週遊管理 設定階層,取得資料檢視 (設定檔) ID。
  • 在 Google Analytics (分析) 中每份報表的網址中。
  • Google Analytics (分析) 中,按一下選單列的「管理」。選取資料檢視所屬的帳戶和資源。按一下「VIEW」欄中的「View Settings」,即可取得檢視表 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 的運作方式,以下提供多項資源協助您快速上手:

  • 如要瞭解如何使用 API,請參閱 開發人員指南
  • 使用互動式 Query Explorer 工具,以視覺化方式建構查詢,並透過 API 查看回應。
  • 請參閱 常見查詢一文,其中列出對 Core Reporting API 最常見的幾個查詢。
  • 如需透過 API 取得的所有資料清單,請參閱 維度和指標參考資料。
  • 請參閱 程式庫和範例頁面,取得可與此 API 搭配使用的所有用戶端程式庫清單。

返回開頭