Python SDK 使用方法

下载地址

AIRec Python SDK 的下载地址是：https://pypi.org/project/aliyun-python-sdk-airec
SDK 源码地址：https://github.com/aliyun/aliyun-openapi-python-sdk/tree/master/aliyun-python-sdk-airec

使用步骤

为快速开始使用 AIRec Python SDK，请按照如下步骤进行。

步骤1 创建阿里云账号

具体方法请参考 阿里云账号注册流程。
为了更好地使用阿里云服务，建议尽快完成实名认证，否则部分阿里云服务将无法使用。

步骤2 获取阿里云访问密钥

为了使用 AIRec Python SDK，您必须申请阿里云的 访问秘钥。

登录阿里云 秘钥管理页面 。选择一对用于 SDK 的访问密钥对。如果没有，请创建一对新访问密钥，且保证它处于启用状态。有关如何创建访问密钥，参见 准备流程。

步骤3 安装阿里云 Python SDK

完成以下操作安装 Python SDK：

1. 安装 SDK 核心库

   • 如果您使用 Python 2.x，执行以下命令，安装阿里云SDK核心库：

     pip install aliyun-python-sdk-core

   • 如果您使用 Python 3.x，执行以下命令，安装阿里云SDK核心库：

     pip install aliyun-python-sdk-core-v3

2. 安装云产品 AIRec 的 SDK

执行以下命令，安装 AIRec 的 SDK

pip install aliyun-python-sdk-airec

步骤4 开始使用SDK

使用阿里云Python SDK的3个主要步骤：

1. 创建 Client。在创建 Client实例时，您需要获取 Region ID、AccessKey ID 和 AccessKey Secret。
2. 设置 Endpoint
3. 创建 Request 并设置参数。
4. 发起请求并处理应答或异常。

推送数据示例代码

#!/usr/bin/python
# coding=utf-8
from aliyunsdkcore.client import AcsClient
from aliyunsdkcore.acs_exception.exceptions import ClientException
from aliyunsdkcore.acs_exception.exceptions import ServerException
from aliyunsdkairec.request.v20181012.PushDocumentRequest import PushDocumentRequest
# 创建 AcsClient 实例
client = AcsClient(
    ak="阿里key",
    secret="阿里secret",
    #输入你的region地区：如果是北京则填cn-beijing
    region_id="cn-hangzhou"
)
# 设置 Endpoint
# 传入 RegionId、roduct 名称、服务接入地址
client.add_endpoint("cn-hangzhou", "Airec", "airec.cn-hangzhou.aliyuncs.com")
# 创建 Request，并设置参数
# 创建一个对应方法的 Request，类的命名规则一般为 API 的方法名加上 Request。
# 如获推送文档的 API 方法名为 PushDocument，那么对应的请求类名就是 PushDocumentRequest
request = PushDocumentRequest()
request.set_InstanceId("实例id")
request.set_TableName("item")
# 设置 Request的参数
content = "json数据"
request.set_content(content)
request.set_content_type("application/json")
# 使用 Client 对应的方法传入 Request，获得 Response 和处理异常。
try:
    response = client.do_action_with_exception(request)
    print(response)
except ClientException as e:
    print(e)
except ServerException as e:
    print(e)

获取推荐结果示例代码

#!/usr/bin/env python
#coding=utf-8
#获取推荐结果
from aliyunsdkcore.client import AcsClient
from aliyunsdkcore.request import CommonRequest
client = AcsClient('<accessKeyId>', '<accessSecret>', 'cn-hangzhou')
request = CommonRequest()
request.set_accept_format('json')
request.set_method('GET')
request.set_protocol_type('https') # https | http
request.set_domain('airec.cn-hangzhou.aliyuncs.com')
request.set_version('2018-10-12')
#场景id、returncount是必填的。userid/imei必须填其中一个
request.add_query_param('ReturnCount', "2")
request.add_query_param('UserId', "输入用户id")
request.add_query_param('SceneId', "输入场景id")
request.add_query_param('Imei', "输入设备号")
request.add_header('Content-Type', 'application/json')
request.set_uri_pattern('/openapi/instances/[InstanceId]/actions/recommend')
body = '''{}'''
request.set_content(body.encode('utf-8'))
response = client.do_action_with_exception(request)
# python2:  print(response) 
print(str(response, encoding = 'utf-8'))