如何从对象数组中提取维度与指标值并组合成二维数组

本文介绍如何从嵌套的 API 响应数据中，精准提取 dimensionValues 和 metricValues 中的 value 字段，并将它们配对组合为形如 [‘Unassigned’, 64314] 的字符串-数值数组。

本文介绍如何从嵌套的 api 响应数据中，精准提取 `dimensionvalues` 和 `metricvalues` 中的 `value` 字段，并将它们配对组合为形如 `[‘unassigned’, 64314]` 的字符串-数值数组。

在 Google Analytics Data API 等分析类接口返回的数据结构中，rows 是一个对象数组，每个对象包含 dimensionValues（维度，如渠道组名称）和 metricValues（指标，如会话数），且二者均为单元素数组（即每个 row 对应一个维度值 + 一个指标值）。因此，无需复杂嵌套循环，只需安全访问首项即可完成配对。

✅ 正确提取方式（推荐）

const rows = obj.rows;
const result = rows.map(row => [
  row.dimensionValues[0]?.value || '',
  parseInt(row.metricValues[0]?.value, 10) || 0
]);

console.log(result);
// 输出示例（部分）：
// [['Direct', 789456], ['Organic Search', 7894521], ..., ['Unassigned', 64314], ...]

⚠️ 注意：使用可选链操作符 ?. 防止因某行缺失 dimensionValues 或 metricValues 导致运行时错误；parseInt(…, 10) 确保数值类型安全，避免字符串拼接陷阱。

? 定位特定项（如 ‘Unassigned’）

若仅需提取 value === ‘Unassigned’ 对应的组合，可进一步过滤：

const unassignedPair = rows
  .find(row => 
    row.dimensionValues[0]?.value === 'Unassigned'
  );

if (unassignedPair) {
  const pair = [
    unassignedPair.dimensionValues[0].value,
    parseInt(unassignedPair.metricValues[0].value, 10)
  ];
  console.log(pair); // ['Unassigned', 64314]
}

❌ 避免使用 for…in 遍历数组

for (var item in data) 实际遍历的是数组索引（字符串形式），且会继承原型属性，不适用于数组遍历。应优先使用 for…of、forEach() 或函数式方法（如 map/find）。

? 总结

• dimensionValues 和 metricValues 在该 API 中均为长度为 1 的数组，直接取 [0].value 即可；
• 使用 map() 实现声明式转换，语义清晰、易于测试；
• 添加空值防护（?.）和类型转换（parseInt），提升代码鲁棒性；
• 如需条件筛选，配合 find() 或 filter() 更高效准确。

此方案兼顾简洁性、可读性与健壮性，适用于同类嵌套数组结构的数据解析场景。