1. Content tags 内容标签
EventLightning CDP
  • Content tags 内容标签
    • List or get content tags / 查询内容标签
      GET
    • Create or reuse content tag / 创建或复用内容标签
      POST
    • Update content tag / 更新内容标签
      PUT
    • Delete content tag / 删除内容标签
      DELETE
    • List or get content tag groups / 查询内容标签组
      GET
    • Create or reuse content tag group / 创建或复用内容标签组
      POST
  • Authentication 认证
    • Get access token / 获取访问令牌
      POST
  • Customers 客户
    • Get customer / 查询客户
      GET
    • Create or update customer / 创建或更新客户
      POST
  • Tags 标签
    • List or get tag groups / 查询标签组
      GET
    • Create or reuse tag group / 创建或复用标签组
      POST
    • List or get static tags / 查询静态标签
      GET
    • Create or reuse static tag / 创建或复用静态标签
      POST
    • Update static tag / 更新静态标签
      PUT
    • Delete static tag / 删除静态标签
      DELETE
  • Customer Tags 客户标签
    • Add customer tags / 添加客户标签
      POST
    • Remove customer tags / 移除客户标签
      POST
    • Query customer tags / 查询客户标签
      POST
  • Events 客户事件
    • 查询客户事件
      GET
    • Create customer event / 创建客户事件
      POST
  • Related Entities 关联实体
    • 查询关联实体
      GET
    • Create or update related entity / 创建或更新关联实体
      POST
  • Customer Segments 客户分群
    • Add customer segments / 添加客户群组
    • Remove customer segments / 移除客户群组
    • List or get segment groups / 查询客户分群组
    • Create or reuse segment group / 创建或复用客户分群组
    • Query customer segments / 查询客户群组
  • 数据模型
    • OAuthToken
    • OAuthError
    • SuccessEnvelope
    • AudienceGroupDetail
    • TagDetail
    • TagMembershipDetail
    • SegmentMembershipDetail
    • CustomerEventResponse
    • CodeResponse
    • CustomerDetailResponse
    • Identification
    • CustomerSaveResponse
    • DynamicBody
    • TagWrite
    • CustomerSelectors
    • AudienceGroupDetailResponse
    • CustomerTagQuery
    • AudienceGroupListResponse
    • CustomerTagChange
    • TagDetailResponse
    • CustomerSegmentQuery
    • TagListResponse
    • CustomerSegmentChange
    • CustomerTagMembershipResponse
    • CustomerTagChangeResponse
    • CustomerSegmentMembershipResponse
    • CustomerSegmentChangeResponse
    • RelatedEntityResponse
    • ErrorEnvelope
  1. Content tags 内容标签

Delete content tag / 删除内容标签

DELETE
/api/v1/content-tags
OAuth2 bearer authentication and the respective read/write permission are required; write does not imply read.
List and encoded-ID access follow the existing tag API scope. External-ID access requires an integration account and validates ownership, but not the account prefix.
external_name represents the canonical label. Different external IDs may share a name; global tags are not resolved or renamed by name.
On create an empty name defaults to external ID. For an existing external tag an empty name preserves its label; a non-empty name replaces it.
Content tag IDs are encoded strings and can be passed directly in customer-event content_tag_ids. Group IDs are encoded. Customer interactions originate from events, not direct summary writes.
A tag bound to content cannot be deleted; returns 400.
需要 OAuth2 Bearer token 和对应读 / 写权限;写不包含读。
读取列表和按系统 ID 访问沿用现有标签接口范围;按外部 ID 访问仍需集成账号并校验所属账号,但不校验账号前缀。
external_name 是标签名称的 API 表达,不另存一份名称。不同外部 ID 允许同名,不按名称合并全局标签。
创建时缺省名称使用外部 ID;复用已有外部标签时空名称保留原名,非空名称覆盖原名。
内容标签 ID 是编码字符串,可直接用于客户事件 content_tag_ids 数组;标签组 ID 为编码 ID。客户互动仍通过事件产生,不直接修改客户内容标签汇总。
绑定内容的标签不能删除,返回 400。
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 优先,提供时忽略外部字段。

请求参数

Query 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request DELETE '/api/v1/content-tags?content_tag_id=undefined&external_id=undefined'

返回响应

🟢200成功
application/json
Success
Bodyapplication/json

示例
{
    "code": 0,
    "message": "string",
    "data": {
        "content_tag_id": "string",
        "label": "string",
        "external_id": "string",
        "external_name": "string",
        "group_id": "string",
        "items": [
            {
                "content_tag_id": "string",
                "label": "string"
            }
        ],
        "last_id": "string"
    }
}
🟠400请求有误
🟠401没有权限
🟠403禁止访问
🔴500服务器错误
修改于 2026-09-21 09:29:23
上一页
Update content tag / 更新内容标签
下一页
List or get content tag groups / 查询内容标签组
Built with