資料存取結構定義

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

尺寸

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

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 資源 存取 GA 報表資料的資源顯示名稱。大多數資料存取報表只包含一項資源,但如果要求的資源含有子資源,資料存取報表就會同時包含來源資源和子資源的存取資料。詳情請參閱「關於子資源」。
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 紀元時間為基準,以微秒為單位傳回。通常與「userEmail」和類似維度一起使用,用於判斷 GA 使用者上次存取時間。
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 使用者電子郵件地址。部分整合服務的功能可供使用者存取 GA 報表資料,無須直接存取資源;在這種情況下,「userEmail」會傳回「Google Ads 已連結使用者」等值,視整合服務而定。
userIP 使用者 IP Google Analytics 360 資源 存取 Google Analytics 報表資料的 Google Analytics 使用者 IP。

指標

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

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