Shopify事件接口的created_at_min参数失效问题排查

你的代码存在几个关键问题，导致created_at_min参数失效或触发500错误，逐一说明并给出修正方案：

1. 错误的参数编码方式 #

你在attempt4、5中使用Utilities.base64encode()对时间参数编码，但URL查询参数需要的是URL编码而非Base64编码。Base64编码会将时间字符串转换为Shopify API无法识别的格式，直接导致参数无效。

2. 缺少必要的filter参数 #

你的attempt0通过filter=order限定获取订单相关事件，但后续尝试都移除了这个参数。如果不指定filter=order，事件接口会返回全类型店铺事件，数据量过大可能触发服务器错误，同时也会让created_at_min的过滤逻辑因范围过广出现异常。

3. 冗余的请求头配置 #

GET请求不需要设置Content-type: application/json，因为GET请求没有请求体，这个冗余配置可能干扰服务器对请求的解析。

4. 时间格式的规范处理 #

Shopify API要求created_at_min使用ISO 8601格式，推荐优先使用UTC时间（带Z后缀），或正确编码时区偏移符号：

• 时区偏移的减号-可直接使用，无需编码
• 时区偏移的加号+必须URL编码为%2B

修正后的代码示例 #

const key = '你的API密钥';
const pass = '你的API密码';
const storeUrl = '你的店铺域名';

const options = {
  headers: {
    'Authorization': 'Basic ' + Utilities.base64Encode(`${key}:${pass}`)
    // 移除多余的Content-Type头
  },
  method: 'GET',
  muteHttpExceptions: true // 启用后可获取服务器返回的具体错误信息，便于排查
};

// 方案1：使用UTC时间格式（推荐）
try {
  // 原时间2022-04-25T16:15:47-04:00 等价于UTC时间2022-04-25T20:15:47Z
  const url = `https://${storeUrl}.myshopify.com/admin/api/2023-01/events.json?filter=order&created_at_min=2022-04-25T20:15:47Z`;
  const response = UrlFetchApp.fetch(url, options);
  Logger.log(response.getContentText());
} catch (e) {
  Logger.log('请求失败');
  Logger.log(e.toString());
}

// 方案2：使用带时区偏移的正确编码格式
try {
  const url = `https://${storeUrl}.myshopify.com/admin/api/2023-01/events.json?filter=order&created_at_min=2022-04-25T16:15:47%2B04:00`;
  const response = UrlFetchApp.fetch(url, options);
  Logger.log(response.getContentText());
} catch (e) {
  Logger.log('请求失败');
  Logger.log(e.toString());
}

// 方案3：用Google Apps Script工具自动处理URL编码
try {
  const createdAtMin = Utilities.urlEncode('2022-04-25T16:15:47-04:00');
  const url = `https://${storeUrl}.myshopify.com/admin/api/2023-01/events.json?filter=order&created_at_min=${createdAtMin}`;
  const response = UrlFetchApp.fetch(url, options);
  Logger.log(response.getContentText());
} catch (e) {
  Logger.log('请求失败');
  Logger.log(e.toString());
}

额外排查点 #

• 确认你的API密钥拥有read_events权限，权限不足也会导致参数失效或错误
• 启用muteHttpExceptions: true后，可直接打印服务器返回的错误响应，能更精准定位问题

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