Google Analytics · Schema

RunRealtimeReportRequest

The request to generate a realtime report.

AnalyticsDataGoogleMetricsReportingWeb AnalyticsMachine LearningAttribution

Properties

Name Type Description
dimensionFilter object The filter clause of dimensions. Metrics cannot be used in this filter.
dimensions array The dimensions requested and displayed.
limit string The number of rows to return. If unspecified, 10,000 rows are returned. The API returns a maximum of 250,000 rows per request, no matter how many you ask for. `limit` must be positive. The API can als
metricAggregations array Aggregation of metrics. Aggregated metric values will be shown in rows where the dimension_values are set to "RESERVED_(MetricAggregation)".
metricFilter object The filter clause of metrics. Applied at post aggregation phase, similar to SQL having-clause. Dimensions cannot be used in this filter.
metrics array The metrics requested and displayed.
minuteRanges array The minute ranges of event data to read. If unspecified, one minute range for the last 30 minutes will be used. If multiple minute ranges are requested, each response row will contain a zero based min
orderBys array Specifies how rows are ordered in the response.
returnPropertyQuota boolean Toggles whether to return the current state of this Analytics Property's Realtime quota. Quota is returned in [PropertyQuota](#PropertyQuota).
View JSON Schema on GitHub

JSON Schema

google-analytics-runrealtimereportrequest-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/RunRealtimeReportRequest",
  "title": "RunRealtimeReportRequest",
  "description": "The request to generate a realtime report.",
  "properties": {
    "dimensionFilter": {
      "$ref": "#/components/schemas/FilterExpression",
      "description": "The filter clause of dimensions. Metrics cannot be used in this filter."
    },
    "dimensions": {
      "description": "The dimensions requested and displayed.",
      "items": {
        "$ref": "#/components/schemas/Dimension"
      },
      "type": "array"
    },
    "limit": {
      "description": "The number of rows to return. If unspecified, 10,000 rows are returned. The API returns a maximum of 250,000 rows per request, no matter how many you ask for. `limit` must be positive. The API can also return fewer rows than the requested `limit`, if there aren't as many dimension values 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.",
      "format": "int64",
      "type": "string"
    },
    "metricAggregations": {
      "description": "Aggregation of metrics. Aggregated metric values will be shown in rows where the dimension_values are set to \"RESERVED_(MetricAggregation)\".",
      "items": {
        "enum": [
          "METRIC_AGGREGATION_UNSPECIFIED",
          "TOTAL",
          "MINIMUM",
          "MAXIMUM",
          "COUNT"
        ],
        "type": "string"
      },
      "type": "array"
    },
    "metricFilter": {
      "$ref": "#/components/schemas/FilterExpression",
      "description": "The filter clause of metrics. Applied at post aggregation phase, similar to SQL having-clause. Dimensions cannot be used in this filter."
    },
    "metrics": {
      "description": "The metrics requested and displayed.",
      "items": {
        "$ref": "#/components/schemas/Metric"
      },
      "type": "array"
    },
    "minuteRanges": {
      "description": "The minute ranges of event data to read. If unspecified, one minute range for the last 30 minutes will be used. If multiple minute ranges are requested, each response row will contain a zero based minute range index. If two minute ranges overlap, the event data for the overlapping minutes is included in the response rows for both minute ranges.",
      "items": {
        "$ref": "#/components/schemas/MinuteRange"
      },
      "type": "array"
    },
    "orderBys": {
      "description": "Specifies how rows are ordered in the response.",
      "items": {
        "$ref": "#/components/schemas/OrderBy"
      },
      "type": "array"
    },
    "returnPropertyQuota": {
      "description": "Toggles whether to return the current state of this Analytics Property's Realtime quota. Quota is returned in [PropertyQuota](#PropertyQuota).",
      "type": "boolean"
    }
  },
  "type": "object"
}