使用Amazon Selling Partner API /sales/v1/orderMetrics仅返回时间戳无订单指标

问题概述 #

使用Amazon Selling Partner API的/sales/v1/orderMetrics端点获取指定时间区间的聚合订单指标，请求参数如下：

• 请求方法：GET
• 参数：
  • marketplaceIds=ATVPDKIKX0DER（美国站点）
  • interval=2024-03-03T00:00:00-07:00--2024-03-09T00:00:00-07:00
  • granularity=Total
  • firstDayOfWeek=Monday

预期返回包含总订单数、总销量、总销售额等指标的JSON对象，但实际仅返回：

{"timestamp": "2024-03-23T06:26:32.032Z"}

可能的原因及解决方法 #

• 权限不足：该端点需要SalesAndTrafficReports权限。检查SP API应用是否已申请并获得此权限，同时确认当前使用的认证令牌包含该权限范围。权限缺失时，API会仅返回timestamp字段。
• 数据延迟或区间无数据：Amazon订单指标存在24-48小时的数据延迟，若请求区间过于接近当前时间可能无数据返回；另外需确认指定区间内该账号在美国站确实有订单产生，无订单时API仅返回timestamp。
• 认证有效性问题：检查请求使用的访问令牌是否过期，或令牌关联的角色是否拥有对应站点的访问权限。令牌失效但通过基础认证时，可能导致响应不完整。
• 参数细节问题：再次确认interval的时区是否正确，以及granularity=Total是否与其他参数兼容（此参数本身无需额外搭配粒度参数，但需确保marketplaceIds对应的站点正确）。

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