YouTube 連携セットアップ手順 (まるごとSNS)

本書はまるごとSNS から YouTube (Short / Long) へ動画を自動投稿するための、お客様側の作業手順です（API・OAuth の設定は弊社で完了済みです）。

1. 仕組みの概要

まるごとSNS は YouTube Data API v3 の videos.insert で動画をアップロードします。認証は Google OAuth 2.0。初回取得の refresh_token を Fernet 暗号化で DB 保存し、以降は自動でアクセストークン再発行。

Short — 9:16 縦、60 秒以内、タイトルに #shorts を自動付与
Long — 16:9 横 (数分〜十数分)

2. 事前準備

Google アカウント と、そのアカウントが管理する YouTube チャンネル
チャンネル側の電話番号認証 — YouTube Studio → 設定 → チャンネル → 機能の利用資格で電話番号確認を済ませておく（未認証だと channelUploadsDisabled が返ります）

Google Cloud / YouTube API の設定（OAuth クライアント作成・API 有効化・審査）は弊社で完了済みです。 お客様の作業は 「YouTube アカウントの連携」 と 「プラン作成」 だけです。

3. YouTube アカウントを連携

左メニューの 「設定」 →「SNS アカウント管理」の YouTube 行で 「+ YouTube アカウントを追加」 を押します
Google のログイン画面で、投稿に使う YouTube チャンネルの Google アカウント でログイン
「YouTube への動画アップロード」権限を許可 します
まるごとSNS に戻り、YouTube の欄に追加したチャンネルが表示されれば連携完了です

「Google によって確認されていません」という警告が出たら：画面左下の 「詳細（Advanced）」 →「{アプリ名}（安全ではないページ）に移動」を押すと許可画面に進めます（未審査運用時の Google の標準動作です。運用担当者ご自身が許可してください）。

4. プランを作成

左メニューの 「プラン管理」→「新規プラン追加」 でウィザードを開き、種別 → 投稿スケジュール（YouTube の曜日を選択）→ 事業内容 → SNS 連携（YouTube が「接続済」を確認）→ プレビュー（プラン名を入力して保存） の順に進めます。画面の流れは X 連携手順書と共通です。投稿タイプ（Short / Long）は詳細設定で選べます。

5. 投稿制限 (2026 年時点の目安)

値は随時変わるため最新は YouTube Data API - Quota を確認してください。

API quota: 1 プロジェクト 1 日 10,000 units (デフォルト)
videos.insert コスト: 約 1,600 units / 回 = 1 日およそ 6 本が実質上限。Quota Extension 申請で増枠可
Short は 60 秒以内、9:16、#shorts 必須 / Long は最大 12 時間、16:9 推奨
未認証チャンネルは 15 分超の動画を投稿不可

6. よくあるエラー

※ Google Cloud / API・OAuth の設定は弊社管理のため、下記のうち Console 起因のエラー（redirect_uri 等）は通常お客様側では発生しません。発生した場合は弊社までご連絡ください。

エラー	原因	対処
`403 quotaExceeded`	日次 quota 超過	翌日まで待機 or 増枠申請
`401 invalid_grant`	refresh_token 失効	組織設定から再認証 (審査前は 7 日毎)
`400 channelUploadsDisabled`	チャンネル側 upload 無効	YouTube Studio で電話番号認証
`redirect_uri_mismatch`	redirect URI 不一致	§3-4 の URL を 1 文字違わず再登録
`403 accessNotConfigured`	API 未有効化	§3-2 を再実施

7. セキュリティ

Client Secret / refresh_token は Fernet 暗号化で DB 保存、multi-tenant 分離されています。Google 側でアクセス取り消しを行いたい場合は Google アカウントのセキュリティ設定からまるごとSNS のアクセス権を削除してください。