如何通过GA4 API获取user_pseudo_id字段及导出历史数据？

GA4 Reporting Data API 不支持通过传入未公开维度的方式获取user_pseudo_id字段，旧版UA API可隐式传入未公示clientId调用的经验在GA4上完全不适用，不要直接套用。

• 优先选择GA4原生BigQuery回溯导出：如果你的目标是把GA4历史数据同步到BigQuery，不需要走Reporting API中转，直接在GA4媒体资源的BigQuery导出配置中开启回溯导出即可：标准版GA4支持最多补导出过去13个月的历史数据，360版本支持更长的回溯周期，导出的事件明细表默认自带user_pseudo_id字段，数据完整性、和原生BigQuery导出的字段匹配度是100%，是成本最低的方案。

  注意：只要当前你对目标GA4媒体资源有编辑权限，哪怕之前从未开过BigQuery导出，开启后都可以直接选择回溯历史数据，不需要额外做埋点改造。

• 小批量补数场景用GA4 Admin API的用户导出能力：Reporting Data API的定位是聚合类报表查询，接口层面做了用户粒度数据的隐私拦截，哪怕你硬传user_pseudo_id作为维度参数，也会直接返回400参数错误，不会正常返回结果。如果只需要拉取小批量的用户级数据，可以用Admin API提供的用户探索导出接口获取对应字段，但该接口有严格的配额限制，且调用需要符合GA4的用户数据隐私合规要求，不适合全量历史数据同步。
• 仅需后续新增数据可用自定义维度兜底：如果以上路径都无法满足，可以在GA4中新建一个自定义用户维度，通过前端埋点或者GTM把user_pseudo_id的值赋值给该维度，等维度数据收集生效后，就可以在Reporting Data API中通过customUser:维度参数名的格式查询到对应值，但这个方案只能拿到配置生效后新产生的数据，无法回溯历史数据。

目前GA4 Reporting Data API已经上线了严格的维度白名单校验机制，所有不在官方公开维度列表内的参数传入都会直接触发接口报错，不存在类似旧UA的隐藏维度可以调用，不用浪费时间测试各类网传的未公开字段名。

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