資料存取結構定義

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

尺寸

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

API 名稱 UI 名稱 允許的屬性 說明
accessDateHour 存取日期時間 所有 Google Analytics 資源 Google Analytics 使用者存取 Google Analytics 報表資料的日期時間。格式為 YYYYMMDDHH。
accessMechanism 存取機制 Google Analytics 360 資源 Google Analytics 使用者存取 Google Analytics 報表資料所用的機制。可能的值包括「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 Data API 配額類別 所有 Google Analytics 資源 Data API 要求的配額類別,可能的值包括:「核心」、「即時」和「漏斗」。
epochTimeMicros Epoch 時間 (以微秒為單位) Google Analytics 360 資源 Google Analytics 使用者存取 Google Analytics 報表資料時,自 Unix 紀元以來的微秒數。舉例來說,Unix 微秒「1655220215027371」在 America/New_York 時區中是 2022-06-14 11:23:35。
mostRecentAccessEpochTimeMicros 最近一次存取的 Epoch 時間 (以微秒為單位) Google Analytics 360 資源 這個資料列最近一次的存取時間戳記。以 Unix 微秒為單位,自 Epoch 時間起算。通常會與「userEmail」和類似維度搭配使用,判斷 Google Analytics 使用者的上次存取時間。
reportType 報告類型 Google Analytics 360 資源 Google Analytics 使用者存取的報表資料類型。可能的值包括「報表」、「即時」、「任意形式探索」、「漏斗探索」等。
revenueDataReturned 傳回的收益資料 Google Analytics 360 資源 如果這份報表傳回收益資料,則會傳回 true。否則,這個維度會傳回 false。受到「無收益指標」限制的 Google Analytics 使用者無法查看收益指標。只要限制生效,這個維度就會一律設為 false。詳情請參閱「存取權和資料限制管理」。
userCountry 使用者國家/地區 Google Analytics 360 資源 存取 Google Analytics 報表資料的 Google Analytics 使用者所在國家/地區。
userCountryId 使用者國家/地區 ID Google Analytics 360 資源 存取 Google Analytics 報表資料的 Google Analytics 使用者所在國家/地區 ID。格式符合 ISO 3166-1 alpha-2 標準。
userEmail 使用者電子郵件地址 所有 Google Analytics 資源 存取 Google Analytics 報表資料的 Google Analytics 使用者電子郵件。部分整合服務的功能可供使用者存取 Google Analytics 報表資料,無須直接存取資源;在這種情況下,「userEmail」會傳回「Google Ads 已連結使用者」等值,視整合服務而定。
userIP 使用者 IP Google Analytics 360 資源 存取 Google Analytics 報表資料的 Google Analytics 使用者 IP。

指標

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

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