gapi

Two CLIs for Google APIs, sharing the same OAuth credentials.

Commands

node ${CLAUDE_PLUGIN_ROOT}/scripts/gtm.js $ARGUMENTS   # Google Tag Manager API v2
node ${CLAUDE_PLUGIN_ROOT}/scripts/ga.js $ARGUMENTS    # Google Analytics Admin API v1

Run with help for full command list.

Setup

Credentials

Store OAuth client credentials in ${CLAUDE_PLUGIN_ROOT}/scripts/.gapis/credentials.json:

# From file
node ${CLAUDE_PLUGIN_ROOT}/scripts/gtm.js auth credentials set --file /path/to/credentials.json

# From clipboard
node ${CLAUDE_PLUGIN_ROOT}/scripts/gtm.js auth credentials paste-win --overwrite   # Windows
node ${CLAUDE_PLUGIN_ROOT}/scripts/gtm.js auth credentials paste-macos --overwrite # macOS

Login

node ${CLAUDE_PLUGIN_ROOT}/scripts/gtm.js auth login                 # edit scope (default)
node ${CLAUDE_PLUGIN_ROOT}/scripts/gtm.js auth login --preset readonly
node ${CLAUDE_PLUGIN_ROOT}/scripts/gtm.js auth login --preset publish

Scopes are combined for both APIs:

• readonly: tagmanager.readonly + analytics.readonly
• edit: tagmanager.edit.containers + analytics.edit
• publish: above + tagmanager.publish

---

GTM Reference (93 commands)

Hierarchy

accounts > containers > workspaces > tags/triggers/variables/...
                      > environments
                      > versions

Commands

Resource	Actions
accounts	list, get, update
containers	list, get, create, update, delete
workspaces	list, get, create, update, delete, sync, quick-preview, get-status, create-version
tags	list, get, create, update, delete, revert
triggers	list, get, create, update, delete, revert
variables	list, get, create, update, delete, revert
folders	list, get, create, update, delete, revert, move-entities
clients	list, get, create, update, delete, revert (server containers)
templates	list, get, create, update, delete, revert
zones	list, get, create, update, delete, revert
transformations	list, get, create, update, delete, revert (server containers)
built-in-variables	list, create, delete, revert
environments	list, get, create, update, delete, reauthorize
versions	list, get, publish, set-latest, delete, undelete, live, update
user-permissions	list, get, create, update, delete

Required Flags

Resource	Flags
accounts	(none for list)
containers	--accountId
workspaces	--accountId --containerId
tags/triggers/variables/etc	--accountId --containerId --workspaceId
environments	--accountId --containerId
versions	--accountId --containerId

Examples

# List accounts
node ${CLAUDE_PLUGIN_ROOT}/scripts/gtm.js accounts list

# List containers
node ${CLAUDE_PLUGIN_ROOT}/scripts/gtm.js containers list --accountId 6310095540

# List tags in workspace
node ${CLAUDE_PLUGIN_ROOT}/scripts/gtm.js tags list --accountId 6310095540 --containerId 228346062 --workspaceId 20

# Get specific tag
node ${CLAUDE_PLUGIN_ROOT}/scripts/gtm.js tags get --accountId 6310095540 --containerId 228346062 --workspaceId 20 --tagId 21

# Get live version
node ${CLAUDE_PLUGIN_ROOT}/scripts/gtm.js versions live --accountId 6310095540 --containerId 228346062

# Create tag (JSON via stdin)
echo '{"name":"My Tag","type":"html"}' | node ${CLAUDE_PLUGIN_ROOT}/scripts/gtm.js tags create --accountId <id> --containerId <id> --workspaceId <id>

---

GA Reference (49 commands)

Hierarchy

accounts > properties > data-streams > mp-secrets
                      > custom-dimensions
                      > custom-metrics
                      > key-events
                      > google-ads-links
                      > firebase-links

Commands

Resource	Actions
accounts	list, get, delete, patch, search-change-history
account-summaries	list
properties	list, get, create, delete, patch, get-data-retention, update-data-retention
data-streams	list, get, create, delete, patch
custom-dimensions	list, get, create, patch, archive
custom-metrics	list, get, create, patch, archive
key-events	list, get, create, delete, patch
google-ads-links	list, create, delete, patch
firebase-links	list, create, delete
mp-secrets	list, get, create, delete, patch

Required Flags

Resource	Flags
accounts	(none for list)
account-summaries	(none)
properties	--accountId (for list) or --propertyId (for get/patch)
data-streams	--propertyId
custom-dimensions/metrics	--propertyId
key-events	--propertyId
google-ads-links	--propertyId
firebase-links	--propertyId
mp-secrets	--propertyId --dataStreamId

Examples

# List accounts
node ${CLAUDE_PLUGIN_ROOT}/scripts/ga.js accounts list

# List account summaries (includes properties)
node ${CLAUDE_PLUGIN_ROOT}/scripts/ga.js account-summaries list

# List properties
node ${CLAUDE_PLUGIN_ROOT}/scripts/ga.js properties list --accountId 40457743

# Get property
node ${CLAUDE_PLUGIN_ROOT}/scripts/ga.js properties get --propertyId 452774256

# List data streams
node ${CLAUDE_PLUGIN_ROOT}/scripts/ga.js data-streams list --propertyId 452774256

# List key events (conversions)
node ${CLAUDE_PLUGIN_ROOT}/scripts/ga.js key-events list --propertyId 452774256

# Create key event (JSON via stdin)
echo '{"eventName":"sign_up","countingMethod":"ONCE_PER_EVENT"}' | node ${CLAUDE_PLUGIN_ROOT}/scripts/ga.js key-events create --propertyId <id>