STORYAIヘルプポータル

YouTubeと連携する

STORYAIとYouTubeを連携して、動画の取り込み、自分のチャンネルの詳しい数値の確認、STORYAIからのアップロード、過去の動画との比較分析を行う方法を説明します。

前提条件

  • ロール：オーナーまたはシステム管理者だけが設定・連携できます。
  • プラン：課金プランに登録しているブランドで利用できます。
  • Google側の準備：ブランドの Google Cloud プロジェクトでOAuthクライアントを作成し、「Client ID」と「Client Secret」を用意します。OAuthクライアントの「承認済みのリダイレクトURI」には、STORYAIのコールバックURLを登録します。
  • 「APIキー」（YouTube Data API のAPIキー）は任意です。登録すると、ほかのチャンネルの公開動画の取得にも使います。
  • YouTube APIの利用枠（クォータ）は、ブランドの Google Cloud プロジェクトのものを使います。

連携手順

  1. 画面右上のアカウントメニューから「API」を開き、「SNS API統合」タブを選びます。左のサイドバーの「設定」→「API」タブからも開けます。
  2. 「YouTube API」の行の編集ボタン（鉛筆アイコン）を押します。
  3. 「API認証情報を登録：YouTube API」で「Client ID」と「Client Secret」を入力します。必要なら「APIキー」も入力し、「登録」を押します。行の表示が「設定済み」に変わります。
  4. 「YouTubeと連携する」を押します。Googleの認可画面で、連携したいチャンネルのGoogleアカウントでログインし、アクセスを許可します。
  5. 「連携が完了しました」と表示されたら「設定画面に戻る」を押します。「YouTube API」の行が「連携済み」になり、「チャンネルID」が表示されていれば完了です。

連携が切れたときや、別のチャンネルに切り替えたいときは「YouTubeと再連携する」を押して手順4〜5をやり直してください。連携を解除するときは、編集ボタンから「削除」を押します。

動画を取り込んで分析する

  1. 左のサイドバーの「分析・作成する」から「新しく分析する」を開きます（ビジネス表示では「作成する」→「分析する」）。
  2. 「短文テキスト入力（X投稿含む）」タブで「YouTubeから取得する」を押します。
  3. 「動画の選択」の「新しく取得」で、「チャンネルIDまたはハンドル」に「UC」で始まるチャンネルIDか「@ハンドル」を入力し、「動画を取得」を押します。25件ずつ表示され、続きは「さらに読み込む」で表示します。
  4. 分析したい動画を1件選んで「選択」を押します。タイトルと説明文が入力欄に、サムネイルが画像として入ります。カテゴリーは「YouTube」になります。
  5. 「設定情報」を入力し、「分析前の確認」→「確認して分析する」で分析を始めます。

動画そのものは取り込めません。分析対象はタイトル・説明文・サムネイルです。動画の中身を分析したい場合は、動画ファイルを「動画アップロード」タブからアップロードしてください。

選んだ動画は「取得履歴」に保存されます。「取得履歴」タブで「取得履歴を検索」に語句を入れて「検索」すると、同じ動画を選び直せます。YouTubeの作品では、「新しい版を追加」画面にも「YouTubeから取得する」が表示されます。

分析結果で見られるもの

  • 「YouTubeの詳細情報」：取り込んだ動画の再生回数、いいね数、コメント数、チャンネル登録者数。
  • 「YouTube Analytics（自チャンネル）」：ブランドのオーナー・システム管理者が見ると、連携したチャンネル自身の動画では、総再生時間、平均視聴時間、平均視聴維持率、共有数、獲得・減少チャンネル登録者数なども確認できます。「集計期間」は「直近28日」「直近90日」「直近365日」から選べます。ほかのチャンネルの動画では表示されません。
  • 「過去動画との比較分析」：取得履歴にある過去の動画の反応数と、今回の動画の感情の流れを突き合わせてAIが総評します（下記）。

過去の動画と比較分析する

YouTubeの作品の分析結果にある「過去動画との比較分析」で、AIモデルを選んで「比較分析を生成」を押します。テキスト生成AIの利用回数を1回使います。比較分析を生成できるのは、作品でAI分析を実行できる人（作品の作成者、プロジェクトの管理者・編集者）です。権限が無い場合はモデルの選択と「比較分析を生成」が表示されません。連携状況と比較対象の件数は、ブランドのオーナー・システム管理者にだけ表示されます。

  • 比較の対象は、取得履歴の直近の動画（最大10件。今回の動画は除く）です。
  • 比べる指標は、再生回数・いいね数・コメント数・登録者増加数・視聴維持率です。視聴維持率などは連携したチャンネル自身の動画だけ補われます。
  • 未連携でも、公開されている数値だけで比較できます（「YouTube未連携のため、公開メトリクスのみで比較します。」と表示されます）。
  • 生成した結果は「生成履歴」から切り替えて見られます。「再生成」で作り直せます。

YouTubeへアップロードする

動画分析の作品と、動画ファイルを含むYouTubeの作品では、分析結果から動画を連携チャンネルへアップロードできます。「YouTubeから取得する」で取り込んだ作品は動画ファイルを持たないため、「YouTubeへアップロード」は表示されません。アップロードできるのは、ブランドのオーナー・システム管理者です。

  1. 分析結果の「YouTubeへアップロード」を押します。
  2. 「YouTubeへ動画をアップロード」で「タイトル」（最初は作品のタイトル）、「説明」、「公開範囲」（「非公開」「限定公開」「公開」）、「タグ」（カンマ区切り）を入力します。
  3. 「アップロード」を押します。ボタンの横に進み具合が表示され、終わると「YouTubeへのアップロードが完了しました。」と「YouTubeで動画を開く」が表示されます。

画面を閉じてもアップロードは続きます。Google の審査を受けていないOAuthクライアントでは、アップロードした動画が非公開に制限される場合があります。「YouTubeから取得する」で取り込んだ作品はサムネイルしか持たないため、アップロードできません。

うまくいかないとき

症状原因と対処
「YouTubeから取得する」が表示されないYouTube API の認証情報が未登録、またはロールがオーナー・システム管理者ではありません。
「動画の取得に失敗しました。」などチャンネルIDやハンドルの誤り、連携の失効、APIの利用枠の超過などです。入力内容を確認し、時間をおいて再度お試しください。「APIキー」も連携も無い場合は取得できません。
「Client ID / Client SecretがGoogleに拒否されました。…」入力した値の誤りや余分な空白がないか確認し、編集ボタンから更新してください。
「リダイレクトURIがGoogle Cloud Consoleに登録されていません。…」OAuthクライアントの「承認済みのリダイレクトURI」を確認してください。
「自チャンネルの詳細メトリクスを表示するには、…」YouTubeと連携してください。「SNS API統合設定へ」から設定画面を開けます。
「自チャンネルの詳細メトリクスは、ブランドのオーナーまたは管理者だけが表示できます。」一般ユーザーの権限では表示されません。
「連携用のリンクの有効期限（15分）が切れました。設定画面からもう一度連携をお試しください。」認可画面を開いてから15分以上たちました。「SNS API統合」タブから、もう一度連携してください。
「連携用のリンクが正しくありません。設定画面からもう一度連携をお試しください。」古いリンクを開いたなどの理由で連携を完了できませんでした。「SNS API統合」タブから、もう一度連携してください。
「この期間の集計はありません。」選んだ集計期間にデータがありません。期間を変えてください。
「YouTubeへアップロード」が押せない理由が表示されます。「YouTubeへのアップロードは、ブランドのオーナーまたは管理者が行えます。」は一般ユーザーの権限です。「現在のプランではYouTubeへのアップロードを利用できません。」はプランの対象外です。「SNS API統合設定で」連携を求められた場合は、YouTubeと連携してください。
「YouTubeへアップロード」が表示されない「YouTubeから取得する」で取り込んだ作品です。動画ファイルを「動画アップロード」で登録した作品からアップロードしてください。
「YouTubeへのアップロードに失敗しました。」1日のアップロード上限、利用枠の超過、連携の失効、動画ファイルが無い作品などが原因です。表示された理由を確認してください。
「取得履歴に過去動画がありません。…」比較の対象がありません。過去の動画を「YouTubeから取得する」で選んで、取得履歴に保存してください。

関連記事