您可通过此接口获取指定直播间或指定账号在指定时间范围内直播流量预付费和后付费的使用情况。
请求频率:单用户请求频率限制为 10 次/秒。
下表仅列出该接口特有的请求参数和部分公共参数。更多信息详见公共参数。
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | GetLiveTrafficPostPayData | 接口名称。当前 API 的名称为 GetLiveTrafficPostPayData 。 |
Version | String | 是 | 2023-08-01 | 接口版本。当前 API 的版本为 2023-08-01 。 |
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
ActivityIds | Array of Long | 否 |
| 直播间 ID。您可以通过 ListActivityAPI 接口查询 ID。 说明
|
ActivityCreator | Object of ActivityCreatorForm | 否 |
| 账号信息。 说明 本参数和 |
StartDay | String | 是 |
| 查询开始日期。格式为
|
EndDay | String | 是 |
| 查询结束日期。格式为
|
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
IsMainAccount | Boolean | 否 |
| 是否为主账号。支持以下取值:
|
SubAccountName | String | 否 |
| 子账号。您可以在企业直播控制台的账户中心 > 权限管理 > 用户管理页面查询子账号的账号信息。 说明
|
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
EstimatedResult | Array of LiveTrafficData | - | 直播流量后付费的预估信息。T 日的数据一般可在 T+1 日 12 时前获取。 |
ActualResult | Array of LiveTrafficData | - | 直播流量后付费的实际信息。T 日的数据一般可在 T+1 日 17 时前获取。 |
ActualPrePayResult | Array of LiveTrafficData | - | 直播流量预付费的实际信息,T 日的数据一般可在 T+1 日 18 时前获取。 |
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
ActivityId | Long | 1795096013214780 | 直播间 ID。 |
ActivityCreator | Object of ActivityCreatorForm | - | 直播间所属账号。 |
LiveUV | Long |
| 查询时间范围内,直播间内观众使用播放器观看的累计观看人数。使用相同设备(即设备 ID 相同)观看的观众被判定为同一人,人数算作 1。 |
LiveTraffic | Double | 1.1 | 查询时间范围内,直播间内观众观看直播所消耗的总流量。单位为 GB。 |
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
IsMainAccount | Boolean |
| 是否为主账号。支持以下取值:
|
SubAccountName | String | +86123456 | 子账号。 |
POST https://livesaas.volcengineapi.com/?Action=GetLiveTrafficPostPayData&Version=2023-08-01 { "StartDay": "20240330", "EndDay": "20240401", "ActivityIds": [1795096013214780] }
{ "ResponseMetadata": { "RequestId": "202306041104200100100232280022D31", "Action": "GetLiveTrafficPostPayData", "Version": "2023-08-01", "Service": "livesaas", "Region": "cn-north-1", "SystemTime": 1700019846 }, "Result": { "EstimatedResult": [ { "ActivityId": 1795096013214780, "ActivityCreator": { "IsMainAccount": false, "SubAccountName": "+86123456" }, "LiveUV": 10, "LiveTraffic": 1.1 } ], "ActualResult": [ { "ActivityId": 1795096013214780, "ActivityCreator": { "IsMainAccount": false, "SubAccountName": "+86123456" }, "LiveUV": 10, "LiveTraffic": 1.15 } ], "ActualPrePayResult": [ { "ActivityId": 1795096013214780, "ActivityCreator": { "IsMainAccount": false, "SubAccountName": "+86123456" }, "LiveUV": 10, "LiveTraffic": 2.25 } ] } }