Apache Software Foundation / SeaTunnel
Merged upstreamFeatureMerged Sep 14, 2026

Add Google Analytics 4 report source

Added a Google Analytics 4 source using Data API v1beta, with service-account authentication, typed dimensions and metrics, and absolute report dates.

apache/seatunnel · #12280

New analytics integration

SeaTunnel batch pipelines can ingest typed Google Analytics 4 aggregate reports with explicit reporting limits and bounded resource use.

Problem

SeaTunnel's connector roadmap requested Google Analytics 4 support, but users lacked a native source for importing property reports into their data pipelines.

Approach

Implements a batch-only report source with parallelism one, bounded pagination and retries, quota checks, cancellation, isolated dependencies, plugin registration, examples, and English/Chinese documentation. Detected reporting limitations fail explicitly.

Impact and scope

  • Enables aggregate website and application analytics reports to flow through SeaTunnel's existing pipeline engines.
  • Provides typed report ingestion and controlled pagination, retries, and quota handling rather than requiring custom extraction scripts.
  • Makes scope explicit: this is not raw-event ingestion or CDC; recovery replays the report and snapshot consistency is not guaranteed.

Validation

  • The PR reports 23 unit tests and one shaded-JAR authentication/HTTP test passing on both Java 8 and Java 11.
  • Selected Zeta, Flink 1.18.0, and Spark 3.3.0 runs passed against a mock reporting endpoint, with a final Zeta network-cleanup rerun. Live-property validation was not reported.
  • The final Build check passed and the GitHub-verified merge commit credits Goutam Adwant. Maintainer davidzollo approved: 'LGTM, thanks for your work and keep up the good effort!'