如何通过API获取reCAPTCHA Enterprise的actions指标数据

1. 能否通过官方API获取控制台展示的actions维度数据 #

• 公开的GetMetrics接口不提供按用户操作（action）拆分的聚合指标。GCP控制台reCAPTCHA仪表盘里展示的分action统计，是控制台后端基于原始评估日志做的内部聚合结果，没有对外暴露在通用Metrics API中。
• 如果需要分action的指标搭建自定义仪表盘，需要自行完成聚合流程：将reCAPTCHA评估日志导出到Cloud Logging或者BigQuery，基于日志中携带的event.action、评分、挑战结果等字段，按需要的时间粒度、action维度做统计计算即可。

2. score metrics与challenge metrics的区别，以及challenge metrics为空的原因 #

• 两类指标不属于同一统计维度，核心差异如下：
  • score_metrics：全量评估请求的评分分布统计，只要站点接入reCAPTCHA Enterprise产生评估请求就会生成对应数据，统计内容是0-1不同分数区间的请求计数，和是否开启挑战功能无关。
  • challenge_metrics：仅当站点配置了挑战触发规则（比如分数低于阈值弹出复选框、交互式验证）后才会生成的指标，统计内容包含挑战触发量、挑战通过率、挑战失败率等和验证交互流程相关的数据。
• 你接口返回challenge_metrics为空结构，通常是两种原因导致：
  • 当前站点没有配置任何触发挑战的规则，所有请求仅返回风险评分，不会弹出验证流程，因此没有对应统计数据
  • 你查询的时间范围内没有产生任何触发挑战的请求，字段就会返回空值
• 额外注意：你提供的示例代码中name参数使用了占位符name_value，正式调用时需要替换为正确的资源路径，格式为projects/{GCP项目编号}/keys/{reCAPTCHA密钥ID}/metrics，路径配置错误也可能导致返回数据不全。

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