一桑包、前言
主要步驟:
1、注冊淘寶聯(lián)盟和淘寶開放平臺賬號
2纺非、申請推廣位PID
3哑了、申請App Key和App Secret
4藏斩、下載SDK
淘寶聯(lián)盟的官方文檔钓账,其中頁面版本是老的,新版本的請按照我這邊截圖的步驟
https://aff-open.taobao.com/?spm=a219a.13922336.0.0.373c24adbNEN6A#/document
二、注冊賬號
首先在沒有對接api前需要去注冊一個阿里幾個平臺的賬號倒信,也可以直接用個人/企業(yè) 淘寶賬號直接登錄。
- 1.淘寶聯(lián)盟: https://pub.alimama.com/
- 2.淘寶開放平臺: http://open.taobao.com/
三泳梆、申請推廣位PID
1鳖悠、登錄進淘寶聯(lián)盟: https://pub.alimama.com/榜掌,然后點進入后臺
2、選擇“推廣管理”->"媒體備案管理" -> "新增媒體備案"
3乘综、選擇 "地方平臺"-> "社交平臺"-> "點擊下一步"
4憎账、填寫相關(guān)信息,點擊下一步
5卡辰、然后選擇“推廣管理”->"推廣位管理" -> "新增推廣位"
6胞皱、選擇上面創(chuàng)建的媒體,成功后會返回PID信息
注:淘寶客pid組成介紹:pid=mm_1_2_3(其中1/2/3分別代表一串?dāng)?shù)字九妈,舉例pid=mm_98836808_12970065_68140878)
說明:
- 1反砌、其中1這串?dāng)?shù)字對應(yīng)淘寶客的賬戶id(通常稱member);
- 2萌朱、這串?dāng)?shù)字對應(yīng)媒體管理中備案的網(wǎng)站或APP(統(tǒng)稱site宴树,包含網(wǎng)站ID、APPID)晶疼;
- 3酒贬、這串?dāng)?shù)字對應(yīng)網(wǎng)站或APP中的具體推廣位(通常稱adzone)。
- 4翠霍、每一個網(wǎng)站(網(wǎng)站ID)或APP(APPID)锭吨,均可申請自己的appkey,供對應(yīng)網(wǎng)站/APP使用寒匙,調(diào)用api時系統(tǒng)會校驗是否應(yīng)用于對應(yīng)網(wǎng)站ID或APPID耐齐。如果appkey不匹配或傳遞參數(shù)錯誤,會不算淘客交易蒋情,切記!
四埠况、申請App Key和App Secret
1、登錄淘寶開放平臺: http://open.taobao.com/ 棵癣,進入 "控制臺"
2辕翰、點擊 "應(yīng)用管理"->"新建應(yīng)用"
3、選擇 "其他"狈谊,狀態(tài)為可申請的才能創(chuàng)建應(yīng)用喜命,創(chuàng)建好后會生成App Key和App Secret
4、創(chuàng)建好應(yīng)用后河劝,要發(fā)布上線和申請?zhí)詫毧虯PI權(quán)限壁榕,按照提示操作就可以了
獲取的淘寶客權(quán)限能力參考這篇:https://tbk.bbs.taobao.com/detail.html?appId=45301&postId=8127005
目前根據(jù)個人權(quán)限只有如下紅框里的有用,有權(quán)限的只有淘口令
四赎瞎、編碼準(zhǔn)備
1牌里、文檔查看和接口測試
- 文檔地址:https://open.taobao.com/api.htm?docId=24515&docType=2
- 接口測試:https://open.taobao.com/docV3.htm?spm=a219a.7386653.0.0.c7f4669au8AY1t&docId=1&docType=15
2、接口請求參數(shù)
- 主要是淘寶聯(lián)盟里申請到的推廣位PID和淘寶開放平臺的App Key、App Secret為主
- 淘寶聯(lián)盟https://pub.alimama.com/牡辽,推廣位PID查看:
進入推廣管理->推廣資源管理->推廣位管理喳篇,下面列表的pid中類似是mm_260870060_224000411_63877050230的字符串,adzone_id就是在_最后的那個态辛,260870060淘寶聯(lián)盟賬戶id麸澜,224000411推廣媒體id(是網(wǎng)站還是app,是安卓亦是蘋果)奏黑,63877050230推廣位id炊邦。
- 淘寶開放平臺http://open.taobao.com/,App Key和App Secret查看:
進入應(yīng)用管理->管理
3熟史、SDK下載铣耘,按照鏈接里的操作
https://aff-open.taobao.com/?spm=a219a.13922336.0.0.373c24adbNEN6A#/document
注意:
其中官方提供的Python是2.x版本的,Python3.x的版本github里有 github地址:https://github.com/makelove/Taobao_topsdk/tree/master/%E6%B5%8B%E8%AF%95
4以故、下載完后導(dǎo)入的自己的IDE工程里
淘寶客API主要在top文件夾里蜗细,demo文件夾是我手工創(chuàng)建的這里面的程序需要自己寫
5、舉一個列子
1怒详、創(chuàng)建config.py文件炉媒,主要放自己上面申請到的參數(shù):推廣位PID、App Key和App Secret
# -*- coding: utf-8 -*-
"""
config.py:
"""
#設(shè)置為你的key
appkey = "31673409"
secret = "c37551da4950a87bee6a3342442bffbd"
pid = 110950050487#110944334285 # mm_123_456_274398347498 #最后一位
2昆烁、調(diào)用淘寶客API
比如我調(diào)用的是taobao.tbk.item.info.get這個接口吊骤,請求參數(shù)和返回參數(shù)請查看接口文檔
https://open.taobao.com/api.htm?docId=24515&docType=2
# -*- coding: utf-8 -*-
# 接口地址:https://open.taobao.com/api.htm?docId=24518&docType=2&scopeId=16189
import sys
sys.path.append("..")
from config import appkey, secret
from pprint import pprint
from top.api import TbkItemInfoGetRequest
from top import appinfo
req = TbkItemInfoGetRequest()
req.set_app_info(appinfo(appkey, secret))
req.platform = 2 # 鏈接形式:1:PC,2:無線静尼,默認(rèn):1
#需要帶入?yún)?shù)
req.num_iids = "562383397584" #商品ID
try:
resp = req.getResponse()
it = resp['tbk_item_info_get_response']['results']['n_tbk_item'][0]
info=u'''店鋪名稱:%s
30天銷量:%s
商品標(biāo)價:%s
商品鏈接:%s
'''%(it['nick'],it['volume'],it['zk_final_price'],it['item_url'])
print(info)
pprint(it)
# ds = json.dumps(resp)
# print(ds)
except Exception as e:
print(e)
3白粉、返回效果
店鋪名稱:資生堂集團海外旗艦店
30天銷量:3082
商品標(biāo)價:90
商品鏈接:https://detail.tmall.hk/hk/item.htm?id=562383397584
接口返回的報文,我們需要提取里面有用的字段信息:
{u'cat_leaf_name': u'\u6d17\u53d1\u6c34',
u'cat_name': u'\u7f8e\u53d1\u62a4\u53d1/\u5047\u53d1',
u'free_shipment': True,
u'item_url': u'https://detail.tmall.hk/hk/item.htm?id=562383397584',
u'ju_online_end_time': u'0',
u'ju_online_start_time': u'0',
u'ju_pre_show_end_time': u'0',
u'ju_pre_show_start_time': u'0',
u'material_lib_type': u'1',
u'nick': u'\u8d44\u751f\u5802\u96c6\u56e2\u6d77\u5916\u65d7\u8230\u5e97',
u'num_iid': 562383397584L,
u'pict_url': u'https://img.alicdn.com/bao/uploaded/i1/2735822823/O1CN01Qbl5FC1Wiyj5MwPEV_!!0-item_pic.jpg',
u'presale_deposit': u'0',
u'presale_end_time': 0,
u'presale_start_time': 0,
u'presale_tail_end_time': 0,
u'presale_tail_start_time': 0,
u'provcity': u'\u65e5\u672c',
u'reserve_price': u'118',
u'seller_id': 2735822823L,
u'small_images': {u'string': [u'https://img.alicdn.com/i1/2735822823/TB2aFnGi6nD8KJjSspbXXbbEXXa_!!2735822823.jpg',
u'https://img.alicdn.com/i3/2735822823/O1CN01NoerEw1WiyfLWt5HL_!!2735822823.jpg',
u'https://img.alicdn.com/i2/2735822823/O1CN011WiyYNyMVt79F35_!!2735822823.jpg']},
u'superior_brand': u'0',
u'title': u'\u8d44\u751f\u5802FINO\u7f8e\u5bb9\u590d\u5408\u7cbe\u534e\u6d17\u53d1\u6c34\u6ecb\u6da6\u578b550mL \u4fee\u62a4\u67d3\u70eb\u53d7\u635f\u53d1\u8d28\u8fdb\u53e3',
u'tmall_play_activity_end_time': 0,
u'tmall_play_activity_start_time': 0,
u'user_type': 1,
u'volume': 3082,
u'zk_final_price': u'90'}