亚马逊 /reports/2021-06-30/reports reportType=GET_BRAND_ANALYTICS_SEARCH_TERMS_REPORT bug记录/补充

建议在对接的时候, 优先查看亚马逊接口文档, 以及大佬们的文章

sp-api: 

Selling Partner API (amazon.com)

本人在对接亚马逊的时候 参考了以下大佬的文章, 使用的是 sdk对接, 使用测试类测试即可

地址: 对接亚马逊 SP-API(Amazon Selling Partner API) 第五章：Reports 模块_sp-api unauthorized_XERXES SEVEN的博客-CSDN博客bug1: 

这里的问题不仅是这个地区是否正确 例如: 错误的填写 eu-west-1ooxx 也会提示这个错误

正确的对应关系应该是: 

参考: 

SP-API Endpoints (amazon.com)

Endpoint 需要与 AWS region 正确对应

bug:2

processingStatus: FATAL

在获取报告的时候 返回报告状态是 FATAL 您就需要注意检查您的参数是否正确了

参考:

Verify that the report processing is complete (amazon.com)

大致意思是 生成报告出问题了, 返回一个 reportDocumentId 可以继续下载 里面的内容是 这次报告出问题的原因

本人在进行测试请求的时候遇到不少这个状态  FATAL ( 以下问题都是基于 报告类型为 GET_BRAND_ANALYTICS_SEARCH_TERMS_REPORT 的)

1. marketplaceIds 参数一定只能是一个, eg:  ATVPDKIKX0DER (us) 

        补充: 不同类型的报告 marketplaceIds 可传入多个 或者 只能是 单个

2. reportOptions 参数 是必填的 表示一个时间的范围

        参考: 

        Report Type Values (amazon.com)

 并且 起止时间要符合 reportOptions 填写的参数, 而且需要考虑时区的问题( 本人猜测是 )

 bug3 ( 补充 ):

此链接就是 报告下载链接, 显示内容是 本人在测试时候 返回的错误

可以使用 postman 直接进行下载文件, 注意文件的后缀名 得是 .gz 结尾, 不是的话需要手动修改一下

然后正常解压 查看里面的 错误描述即可 ( 可能有更方便更快的方法, 但是本人使用了最笨的方法 )

总结: 一定需要仔细的查看接口文档以及大佬们的文章, 本人就是因为细节的原因导致测试多次失败

存在的疑问: 

1. 有一个 roleSessionName 暂时还不知道是 干什么用的 

本人会持续更新 对接亚马逊中遇到的问题, 希望大家可以互相讨论遇到的问题, 以及心得, 可以私信或者在评论区 进行各种问题的探讨