Google Apps Script：UrlFetch仅在浏览器/编辑器请求返回401错误求因

• 调用供应商API时，获取会话ID的请求始终成功，但使用该会话ID调用/candidates端点的GET请求，仅在浏览器/GAS编辑器中执行时返回401 Truncated Server Response错误，通过定时触发器执行则完全正常。
• 办公静态IP及Google官方IP段均已加入供应商白名单，请求不应被拦截。

相关代码 #

function test() {
  // 获取供应商的Session ID，此请求始终成功
  var sesResponse = JSON.parse(UrlFetchApp.fetch("https://www2.pcrecruiter.net/rest/api/access-token/?Username=redacted&Password=redacted&DatabaseId=redacted.redacted&ApiKey=abcdefghijklmnopqrstuvwxyz&AppId=123456"));
  sessionID = sesResponse.SessionId;
  console.log("sessionID = " + sessionID);

  // 使用获取到的Session ID调用API的/candidates端点，此请求返回401错误
  var response = JSON.parse(UrlFetchApp.fetch("https://www2.pcrecruiter.net/rest/api/candidates/?SessionID=" + sessionID + "&Query=MobilePhone%20co%201234567899&ResultsPerPage=100").getContentText());
  console.log(response);
}

错误信息 #

Exception: Request failed for https://www2.pcrecruiter.net returned code 401. Truncated server response: {"errors":"   at Microsoft.VisualBasic.ErrObject.Raise(Int32 Number, Object Source, Object Description, Object HelpFile, Object HelpContext)\r\n   ... (use muteHttpExceptions option to examine full response)

可能的原因及解决方案 #

1. 执行环境的请求头差异 #

Google Apps Script在编辑器/浏览器窗口执行时，会携带当前用户浏览器的相关头信息（如User-Agent、Cookie等），而定时触发器执行时是以Google服务器身份发起请求，头信息更简洁且无用户浏览器相关数据。部分API会对请求头进行校验，若编辑器环境的头信息不符合API预期，就会返回401。

解决方法：
手动指定请求头，模拟触发器环境的请求特征，同时开启muteHttpExceptions查看完整错误响应：

function test() {
  var sesResponse = JSON.parse(UrlFetchApp.fetch("https://www2.pcrecruiter.net/rest/api/access-token/?Username=redacted&Password=redacted&DatabaseId=redacted.redacted&ApiKey=abcdefghijklmnopqrstuvwxyz&AppId=123456"));
  sessionID = sesResponse.SessionId;
  console.log("sessionID = " + sessionID);

  var options = {
    headers: {
      'User-Agent': 'Mozilla/5.0 (compatible; Google-Apps-Script)',
      'Accept': 'application/json'
    },
    muteHttpExceptions: true
  };
  var query = encodeURIComponent("MobilePhone co 1234567899");
  var url = "https://www2.pcrecruiter.net/rest/api/candidates/?SessionID=" + encodeURIComponent(sessionID) + "&Query=" + query + "&ResultsPerPage=100";
  
  var response = UrlFetchApp.fetch(url, options);
  // 先打印完整响应排查问题
  console.log("Full response: " + response.getContentText());
  
  if (response.getResponseCode() === 200) {
    var parsedResponse = JSON.parse(response.getContentText());
    console.log(parsedResponse);
  }
}

2. Session ID的上下文绑定 #

部分API的Session ID会与请求的源IP或请求上下文绑定。编辑器执行时请求出口为办公IP，触发器执行时为Google服务器IP，若API对Session ID的使用上下文有严格校验（比如要求创建和使用Session ID的请求来源一致），可能导致编辑器环境下的验证失败。

解决方法：
确保获取Session ID和调用/candidates端点时使用完全相同的请求头和执行上下文，避免因环境差异导致Session ID失效。

3. URL编码问题 #

编辑器执行时可能存在URL编码的细微差异，导致参数传递不符合API要求。使用encodeURIComponent对所有参数进行统一编码，避免潜在的编码错误。

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