Google Analytics

Access Google Analytics with managed OAuth authentication. This skill covers both the Admin API (manage accounts, properties, data streams) and the Data API (run reports on metrics).

Quick Start

CODEBLOCK0

Base URLs

Admin API (manage accounts, properties, data streams):
CODEBLOCK1

Data API (run reports):
CODEBLOCK2

Replace {native-api-path} with the actual Google Analytics API endpoint path. The gateway proxies requests to analyticsadmin.googleapis.com and analyticsdata.googleapis.com and automatically injects your OAuth token.

Authentication

All requests require the Maton API key in the Authorization header:

CODEBLOCK3

Environment Variable: Set your API key as MATON_API_KEY:

CODEBLOCK4

Getting Your API Key

1. Sign in or create an account at maton.ai
Go to maton.ai/settings
Copy your API key

Connection Management

Manage your Google OAuth connections at https://ctrl.maton.ai.

Important: The Admin API and Data API use separate connections:

- google-analytics-admin - Required for Admin API endpoints (manage accounts, properties, data streams)
INLINECODE6 - Required for Data API endpoints (run reports)

Create the connection(s) you need based on which API you want to use.

List Connections

CODEBLOCK5

Create Connection

CODEBLOCK6

Get Connection

CODEBLOCK7

Response:
CODEBLOCK8

Open the returned url in a browser to complete OAuth authorization.

Delete Connection

CODEBLOCK9

Specifying Connection

If you have multiple Google Analytics connections, specify which one to use with the Maton-Connection header:

CODEBLOCK10

If omitted, the gateway uses the default (oldest) active connection.

Admin API Reference

Accounts

CODEBLOCK11

Properties

CODEBLOCK12

Create Property

CODEBLOCK13

Data Streams

CODEBLOCK14

Create Web Data Stream

CODEBLOCK15

Custom Dimensions

CODEBLOCK16

Create Custom Dimension

CODEBLOCK17

Conversion Events

CODEBLOCK18

Data API Reference

Run Report

CODEBLOCK19

Run Realtime Report

CODEBLOCK20

Batch Run Reports

CODEBLOCK21

Get Metadata

CODEBLOCK22

Common Report Examples

Page Views by Page

CODEBLOCK23

Users by Country

CODEBLOCK24

Traffic Sources

CODEBLOCK25

Common Dimensions

- date, country, city, INLINECODE12
INLINECODE13, pageTitle, INLINECODE15
INLINECODE16, sessionMedium, INLINECODE18

Common Metrics

- activeUsers, newUsers, INLINECODE21
INLINECODE22, bounceRate, INLINECODE24
INLINECODE25, INLINECODE26

Date Formats

- Relative: today, yesterday, 7daysAgo, INLINECODE30
Absolute: INLINECODE31

Code Examples

JavaScript

CODEBLOCK26

Python

CODEBLOCK27

Notes

- GA4 properties only (Universal Analytics not supported)
Property IDs are numeric (e.g., properties/521310447)
Use accountSummaries to quickly list all accessible properties
Use updateMask for PATCH requests in Admin API
Use metadata endpoint to discover available dimensions/metrics
IMPORTANT: When using curl commands, use curl -g when URLs contain brackets (fields[], sort[], records[]) to disable glob parsing
IMPORTANT: When piping curl output to jq or other commands, environment variables like $MATON_API_KEY may not expand correctly in some shell environments. You may get "Invalid API key" errors when piping.

Error Handling

Status	Meaning
400	Missing Google Analytics connection
401

Troubleshooting: Invalid API Key

When you receive a "Invalid API key" error, ALWAYS follow these steps before concluding there is an issue:

1. Check that the MATON_API_KEY environment variable is set:

CODEBLOCK28

2. Verify the API key is valid by listing connections:

CODEBLOCK29

Troubleshooting: Invalid App Name

1. Ensure your URL path starts with the correct app name:

- For Admin API: use google-analytics-admin - For Data API: use INLINECODE43

Examples:

- Correct: INLINECODE44
Correct: INLINECODE45
Incorrect: INLINECODE46

Resources

Google Analytics

通过托管的OAuth认证访问Google Analytics。本技能涵盖管理API（管理账户、媒体资源、数据流）和数据API（运行指标报告）。

快速开始

bash

列出账户摘要（管理API）

python < import urllib.request, os, json
req = urllib.request.Request(https://gateway.maton.ai/google-analytics-admin/v1beta/accountSummaries)
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

运行报告（数据API）

python <header(Authorization, fBearer {os.environ[MATONAPI_KEY]}) req.add_header(Content-Type, application/json) print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF

基础URL

管理API（管理账户、媒体资源、数据流）：

https://gateway.maton.ai/google-analytics-admin/{native-api-path}

数据API（运行报告）：

https://gateway.maton.ai/google-analytics-data/{native-api-path}

将{native-api-path}替换为实际的Google Analytics API端点路径。网关会将请求代理到analyticsadmin.googleapis.com和analyticsdata.googleapis.com，并自动注入您的OAuth令牌。

认证

所有请求都需要在Authorization头中包含Maton API密钥：

Authorization: Bearer $MATONAPIKEY

环境变量： 将您的API密钥设置为MATONAPIKEY：

bash
export MATONAPIKEY=YOURAPIKEY

获取您的API密钥

1. 在maton.ai登录或创建账户
前往maton.ai/settings
复制您的API密钥

连接管理

在https://ctrl.maton.ai管理您的Google OAuth连接。

重要： 管理API和数据API使用独立的连接：

- google-analytics-admin - 管理API端点必需（管理账户、媒体资源、数据流）
google-analytics-data - 数据API端点必需（运行报告）

根据您要使用的API创建所需的连接。

列出连接

bash

列出管理API连接

python < import urllib.request, os, json
req = urllib.request.Request(https://ctrl.maton.ai/connections?app=google-analytics-admin&status=ACTIVE)
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

列出数据API连接

python <header(Authorization, fBearer {os.environ[MATONAPI_KEY]}) print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF

创建连接

bash

创建管理API连接（用于管理账户、媒体资源、数据流）

python < import urllib.request, os, json
data = json.dumps({app: google-analytics-admin}).encode()
req = urllib.request.Request(https://ctrl.maton.ai/connections, data=data, method=POST)
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
req.add_header(Content-Type, application/json)
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

创建数据API连接（用于运行报告）

python <header(Authorization, fBearer {os.environ[MATONAPI_KEY]}) req.add_header(Content-Type, application/json) print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF

获取连接

bash
python < import urllib.request, os, json
req = urllib.request.Request(https://ctrl.maton.ai/connections/{connection_id})
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

响应：
json
{
connection: {
connection_id: 21fd90f9-5935-43cd-b6c8-bde9d915ca80,
status: ACTIVE,
creation_time: 2025-12-08T07:20:53.488460Z,
lastupdatedtime: 2026-01-31T20:03:32.593153Z,
url: https://connect.maton.ai/?session_token=...,
app: google-analytics-admin,
metadata: {}
}
}

在浏览器中打开返回的url以完成OAuth授权。

删除连接

bash
python < import urllib.request, os, json
req = urllib.request.Request(https://ctrl.maton.ai/connections/{connection_id}, method=DELETE)
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

指定连接

如果您有多个Google Analytics连接，使用Maton-Connection头指定要使用的连接：

bash
python < import urllib.request, os, json
req = urllib.request.Request(https://gateway.maton.ai/google-analytics-admin/v1beta/accountSummaries)
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
req.add_header(Maton-Connection, 21fd90f9-5935-43cd-b6c8-bde9d915ca80)
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

如果省略，网关将使用默认（最旧）的活动连接。

管理API参考

账户

bash
GET /google-analytics-admin/v1beta/accounts
GET /google-analytics-admin/v1beta/accounts/{accountId}
GET /google-analytics-admin/v1beta/accountSummaries

媒体资源

bash
GET /google-analytics-admin/v1beta/properties?filter=parent:accounts/{accountId}
GET /google-analytics-admin/v1beta/properties/{propertyId}

创建媒体资源

bash
POST /google-analytics-admin/v1beta/properties
Content-Type: application/json

{
parent: accounts/{accountId},
displayName: 我的新媒体资源,
timeZone: America/Los_Angeles,
currencyCode: USD
}

数据流

bash
GET /google-analytics-admin/v1beta/properties/{propertyId}/dataStreams

创建Web数据流

bash
POST /google-analytics-admin/v1beta/properties/{propertyId}/dataStreams
Content-Type: application/json

{
type: WEBDATASTREAM,
displayName: 我的网站,
webStreamData: {defaultUri: https://example.com}
}

自定义维度

bash
GET /google-analytics-admin/v1beta/properties/{propertyId}/customDimensions

创建自定义维度

bash
POST /google-analytics-admin/v1beta/properties/{propertyId}/customDimensions
Content-Type: application/json

{
parameterName: user_type,
displayName: 用户类型,
scope: USER
}

转化事件

bash
GET /google-analytics-admin/v1beta/properties/{propertyId}/conversionEvents
POST /google-analytics-admin/v1beta/properties/{propertyId}/conversionEvents

数据API参考

运行报告

bash
POST /google-analytics-data/v1beta/properties/{propertyId}:runReport
Content-Type: application/json

{
dateRanges: [{startDate: 30daysAgo, endDate: today}],
dimensions: [{name: city}

google-analytics谷歌分析