文档

CreateGroup - 创建人群

更新时间:

创建人群。

接口说明

在使用前需要在网页端一键授权 OSS 访问权限,并将需要访问的 OSS Bucket 添加 pai=plugin 的标签,请参考 OSS 添加标签

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求语法

POST /api/v2/groups

请求参数

名称类型必填描述示例值
bodyobject

请求参数的主体信息。

Algorithmstring

关联算法,人群来源为算法时需指定。

user_recall
Columnstring

手机号列名,人群来源为 CSV 文件,MaxCompute,并且包含手机号时需指定。

phone
Filterstring

过滤条件,人群来源为 MaxCompute 时可指定。

ds=20220101
InferenceJobIdstring

预测任务 ID,人群来源为算法。

0a54e195-03e2-40bd-869d-b71cb302783e
Namestring

人群名称。

VIP客户
PhoneNumberboolean

是否包含手机号,包含手机号的人群可用于触达计划。

true
Projectstring

MaxCompute(ODPS)项目名,人群来源为 MaxCompute 时需指定。

project
Remarkstring

人群备注。

充值大于10万
Sourceinteger

人群来源。

  • 0: 文本,每行一个手机号,最多 100 个。
  • 1: 文本文件,每行一个手机号,可通过控制台上传或指定自定义 OSS 地址,指定自定义 OSS 地址前需确保已在控制台完成一键授权。
  • 2: CSV 文件,需指定手机号列名,可通过控制台上传或指定自定义 OSS 地址,指定自定义 OSS 地址前需确保已在控制台完成一键授权。
  • 3: MaxCompute(ODPS)表,需指定手机号列名。
  • 4: 算法。
0
Tablestring

MaxCompute(ODPS)表名,人群来源为 MaxCompute 时需指定。

vip_recall
Textstring

文本,人群来源为文本时需指定。

1390000****
Uristring

文件地址,人群来源为文本文件,CSV 文件时需指定。

https://bucket.region.aliyuncs.com/folder/file

返回参数

名称类型描述示例值
object

成功发起注册人群请求,可通过控制台或 GetGroup 获取人群检查状态。

Dataobject

返回数据。

Algorithmstring

关联算法,人群来源为算法。

user_recall
Amountinteger

人群数量。

0
Columnstring

手机号列名,人群来源为 CSV 文件,MaxCompute,并且包含手机号时需指定。

phone
CreatedTimestring

创建时间 (UTC+8)。

2020-01-01 12:00:00
Filterstring

过滤条件,人群来源为 MaxCompute 时可指定。

ds=20220101
Idstring

人群 Id。

0a54e195-03e2-40bd-869d-b71cb302783e
InferenceJobIdstring

预测任务 Id,人群来源为算法。

0a54e195-03e2-40bd-869d-b71cb302783e
Namestring

人群名称。

VIP客户
PhoneNumberboolean

是否包含手机号,包含手机号的人群可用于触达计划。

1390000****
Projectstring

MaxCompute(ODPS)项目名,人群来源为 MaxCompute 时需指定。

project
Remarkstring

人群备注。

充值大于10万
Sourceinteger

人群来源。

  • 0: 文本,每行一个手机号,最多 100 个。
  • 1: 文本文件,每行一个手机号,可通过控制台上传或指定自定义 OSS 地址,指定自定义 OSS 地址前需确保已在控制台完成一键授权。
  • 2: CSV 文件,需指定手机号列名,可通过控制台上传或指定自定义 OSS 地址,指定自定义 OSS 地址前需确保已在控制台完成一键授权。
  • 3: MaxCompute(ODPS)表,需指定手机号列名。
  • 4: 算法。
0
Statusinteger

人群状态。

  • 0: 检查中。
  • 1: 已通过。
  • 2: 未通过。
0
Tablestring

MaxCompute(ODPS)表名,人群来源为 MaxCompute 时需指定。

recall
Textstring

文本,人群来源为文本时需指定。

1390000****
UpdatedTimestring

更新时间 (UTC+8)。

2020-01-01 12:00:00
Uristring

文件地址,人群来源为文本文件,CSV 文件时需指定。

https://bucket.region.aliyuncs.com/folder/file
ErrorCodeinteger

错误码。

0
ErrorMessagestring

错误信息。

OK
RequestIdstring

请求 ID。

f8651828-609d-4de8-ab49-ab781d7fd85a

示例

正常返回示例

JSON格式

{
  "Data": {
    "Algorithm": "user_recall",
    "Amount": 0,
    "Column": "phone",
    "CreatedTime": "2020-01-01 12:00:00",
    "Filter": "ds=20220101",
    "Id": "0a54e195-03e2-40bd-869d-b71cb302783e",
    "InferenceJobId": "0a54e195-03e2-40bd-869d-b71cb302783e",
    "Name": "VIP客户",
    "PhoneNumber": true,
    "Project": "project",
    "Remark": "充值大于10万",
    "Source": 0,
    "Status": 0,
    "Table": "recall",
    "Text": "1390000****",
    "UpdatedTime": "2020-01-01 12:00:00",
    "Uri": "https://bucket.region.aliyuncs.com/folder/file"
  },
  "ErrorCode": 0,
  "ErrorMessage": "OK",
  "RequestId": "f8651828-609d-4de8-ab49-ab781d7fd85a"
}

错误码

访问错误中心查看更多错误码。

  • 本页导读 (1)
文档反馈