You need to enable JavaScript to run this app.
导航
ListQuestionnaireDataAPIV2 - 获取直播间问卷列表
最近更新时间:2025.03.24 16:50:55首次发布时间:2023.02.01 10:13:29
我的收藏
有用
有用
无用
无用

您可通过此接口获取指定直播间的问卷列表。

注意事项

  • 请求频率:单用户请求频率限制为 120 次/分钟
  • 前提条件:确保您拥有火山引擎主账号或具备直播间的数据统计 > 仅查看可编辑权限的子账号。有关如何添加子账号,详见子账号管理

请求说明

  • 请求方式:GET
  • 请求地址:https://livesaas.volcengineapi.com/?Action=ListQuestionnaireDataAPIV2&Version=2020-06-01

请求参数

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

Query

参数类型是否必选示例值描述
ActionStringListQuestionnaireDataAPIV2接口名称。当前 API 的名称为 ListQuestionnaireDataAPIV2
VersionString2020-06-01接口版本。当前 API 的版本为 2020-06-01

ActivityId

Long

1779168245

直播间 ID。您可以通过 ListActivityAPI 接口查询 ID。

说明

使用子账号调用接口时,确保该直播间对子账号可见。有关如何配置子账号的可见范围,详见子账号管理

PageNoInteger1分页查询页码。默认值为 1
PageItemCountInteger10分页查询数量。默认值为 10
ChannelString123渠道标识。支持根据渠道标识查询不同渠道下的 UserCount (即问卷参与人数)。默认查询全部渠道数据。您可以通过 ListChannelAPI 接口查询渠道标识。

返回参数

参数类型示例值描述
PageItemCountInteger10分页查询数量。
PageNoInteger1分页查询页码。
TotalItemCountInteger1问卷总数。
StatisticsQuestionnairesArray of StatisticsQuestionnaires-问卷信息。

StatisticsQuestionnaires

参数类型示例值描述
QuestionnaireIdInteger117850问卷 ID。
TitleString问卷 A问卷标题。
PublishTimeLong1697091022问卷发布时间。Unix 时间戳,单位为秒。
UserCountInteger11问卷参与人数。

IsDelete

Boolean

false

问卷是否已删除。支持以下取值:

  • false:否
  • true:是

请求示例

GET https://livesaas.volcengineapi.com/?Action=ListQuestionnaireDataAPIV2&Version=2020-06-01&ActivityId=1779168245&PageNo=1&PageItemCount=10&Channel=123

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202201201826170101501312091D1C09D2",
        "Action": "ListQuestionnaireDataAPIV2",
        "Version": "2020-06-01",
        "Service": "livesaas",
        "Region": "cn-north-1",
        "SystemTime": 1656067132
    },
    "Result": {
        "PageItemCount": 10,
        "PageNo": 1,
        "TotalItemCount": 1,
        "StatisticsQuestionnaires": [
            {
                "QuestionnaireId": 117850,
                "Title": "问卷 A",
                "PublishTime": 1697091022,
                "UserCount": 11,
                "IsDelete": false
            }
        ]
    }
}

错误码

访问公共错误码错误码获取详细信息。