切换至Google Analytics GA4后API调用出现403权限错误求助

核心问题根源 #

Analytics API v4仅适用于UA（Universal Analytics），GA4需要使用专门的Google Analytics Data API v1，你混淆了两个版本的API适配逻辑，这是导致权限错误的核心原因。

具体修复步骤 #

• 切换API服务：在GCP控制台中启用「Google Analytics Data API v1」，停用或忽略原有的Analytics API v4。
• 修正权限配置：
  1. 登录GA4后台，进入「管理」-「账号访问管理」，将JSON密钥文件中client_email对应的GCP服务账号添加为查看者或更高权限角色。
  2. 在GCP控制台的IAM页面，确保该服务账号拥有roles/analytics.dataViewer权限。
• 替换代码逻辑：GA4的Data API v1请求格式与UA完全不同，Python示例代码如下：

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

# 初始化客户端
client = BetaAnalyticsDataClient.from_service_account_json("your-service-key.json")

# 构造报表请求
request = RunReportRequest(
    property=f"properties/{你的GA4属性ID}",
    date_ranges=[{"start_date": "7daysAgo", "end_date": "today"}],
    dimensions=[{"name": "city"}],
    metrics=[{"name": "activeUsers"}]
)

# 发送请求并获取响应
response = client.run_report(request)

• 替换标识：GA4没有UA的View ID概念，需使用GA4属性ID（格式为2XXXXXXXXX），可在GA4后台「管理」-「属性设置」中查看。

额外排查点 #

• 确认JSON密钥文件未被篡改，其中的client_email与GCP服务账号完全一致。
• 检查GA4属性是否已正确关联到目标GCP项目，服务账号未被删除或禁用。
• 权限同步延迟：GCP与GA4的权限生效可能需要5-10分钟，配置完成后不要立即测试。

注意：官方明确区分UA和GA4的API服务，切勿混用，这是多数开发者踩坑的关键点。

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