查询会员分群详情

GET 
/openapi/2026-07/loyalty/member-groups/:member_group_id

查询指定会员分群的详细信息

请求

Path参数

member_group_id string必填

URL 路径中的分群 ID

Query参数

cursor string

会员名单分页游标

limit int32

会员名单每页条数

响应

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[]
members object
会员分群详情里的会员名单分页块
items object[]
Array [
member_idstring
会员唯一 ID
emailstring
会员邮箱
phonestring
会员手机号
first_namestring
会员名
last_namestring
会员姓
current_tier_namestring
当前等级名称
created_atstring
注册时间,ISO-8601
transactions_amountstring
累计消费金额,decimal 字符串
birthdaystring
会员生日,未设置时为空字符串
statusstring
会员状态:active / inactive / ...
tagsstring[]
会员标签
activated_atstring
会员激活时间,ISO-8601;未激活时为空
first_order_atstring
首单时间,ISO-8601;无单时为空
]
next_cursorstring
has_moreboolean
limitint32

示例

{
  "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
      ]
    },
    "members": {
      "items": [
        {
          "member_id": "string",
          "email": "string",
          "phone": "string",
          "first_name": "string",
          "last_name": "string",
          "current_tier_name": "string",
          "created_at": "string",
          "transactions_amount": "string",
          "birthday": "string",
          "status": "string",
          "tags": [
            "string"
          ],
          "activated_at": "string",
          "first_order_at": "string"
        }
      ],
      "next_cursor": "string",
      "has_more": true,
      "limit": 0
    }
  }
}