为何Google Data Studio中npm下载计数器连接器的所有字段均显示为维度？

1. 刷新缓存排除本地加载问题 #

• 先强制刷新Looker Studio页面（Windows按Ctrl+F5，Mac按Cmd+Shift+R），排除UI临时加载异常
• 打开对应数据源的编辑页，点击右上角「编辑字段」→ 选择顶部「刷新字段」，强制拉取最新的字段定义

若为新建数据源，需先断开连接器连接，重新完成配置加载

2. 校验getSchema函数返回逻辑 #

仅在getFields中定义字段不会生效，必须通过getSchema将字段定义返回给Data Studio，正确实现示例：

function getSchema(request) {
  return {
    schema: getFields().build()
  };
}

• 若getSchema返回硬编码的旧字段列表、或未调用getFields().build()，Data Studio会沿用旧的字段配置，不会识别新增的指标定义

3. 检查getData返回的字段值类型 #

• getFields中定义downloads为NUMBER类型时，getData函数返回的行数据中，downloads的值必须为纯数字类型，不能是字符串格式的数字
• 正确返回行数据示例：

// getData内部组装的行结构
var rows = [
  {
    dimensions: {
      packageName: "test-package",
      day: "20240601"
    },
    metrics: {
      downloads: 1234 // 此处为数字，不能加引号
    }
  }
];

• 若返回的downloads为字符串格式，Data Studio会自动识别为文本类型，归类到维度分组

4. 确认加载的是最新部署的代码 #

• 修改getFields代码后，需在Apps Script项目中更新对应测试部署的版本，旧的部署不会自动同步最新代码
• 重新在Looker Studio中选择对应测试部署ID完成连接，确保加载的是修改后的逻辑

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