Data Access Schema

The dimensions and metrics supported in queries to the Data Access Reports method of the Analytics Admin API.

Dimensions

The following dimensions can be requested in data access reports. Specify the "API Name" in an AccessDimension resource's dimension name field for a column of the dimension in the report response.

API NameUI NameAllowed PropertiesDescription
accessDateHourAccess date hourAll Google Analytics PropertiesThe date hour of the GA user that accessed GA reporting data. Formatted as YYYYMMDDHH.
accessMechanismAccess mechanismGoogle Analytics 360 PropertiesThe mechanism through which a GA user accessed GA reporting data. Possible values include 'Google Analytics User Interface', 'Google Analytics API', 'Firebase', 'Google Ads', and others.
accessedPropertyIdAccessed property IDAll Google Analytics PropertiesThe property ID where GA reporting data was accessed. Most Data Access Reports contain only one property, but if the requested property has a sub-property, Data Access Reports contain accesses to both the source property & sub-property. To learn more, see about sub-properties.
accessedPropertyNameAccessed property nameAll Google Analytics PropertiesThe property display name where GA reporting data was accessed. Most Data Access Reports contain only one property, but if the requested property has a sub-property, Data Access Reports contain accesses to both the source property & sub-property. To learn more, see about sub-properties.
accessorAppNameAccessor app nameAll Google Analytics PropertiesThe name of the application that accessed Google Analytics reporting data. You grant third-party apps and services access to see your Google Analytics reporting data. To learn more, see manage connections between your Google Account and third-parties.
costDataReturnedCost data returnedGoogle Analytics 360 PropertiesReturns true if cost data was returned in this report. Otherwise, this dimension returns false. GA users with the 'No Cost Metrics' restriction are unable to see cost metrics. This dimension will always be false while that restriction is active. To learn more, see Access and data-restriction management.
dataApiQuotaCategoryData API quota categoryAll Google Analytics PropertiesThe quota category for the Data API request. Possible values include: 'Core', 'Realtime', and 'Funnel'.
epochTimeMicrosEpoch time microsGoogle Analytics 360 PropertiesThe unix microseconds since the epoch that the GA user accessed GA reporting data. For example, a unix microsecond of '1655220215027371' is 2022-06-14 11:23:35 in America/New_York.
mostRecentAccessEpochTimeMicrosMost recent access epoch time microsGoogle Analytics 360 PropertiesThe most recent access timestamp for this row. Returned in unix microseconds since the epoch. Commonly used with 'userEmail' & similar dimensions to determine the last access times of GA users.
reportTypeReport typeGoogle Analytics 360 PropertiesThe type of reporting data that the GA user accessed. Possible values include 'Reporting', 'Realtime', 'Free form exploration', 'Funnel exploration', and others.
revenueDataReturnedRevenue data returnedGoogle Analytics 360 PropertiesReturns true if revenue data was returned in this report. Otherwise, this dimension returns false. GA users with the 'No Revenue Metrics' restriction are unable to see revenue metrics. This dimension will always be false while that restriction is active. To learn more, see Access and data-restriction management.
userCountryUser countryGoogle Analytics 360 PropertiesThe country of the GA user that accessed GA reporting data.
userCountryIdUser country IDGoogle Analytics 360 PropertiesThe country id of the GA user that accessed GA reporting data. Formatted according to ISO 3166-1 alpha-2 standard.
userEmailUser emailAll Google Analytics PropertiesThe email of the GA user that accessed GA reporting data. Some integrations allow users to access GA reporting data through the integration without the user having direct access to the property; in that case, 'userEmail' will return for example 'Google Ads Linked User' depending upon the integration.
userIPUser IPGoogle Analytics 360 PropertiesThe IP of the GA user that accessed GA reporting data.

Metrics

The following metrics can be requested in data access reports. Specify the "API Name" in an AccessMetric resource's metric name field for a column of the metric in the report response.

API NameUI NameAllowed PropertiesDescription
accessCountAccess countGoogle Analytics 360 PropertiesThe number of times GA reporting data was accessed. When using the Google Analytics User Interface, each report card can result in one or more data access events. Consequently, navigating through the Google Analytics User Interface can result in more access events than the number of reports viewed.
dataApiQuotaPropertyTokensConsumedData API quota property tokens consumedAll Google Analytics PropertiesReturns the total property quota tokens consumed for Data API requests.