跳至主内容

获取推荐配置

使用此方法获取特定推荐适用的行为配置信息。

参数

名称

描述

包含在请求中

类型

取值

companyId

目标推荐所属公司的ID。

可选

注意

当针对其他公司的推荐时为必填项。

字符串

必须是您拥有管理权限的有效公司ID。

默认值:与请求所用API密钥关联的公司ID。

objectId

您想获取行为画像的推荐ID。

必填

字符串

必须是有效的推荐ID。

这些是公共API方法通用的参数。

参数

描述

包含于请求中

类型

取值

id

该参数为请求添加标识符,使其与对应响应关联。

目标响应中会返回相同值,便于调用追踪。

必填

字符串

无额外要求

method

发送请求时所用方法的名称。

必填

字符串

必须是有效的方法名。

jsonrpc

请求与响应所使用的JSON-RPC版本。

必填

整数

可选值:

  • 2.0

params

包含请求配置的对象。

必填

对象

无额外要求。

params 对象下

page

结果页码。

可选

整数

默认值: 1

每页条数

每页显示的搜索结果数量。

可选

整数

每页上限为100条。

默认值: 30

返回值

属性

类型

说明

条目

对象数组

每个对象包含行为画像的相关信息。

对象

条目

属性

类型

说明

推荐ID

字符串

适用于此行为画像的推荐标识符。

行为画像资源

字符串

属于行为画像的资源标识符。

行为画像资源名称

字符串

属于行为配置文件的资源名称。

行为配置文件身份标识

字符串

属于行为配置文件的身份标识ID。

行为配置文件身份名称

字符串

属于行为配置文件的身份名称。

示例

请求 :

{
  "params": {
    "page": 1,
    "perPage": 20,
    "objectId": "123abc123abc123abc123abc",
    "companyId": "456def456def456def456def",
    "search": "字体驱动主机"
  },
  "jsonrpc": "2.0",
  "method": "getRecommendationProfiles",
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

响应 :

{
  "total": 9,
  "page": 1,
  "perPage": 20,
  "pagesCount": 1,
  "items": [
    {
      "recommendationId": "123abc123abc123abc123abc",
      "behavioralProfileResource": "00000000-0000-0000-0000-100000000001",
      "behavioralProfileResourceName": "WIN10-模板",
      "behavioralProfileIdentity": "Local_S-1-5-96-0-0_683ebe0d21ee239251adc088",
      "behavioralProfileIdentityName": "字体驱动主机\\UMFD-0"
    },
    {
      "recommendationId": "123abc123abc123abc123abc",
      "behavioralProfileResource": "00000000-0000-0000-0000-100000000001",
      "behavioralProfileResourceName": "WIN10-模板",
      "behavioralProfileIdentity": "Local_S-1-5-96-0-1_683ebe0d21ee239251adc088",
      "behavioralProfileIdentityName": "字体驱动主机\\UMFD-1"
    },
    {
      "recommendationId": "123abc123abc123abc123abc",
      "behavioralProfileResource": "00000000-0000-0000-0000-100000000001",
      "behavioralProfileResourceName": "WIN10-模板",
      "behavioralProfileIdentity": "Local_S-1-5-96-0-2_683ebe0d21ee239251adc088",
      "behavioralProfileIdentityName": "字体驱动主机\\UMFD-2"
    }
  ]
}