如何从嵌套对象数组中提取维度与指标值并组合成扁平数组

本文介绍如何从 Google Analytics API 返回的嵌套结构（如 rows 中的 dimensionValues 和 metricValues）中精准提取对应字段（如 “Unassigned” 和 64314），并将其组合为形如 [‘Unassigned’, 64314] 的二维数组，涵盖单值匹配、等长数组遍历及健壮性处理方案。

本文介绍如何从 google analytics api 返回的嵌套结构（如 `rows` 中的 `dimensionvalues` 和 `metricvalues`）中精准提取对应字段（如 `”unassigned”` 和 `64314`），并将其组合为形如 `[‘unassigned’, 64314]` 的二维数组，涵盖单值匹配、等长数组遍历及健壮性处理方案。

在分析 Google Analytics Data API 的响应时，rows 字段通常包含一组对象，每个对象拥有 dimensionValues（维度值，如渠道组名称）和 metricValues（指标值，如会话数）两个数组。虽然每个子数组通常仅含一个元素（如 [{ value: “Unassigned” }]），但其嵌套结构要求我们显式访问 .value 属性才能获取原始值。

最直接且推荐的方式是利用数组索引 + 解构，假设每行的 dimensionValues 和 metricValues 均有且仅有一个元素：

const result = obj.rows.map(row => [
  row.dimensionValues[0]?.value || '',
  parseInt(row.metricValues[0]?.value, 10) || 0
]);
console.log(result);
// 输出示例（部分）：
// [['Direct', 789456], ['Organic Search', 7894521], ..., ['Unassigned', 64314], ...]

若需精准定位 ‘Unassigned’ 对应的项（而非全部转换），可结合 find() 方法：

const targetRow = obj.rows.find(row => 
  row.dimensionValues[0]?.value === 'Unassigned'
);
if (targetRow) {
  const unassignedPair = [
    targetRow.dimensionValues[0].value,
    Number(targetRow.metricValues[0].value)
  ];
  console.log(unassignedPair); // ['Unassigned', 64314]
}

⚠️ 注意事项：

• 始终使用可选链操作符（?.）和空值合并（||）避免因数据缺失导致的 TypeError；
• metricValues[0].value 默认为字符串（如 “64314”），需用 Number() 或 parseInt() 转为数值类型；
• 若 dimensionValues 或 metricValues 可能为空数组，务必添加长度校验（如 row.dimensionValues.length > 0）；
• 不建议使用 for…in 遍历数组（它用于对象属性枚举），应改用 for…of、forEach() 或 map() 等数组原生方法，确保语义清晰、性能稳定。

综上，核心逻辑是「逐行解构 → 提取首元素 .value → 组合成新数组」。该模式简洁、可读性强，且易于扩展为多维度/多指标场景（例如同时提取 channelGroup 和 sessions、users 多个指标）。