跳转到主要内容
POST
Reference example

请求规范

  • 方法与路径: POST /apis/v1/social/analytics/googleanalytics/realtime
  • 可用状态: enabled
  • 请求 URL 模板: https://api.aisa.one/apis/v1/social/analytics/googleanalytics/realtime
  • Runtime 事实版本: 99acb5bddbedc8d3352e7c4fef86c3e6d8852c14772bcd18dbcf415237a642bd
完整 OpenAPI 定义 有效请求与价格声明(包括认证和引用的 schema):

费用与请求规则

当前未提供请求参考价格;请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。 公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口,执行前请针对完整请求获取免费报价;执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
accountId
string
必填

One of your social accounts (acc_...).

Pattern: ^acc_[0-9A-Za-z]{22}$
metrics
string[]
必填

GA4 metric API names, e.g. sessions, activeUsers, keyEvents, totalRevenue.

Required array length: 1 - 10 elements
dimensionFilter
object

A Google FilterExpression on dimensions, in Google's own shape.

dimensions
string[]

GA4 dimension API names, e.g. date, sessionSource, pagePath. List them with GET /apis/v1/social/analytics/googleanalytics/metadata.

Maximum array length: 9
limit
integer

Rows to return. Defaults to Google's default (10000).

必填范围: 1 <= x <= 10000
metricFilter
object

A Google FilterExpression on metrics, in Google's own shape.

minuteRanges
object[]
Required array length: 1 - 2 elements
orderBys
object[]

Google OrderBy objects, e.g. { "metric": { "metricName": "sessions" }, "desc": true }.

Maximum array length: 10

响应

Realtime report rows from Google

Google Analytics Data API report, passed through as Google returns it. Every value in rows is a string; read metricHeaders[].type to parse metrics.

accountId
string

One of your social accounts (acc_...).

Pattern: ^acc_[0-9A-Za-z]{22}$
dimensionHeaders
object[]
metadata
object

Google report metadata (currency, time zone, sampling and thresholding flags).

metricHeaders
object[]
propertyId
string

Numeric GA4 property ID.

propertyQuota
object

Google quota left on this property after the request (tokens per day and per hour, concurrent requests). Cached responses carry the quota from when they were fetched.

rowCount
integer

Total rows matching the request, across all pages.

rows
object[]