Python SDK 使用方法

下载地址

AIRec Python SDK 的下载地址是：https://pypi.org/project/aliyun-python-sdk-airecSDK 源码地址：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==1.1.3

步骤4 开始使用SDK

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

1. 创建 Client。在创建 Client实例时，您需要获取 Region ID、AccessKey ID 和 AccessKey Secret。

2. 设置 Endpoint

3. 创建 Request 并设置参数。

4. 发起请求并处理应答或异常。

注意：推送的数据json格式详见：推送数据

#!/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('POST')
request.set_protocol_type('https') # https | http
request.set_domain('airec.cn-hangzhou.aliyuncs.com')
request.set_version('2018-10-12')

request.add_query_param('RegionId', "cn-hangzhou")
request.add_header('Content-Type', 'application/json')
request.set_uri_pattern('/openapi/instances/实例id/tables/推送数据的表名/actions/bulk')
body = '''{}'''
request.set_content(body.encode('utf-8'))

response = client.do_action_with_exception(request)

# python2:  print(response) 
print(str(response, encoding = 'utf-8'))

注意：获取推荐结果返回的参数说明，及常见报错详见：获取推荐结果

#!/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')


request.add_query_param('SceneId', "110110")
request.add_query_param('UserId', "123")
request.add_query_param('ReturnCount', "10")
request.add_header('Content-Type', 'application/json')
request.set_uri_pattern('/openapi/instances/实例id/actions/recommend')



response = client.do_action_with_exception(request)

# python2:  print(response) 
print(str(response, encoding = 'utf-8'))