List every GA4 account and its properties the service account can see. Returns account name/id plus each property's display name and numeric id. Call this first to discover property ids for the other GA4 tools.

Get configuration details for one GA4 property (name, time zone, currency, industry, create time).

List the data streams (web/app) on a GA4 property. The stream id (last path segment of 'name') is needed by the Measurement Protocol secret tools.

Run a GA4 report. metrics/dimensions are GA4 API names (e.g. metrics ['activeUsers','conversions'], dimensions ['date','sessionDefaultChannelGroup']). Dates accept YYYY-MM-DD or relative forms like '28daysAgo' / 'today'.

Run a GA4 realtime report (last ~30 minutes). Example: metrics ['activeUsers'], dimensions ['country','unifiedScreenName'].

List custom dimensions defined on a GA4 property.

Create a custom dimension. parameter_name is the event parameter / user property key; scope is 'EVENT', 'USER' or 'ITEM'. display_name may contain only letters, numbers, underscores and spaces.

Archive (delete) a custom dimension. custom_dimension_id may be the numeric id or the full 'properties/NNN/customDimensions/MMM' name.

List custom metrics defined on a GA4 property.

Create a custom metric. measurement_unit is one of STANDARD, CURRENCY, FEET, METERS, KILOMETERS, MILES, MILLISECONDS, SECONDS, MINUTES, HOURS.

List key events (conversions) on a GA4 property.

Mark an event as a key event (conversion). counting_method is 'ONCE_PER_EVENT' or 'ONCE_PER_SESSION'.

List audiences defined on a GA4 property.

Create a GA4 audience of users who triggered a given event (e.g. 'purchase', 'generate_lead') — useful for remarketing lists that can be shared to Google Ads. membership_duration_days is how long a user stays in the audience (max 540).

Archive a GA4 audience. audience_id may be the numeric id or the full 'properties/NNN/audiences/MMM' name.

List Measurement Protocol API secrets for a data stream. stream_id is the numeric id from list_data_streams.

Create a Measurement Protocol API secret on a data stream. Returns the secret_value (api_secret) needed by send_ga4_event. Treat it as sensitive.

Delete a Measurement Protocol API secret. secret_id may be the numeric id or the full resource name.

Send an event into a GA4 property via the Measurement Protocol. measurement_id is the stream's 'G-XXXXXXX'; api_secret comes from a Measurement Protocol secret; client_id identifies the user/device. Set validate=True to hit GA4's debug/validation endpoint (checks the payload WITHOUT ingesting it) — recommended before real sends.

Show which service-account identity and scopes this server uses for GTM, and how many GTM accounts it can currently see. Use this to verify access after granting the service account permission in Tag Manager.

List all GTM accounts the service account can access.

List containers in a GTM account.

List workspaces in a container.

List tags in a workspace.

List triggers in a workspace.

List variables in a workspace.

Get a single tag by id.

List container version headers (published + saved versions).

Get the currently live (published) container version.

Create a tag. tag_json is the full GTM Tag resource as a JSON string, e.g. {"name":"GA4 Config","type":"gaawc","parameter":[...], "firingTriggerId":["2147479553"]}.

Update an existing tag with a full GTM Tag resource (JSON string).

Delete a tag. Requires confirm=true.

Create a trigger from a full GTM Trigger resource (JSON string).

Update an existing trigger with a full GTM Trigger resource (JSON string).

Delete a trigger. Requires confirm=true.

Create a variable from a full GTM Variable resource (JSON string).

Update an existing variable with a full GTM Variable resource (JSON string).

Delete a variable. Requires confirm=true.

Freeze the current workspace into a new container version. Returns the new containerVersion (with containerVersionId) plus any compiler errors. This does NOT publish; use gtm_publish_version next.

Publish a container version to live. Requires confirm=true because this affects the live site.