YouTube OAuth 設定ガイド

twitchTransFreeNeo で YouTube Live チャットに翻訳を投稿するための設定方法

📖
このページについて

twitchTransFreeNeoでYouTube Liveのチャットに翻訳を投稿するには、YouTube Data API v3のOAuth認証が必要です。このガイドでは、必要な「Client ID」と「Client Secret」の取得方法を説明します。

所要時間: 約10〜15分

⚠️
認証時のアカウント確認について

認証時は、現在Googleにログインしているアカウントで認証されます。

複数のGoogleアカウントをお持ちの場合は、認証前に正しいアカウントでログインしているか確認してください。

twitchTransFreeNeoの「YouTube認証を行う」ボタンを押すと、ブラウザが開き、認証するGoogleアカウントを選択できます。認証完了後、アプリ内に認証されたアカウント名が表示されます。

💡
読み取り専用モードについて

OAuth認証を設定しなくても、YouTube Liveのチャットを読み取って翻訳表示することは可能です。チャットへの翻訳投稿が不要な場合は、この設定は不要です。

事前準備

設定手順

  1. Google Cloud Console にアクセス

    以下のボタンをクリックして、Google Cloud Console を開きます。

    Google Cloud Console を開く →

    初めての場合は、利用規約への同意が必要です。

  2. 新しいプロジェクトを作成

    1. 画面上部のプロジェクト選択ドロップダウンをクリック
    2. 「新しいプロジェクト」をクリック
    3. プロジェクト名を入力(例: twitchTransFreeNeo
    4. 「作成」をクリック
  3. YouTube Data API v3 を有効化

    以下のボタンをクリックして、YouTube Data API v3 の有効化ページを開きます。

    YouTube Data API v3 を有効化 →
    1. 作成したプロジェクトが選択されていることを確認
    2. 「有効にする」ボタンをクリック
  4. Google Auth Platform を設定(旧「OAuth 同意画面」)

    🆕
    新UIについて(2025年以降)

    Google Cloud Console のUIが刷新され、「OAuth 同意画面」は「Google Auth Platform」という名前になりました。設定項目は以下のタブに分かれています:

    • ブランディング(Branding):アプリ名・サポートメールなど
    • 対象(Audience):公開ステータスとテストユーザー
    • データアクセス(Data Access):スコープ設定
    • クライアント(Clients):OAuth クライアントID
    Google Auth Platform を開く →
    4-1. 初回セットアップ(「Get Started」)
    1. 「Get Started(始める)」をクリック
    2. アプリ名: twitchTransFreeNeo を入力
    3. ユーザーサポートメール: 自分のメールアドレスを選択
    4. 対象(Audience): 「外部 (External)」を選択
    5. デベロッパーの連絡先: 自分のメールアドレスを入力
    6. 利用規約に同意して「作成」をクリック
    4-2. 「対象(Audience)」タブでテストユーザーを追加
    🚨
    最重要:テストユーザーの追加(この手順を忘れると認証できません)

    「外部」で作成したアプリは公開ステータスが「テスト」となっており、テストユーザーとして追加されたGoogleアカウントのみが使用できます。

    自分のGoogleアカウント(Gmailアドレス)を必ず「テストユーザー」に追加してください。

    追加しないと 403: access_denied(アクセスをブロック)エラーが発生します。

    1. 左メニューで「対象(Audience)」タブを開く
    2. 「テストユーザー(Test users)」セクションの「+ Add users」をクリック
    3. 自分の Gmail アドレスを入力して「保存」
    4. 複数アカウントがある場合は、認証に使うアカウント全てを追加
  5. OAuth クライアント ID を作成

    クライアント ページを開く(新UI) → 認証情報ページ(旧UI) →
    1. 左メニューから「クライアント(Clients)」タブを開く
    2. + クライアントを作成(Create Client)」をクリック
    3. アプリケーションの種類: 「デスクトップアプリ」を選択
    4. 名前を入力(例: twitchTransFreeNeo Desktop
    5. 「作成」をクリック
  6. Client ID と Client Secret をコピー

    作成が完了すると、以下の情報が表示されます:

    • クライアント ID — 長い文字列(.apps.googleusercontent.com で終わる)
    • クライアント シークレット — 短い英数字の文字列

    これらを twitchTransFreeNeo の設定画面にコピー&ペーストしてください。

    設定完了!

    Client ID と Client Secret を twitchTransFreeNeo の「設定」→「基本設定」→「YouTube Live設定」に入力し、「YouTube認証を行う」ボタンをクリックしてください。

twitchTransFreeNeo での設定

  1. twitchTransFreeNeo を起動
  2. 「設定」ボタンをクリック
  3. 「基本設定」タブを選択
  4. プラットフォームで「YouTube Live のみ」または「同時配信」を選択
  5. 「YouTube Client ID」に取得した Client ID を入力
  6. 「YouTube Client Secret」に取得した Client Secret を入力
  7. 「YouTube認証を行う」ボタンをクリック
  8. ブラウザが開くので、Googleアカウントでログインして許可
  9. 「認証済み」と表示されれば完了!
⚠️
認証時に「このアプリは Google で確認されていません」が表示された場合

これはエラーではなく、自作OAuthアプリで必ず表示される正常な警告です。以下の手順で続行してください。

  1. 警告画面の左下の「詳細」リンクをクリック
    ※ 右下の青い「安全なページに戻る」ボタンは押さないでください
  2. 展開されたテキスト内の「twitchTransFreeNeo に移動(安全ではないページ)」リンクをクリック
  3. 通常の Google ログイン画面に進むので、認証を完了させる

この警告は、あなた自身が作成したアプリ(Google審査を受けていない)のため表示されるものです。自分専用のアプリなので、安全に続行できます。

よくある質問(FAQ)

Q: 「このアプリは Google で確認されていません」と表示されます

A: これは正常な警告画面です。エラーではありません。以下の手順で続行してください:

  1. 画面左下の「詳細」リンクをクリック(右下の「安全なページに戻る」ボタンを押さない)
  2. 展開されたテキスト内の「twitchTransFreeNeo に移動(安全ではないページ)」リンクをクリック
  3. Google ログイン画面に進むので認証を完了

自作OAuthアプリは Google の審査を受けていないため、この警告が必ず表示されます。自分で作成したアプリなので安全に続行できます。

Q: 「アクセスをブロック」「403: access_denied」と表示されます

A: 最もよくある原因は、テストユーザーに自分を追加していないことです。

  1. Google Auth Platform の「対象(Audience)」タブを開く
  2. 「テストユーザー(Test users)」セクションで「+ Add users」をクリック
  3. 自分の Gmail アドレスを追加して保存
  4. twitchTransFreeNeo に戻り、再度「YouTube認証を行う」をクリック

※ 旧UIの場合は OAuth同意画面 の「テストユーザー」セクションです。

Q: 認証に失敗します

A: 以下を確認してください:

  • OAuth同意画面でテストユーザーに自分を追加したか
  • YouTube Data API v3が有効になっているか
  • Client IDとSecretが正しくコピーされているか

Q: クォータ(quota)エラーが出ます

A: YouTube Data API には1日あたりの使用量制限があります。翻訳投稿の頻度が高すぎる場合に発生することがあります。しばらく待ってから再試行してください。

Q: 投稿せずに翻訳表示だけしたい

A: OAuth設定は不要です。動画IDだけ入力すれば、チャットの読み取りと翻訳表示が可能です。また、「表示のみモード」をオンにすることでも投稿を無効にできます。

関連リンク

Google Auth Platform クライアント 対象(テストユーザー) YouTube API 公式ドキュメント GitHub リポジトリ ← チャット翻訳ちゃんに戻る