garf for Google Analytics Data API

Interacts with Google Analytics Data API.

Install

Install garf-google-analytics library

pipuv

pip install garf-executors garf-google-analytics

uv pip install garf-executors garf-google-analytics

Usage

Prerequisites

• Google Analytics API enabled.

clipython

echo "
SELECT
  dimension.country AS country,
  metric.activeUsers AS active_users
FROM resource
WHERE
  start_date >= '2025-09-01'
  AND end_date <= '2025-09-07'
" > query.sql
garf query.sql --source google-analytics \
  --output csv \
  --source.property-id=GA_PROPERTY_ID

from garf_io import writer
from garf_google_analytics import GoogleAnalyticsApiReportFetcher

query = """
SELECT
  dimension.country AS country,
  metric.activeUsers AS active_users
FROM resource
WHERE
  start_date >= '2025-09-01'
  AND end_date <= '2025-09-07'
"""

fetched_report = (
  GoogleAnalyticsApiReportFetcher()
  .fetch(query, property_id='PROPERTY_ID')
)

csv_writer = writer.create_writer('csv')
csv_writer.write(fetched_report, 'query')