模板:YoutubeChannel/doc
跳到导航
跳到搜索
此模板用以获取Youtube频道数据。
服务器端配置
配置项 | Bilibili相关 | Niconico相关 | Youtube相关 | |||
---|---|---|---|---|---|---|
视频接口 | UP接口 | 视频接口 | 视频接口 | 频道接口 | ||
缓存时长 | ||||||
缓存更新 最大频率控制 |
低频时段 | |||||
低频时段频率 | ||||||
高频时段频率 | ||||||
代理节点个数 |
注:
- 缓存更新最大频率是指连续60秒内服务器或代理节点进行缓存刷新的最大次数,超出最大次数之后的请求将会延长缓存有效期至解除频率控制时间点,并会在每日的低频时段被服务器重试,直至完成缓存刷新。
- 建议通过搭配onlyTime参数来向读者提示缓存时间,如有需要强制刷新请联系AnnAngela[更多]。
统计数据
|
参数说明
id
:必填,频道id。type
:选填,填写需要获取的信息类型:title
:显示频道标题;privacyStatus
:显示频道是否公开;hiddenSubscriberCount
:显示频道数据是否隐藏(注意此处为隐藏不是公开);viewCount
:显示频道播放数;subscriberCount
(默认值):显示频道关注数(公开 API 只能获得非精确值);videoCount
:显示频道发布视频数;
format
:选填,指定输出的数据的格式,只能填以下三种参数:round
/toFixed
(默认值):- 数据小于10000时显示原始数据;
- 大于10000时以“万”为单位显示:
- 此时四舍五入保留的小数位数以
{{{decimalLength|}}}
指定,只接受正整数,默认为2;
- 此时四舍五入保留的小数位数以
plain
:直接显示原始数据separate
:显示带千位分隔符的数据
dateFormat
:选填,直接传递给moment库,所以请使用moment库可用的格式,默认值为LLL
(2020年1月2日晚上4点50分,在只显示时间时)
用例
参数举例 | title | privacyStatus | hiddenSubscriberCount |
---|---|---|---|
结果举例 | -- | -- | -- |
用法举例 | {{YoutubeChannel|id=UCSs4A6HYKmHA2MG_0z-F0xw|type=title}} | {{YoutubeChannel|id=UCSs4A6HYKmHA2MG_0z-F0xw|type=privacyStatus}} | {{YoutubeChannel|id=id=UCSs4A6HYKmHA2MG_0z-F0xw|type=hiddenSubscriberCount}} |
参数举例 | viewCount | subscriberCount | videoCount |
结果举例 | -- | -- | -- |
用法举例 | {{YoutubeChannel|id=UCSs4A6HYKmHA2MG_0z-F0xw}} {{YoutubeChannel|id=UCSs4A6HYKmHA2MG_0z-F0xw|type=viewCount}} |
{{YoutubeChannel|id=UCSs4A6HYKmHA2MG_0z-F0xw|type=subscriberCount}} | {{YoutubeChannel|id=UCSs4A6HYKmHA2MG_0z-F0xw|type=videoCount}} |
示例用频道为Rick Astley - Never Gonna Give You Up (Official Music Video) | |||
参数举例 | round / toFixed | plain | separate |
结果举例 | -- | -- | -- |
用法举例 | {{YoutubeChannel|id=UCSs4A6HYKmHA2MG_0z-F0xw|format=toFixed}} | {{{YoutubeChannel|id=UCSs4A6HYKmHA2MG_0z-F0xw|format=plain}} | {{YoutubeChannel|id=UCSs4A6HYKmHA2MG_0z-F0xw|format=separate}} |
参数举例 | decimalLength | dateFormat | 类型设置错误 |
结果举例 | -- | -- | -- |
用法举例 | {{YoutubeChannel|id=UCSs4A6HYKmHA2MG_0z-F0xw|format=toFixed|decimalLength=4}} | {{YoutubeChannel|id=UCSs4A6HYKmHA2MG_0z-F0xw|onlyTime=1|dateFormat=LLLL}} | {{YoutubeChannel|id=UCSs4A6HYKmHA2MG_0z-F0xw|type=0}} {{YoutubeChannel|id=UCSs4A6HYKmHA2MG_0z-F0xw|type=error}} |
参见
- {{YoutubeVideo}}