模板:YoutubeCount/doc

此模板用以獲取Youtube視頻數據。

伺服器端配置

配置項		Bilibili相關		Niconico相關	Youtube相關
		視頻接口	UP接口	視頻接口	視頻接口	頻道接口
緩存時長
緩存更新 最大頻率控制	低頻時段
	低頻時段頻率
	高頻時段頻率
代理節點個數

註：

• 緩存更新最大頻率是指連續60秒內伺服器或代理節點進行緩存刷新的最大次數，超出最大次數之後的請求將會延長緩存有效期至解除頻率控制時間點，並會在每日的低頻時段被伺服器重試，直至完成緩存刷新。
• 建議通過搭配onlyTime參數來向讀者提示緩存時間，如有需要強制刷新請聯繫AnnAngela[更多]討論頁貢獻上載歷史封鎖及歷史被刪貢獻移動日誌巡查日誌用戶權限及日誌用戶查核。

參數說明

• id：必填，視頻id。
• type：選填，填寫需要獲取的信息類型：
  • publishedAt：顯示視頻發佈時間，可結合format參數指定時間格式；
  • title：顯示視頻標題；
  • privacyStatus：顯示視頻是否公開；
  • publicStatsViewable：顯示視頻數據是否公開；
  • viewCount（默認值）：顯示視頻播放數；
  • likeCount：顯示視頻點讚數；
  • commentCount：顯示視頻評論數；
• fallback：選填（建議填寫），在無法獲取 顯示 視頻數據時顯示該值（即作為手動指定數據顯示），僅支持純數字。不再使用。
• format：選填，指定輸出的數據的格式，只能填以下三種參數：
  • round / toFixed（默認值）：
    • 數據小於10000時顯示原始數據；
    • 大於10000時以「萬」為單位顯示：
      • 此時四捨五入保留的小數位數以{{{decimalLength|}}}指定，只接受正整數，默認為2；
  • plain：直接顯示原始數據
  • separate：顯示帶千位分隔符的數據
• dateFormat：選填，直接傳遞給moment庫，所以請使用moment庫可用的格式，默認值為LLL（2020年1月2日晚上4點50分，在只顯示時間時）

用例

參數舉例	publishedAt	title	privacyStatus
結果舉例	--	--	--
用法舉例	{{YoutubeCount|id=dQw4w9WgXcQ|type=publishedAt}}	{{YoutubeCount|id=dQw4w9WgXcQ|type=title}}	{{YoutubeCount|id=dQw4w9WgXcQ|type=privacyStatus}}
參數舉例	publicStatsViewable	viewCount	likeCount
結果舉例	--	--	--
用法舉例	{{YoutubeCount|id=id=dQw4w9WgXcQ|type=publicStatsViewable}}	{{YoutubeCount|id=dQw4w9WgXcQ}} {{YoutubeCount|id=dQw4w9WgXcQ|type=viewCount}}	{{YoutubeCount|id=dQw4w9WgXcQ|type=likeCount}}
參數舉例	commentCount	示例用視頻為Rick Astley - Never Gonna Give You Up (Official Music Video)
結果舉例	--
用法舉例	{{YoutubeCount|id=dQw4w9WgXcQ|type=commentCount}}
參數舉例	round / toFixed	plain	separate
結果舉例	--	--	--
用法舉例	{{YoutubeCount|id=dQw4w9WgXcQ|format=toFixed}}	{{{YoutubeCount|id=dQw4w9WgXcQ|format=plain}}	{{YoutubeCount|id=dQw4w9WgXcQ|format=separate}}
參數舉例	decimalLength	dateFormat	類型設置錯誤
結果舉例	--	--	--
用法舉例	{{YoutubeCount|id=dQw4w9WgXcQ|format=toFixed|decimalLength=4}}	{{YoutubeCount|id=dQw4w9WgXcQ|onlyTime=1|dateFormat=LLLL}}	{{YoutubeCount|id=dQw4w9WgXcQ|type=0}} {{YoutubeCount|id=dQw4w9WgXcQ|type=error}}

參見

• {{YoutubeVideo}}