标签用于描述支付宝用户的各种特征,包括自定义标签(开发者自主创建维护的标签)与通用标签(支付宝给每个用户指定的标签,如性别、职业等),生活号开发者可以通过标签管理相关接口创建、修改、删除自定义标签,也可以批量给用户添加标签值或者删除标签值,每个支付宝用户对应每个标签最多只有一个标签值,通过自定义标签,开发者可以预先将与自己相关的用户打上各种标签值,来进行后续的个性化操作,如个性化菜单展示、个性化扩展区展示、用户分组创建等。
生活号提供的标签管理接口如下:
接口英文名 | 接口中文名 | API文档 |
---|---|---|
alipay.open.public.life.label.create |
创建标签接口 |
|
alipay.open.public.life.label.modify |
修改标签接口 |
|
alipay.open.public.life.label.delete |
删除标签接口 |
|
alipay.open.public.life.label.batchquery |
标签批量查询接口 |
|
alipay.open.public.matchuser.label.create |
用户打标接口 |
|
alipay.open.public.matchuser.label.delete |
用户取消标签接口 |
注意:
1. 每个生活号可以创建100个自定义标签。
2. 每个用户每个标签只能打一个标签值,重复打标时最新的标签值会覆盖之前的标签值。
3. 批量打标和取消标签每次最多操作10个匹配用户。