Add customer tags / 添加客户标签

Add customer tag memberships / 添加客户标签关系。

Additions are queued per customer. HTTP 200 means accepted, not completed. / 按客户加入保存队列，HTTP 200 表示已接受，不表示写入已完成。

Use customer_ids and/or customer_identifications; combined limit 20 per selector object. At least one customer must resolve. / 使用 customer_ids 和/或 customer_identifications，每个选择对象合计最多 20 项，至少解析到一个客户。

Request body is an array, at most 200 items. Each item uses tag_id (singular), not tag_ids. / 请求体为数组，最多 200 项；每项填写单个 tag_id，不是 tag_ids。

Bearer authentication and the existing REST permission are required. External IDs are supported on this create endpoint. / 需要 Bearer 认证及现有 REST 权限；本添加接口支持外部 ID。

[
  {
    "tag_id": "{{tag_id}}",
    "customer_ids": [
      "{{customer_id}}"
    ]
  }
]

Empty batches are rejected with HTTP 400. / 空批次返回 HTTP 400。

Provide either the system ID or external_id. A supplied system ID always wins, including when invalid (no fallback). External IDs are unique within each domain and owned by the integration account; another account cannot rename/reuse them. Nonblank external_name overwrites the owned name, blank preserves it or defaults to external_id on creation. Different external IDs may share names; never merge by name. Name-based lookups exclude externally identified audiences. External metadata is resolved transactionally before memberships enter the existing per-customer queue; queue failures can leave the metadata for an idempotent retry. Query/delete keep their existing system-ID contracts.

提供系统 ID 或 external_id；只要提供系统 ID 就优先使用，无效时也不回退。外部 ID 在标签、群组各自领域内唯一并归属接口账号；其他账号不能复用或改名。external_name 非空覆盖所属对象名称，空值保留已有名称或在新建时使用 external_id。不同外部 ID 允许同名，不按名称合并；按名称查找时排除有外部 ID 的对象。外部元数据事务完成后才进入现有按客户添加队列；队列失败时元数据可能保留，重试会复用。查询、删除仍使用原系统 ID 参数。

Required operation permission: restful post el_cdp_api_customer_tags_resource. Read and write are independent even though all requests use POST. / 本操作权限：restful post el_cdp_api_customer_tags_resource。虽然请求均为 POST，但查询检查读权限，添加／移除检查写权限，写不隐含读。

Creating or actually renaming an external audience additionally requires Tag/Segment management write permission; unchanged reuse does not. Denial returns HTTP 403 before membership writes. / 外部 ID 自动创建对象或实际改名，还须具备标签／群组管理写权限；原名或空名称复用已有对象不需要该权限。无权限返回 403，成员关系不写入。

external_id requires no account prefix; it must be a nonblank string of at most 250 characters. An integration account and the endpoint permissions are still required, and ownership is checked. External IDs remain unique within each domain and cannot be reused by another account. System IDs take precedence and external fields are ignored when supplied.

external_id 不要求账号前缀；必须是非空白字符串，最多 250 字符。仍需集成账号及对应接口权限，并检查对象归属；同一领域内外部 ID 唯一，其他账号不能复用。系统 ID 优先，提供时忽略外部字段。

application/json

Additions are queued per customer. HTTP 200 means accepted, not completed. / 按客户加入保存队列，HTTP 200 表示已接受，不表示写入已完成。

Bodyapplication/json

示例

{
    "code": 200,
    "data": [
        {
            "tag_id": "string",
            "customer_ids": [
                "string"
            ]
        }
    ]
}

Add customer tags / 添加客户标签

请求参数

请求示例代码

返回响应