Google Apps Script遍历账户遇无GA4属性时停止，求解决

问题描述 #

我正在编写一个Google Apps Script脚本，用于将GA4分析媒体资源的信息填充到Google表格中。脚本流程为：先列出所有可访问账户，再逐个遍历账户并列出其中的GA4媒体资源，最后遍历媒体资源将信息输出到表格。

目前遇到的问题是：当脚本遇到不含GA4媒体资源的账户时，会直接停止运行，而非继续处理下一个账户。我最初为UA媒体资源编写的同款脚本运行完全正常，仅因API端点不同就出现此问题令我困惑。我尝试过将“return”改为“break”等多种调整，但均无效果。

原代码：

function init_ga4() {

  // define current sheet as target
  const activeSheet = SpreadsheetApp.getActiveSheet();

  // clear existing data
  activeSheet.getRange("A2:D1000").clear();

  // run main function
  get_ga4_data(activeSheet);
}

function get_ga4_data(activeSheet) {

  // make list of all accounts accessible by current user
  const accounts = Analytics.Management.Accounts.list();

  // set row to start outputting data on
  let r = 2;

  // loop through each account
  for (let i = 0; i < accounts.items.length; i++) {
    
    // get current account idetails
    const account = accounts.items[i];

    // make list of properties in current account
    const propertiesList = AnalyticsAdmin.Properties.list({ filter: "parent:accounts/" + account.id });

    // check if account doesn't have any GA4 properties
    if (propertiesList.properties === undefined) {
      return;

    } else {

      // count properties in list
      const propertiesCount = propertiesList.properties.length;

      // get the range for properties in this accout and output account name
      const accountNameRange = activeSheet.getRange(`A${r}:A${r + (propertiesCount - 1)}`);

      accountNameRange.setValue(account.name);

      const properties = propertiesList.properties;

      // loop through properties and put the property details in the right cells
      for (let p = 0; p < properties.length; p++) {
        const property = properties[p];

        const propertyNameCell = activeSheet.getRange(`C${r + p}`);

        propertyNameCell.setValue(property.displayName);
      }

      // update starting row for next batch of data
      r += propertiesCount;
    } 
  }
}

问题根源 #

核心错误在于这行代码：

if (propertiesList.properties === undefined) {
  return;
}

• return会直接终止整个get_ga4_data函数，导致后续所有账户的遍历直接中断。
• 你尝试的break也不对：break是跳出当前的账户遍历循环，同样会终止后续所有账户的处理，不是跳过当前账户。

修复方案 #

需要用continue替代return，continue的作用是跳过当前循环的剩余代码，直接进入下一次账户遍历，不会终止整个函数。同时优化判断条件，覆盖空数组的情况。

修复后的完整代码：

function init_ga4() {
  const activeSheet = SpreadsheetApp.getActiveSheet();
  activeSheet.getRange("A2:D1000").clear();
  get_ga4_data(activeSheet);
}

function get_ga4_data(activeSheet) {
  const accounts = Analytics.Management.Accounts.list();
  let r = 2;

  for (let i = 0; i < accounts.items.length; i++) {
    const account = accounts.items[i];
    const propertiesList = AnalyticsAdmin.Properties.list({ filter: "parent:accounts/" + account.id });

    // 跳过无GA4资源的账户：要么properties不存在，要么为空数组
    if (!propertiesList.properties || propertiesList.properties.length === 0) {
      continue;
    }

    const propertiesCount = propertiesList.properties.length;
    // 批量写入账户名称到对应行
    activeSheet.getRange(`A${r}:A${r + propertiesCount - 1}`).setValue(account.name);

    const properties = propertiesList.properties;
    for (let p = 0; p < properties.length; p++) {
      const property = properties[p];
      // 写入资源名称到C列
      activeSheet.getRange(`C${r + p}`).setValue(property.displayName);
      // 可选：写入GA4资源ID到B列（从资源名称中提取ID部分）
      activeSheet.getRange(`B${r + p}`).setValue(property.name.split("/").pop());
    }

    r += propertiesCount;
  }
}

关键改动说明 #

1. 替换return为continue：确保遇到无GA4资源的账户时，仅跳过当前账户，继续处理下一个。
2. 优化判断条件：!propertiesList.properties || propertiesList.properties.length === 0同时覆盖properties未定义和空数组两种情况，避免遗漏。
3. 简化代码结构：移除else分支，跳过空账户后直接执行有资源的逻辑，代码更简洁易读。

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