Google Apps Script执行无效果：YouTube数据无法同步至Google Sheets

核心问题排查与修复步骤 #

1. 电子表格引用错误 #

代码中同时调用了SpreadsheetApp.getActiveSpreadsheet()和SpreadsheetApp.openByUrl("<URL HERE>")，如果脚本是绑定在目标表格上运行的，完全没必要用openByUrl，直接从活跃表格获取工作表即可。另外，若你未替换<URL HERE>为实际表格URL，会导致脚本无法定位到目标工作表。

修复：
如果脚本绑定在目标表格，替换工作表获取逻辑：

// 替换原有的spreadsheet和sheet定义
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Sheet1");

若必须通过URL打开表格，确保<URL HERE>替换为完整的Google Sheets地址（如https://docs.google.com/spreadsheets/d/xxxxxx/edit），且脚本已获得该表格的访问权限。

2. API密钥与Channel ID占位符未替换 #

代码中的<API KEY HERE>是占位符，若未替换为有效密钥，或表格第一列的频道ID为空/无效，会直接导致API请求失败，脚本静默终止。

修复：

• 替换<API KEY HERE>为你在Google Cloud Console创建的YouTube Data API v3密钥，确保API已启用，且密钥无IP或配额限制。
• 确保Sheet1的A列（第一列）从第二行开始填写有效的YouTube频道ID（例如UC_x5XG1OV2P6uZZ5FSM9Ttw）。

3. 缺失错误处理机制 #

当前代码没有任何错误捕获逻辑，一旦API请求失败（如密钥无效、频道ID错误、配额耗尽），脚本会直接停止执行，但你可能没查看执行日志，误以为没有任何变化。

修复：
添加try-catch块捕获错误，同时在日志中输出关键信息：

for (var i = 1; i < values.length; i++) {
  var channelId = values[i][0];
  // 跳过空频道ID的行
  if (!channelId) continue;
  
  try {
    var apiUrl = 'https://www.googleapis.com/youtube/v3/channels';
    var params = {
      'part': 'statistics',
      'id': channelId,
      'key': '你的实际API密钥'
    };
    
    var queryString = Object.keys(params).map(key => `${key}=${encodeURIComponent(params[key])}`).join('&');
    var response = UrlFetchApp.fetch(`${apiUrl}?${queryString}`);
    var result = JSON.parse(response.getContentText());
    
    // 检查API返回是否有有效数据
    if (!result.items || result.items.length === 0) {
      console.log(`频道ID ${channelId} 无有效返回数据`);
      sheet.getRange(i + 1, 3).setValue("无效频道ID");
      continue;
    }
    
    var statistics = result.items[0].statistics;
    
    sheet.getRange(i + 1, 3).setValue(statistics.subscriberCount);
    sheet.getRange(i + 1, 4).setValue(statistics.viewCount);
    sheet.getRange(i + 1, 5).setValue(statistics.videoCount);
    
  } catch (error) {
    console.log(`处理频道ID ${channelId} 时出错: ${error.message}`);
    sheet.getRange(i + 1, 3).setValue("请求失败");
  }
}

4. 循环执行条件问题 #

如果Sheet1只有表头（第一行），values.length等于1，循环for (var i = 1; i < values.length; i++)不会执行，自然不会有数据更新。

修复：
确保Sheet1中至少有一行有效频道ID（第二行及以后），或者添加判断提示：

if (values.length <= 1) {
  console.log("没有可处理的频道ID数据");
  return;
}

完整修复后的代码 #

function getYouTubeChannelStatistics() {
  var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Sheet1"); 
  if (!sheet) {
    console.log("未找到Sheet1工作表");
    return;
  }
  
  var range = sheet.getDataRange();
  var values = range.getValues();
  
  if (values.length <= 1) {
    console.log("没有可处理的频道ID数据");
    return;
  }
  
  for (var i = 1; i < values.length; i++) {
    var channelId = values[i][0];
    if (!channelId) {
      sheet.getRange(i + 1, 3).setValue("频道ID为空");
      continue;
    }
    
    try {
      var apiUrl = 'https://www.googleapis.com/youtube/v3/channels';
      var params = {
        'part': 'statistics',
        'id': channelId,
        'key': '你的实际API密钥' // 替换为你的API密钥
      };
      
      var queryString = Object.keys(params).map(key => `${key}=${encodeURIComponent(params[key])}`).join('&');
      var response = UrlFetchApp.fetch(`${apiUrl}?${queryString}`);
      var result = JSON.parse(response.getContentText());
      
      if (!result.items || result.items.length === 0) {
        sheet.getRange(i + 1, 3).setValue("无效频道ID");
        console.log(`频道ID ${channelId} 无效`);
        continue;
      }
      
      var statistics = result.items[0].statistics;
      
      // 批量更新单元格，提升执行效率
      sheet.getRange(i + 1, 3, 1, 3).setValues([
        [statistics.subscriberCount, statistics.viewCount, statistics.videoCount]
      ]);
      
    } catch (error) {
      sheet.getRange(i + 1, 3).setValue("请求失败");
      console.log(`频道ID ${channelId} 处理错误: ${error.message}`);
    }
  }
}

额外检查项 #

• 查看脚本执行日志：在Apps Script编辑器中点击「查看」→「日志」，排查是否有具体错误信息。
• 检查YouTube Data API配额：在Google Cloud Console中确认API配额是否耗尽，默认配额为每天10,000单位，每次请求消耗1单位。
• 验证频道ID正确性：频道ID可从YouTube频道页面URL中提取（如https://www.youtube.com/channel/UC_x5XG1OV2P6uZZ5FSM9Ttw中的UC_x5XG1OV2P6uZZ5FSM9Ttw）。

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