创建会员分群

POST 
/openapi/2026-07/loyalty/member-groups

创建一个新的会员分群，用于定向运营

请求

application/json

请求体

请求体必填

namestring必填

分群名称

idempotency_keystring

可选幂等键

member_condition object必填
会员筛选条件
keystring
operatorstring
valueGoogleProtobufValue
Represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values.
extra object
会员条件附加配置(时间窗口、分类、商品、地区)
time_rangestring
时间窗口:all / 7d / 30d
categories object[]
指定分类,二维数组 [["a","a-1"],["b"]]
Array [
valuesGoogleProtobufValue[]
]
product_idsstring[]
指定商品 id 列表
country_and_province object
国家+地区:key=国家码,value=地区码列表(["ALL"] 表示整国)
property name* ListValue
valuesGoogleProtobufValue[]
relationstring
childrenundefined[]

示例

{
  "name": "string",
  "idempotency_key": "string",
  "member_condition": {
    "key": "string",
    "operator": "string",
    "extra": {
      "time_range": "string",
      "categories": [
        {
          "values": [
            null
          ]
        }
      ],
      "product_ids": [
        "string"
      ],
      "country_and_province": {}
    },
    "relation": "string",
    "children": [
      null
    ]
  }
}

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object
创建会员分群响应
member_group_idstring
namestring
is_real_timeboolean
member_countint64
created_atstring
updated_atstring
member_condition object
会员筛选条件表达式(递归树)
keystring
operatorstring
valueGoogleProtobufValue
Represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values.
extra object
会员条件附加配置(时间窗口、分类、商品、地区)
time_rangestring
时间窗口:all / 7d / 30d
categories object[]
指定分类,二维数组 [["a","a-1"],["b"]]
Array [
valuesGoogleProtobufValue[]
]
product_idsstring[]
指定商品 id 列表
country_and_province object
国家+地区:key=国家码,value=地区码列表(["ALL"] 表示整国)
property name* ListValue
valuesGoogleProtobufValue[]
relationstring
childrenundefined[]

示例

{
  "code": "string",
  "message": "string",
  "data": {
    "member_group_id": "string",
    "name": "string",
    "is_real_time": true,
    "member_count": 0,
    "created_at": "string",
    "updated_at": "string",
    "member_condition": {
      "key": "string",
      "operator": "string",
      "extra": {
        "time_range": "string",
        "categories": [
          {
            "values": [
              null
            ]
          }
        ],
        "product_ids": [
          "string"
        ],
        "country_and_province": {}
      },
      "relation": "string",
      "children": [
        null
      ]
    }
  }
}