Run Report

google_analytics.run_report
ActionBusiness appsconnection required

Calls the GA4 Data API POST /properties/{id}:runReport.

Run a GA4 report (metrics by dimensions over a date range).

Connection

Required
Yes — the node will not save without one
Auth type
OAuth 2.0
Providers
Google Analytics (GA4)
Secret shape
{"client_id", "client_secret", "refresh_token"}
Config it needs
property_id
Resolved by
config.connection_id, else node.connection_id

Configuration

5 fields, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.

FieldTypeRequiredDefaultConstraintsExample
property_id
GA4 property id (overrides connection).
stringNo———
metrics
Metrics, comma-separated (e.g. activeUsers,sessions).
stringYes———
dimensions
Dimensions, comma-separated (e.g. country).
stringNo———
start_date
Start (e.g. 7daysAgo).
stringNo7daysAgo——
end_date
End (e.g. today).
stringNotoday——

Example configuration

Every value below is the contract’s own example or default — nothing invented.

{
  "end_date": "today",
  "start_date": "7daysAgo"
}

Output

One shape.

result

FieldTypeExample
rows
array—
count
number—
{
  "count": 0,
  "rows": []
}

See Run Report run in a workflow.

In a technical demo we add the Google Analytics (GA4) connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.