資料存取結構定義

查詢 Analytics 管理員 API 的 Data Access Reports 方法時支援的維度和指標。

尺寸

您可以在資料存取報表中要求下列維度。在報表回應中,針對維度欄指定 AccessDimension 資源維度 name 欄位中的「API 名稱」。

API 名稱 UI 名稱 允許的資源 說明
accessDateHour 存取日期時間 所有 Google Analytics 資源 Google Analytics 使用者存取 Google Analytics 報表資料的日期 (小時)。格式為 YYYYMMDDHH。
accessMechanism 存取機制 Google Analytics 360 資源 GA 使用者存取 GA 報表資料的機制。可能的值包括「Google Analytics 使用者介面」、「Google Analytics API」、「Firebase」、「Google Ads」等。
accessedPropertyId 存取的資源 ID 所有 Google Analytics 資源 存取 Google Analytics 報表資料的資源 ID。大多數資料存取報表只包含一個資源,但如果要求的資源含有子資源,資料存取報表就會包含來源資源和子資源的存取權。詳情請參閱「子資源簡介」。
accessedPropertyName 存取的資源名稱 所有 Google Analytics 資源 存取 Google Analytics 報表資料的資源顯示名稱。大多數資料存取報表只包含一個資源,但如果要求的資源含有子資源,資料存取報表就會包含來源資源和子資源的存取權。詳情請參閱「子資源簡介」。
accessorAppName 存取子應用程式名稱 所有 Google Analytics 資源 存取 Google Analytics 報表資料的應用程式名稱。您授權第三方應用程式和服務查看 Google Analytics 報表資料。詳情請參閱管理 Google 帳戶與第三方之間的連結一文。
costDataReturned 傳回的費用資料 Google Analytics 360 資源 如果這份報表傳回費用資料,則會傳回 true。否則,這個維度會傳回 false。設有「無費用指標」限制的 Google Analytics 使用者無法查看費用指標。只要限制生效,這個維度就會一律設為 false。詳情請參閱「存取權和資料限制管理」。
dataApiQuotaCategory Google Data API 配額類別 所有 Google Analytics 資源 Data API 要求的配額類別,可能的值包括:「Core」、「Realtime」和「Funnel」。
epochTimeMicros Epoch 時間 (以微秒為單位) Google Analytics 360 資源 自 GA 使用者存取 GA 報表資料起算的 Unix 微秒。舉例來說,「1655220215027371」的 Unix 微秒是 America/New_York 的 2022-06-14 11:23:35。
mostRecentAccessEpochTimeMicros 最近一次存取的 Epoch 時間 (以微秒為單位) Google Analytics 360 資源 這一列的最新存取時間戳記。以 Unix 紀元時間起算的微秒為單位傳回。通常會與「userEmail」和類似維度搭配使用,以判斷 Google Analytics 使用者上次存取的時間。
reportType 報告類型 Google Analytics 360 資源 Google Analytics 使用者存取的報表資料類型。可能的值包括「Reporting」、「Realtime」、「Free form exploration」、「Funnel exploration」等。
revenueDataReturned 傳回的收益資料 Google Analytics 360 資源 如果這份報表傳回收益資料,就會傳回 true。否則,這個維度會傳回 false。設有「無收益指標」限制的 GA (分析) 使用者無法查看收益指標。只要限制生效,這個維度就會一律設為 false。詳情請參閱「存取權和資料限制管理」。
userCountry 使用者國家/地區 Google Analytics 360 資源 存取 Google Analytics 報表資料的 GA 使用者所在國家/地區。
userCountryId 使用者國家/地區 ID Google Analytics 360 資源 存取 Google Analytics 報表資料的 Google Analytics 使用者國家/地區 ID。採用 ISO 3166-1 alpha-2 標準格式。
userEmail 使用者電子郵件 所有 Google Analytics 資源 存取 Google Analytics 報表資料的 GA 使用者電子郵件地址。部分整合功能可讓使用者透過整合功能存取 GA 報表資料,而無須直接存取資源;在這種情況下,系統會根據整合功能,將「userEmail」傳回為「Google Ads 已連結使用者」。
userIP 使用者 IP Google Analytics 360 資源 存取 Google Analytics 報表資料的 GA 使用者 IP 位址。

指標

您可以在資料存取報表中要求下列指標。在報表回應中某個指標資料欄的 AccessMetric 資源指標 name 欄位中,指定「API 名稱」。

API 名稱 UI 名稱 允許的資源 說明
accessCount 存取次數 Google Analytics 360 資源 存取 Google Analytics 報表資料的次數。使用 Google Analytics 使用者介面時,每個報表資訊卡都可能會產生一或多個資料存取事件。因此,在 Google Analytics 使用者介面中瀏覽資料時,存取事件的數量可能會超過查看的報表數量。
dataApiQuotaPropertyTokensConsumed 已使用的 Google Data API 配額資源權杖 所有 Google Analytics 資源 傳回已用於 Data API 要求的資源配額權杖總數。