如何通过Google Analytics API获取指定时间段的独立用户？

Google Analytics（GA）的新旧版本（UA和GA4）API调用逻辑略有差异，以下分场景说明如何获取指定时间段的独立用户：

一、Universal Analytics（UA）旧版API #

UA中直接用ga:users指标就能统计指定日期范围的独立用户数，完全不需要依赖30天活跃用户的固定维度。

Python调用示例 #

from googleapiclient.discovery import build
from oauth2client.service_account import ServiceAccountCredentials

# 初始化API客户端
SCOPES = ['https://www.googleapis.com/auth/analytics.readonly']
KEY_FILE = '你的服务账号密钥.json'
VIEW_ID = 'ga:12345678'  # 替换为你的UA视图ID

credentials = ServiceAccountCredentials.from_json_keyfile_name(KEY_FILE, SCOPES)
analytics = build('analyticsreporting', 'v4', credentials=credentials)

# 请求2022-10-01至2022-10-12的独立用户数
response = analytics.reports().batchGet(
    body={
        'reportRequests': [
            {
                'viewId': VIEW_ID,
                'dateRanges': [{'startDate': '2022-10-01', 'endDate': '2022-10-12'}],
                'metrics': [{'expression': 'ga:users'}]
            }
        ]
    }
).execute()

# 解析结果
user_count = response['reports'][0]['data']['totals'][0]['values'][0]
print(f"目标时间段独立用户数：{user_count}")

核心说明 #

ga:users指标基于用户标识（Cookie或用户ID）统计指定日期范围内的独立访客，和30天活跃用户是完全独立的统计维度，直接调用就能得到你要的12天周期数据。

二、GA4新版API #

GA4中对应指标为activeUsers，指定日期范围后，该指标会统计这段时间内至少有一次会话的独立用户，完全匹配你的需求。

Python调用示例 #

from google.analytics.data_v1beta import BetaAnalyticsDataClient
from google.analytics.data_v1beta.types import RunReportRequest

# 初始化客户端
PROPERTY_ID = 'properties/123456789'  # 替换为你的GA4媒体资源ID
client = BetaAnalyticsDataClient()

# 构建请求
request = RunReportRequest(
    property=PROPERTY_ID,
    date_ranges=[{'start_date': '2022-10-01', 'end_date': '2022-10-12'}],
    metrics=[{'name': 'activeUsers'}]
)

response = client.run_report(request)

# 解析结果
for row in response.rows:
    print(f"目标时间段独立用户数：{row.metric_values[0].value}")

误区澄清 #

你提到的“30 Day Active Users”是GA内置的固定周期统计（过去30天活跃用户），但API支持自定义任意日期范围的独立用户统计，直接使用对应指标即可，无需受限于固定周期。

内容的提问来源于stack exchange，提问作者Eks27