如何使用Python获取Google Analytics维度、指标及合法组合？

全量维度、指标列表获取 #

• 不用找专门的第三方Web端适配库，Google Analytics Report API v4自带官方元数据查询接口，不管你用Web端OAuth2认证还是服务账号认证，只要持有合法授权凭据就能调用，没有场景限制。
• 接口返回内容覆盖所有公开维度、指标的完整信息：字段唯一标识、显示名称、功能描述、数据类型、所属分类、弃用状态、支持的筛选操作，完全可以直接作为前端维度/指标选择器的数据源。
• Python侧直接复用你现在对接Report API已经在用的官方google-api-python-client库就行，不需要额外安装依赖，认证环节直接传入你已经跑通的Web端OAuth2授权对象即可，不用切换服务账号逻辑。
• 核心调用代码参考：

from googleapiclient.discovery import build

# http_auth 替换为你完成OAuth2流程后生成的已授权http实例
analytics_client = build('analyticsreporting', 'v4', http=http_auth)
meta_res = analytics_client.metadata().columns().list(reportType='ga').execute()

# 按字段类型拆分维度和指标
all_columns = meta_res.get('columns', [])
dimension_list = [col for col in all_columns if col['attributes'].get('type') == 'DIMENSION']
metric_list = [col for col in all_columns if col['attributes'].get('type') == 'METRIC']

维度、指标合法组合规则获取 #

• 官方没有提供单独返回所有合法组合的接口，但是有两种可靠的方式实现校验：
  • 第一种是用元数据接口返回的字段属性做本地预校验：每个字段的属性中会携带适用场景标记、模板字段索引范围、弃用替换关系、适用版本（普通版/360版）等信息，同业务分类下的字段默认支持自由组合，跨分类的特殊限制都会在字段属性中标注。
  • 第二种是做实时接口校验，准确率100%：用户选完字段后，你可以构造查询请求时把dryRun参数设为True发起调用，接口不会实际查询数据，只会校验请求合法性，直接返回当前字段组合是否合规、具体哪几个字段存在冲突，不需要本地维护全量规则表，也不会产生查询开销。
• 不要用网上第三方整理的静态维度、指标表，GA会不定期新增字段、下线旧字段、调整组合规则，直接调用官方元数据接口拿到的是和线上规则完全同步的最新数据，不会出现规则过时的问题。也不要爬取公开的维度指标探索页面内容做数据源，页面结构会不定期调整，内容更新和API实际生效时间存在延迟，稳定性很差。

Web端场景适配说明 #

• 你之前找到的适配服务账号的Python库，本质都是对官方google-api-python-client的上层封装，只要把封装逻辑里的认证凭据替换成你Web端OAuth2流程拿到的用户授权凭据，完全可以直接使用，不存在场景隔离问题。官方库本身就同时支持服务账号、OAuth2 Web端、OAuth2桌面端等所有认证方式，没有绑定特定部署场景。

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