> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atako.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Analytics

> Connect Google Analytics to your Atako agents — 6 read and 0 write actions.

Let your agents query Google Analytics 4 reports, realtime data and available dimensions/metrics. The property id is shown in Google Analytics → Admin → Property settings. Read-only.

## Connection

* **Authentication**: OAuth 2.0 — you authorize Atako via Google Analytics's consent screen; no key to copy.
* **Scopes requested**:
  * `https://www.googleapis.com/auth/analytics.readonly`

See [Google Analytics's documentation](https://developers.google.com/analytics/devguides/reporting/data/v1).

## Read actions (6)

| Action                | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `batch_run_reports`   | Query multiple reports in a batch for the same property. propertyId: numeric property identifier. requests: array of up to 5 RunReportRequest objects, each with date\_ranges, dimensions, metrics, and optional limit/offset/order\_bys/dimension\_filter.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `check_compatibility` | Check whether a set of dimensions and metrics can be retrieved for a report request. propertyId: numeric property identifier. dimensions and metrics should match your intended runReport request. compatibility\_filter: optional — "COMPATIBLE", "INCOMPATIBLE", or leave unspecified for all.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `get_metadata`        | List available dimensions and metrics for a Google Analytics property. propertyId: numeric property identifier. Use propertyId "0" to get dimensions and metrics common to all properties (excludes custom dimensions/metrics).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `run_pivot_report`    | Query a pivot report on a Google Analytics property. Pivot reports are more expressive than regular reports — dimensions are only visible if included in a pivot. propertyId: numeric property identifier. date\_ranges: date ranges. dimensions: all requested dimensions. metrics: at least one metric. pivots: array of pivot configurations with fieldNames, limit, and optional orderBys/metricAggregations.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `run_realtime_report` | Fetch realtime report data for a Google Analytics property. Shows events from the last 30 minutes (60 minutes for GA360). propertyId: numeric property identifier. dimensions: array of realtime dimension names (e.g. "country", "city", "deviceCategory", "streamName"). metrics: array of realtime metric names (e.g. "activeUsers", "screenPageViews", "conversions"). limit: max rows returned.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `run_report`          | Fetch a customized report on a Google Analytics property. propertyId: numeric property identifier (e.g. "123456", the "properties/" prefix is added automatically). date\_ranges: array of \{start\_date, end\_date} — dates use YYYY-MM-DD format, or special values today, yesterday, NdaysAgo (e.g. "30daysAgo"). dimensions: array of dimension API names (strings) (e.g. "date", "country", "city", "pagePath", "sessionSource", "deviceCategory", "browser", "operatingSystem"). metrics: array of metric API names (strings, e.g. "activeUsers", "sessions", "screenPageViews", "conversions", "totalRevenue", "eventCount", "bounceRate", "averageSessionDuration"). limit: max rows returned (default 10000). offset: row offset for pagination. order\_bys: optional array of \{metric?: \{metricName}, dimension?: \{dimensionName}, desc?}. dimension\_filter: optional FilterExpression object for filtering dimensions. |

## Write actions (0)

This connector is read-only — it exposes no write actions.

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.