手把手教你从零开始搭建Amazon Advertising-API开发环境(二)之获取SP广告数据

本文主要是介绍手把手教你从零开始搭建Amazon Advertising-API开发环境(二)之获取SP广告数据,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

1. 获取access_token

官方链接

1.1 请求路径 POST
地区URL
NAhttps://api.amazon.com/auth/o2/token
EUhttps://api.amazon.co.uk/auth/o2/token
FEhttps://api.amazon.co.jp/auth/o2/token
1.2 请求事例
curl \                                                                                                                                                            -X POST \    -H "Content-Type:application/x-www-form-urlencoded;charset=UTF-8" \    --data "grant_type=refresh_token&client_id=YOUR_CLIENT_ID&refresh_token=YOUR_REFRESH_TOKEN&client_secret=YOUR_CLIENT_SECRET" \    https://api.amazon.com/auth/o2/token
1.3 代码实操
 //获取access_token的方法,以NA地区为例。
HashMap<String, Object> map = new HashMap<>();
map.put("grant_type","refresh_token");            map.put("refresh_token","your refresh_token");
map.put("client_id","your client_id");
map.put("client_secret","your client_secret");
String getAccessUrl = "https://api.amazon.com/auth/o2/token";
String result = HttpUtil.doPost(getAccessUrl,map,null);
Map map1 = JSONObject.parseObject(result, Map.class);
String access_token = (String) map1.get("access_token");
System.out.println("access_token = " + access_token);

运行结果如下:

在这里插入图片描述

2. 获取profileId

官方连接

2.1 请求路径 GET
https://advertising-api.amazon.com/v2/profiles
2.2 请求参数
参数名称可能的值(string)
apiProgrambilling, campaign, paymentMethod, store, report, account, posts
accessLeveledit, view
profileTypeFilterseller, vendor, agency
validPaymentMethodFiltertrue, false

请求头:

keyvalue
Content-Typeapplication/json
Authorizationaccess_token
Amazon-Advertising-API-ClientIdyour client_id
2.3 代码实操
String url = "https://advertising-api.amazon.com/v2/profiles?apiProgram=billing&profileTypeFilter=seller&validPaymentMethodFilter=true";
HashMap<String, String> headerMap = new HashMap<>();
headerMap.put("Content-Type","application/json");
headerMap.put("Authorization","Bearer "+access_token);
headerMap.put("Amazon-Advertising-API-ClientId","your client_id");
String result1 = HttpUtil.doGet1(url,headerMap);
List<Map> profileIds = JSONObject.parseArray(result1, Map.class);
System.out.println("profileIds = " + profileIds);

运行结果如下:

在这里插入图片描述

3. 创建sp_campaign报表

官方链接

⚠️:此次官方文档的Responses有误,大家懂的都懂,已实际的Responses为主。

3.1 请求路径 POST
https://advertising-api.amazon.com/v2/sp/campaigns/report
3.2 请求参数

请求体参数:

keyValue
stateFilterenabled, paused, archived
campaignTypesponsoredProducts
segmentquery, placement
reportDateYYYYMMDD
metrics传入你想获取的值

请求头:

keyvalue
Content-Typeapplication/json
Amazon-Advertising-API-ClientIdyour client_id
Amazon-Advertising-API-ScopeprofileId(第二步获取的)
Authorizationaccess_token
3.3 代码实操
/**
*第二步获取的是个List,选择符合条件的进行操作,本次实操选择的是type=seller,profileId=xxxxxxxx,countryCode=CA
*/
String createSpReport = "https://advertising-api.amazon.com/v2/sp/campaigns/report";
//构造请求头
HashMap<String, String> headerMap1 = new HashMap<>();
headerMap1.put("Content-Type","application/json");
headerMap1.put("Amazon-Advertising-API-ClientId","your client_id");
headerMap1.put("Amazon-Advertising-API-Scope",profileId.toString());
headerMap1.put("Authorization","Bearer "+access_token);
//请求体的参数
HashMap<String, Object> paramMap = new HashMap<>();
//paramMap.put("stateFilter", "enabled");
//paramMap.put("campaignType","sponsoredProducts");
//paramMap.put("segment","query");
paramMap.put("reportDate","20210701");
paramMap.put("metrics","campaignName,campaignId,impressions,clicks,cost,attributedConversions14d,attributedSales14d");
String s2 = HttpUtil.doPostBody(createSpReport, JSONObject.toJSONString(paramMap),headerMap1);   
System.out.println("s2 = " + s2);

运行结果如下:

在这里插入图片描述

4.获取表报下载地址

4.1 请求路径 GET
https://advertising-api.amazon.com/v2/reports/{reportId}
4.2 请求参数

请求头:

keyvalue
Content-Typeapplication/json
Authorizationaccess_token
Amazon-Advertising-API-ClientIdyour client_id
Amazon-Advertising-API-ScopeprofileId
4.3 代码实操
/**当status=SUCCESS的时候说明报表创建好了,这时去获取下载URL
*/
String getSpReport = "https://advertising-api.amazon.com/v2/reports/"+reportId;
HashMap<String, String> header = new HashMap<>();
header.put("Content-Type","application/json");
header.put("Authorization","Bearer "+access_token);
header.put("Amazon-Advertising-API-ClientId","your client_id");
header.put("Amazon-Advertising-API-Scope",profileId.toString());
String report = HttpUtil.doGet1(getSpReport, header);
reportMap = JSONObject.parseObject(report, Map.class);
String downUrl = reportMap.get("location").toString();

运行结果如下:

在这里插入图片描述

5. 下载报表一

官方链接

官方文档只有在sd广告中才有下载的API

5.1 请求路径 GET

步骤4中获取的downUrl

5.2 请求参数

请求头参数:

keyvalue
Content-Typeapplication/json
Authorizationaccess_token
Amazon-Advertising-API-ClientIdyour client_id
Amazon-Advertising-API-ScopeprofileId
5.3 代码实操
/**
步骤4中获取downUrl并不是最终的下载地址,还需再一次请求获取。
*/
HashMap<String, String> headerMap2 = new HashMap<>();
headerMap2.put("Content-Type","application/json");
headerMap2.put("Authorization","Bearer "+access_token);
headerMap2.put("Amazon-Advertising-API-ClientId","your client_id");
headerMap2.put("Amazon-Advertising-API-Scope",profileId.toString());
CloseableHttpResponse response = HttpUtil.doGetReturnResponse(downUrl, headerMap2);
Header[] locations = response.getHeaders("Location");
System.out.println("locations = " + locations);

6.下载报表二

6.1 请求路径 GET

步骤5中获取的url

6.2 请求参数

请求头参数:

keyvalue
Accept-Encodinggzip
Acceptapplication/octet-stream
6.3 代码实操
HashMap<String, String> header = new HashMap<>();
header.put("Accept-Encoding","gzip");
header.put("Accept","application/octet-stream");
String s3 = HttpUtil.doGet3("url", header);
System.out.println("s3 = " + s3);

执行结果如下:

在这里插入图片描述

7.根据campaignId获取portfolioId

官方文档

由于步骤六中获取的信息里不包含portfolioId,所以继续获取portfolioId。

7.1 请求路径 GET
https://advertising-api.amazon.com/v2/sp/campaigns
7.2 请求参数

本次请求只传campaignIdFilter参数,

请求头参数:

keyvalue
Authorizationaccess_token
Amazon-Advertising-API-ClientIdyour client_id
Amazon-Advertising-API-ScopeprofileId
Content-Typeapplication/json
7.3 代码实操
/**campaignId_param为所有的campaignId以逗号拼接在一起
*/
String getPortfolioId_url = "https://advertising-api.amazon.com/v2/sp/campaigns?campaignIdFilter="+campaignId_param;
HashMap<String, String> headerMap3 = new HashMap<>();
headerMap3.put("Authorization","Bearer "+access_token);
headerMap3.put("Amazon-Advertising-API-ClientId","your client_id");
headerMap3.put("Amazon-Advertising-API-Scope",profileId.toString());
headerMap3.put("Content-Type","application/json");
String s4 = HttpUtil.doGet1(getPortfolioId_url, headerMap3);
System.out.println("获取的portfolioId = " + s4);

执行结果就不演示了。

7.4 根据portfolioId去获取portfolio信息

官方文档

7.5 请求路径
https://advertising-api.amazon.com/v2/portfolios
7.6 请求参数
nametype描述
portfolioIdstring检索具有指定 ID 的投资组合
portfolioNamestring检索具有指定名称的投资组合
portfolioStatestring检索具有指定状态的投资组合

请求头参数:

keyvalue
Authorizationaccess_token
Amazon-Advertising-API-ClientIdyour client_id
Amazon-Advertising-API-ScopeprofileId
Content-Typeapplication/json
7.7 代码实操
/**portfolioIdFilter是portfolioId以逗号拼接到一起的,但是一次最大拼接100个。
*/
String getPortfolios_url = "https://advertising-api.amazon.com/v2/portfolios?portfolioIdFilter="+portfolioIdFilter;
HashMap<String, String> headerMap4 = new HashMap<>();
headerMap4.put("Authorization","Bearer "+access_token);
headerMap4.put("Amazon-Advertising-API-ClientId","your client_id");
headerMap4.put("Amazon-Advertising-API-Scope",profileId.toString());
headerMap4.put("Content-Type","application/json");
String s5 = HttpUtil.doGet1(getPortfolios_url, headerMap4);
System.out.println("获取的portfolio = " + s5); 

执行结果就不演示了。

到此sp广告数据已获取到,处理数据保存到文件即可。

这篇关于手把手教你从零开始搭建Amazon Advertising-API开发环境(二)之获取SP广告数据的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/310781

相关文章

MyBatisPlus如何优化千万级数据的CRUD

《MyBatisPlus如何优化千万级数据的CRUD》最近负责的一个项目,数据库表量级破千万,每次执行CRUD都像走钢丝,稍有不慎就引起数据库报警,本文就结合这个项目的实战经验,聊聊MyBatisPl... 目录背景一、MyBATis Plus 简介二、千万级数据的挑战三、优化 CRUD 的关键策略1. 查

python实现对数据公钥加密与私钥解密

《python实现对数据公钥加密与私钥解密》这篇文章主要为大家详细介绍了如何使用python实现对数据公钥加密与私钥解密,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录公钥私钥的生成使用公钥加密使用私钥解密公钥私钥的生成这一部分,使用python生成公钥与私钥,然后保存在两个文

mysql中的数据目录用法及说明

《mysql中的数据目录用法及说明》:本文主要介绍mysql中的数据目录用法及说明,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录1、背景2、版本3、数据目录4、总结1、背景安装mysql之后,在安装目录下会有一个data目录,我们创建的数据库、创建的表、插入的

SQLite3 在嵌入式C环境中存储音频/视频文件的最优方案

《SQLite3在嵌入式C环境中存储音频/视频文件的最优方案》本文探讨了SQLite3在嵌入式C环境中存储音视频文件的优化方案,推荐采用文件路径存储结合元数据管理,兼顾效率与资源限制,小文件可使用B... 目录SQLite3 在嵌入式C环境中存储音频/视频文件的专业方案一、存储策略选择1. 直接存储 vs

MySQL 获取字符串长度及注意事项

《MySQL获取字符串长度及注意事项》本文通过实例代码给大家介绍MySQL获取字符串长度及注意事项,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧... 目录mysql 获取字符串长度详解 核心长度函数对比⚠️ 六大关键注意事项1. 字符编码决定字节长度2

Navicat数据表的数据添加,删除及使用sql完成数据的添加过程

《Navicat数据表的数据添加,删除及使用sql完成数据的添加过程》:本文主要介绍Navicat数据表的数据添加,删除及使用sql完成数据的添加过程,具有很好的参考价值,希望对大家有所帮助,如有... 目录Navicat数据表数据添加,删除及使用sql完成数据添加选中操作的表则出现如下界面,查看左下角从左

SpringBoot中4种数据水平分片策略

《SpringBoot中4种数据水平分片策略》数据水平分片作为一种水平扩展策略,通过将数据分散到多个物理节点上,有效解决了存储容量和性能瓶颈问题,下面小编就来和大家分享4种数据分片策略吧... 目录一、前言二、哈希分片2.1 原理2.2 SpringBoot实现2.3 优缺点分析2.4 适用场景三、范围分片

SpringBoot开发中十大常见陷阱深度解析与避坑指南

《SpringBoot开发中十大常见陷阱深度解析与避坑指南》在SpringBoot的开发过程中,即使是经验丰富的开发者也难免会遇到各种棘手的问题,本文将针对SpringBoot开发中十大常见的“坑... 目录引言一、配置总出错?是不是同时用了.properties和.yml?二、换个位置配置就失效?搞清楚加

python3如何找到字典的下标index、获取list中指定元素的位置索引

《python3如何找到字典的下标index、获取list中指定元素的位置索引》:本文主要介绍python3如何找到字典的下标index、获取list中指定元素的位置索引问题,具有很好的参考价值,... 目录enumerate()找到字典的下标 index获取list中指定元素的位置索引总结enumerat

Redis分片集群、数据读写规则问题小结

《Redis分片集群、数据读写规则问题小结》本文介绍了Redis分片集群的原理,通过数据分片和哈希槽机制解决单机内存限制与写瓶颈问题,实现分布式存储和高并发处理,但存在通信开销大、维护复杂及对事务支持... 目录一、分片集群解android决的问题二、分片集群图解 分片集群特征如何解决的上述问题?(与哨兵模