將 YouTube 連接到 Social Quack —— 完整指南

YouTube 的做法和 TikTok 一樣：您在 Google 的主控台裡建立一個屬於自己的小型開發者應用程式，幾分鐘就能連上，也能馬上上傳 —— 但在 Google 審查您的專案之前，這些上傳都會維持私人。這一頁會帶您走完前後兩半，每個答案都已備妥、直接貼上即可。這件事只需要做一次。

想跳過 Google 的審查？改用 Zernio 連接：貼上一把金鑰、登入、上傳 —— 幾分鐘搞定，從第一天起就能公開上傳。請看 Zernio 指南。本頁是使用您自己的 Google Cloud 專案、自己動手的路線。

分成兩個階段，完成第 1 階段後就能開始上傳：

Shorts 不需要任何特別處理：3 分鐘以內的直式影片自動就是 Short。

第 1 階段 —— 建立您的 Google Cloud 專案並連接

1. 前往 https://console.cloud.google.com，用擁有您 YouTube 頻道的那個 Google 帳號登入（或任何一個 Google 帳號 —— 頻道稍後再選）。

2. 建立專案：點頂端的專案選擇器 → New project → 取個名字（例如 My Social Quack）→ Create，然後確認它已被選取。

3. 啟用 API：左側選單 APIs & Services → Library → 搜尋 YouTube Data API v3 → Enable。

4. 設定同意畫面：左側選單 APIs & Services → Google Auth Platform（較舊的專案會顯示 OAuth consent screen）→ Get started：

   • App information（應用程式資訊）：應用程式名稱（例如 My Social Quack），user support email 填您自己的電子郵件。
   • Audience（目標對象）：External。
   • Contact information（聯絡資訊）：再填一次您的電子郵件 → 同意 → Create。

5. 把自己加為測試使用者：Google Auth Platform → Audience → Test users → Add users → 填入您的 Google 電子郵件 → Save。（應用程式處於 Testing（測試）狀態期間，只有測試使用者才能連接。）

6. 加入權限範圍：Google Auth Platform → Data Access → Add or remove scopes → 篩選 youtube 並勾選：

   • https://www.googleapis.com/auth/youtube.upload
   • https://www.googleapis.com/auth/youtube.readonly

   → Update → Save。這兩項都屬於「敏感」權限範圍；這只有在第 2 階段才有影響。

7. 建立憑證：Google Auth Platform → Clients → Create client → Application type 選 Desktop app → 取個名字 → Create。複製 Client ID 和 Client secret（也可以下載成 JSON）。

   為什麼選 Desktop app？Social Quack 是在您自己的電腦上執行的，而 Google 的 Desktop 用戶端類型接受 Social Quack 所監聽的 localhost 位址，不需要登記網站。這種用戶端類型沒有需要加入的重新導向網址。如果 Google 出現 redirect_uri_mismatch，代表這個用戶端被建成了 Web application —— 改建一個 Desktop 的就好。

8. 在 Social Quack 裡：Channels → YouTube → Set up keys ▾ → Set up app keys（頻道 → YouTube → 設定金鑰 → 設定應用程式金鑰）→ 貼上 Client ID 和 secret → Connect（連接）。瀏覽器會打開 Google 的登入頁：選擇帳號，若有詢問就選擇頻道，在 "Google hasn't verified this app" 畫面上點 Continue（您就是開發者 —— 第 1 階段出現這個是正常的）。勾選兩項權限 → Continue。您的頻道就會出現在 Connected（已連接）底下。

9. 從 Compose（撰寫）上傳一支測試影片：附上影片，勾選 YouTube 頻道，填寫出現的 YouTube options（YouTube 選項）面板 —— 標題、瀏覽權限、made for kids（為兒童打造）聲明、標籤。立即發布或排定時間。打開 YouTube Studio：影片就在那裡 —— 不管您選的是哪種瀏覽權限，它都是 Private。這是 Google 對未經審查專案的規定（見第 2 階段），不是 Social Quack 的錯誤。

在第 1 階段期間要知道的兩件事：

• 每 7 天重新連接一次。任何處於 Testing 狀態的應用程式，Google 都會在 7 天後讓連接失效。發生時 Social Quack 會在 Channels 裡提醒您；再點一次 Connect 即可。第 2 階段就會結束這種情況。
• 配額：新專案每天可以上傳 100 支影片，其他呼叫則有 10,000 個單位（設定一張縮圖要 50）。個人或小團隊綽綽有餘；代理商可以在第 2 階段申請更多。

第 2 階段 —— 通過審查（公開上傳、連接不再過期）

這裡有兩項各自獨立的審查，由 Google 的兩個不同團隊負責。兩項都要做；每一項都是一份表單。

A. YouTube API 合規稽核 —— 解除「只能私人」的限制

2020 年 7 月 28 日之後建立的每個專案，上傳的影片都會被鎖定為 Private，直到 YouTube 稽核確認它符合 YouTube API Services Terms of Service（服務條款）為止。

1. 打開 YouTube API Services – Audit and Quota Extension Form：https://support.google.com/youtube/contact/yt_api_form
2. 用下方「可直接貼上的答案」來填寫。問到 API 用戶端時，就說這是一個只用於您自己頻道的個人桌面排程工具；要求提供示範時，附上下方「示範影片」一節所說的那段螢幕錄影。
3. 如果您每天需要上傳超過 100 支影片，就在同一份表單裡申請提高配額，並寫明需要多少。

稽核通過時您會收到電子郵件。從此之後，您在 Social Quack 裡選的瀏覽權限（Public / Unlisted / Private）就是 YouTube 實際採用的。

B. OAuth 應用程式驗證 —— 結束每 7 天重連和警告畫面

1. Google Auth Platform → Audience → Publish app → 確認。您的應用程式現在處於 In production（正式版）狀態。從此之後，連接不會再於 7 天後失效。在驗證完成之前，登入時仍會顯示 "Google hasn't verified this app" —— 點 Advanced → Go to (your app name) 繼續即可；每個未經驗證的應用程式，Google 允許最多 100 人這樣做，一個頻道遠遠用不到這麼多。
2. Google Auth Platform → Branding：加入您的應用程式標誌（可選），在 Authorized domains 底下加入 socialquack.com；Application home page 填 https://socialquack.com，Privacy policy 填 https://socialquack.com/privacy，Terms of service 填 https://socialquack.com/terms。儲存。
3. Google Auth Platform → Verification Center → Prepare for verification → 核對資料 → 為每個權限範圍貼上下方「可直接貼上的答案」裡的說明 → 加入您示範影片的連結（以 Unlisted 方式上傳到 YouTube，或放在 Drive 上）→ Submit for verification。
4. Google 會用電子郵件提問並通知結果。只要影片拍到同意畫面以及每一項權限的實際使用，小型個人應用程式的驗證通常都會通過。

您可以完全跳過 B，接受警告畫面和 Advanced → Go to app 這一下點擊 —— 這是個人選擇。但如果您想公開上傳，A 就跳不過去。

可直接貼上的答案

What does your application do?（您的應用程式是做什麼的？）

Personal social-media scheduling tool. I write and schedule posts on my own computer (Social Quack, a self-hosted scheduler that runs locally on my Mac/PC) and it uploads them to my own YouTube channel at the scheduled time. Single user: me. The application never accesses other users' data, does not read comments or analytics, and stores nothing on any server — access tokens are kept encrypted on my computer only and deleted when I disconnect the channel.

How is each scope used?（每個權限範圍如何使用？）

youtube.upload — uploads the video file for a post I created and scheduled myself, with the title, description, tags and visibility I chose, and sets the thumbnail I attached.

youtube.readonly — reads my own channel's name and avatar once, to show which channel is connected in the app.

API client / platform → Desktop application installed on the user's own computer; website https://socialquack.com.

Expected number of users → 1 (my own account). Quota → the default is enough (or state the number of uploads per day you need).

Do you display or store YouTube data? → No. The app only uploads; it shows the channel name in its own settings page and stores nothing about other users.

示範影片 —— 要錄些什麼

一段 60–90 秒的螢幕錄影，一鏡到底，不需要旁白。Mac：⌘⇧5 或 QuickTime → New Screen Recording。

1. (0:00) 打開 Social Quack，展示 Channels（頻道）頁面。
2. (0:05) 在 YouTube 上點 Connect。Google 的登入頁會在瀏覽器中打開 —— 把列出兩項權限的同意畫面拍進去，然後點 Continue。拍出 Social Quack 裡該頻道已經列在 Connected 底下。
3. (0:25) Compose：附上一支短影片，勾選 YouTube 頻道，填寫 YouTube options 面板（標題、瀏覽權限、made-for-kids），點 Post now（立即發布）。
4. (0:45) 展示這則貼文在 Queue（佇列）中變成 published，並點開它的連結。
5. (1:00) 在 YouTube Studio 裡展示您頻道上的這支影片。
6. (1:15，可選) Channels → Remove（移除）YouTube 頻道，展示中斷連接會撤銷存取權。

疑難排解