Google Analytics · Schema

GoogleAnalyticsAdminV1betaRunAccessReportRequest

The request for a Data Access Record Report.

AnalyticsDataGoogleMetricsReportingWeb AnalyticsMachine LearningAttribution

Properties

Name Type Description
dateRanges array Date ranges of access records to read. If multiple date ranges are requested, each response row will contain a zero based date range index. If two date ranges overlap, the access records for the overl
dimensionFilter object Dimension filters let you restrict report response to specific dimension values which match the filter. For example, filtering on access records of a single user. To learn more, see [Fundamentals of D
dimensions array The dimensions requested and displayed in the response. Requests are allowed up to 9 dimensions.
expandGroups boolean Optional. Decides whether to return the users within user groups. This field works only when include_all_users is set to true. If true, it will return all users with access to the specified property o
includeAllUsers boolean Optional. Determines whether to include users who have never made an API call in the response. If true, all users with access to the specified property or account are included in the response, regardl
limit string The number of rows to return. If unspecified, 10,000 rows are returned. The API returns a maximum of 100,000 rows per request, no matter how many you ask for. `limit` must be positive. The API may ret
metricFilter object Metric filters allow you to restrict report response to specific metric values which match the filter. Metric filters are applied after aggregating the report's rows, similar to SQL having-clause. Dim
metrics array The metrics requested and displayed in the response. Requests are allowed up to 10 metrics.
offset string The row count of the start row. The first row is counted as row 0. If offset is unspecified, it is treated as 0. If offset is zero, then this method will return the first page of results with `limit`
orderBys array Specifies how rows are ordered in the response.
returnEntityQuota boolean Toggles whether to return the current state of this Analytics Property's quota. Quota is returned in [AccessQuota](#AccessQuota). For account-level requests, this field must be false.
timeZone string This request's time zone if specified. If unspecified, the property's time zone is used. The request's time zone is used to interpret the start & end dates of the report. Formatted as strings from the
View JSON Schema on GitHub

JSON Schema

google-analytics-googleanalyticsadminv1betarunaccessreportrequest-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/GoogleAnalyticsAdminV1betaRunAccessReportRequest",
  "title": "GoogleAnalyticsAdminV1betaRunAccessReportRequest",
  "description": "The request for a Data Access Record Report.",
  "properties": {
    "dateRanges": {
      "description": "Date ranges of access records to read. If multiple date ranges are requested, each response row will contain a zero based date range index. If two date ranges overlap, the access records for the overlapping days is included in the response rows for both date ranges. Requests are allowed up to 2 date ranges.",
      "items": {
        "$ref": "#/components/schemas/GoogleAnalyticsAdminV1betaAccessDateRange"
      },
      "type": "array"
    },
    "dimensionFilter": {
      "$ref": "#/components/schemas/GoogleAnalyticsAdminV1betaAccessFilterExpression",
      "description": "Dimension filters let you restrict report response to specific dimension values which match the filter. For example, filtering on access records of a single user. To learn more, see [Fundamentals of Dimension Filters](https://developers.google.com/analytics/devguides/reporting/data/v1/basics#dimension_filters) for examples. Metrics cannot be used in this filter."
    },
    "dimensions": {
      "description": "The dimensions requested and displayed in the response. Requests are allowed up to 9 dimensions.",
      "items": {
        "$ref": "#/components/schemas/GoogleAnalyticsAdminV1betaAccessDimension"
      },
      "type": "array"
    },
    "expandGroups": {
      "description": "Optional. Decides whether to return the users within user groups. This field works only when include_all_users is set to true. If true, it will return all users with access to the specified property or account. If false, only the users with direct access will be returned.",
      "type": "boolean"
    },
    "includeAllUsers": {
      "description": "Optional. Determines whether to include users who have never made an API call in the response. If true, all users with access to the specified property or account are included in the response, regardless of whether they have made an API call or not. If false, only the users who have made an API call will be included.",
      "type": "boolean"
    },
    "limit": {
      "description": "The number of rows to return. If unspecified, 10,000 rows are returned. The API returns a maximum of 100,000 rows per request, no matter how many you ask for. `limit` must be positive. The API may return fewer rows than the requested `limit`, if there aren't as many remaining rows as the `limit`. For instance, there are fewer than 300 possible values for the dimension `country`, so when reporting on only `country`, you can't get more than 300 rows, even if you set `limit` to a higher value. To learn more about this pagination parameter, see [Pagination](https://developers.google.com/analytics/devguides/reporting/data/v1/basics#pagination).",
      "format": "int64",
      "type": "string"
    },
    "metricFilter": {
      "$ref": "#/components/schemas/GoogleAnalyticsAdminV1betaAccessFilterExpression",
      "description": "Metric filters allow you to restrict report response to specific metric values which match the filter. Metric filters are applied after aggregating the report's rows, similar to SQL having-clause. Dimensions cannot be used in this filter."
    },
    "metrics": {
      "description": "The metrics requested and displayed in the response. Requests are allowed up to 10 metrics.",
      "items": {
        "$ref": "#/components/schemas/GoogleAnalyticsAdminV1betaAccessMetric"
      },
      "type": "array"
    },
    "offset": {
      "description": "The row count of the start row. The first row is counted as row 0. If offset is unspecified, it is treated as 0. If offset is zero, then this method will return the first page of results with `limit` entries. To learn more about this pagination parameter, see [Pagination](https://developers.google.com/analytics/devguides/reporting/data/v1/basics#pagination).",
      "format": "int64",
      "type": "string"
    },
    "orderBys": {
      "description": "Specifies how rows are ordered in the response.",
      "items": {
        "$ref": "#/components/schemas/GoogleAnalyticsAdminV1betaAccessOrderBy"
      },
      "type": "array"
    },
    "returnEntityQuota": {
      "description": "Toggles whether to return the current state of this Analytics Property's quota. Quota is returned in [AccessQuota](#AccessQuota). For account-level requests, this field must be false.",
      "type": "boolean"
    },
    "timeZone": {
      "description": "This request's time zone if specified. If unspecified, the property's time zone is used. The request's time zone is used to interpret the start & end dates of the report. Formatted as strings from the IANA Time Zone database (https://www.iana.org/time-zones); for example \"America/New_York\" or \"Asia/Tokyo\".",
      "type": "string"
    }
  },
  "type": "object"
}