您可通过此接口更新观众所在的直播分组。
请求频率:单用户请求频率限制为 10 次/秒。
下表仅列出该接口特有的请求参数和部分公共参数。更多信息详见公共参数。
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | UpdateAudienceGroupUserConfig | 接口名称。当前 API 的名称为 UpdateAudienceGroupUserConfig 。 |
Version | String | 是 | 2023-08-01 | 接口版本。当前 API 的版本为 2023-08-01 。 |
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
ActivityId | Long | 是 | 1798536670530570 | 直播间 ID。您可以通过 ListActivityAPI 接口查询 ID。 |
AudienceGroupUsers | Array of AudienceGroupUsers | 是 |
| 待更新的观众分组信息。 说明 最多支持同时更新 10,000 个观众的分组信息。 |
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
UserId | Long | 否 |
| 用户 ID。您可以通过 ListAudienceGroupUser 接口查询 ID。 说明
|
FlagId | String | 否 |
| 观众的唯一标识。最多支持输入 100 个字符。您可以通过 ListAudienceGroupUser 接口查询唯一标识。 说明
|
AudienceGroupName | String | 否 |
| 期望移动到的直播分组的名称。若分组不存在,会自动创建该分组。您可以通过 GetAudienceGroupConfig 接口查询分组名称。 说明
|
AudienceGroupId | Long | 否 |
| 期望移动到的直播分组的 ID。您可以通过 ListAudienceGroupUser 接口查询 ID。 说明
|
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
Status | Boolean |
| 是否更新成功。支持以下取值:
|
POST https://livesaas.volcengineapi.com/?Action=UpdateAudienceGroupUserConfig&Version=2023-08-01 { "ActivityId": 1798536670530570, "AudienceGroupUsers": [ { "UserId": 1798536670530571, "AudienceGroupId": 1798536670530572 } ] }
{ "ResponseMetadata": { "RequestId": "20230604110420****100232280022D31", "Action": "UpdateAudienceGroupUserConfig", "Version": "2023-08-01", "Service": "livesaas", "Region": "cn-north-1", "SystemTime": 1705992306 }, "Result": { "Status": true } }