您可通过此接口新增自定义表情专辑，或更新已有自定义表情专辑的专辑名称、表情图片等。

使用说明

接口行为

• 通过本接口的 EmojiSet 参数，您可以新增和更新自定义表情专辑。
  • 新增自定义表情专辑：在请求参数中不传 EmojiSetId（自定义表情专辑 ID）或传入 EmojiSetId 且参数取值为 0 ，即可新增自定义表情专辑。
  • 更新自定义表情专辑信息：在请求参数中传入待更新信息的自定义表情专辑的 ID 作为 EmojiSetId 参数值，即可更新该专辑。您可以通过 ListActivityCustomEmojiSets 接口查询 ID。
• 通过本接口的 Emojis 参数，您可以新增、更新或删除自定义表情专辑中的表情图片。
  • 新增表情图片：在请求参数中不传 EmojiId（表情图片 ID）或传入 EmojiId 且参数取值为 0 ，即可新增表情图片。
  • 更新表情图片：在请求参数中传入待更新的表情图片的 ID 作为 EmojiId 参数值，即可更新该表情图片。
  • 删除表情图片：在请求参数中不传已有表情图片的 ID，即可删除该表情图片。

  说明

  为避免当前自定义表情专辑中已有表情图片被误删，您必须将不需要删除和更新的表情图片 ID 及其配置信息作为请求参数传入该接口。您可以调用 GetActivityCustomEmojiSetDetail 接口，通过返回参数 Emojis 获取当前表情专辑中的所有表情图片信息。

注意事项

请求频率：单用户请求频率限制为 10 次/秒。

请求说明

• 请求方式：POST
• 请求地址：https://livesaas.volcengineapi.com/?Action=CreateOrUpdateActivityCustomEmojiSet&Version=2023-08-01

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息详见公共参数。

Query

Body

EmojiSet

Emojis

返回参数

请求示例

POST https://livesaas.volcengineapi.com/?Action=CreateOrUpdateActivityCustomEmojiSet&Version=2023-08-01
{
    "ActivityId": 1772285976254,
    "EmojiSet": {
        "EmojiSetId": 1772285976257,
        "EmojiSetName": "卡通",
        "EmojiSetType": 1,
        "EmojiSetIcon": "https://www.example.com/a.png",
        "Emojis": [
            {
                "EmojiId": 1772285976256,
                "EmojiName": "大笑",
                "EmojiImage": "https://www.example.com/b.png",
                "EmojiLocation": 1
            }
        ]
    }
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202306041104200100100232280022D31",
        "Action": "CreateOrUpdateActivityCustomEmojiSet",
        "Version": "2023-08-01",
        "Service": "livesaas",
        "Region": "cn-north-1",
        "SystemTime": 1717122857
    },
    "Result": {
        "Status": true
    }
}

错误码

下表提供了该接口特有的错误码，公共错误码请参见公共错误码和错误码文档。