Create or reuse segment group / 创建或复用客户分群组

Purpose

Create or reuse a customer-segment group and optionally set its parent.

Execution logic

The request body must be a non-empty object and label must be present as a string.

Parent resolution gives parent_group_id precedence over parent_label. parent_group_id must decode to an existing customer-segment group. parent_label performs an exact label lookup within customer-segment groups.

Creation is serialized by group type and label. If a group with the same type and exact label exists, it is reused instead of duplicated.

The resolved parent is assigned to both new and reused groups. Therefore, supplying a different parent changes the existing group's parent; omitting both parent fields resolves to no parent and can clear an existing parent. The entity is saved only when it is new or the parent actually changes.

The response returns encoded group_id, label, encoded parent_group_id (0 for none), plus created and changed.

Errors and authorization

Malformed IDs, missing parents, parents of another group type, and invalid field types return a client error. Bearer authentication and this endpoint's REST permission are required.

中文说明

用途

创建或复用一个客户标签分组，并可设置其父分组。

执行逻辑

请求体必须是非空对象，且必须提供字符串类型的 label。

父分组解析时 parent_group_id 优先于 parent_label。parent_group_id 必须能解码并指向已存在的客户标签分组；parent_label 则在客户标签分组类型内按名称精确匹配。

创建过程按“分组类型 + 名称”串行化；相同类型、相同精确名称的分组已存在时会复用，不会重复创建。

解析出的父级会同时应用于新分组和复用分组。因此传入不同父级会修改已有分组的父级；两个父级字段都省略时会解析为无父级，并可能清除已有父级。只有新建或父级确实变化时才保存。

响应返回编码 group_id、label、编码 parent_group_id（无父级为 0），以及 created、changed。

错误与权限

ID 格式错误、父分组不存在、父分组类型不符或字段类型无效均返回客户端错误。接口需要 Bearer 认证及对应 REST 权限。

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Group saved / 标签组保存成功

Bodyapplication/json

示例

{
    "code": 200,
    "data": {
        "group_id": "string",
        "label": "string",
        "parent_group_id": "string",
        "created": 0,
        "changed": 0
    }
}

🟠400请求有误

🟠401没有权限

🟠403禁止访问

🔴500服务器错误

Create or reuse segment group / 创建或复用客户分群组

Purpose#

Execution logic#

Errors and authorization#

中文说明#

用途#

执行逻辑#

错误与权限#

请求参数