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.需要 OAuth2 Bearer token 和对应读 / 写权限;写不包含读。读取列表和按系统 ID 访问沿用现有标签接口范围;按外部 ID 访问仍需集成账号并校验所属账号,但不校验账号前缀。external_name 是标签名称的 API 表达,不另存一份名称。不同外部 ID 允许同名,不按名称合并全局标签。创建时缺省名称使用外部 ID;复用已有外部标签时空名称保留原名,非空名称覆盖原名。内容标签 ID 是编码字符串,可直接用于客户事件 content_tag_ids 数组;标签组 ID 为编码 ID。客户互动仍通过事件产生,不直接修改客户内容标签汇总。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 优先,提供时忽略外部字段。