YouTube · 設定指南
如何建立 YouTube 資料 API 金鑰
StreamBruh 使用您的 YouTube Data API v3 金鑰進行公共影片搜尋和頻道上傳檢查。 Google 雲端配額和 API 金鑰限制可能會影響這些計畫檢查。
逐步設定
建立或選擇Google雲端項目
使用 Google 帳號登入 Google Cloud Console。為這些通知建立一個專案或選擇您管理的專案。檢查控制台標題中的預期項目是否處於活動狀態。
啟用YouTube Data API v3
在 APIs & Services → Library 中，搜尋 YouTube Data API v3 並為該專案啟用它。單獨建立金鑰並不能啟用 API。
建立 API 金鑰
開啟 APIs & Services → Credentials，選擇 Create credentials → API key，然後複製產生的金鑰。限制其 API 存取 YouTube Data API v3。將密鑰遠離公共頁面和原始程式碼控制。
StreamBruh 從其伺服器呼叫 Google，而不是從訪客的瀏覽器。網站或 HTTP 引用限制將阻止這些伺服器請求。如果StreamBruh支援確認VPS有穩定的公共出口IP，您可以另外將金鑰限製到該IP；否則保留 YouTube API 限制並監控使用情況。
將金鑰保存在StreamBruh中
打開機器人和集成，將密鑰貼上到 YouTube API 密鑰中，然後保存。保存的密鑰被屏蔽。如果您想保留現有金鑰，請在以後的編輯過程中將該欄位留空。
選擇搜尋或頻道
YouTube 搜尋通知遵循與搜尋字詞相符的新公開影片；它的語言設定是相關性偏好而不是保證，並且以逗號分隔的阻止詞排除包含這些術語的標題。通道通知接受 YouTube @handle 連結、通道 ID 連結、句柄或表單支援的通道 ID。
選擇 Discord 目標通道，自訂訊息並儲存。檢查按計劃進行。搜尋請求和通道檢查以不同的速率消耗 YouTube API 配額；結果也取決於 YouTube 的可用性。
檢查您的設置
- YouTube Data API v3 在與金鑰相同的項目中啟用。
- 金鑰的 API 限制包括 YouTube Data API v3，其客戶端限制允許 VPS。
- 頻道連結解析或搜尋配置保存，機器人可以發送到選定的 Discord 頻道。
故障排除
API 金鑰被拒絕
確認金鑰屬於所選項目，YouTube Data API v3已啟用，且其限制允許來自VPS的請求。瀏覽器引薦來源網址限制與伺服器端呼叫不符。
配額已用完
查看 YouTube 資料 API 使用量和 Google Cloud Console 中的配額。減少不必要的搜尋或在符合條件的情況下透過 Google 請求配額延期；配額可用後重試。
沒有發布視頻
檢查自上次檢查以來新的公共影片是否與搜尋或頻道匹配，被阻止的單字是否排除了其標題，以及 Discord 頻道是否仍然可發送。預定的檢查不是即時的。