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 を呼び出します。 Web サイトまたは HTTP リファラー制限により、これらのサーバー リクエストがブロックされます。 StreamBruh サポートによって VPS の安定したパブリック出力 IP が確認された場合は、キーをその IP にさらに制限できます。それ以外の場合は、YouTube API 制限を維持し、使用状況を監視します。
キーを StreamBruh に保存します
[ボットと統合] を開き、キーを YouTube API キーに貼り付けて保存します。保存されたキーはマスクされます。既存のキーを保持したい場合は、後の編集時にフィールドを空白のままにしておきます。
検索またはチャネルを選択してください
YouTube 検索通知は、検索用語に一致する新しい公開ビデオに続きます。言語設定は保証ではなく関連性の設定であり、コンマで区切られたブロックされた単語は、それらの用語を含むタイトルを除外します。チャネル通知は、フォームでサポートされている YouTube @handle リンク、チャネル ID リンク、ハンドル、またはチャネル ID を受け入れます。
Discord 宛先チャンネルを選択し、メッセージをカスタマイズして保存します。チェックはスケジュールに従って実行されます。検索リクエストとチャネル チェックは、さまざまなレートで YouTube API クォータを消費します。結果は YouTube の可用性にも依存します。
設定を確認してください
- YouTube Data API v3 is enabled in the same project as the key.
- キーの API 制限には YouTube Data API v3 が含まれており、そのクライアント制限により VPS が許可されます。
- チャネル リンクが解決されるか、検索構成が保存され、ボットは選択した Discord チャネルに送信できるようになります。
トラブルシューティング
API キーが拒否されました
キーが選択したプロジェクトに属していること、YouTube Data API v3 が有効になっていること、およびその制限により VPS からのリクエストが許可されていることを確認します。ブラウザリファラーの制限はサーバー側の呼び出しと一致しません。
クォータが枯渇しました
YouTube データ API の使用量と割り当てを Google Cloud Console で確認します。不要な検索を減らすか、該当する場合は Google を通じてクォータの延長をリクエストします。クォータが使用可能になってから再試行してください。
動画は投稿されていません
前回のチェック以降、新しい公開ビデオが検索またはチャンネルに一致するかどうか、ブロックされた単語によってタイトルが除外されているかどうか、Discord チャンネルが送信可能なままであるかどうかを確認します。スケジュールされたチェックは即時ではありません。