添加企业标签 - 小裂变-开放平台

注意:
1、如果要向指定的标签组下添加标签，需要填写groupId参数。
2、如果要创建一个全新的标签组以及标签，则需要通过groupName参数指定新标签组名称。
3、如果填写的groupName已经存在，则会在此标签组下新建标签。
4、如果填写了groupId参数，则groupName和标签组的order参数会被忽略。
5、不支持创建空标签组。
6、标签组内的标签不可同名，如果传入多个同名标签，则只会创建一个。

请求参数

Header 参数

Authorization

string <string>

认证令牌

必需

示例值:

Bearer 请求凭证

Body 参数application/json

groupId

string <string>

可选

标签分组id，非必填，与分组名称二选一
向指定的标签组下添加标签，填写groupId参数

groupName

string <string>

可选

标签分组名称非必填，与分组id二选一
创建一个全新的标签组以及标签，填写groupName，最长为30个字符

order

number <int64>

可选

标签组次序值，有效的值范围是[0, 2^32)
不传则企业微信生成

示例值:

tagDetailList

array[object (WecomOpenAppTagDetailRequest_request) {2}]

添加的标签名称

可选

name

string <string>

必需

标签名称，，标签组内的标签不可同名，如果传入多个同名标签，则只会创建一个，最长为30个字符

order

number <int64>

可选

标签次序值。order值大的排序靠前。有效的值范围是[0, 2^32)
不传则企业微信生成

示例值:

示例

{
  "groupId": "",
  "groupName": "",
  "order": 0,
  "tagDetailList": [
    {
      "name": "",
      "order": 0
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200OK

application/json

Body

success

boolean

成功标识

可选

示例值:

true

code

integer <int32>

错误编码

可选

示例值:

msg

string <string>

错误信息

可选

示例值:

value

object (WecomOpenAppTagResponse_response)

可选

返回对象(object)

groupId

string <string>

标签分组id

可选

示例值:

groupName

string <string>

标签分组名称

可选

示例值:

order

number <int64>

标签排序的次序值

可选

示例值:

tagDetailsList

array[object (WecomOpenAppTagDetailsResponse_response) {4}]

标签列表

可选

traceId

string <string>

链路ID

可选

示例值:

示例

{
  "success": true,
  "code": 0,
  "msg": "",
  "value": {
    "groupId": "",
    "groupName": "",
    "order": 0,
    "tagDetailsList": [
      {
        "createBy": "",
        "id": "",
        "name": "",
        "order": 0
      }
    ]
  },
  "traceId": ""
}