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'))