通过API获取YouTube搜索结果超时问题解决方案求助

1. 分批处理关键词并添加间隔 #

把超过100个的关键词拆分成每批20-30个的小批次，每批处理完成后暂停1-2秒，避免脚本连续执行过长时间触发超时：

• 自己实现数组拆分函数，将关键词列表切割为多个小批次：

  function chunk(arr, size) {
    return Array.from({length: Math.ceil(arr.length / size)}, (v, i) => arr.slice(i*size, i*size+size));
  }
  

• 遍历每个批次处理，完成后调用Utilities.sleep(1000)添加间隔
• 用PropertiesService.getScriptProperties()存储已处理的关键词索引，避免脚本中断后从头开始执行

2. 借助时间驱动触发器拆分任务 #

把整个批量任务拆成多个独立小任务，通过时间触发器逐个执行：

• 将所有待处理关键词存入Google表格或脚本属性中
• 创建时间驱动触发器（比如每10分钟触发一次），每次执行时读取20个未处理关键词
• 处理完成后标记这些关键词为已处理，直到所有任务完成
• 注意：触发器单次执行时间同样不能超过6分钟，需合理控制每批任务量

3. 优化API请求效率 #

减少不必要的数据传输和请求次数，降低脚本执行负载：

• 调用YouTube Data API的search.list时，仅指定必需的part参数，比如part=snippet，避免请求冗余字段
• 根据实际需求设置最小的maxResults值，比如只需要前3条结果就设为3，减少返回的数据量
• 先对关键词列表去重，移除重复项，减少无效API请求次数

4. 添加错误重试机制 #

针对临时网络波动或API响应延迟导致的超时，增加重试逻辑：

• 用try-catch块包裹API请求代码，捕获超时类错误
• 触发超时错误时重试2-3次，每次重试前延长间隔时间（比如第一次间隔3秒，第二次5秒）
• 示例代码片段：

function fetchYoutubeResults(query) {
  let retries = 3;
  while (retries > 0) {
    try {
      return YouTube.Search.list('snippet', {q: query, maxResults: 3});
    } catch (e) {
      if (e.message.includes('timeout') && retries > 0) {
        retries--;
        Utilities.sleep(3000 * (3 - retries));
      } else {
        throw e;
      }
    }
  }
  return null;
}

注意事项 #

• 检查YouTube Data API的配额使用情况，配额耗尽也会导致请求失败，不要与超时问题混淆
• 脚本执行过程中避免不必要的UI交互或大量数据写入操作，这类操作会增加执行时间

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