資料存取結構定義

Analytics Admin API 的資料存取報表方法查詢支援的維度和指標。

尺寸

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

API 名稱 使用者介面名稱 允許的屬性 說明
accessDateHour 存取日期小時 所有 Google Analytics (分析) 資源 存取 Google Analytics (分析) 報表資料的 Google Analytics (分析) 使用者日期 (小時)。格式為 YYYYMMDDHH。
accessMechanism 存取機制 Google Analytics (分析) 360 資源 Google Analytics (分析) 使用者存取 Google Analytics (分析) 報表資料的機制。可能的值包括 Google Analytics User InterfaceGoogle Analytics APIFirebaseGoogle Ads 等。
accessedPropertyId 已存取的資源 ID 所有 Google Analytics (分析) 資源 存取 Google Analytics (分析) 報表資料的資源 ID。大多數資料存取報表只包含一個資源,但如果要求的資源包含子資源,資料存取報表就會同時包含來源資源和子資源的存取權。如要進一步瞭解子資源,請參閱「關於子資源」一文
accessedPropertyName 存取的資源名稱 所有 Google Analytics (分析) 資源 存取 Google Analytics (分析) 報表資料的資源顯示名稱。大多數資料存取報表只包含一個資源,但如果要求的資源包含子資源,資料存取報表就會同時包含來源資源和子資源的存取權。如要進一步瞭解子資源,請參閱「關於子資源」一文
accessorAppName 存取子應用程式名稱 所有 Google Analytics (分析) 資源 存取 Google Analytics (分析) 報表資料的應用程式名稱。
costDataReturned 已傳回費用資料 Google Analytics (分析) 360 資源 如果這份報表中傳回費用資料,系統會傳回「true」。否則,這個維度會傳回 false。具有「No Cost Metrics」限制的 Google Analytics (分析) 使用者無法查看費用指標。在該限制有效期間,這個維度一律會是 false。詳情請參閱「存取權和資料限制管理」一文。
dataApiQuotaCategory Data API 配額類別 所有 Google Analytics (分析) 資源 Data API 要求的配額類別。可能的值包括:CoreRealtimeFunnel
epochTimeMicros 紀元時間 (以微秒為單位) Google Analytics (分析) 360 資源 Google Analytics (分析) 使用者存取 Google Analytics (分析) 報表資料以來的 Unix 微秒。舉例來說,1655220215027371 的 Unix 微秒是 America/New_York 的 2022-06-14 11:23:35。
mostRecentAccessEpochTimeMicros 最新存取週期時間 (以微秒為單位) Google Analytics (分析) 360 資源 這個資料列的最新存取時間戳記。自 Epoch 紀元時間起算,以 Unix 微秒為單位傳回。常與 userEmail 和類似維度搭配使用,以判斷 Google Analytics (分析) 使用者的上次存取時間。
reportType 檢舉類型 Google Analytics (分析) 360 資源 Google Analytics (分析) 使用者存取的報表資料類型。可能的值包括 ReportingRealtimeFree form explorationFunnel exploration 等。
revenueDataReturned 已傳回的收益資料 Google Analytics (分析) 360 資源 如果這份報表中傳回收益資料,系統會傳回「true」。否則,這個維度會傳回 false。具有 No Revenue Metrics 限制的 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 Linked User
userIP 使用者 IP Google Analytics (分析) 360 資源 存取 Google Analytics (分析) 報表資料的 Google Analytics (分析) 使用者 IP。

指標

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

API 名稱 使用者介面名稱 允許的屬性 說明
accessCount 存取次數 Google Analytics (分析) 360 資源 Google Analytics (分析) 報表資料存取的次數。
dataApiQuotaPropertyTokensConsumed 已使用的 Data API 配額屬性權杖 所有 Google Analytics (分析) 資源 傳回 Data API 要求耗用的資源配額權杖總數。