원클릭으로 Manus에서 모든 스킬 실행

youtube-publishing-rules

스타31

포크6

업데이트2026년 4월 25일 17:27

YouTube Data API v3 發片完整規則 — description 不能含 < > 字元(`>>` `&&` 會被退稿)、Shorts 自動歸類條件、quota 1600/upload、refresh_token 7 天過期沒辦法 cron 自動 refresh、視覺與標題長度限制。任何要寫 YT 自動發片或改 metadata 的 AI 應該先讀。

설치

Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.

Manus에서 실행

출처

js0980420

js0980420/code-to-video-remotion

GitHub 저장소 열기 Creator 저장소 보기

다운로드

Manus에서 실행

YouTube Publishing — Data API v3 完整規則

1. ⚠️ Description 字元黑名單(最容易踩)

YT API 會 reject 含特定 ASCII 字元的 description,回傳 invalidDescription:

< 跟 >(出於 XSS 防護,connector 字元)
影響範圍:不能直接貼 shell 指令裡的 >>(redirect)、<file>(stdin)、HTML-like syntax

解法

影片用到的 shell 指令 不要直接貼 description,改成「指令到 GitHub README 複製」
或用 Unicode 替代字元(≫ U+226B 看起來像 >> 但合法)
或用敘述式:「把 export 那行 append 到 ~/.zshrc 並 source 一次」

其他字元限制

長度上限 5000 字元(含換行)
emoji / Unicode box drawing(──)/ 中文標點都 OK
URL 自動 hyperlink(IG 不會,YT 會)

2. Title / Tags 規格

欄位	上限	備註
Title	100 字元	過長 API 退稿
Description	5000 字元	見上
Tags(個別)	30 字元	API 不擋,但 YT UI 會截
Tags(總長度)	500 字元(所有 tag 加逗號)	超過 API 退稿

3. Shorts 自動歸類

YT 沒有 isShort API flag。Shorts 是自動判定:

符合三條件 → 自動進 Shorts feed:

垂直比 9:16(1080×1920 之類,正方形也勉強算)
長度 ≤ 3 分鐘(2024 起放寬,以前 60s)
(推薦,但非必要)title / description 含 #Shorts

實作上直接用 videos.insert 上傳垂直短 mp4 就好,跟一般 video API 路徑完全相同。可加 --shorts flag 自動把 #Shorts 塞 description 開頭(YT 演算法看 description 前 100 字)。

4. Token 生命週期(踩坑警告)

Testing mode 下 refresh_token 7 天死

youtube.upload scope 是 restricted scope,Testing mode 下 refresh_token 只活 7 天
⚠️ 用 refresh_token 換 access_token 不會延長 refresh_token 自身的 7 天倒數 — cron 自動 refresh 沒用
拿新 refresh_token 必須重做整套 OAuth(瀏覽器人工同意),不可 headless

實務最佳解

接受每週手動跑一次 node scripts/youtube-oauth.mjs(30 秒)
永久不死 → Google verification(送審 4-6 週)或 Workspace + Internal app type

5. Quota

預設 每天 10,000 點
videos.insert(上傳新影片):1,600 點/支 → 一天最多 6 支
videos.update(改 metadata):50 點/次
thumbnails.set:50 點/次
超過要去 Cloud Console 申請 quota(要寫使用情境)

改 metadata 不算重發 — title / description / tags / category / 縮圖都可透過 videos.update + thumbnails.set 更新,只有影片 binary 不能換(要刪重發)。

6. 視覺規格

縮圖:JPG / PNG,< 2MB,1280×720 16:9
影片:mp4,< 256GB,< 12 小時(個人發片不會碰到上限)
categoryId 常用:
- 28 = Science & Technology(本專案 default)
- 27 = Education
- 22 = People & Blogs

7. API / 腳本邊界

實作走 scripts/publish-youtube.mjs(已存在)。跟 IG/Threads 不同 — YT 直接 binary 上傳,不用先 host。

Visibility 預設 private 安全

--visibility 不帶就是 private,確認 metadata 都對才改 public。改 visibility 用 videos.update 50 quota 點,很便宜。

三段操作(本專案 publish-youtube.mjs 的流程)

refresh_token → access_token(換一小時臨時 token)
POST videos.insert?uploadType=multipart&part=snippet,status(JSON metadata + 影片 binary)
(選填)POST thumbnails.set 上自訂縮圖

8. 失敗處理

錯誤	解法
`invalidDescription`	找 `<` `>` 字元 / 超 5000 字 / 內容違規(政治 / 暴力 / 兒少不宜),最常見 `>>` `<` 在貼 shell 指令時
`invalid_grant` 換 access_token 時	refresh_token 過期 → 重跑 `youtube-oauth.mjs`
`accessNotConfigured`	YouTube Data API v3 沒在 Google Cloud project 啟用 → 去 Cloud Console enable
`quotaExceeded`	今天 quota 用完(發 6 支或大量 update),等 24h 或申請增加
`selfDeclaredMadeForKids` 必填	metadata 一定要含 `status.selfDeclaredMadeForKids: false`(本專案已固定 false)

9. 跟其他平台共版時

YT description 可以放完整連結(IG 不行、脆有字數限制)→ 把 GitHub repo / 圖文教學 / 影片提到的指令(避開 >>)都塞 description
YT title 用 ASCII | 沒問題(脆要 ｜)
YT 不用 hashtag 區塊(IG 規則),tags 走 metadata 欄位即可

이 저장소의 다른 Skills

같은 저장소

remotion-best-practices

js0980420/code-to-video-remotion

Best practices for Remotion - Video creation in React

2026-05-0931

tutorial-reel-rendering

js0980420/code-to-video-remotion

9:16 Reel 影片兩大渲染問題的根因與修法：(1) justifyContent:center 造成 sub-pixel 文字跳動、(2) 字幕 CC 風格切句規則（、，。？！；斷行，移除，。，保留？！：...、）。每次動 StepScene / SubtitleOverlay / 任何 block 動畫時必讀。

2026-05-0931

tutorial-voiceover-style

js0980420/code-to-video-remotion

Tutorial 影片寫 voiceover 的工作順序(先鎖圖再寫配音、先預覽再 render)、內容規範、ElevenLabs 模型 / 速度設定。任何要動 intro / step.voiceovers / outro 字串、或要跑 generate-tutorial-voiceover.ts / render:tutorial 的 AI 都應該先讀。

2026-05-0931

tutorial-publish-pipeline

js0980420/code-to-video-remotion

教學影片 render + publish 跨平台 pipeline 共用規則 — 5 階段管線(工作目錄→對話⇆預覽→後製→發佈,對話⇆預覽內部 iterative)/ 雙 mp4(16:9 + 9:16)/ 字幕用 Remotion 元件 / BGM/縮圖/配音全 Remotion 自動 / YT 章節 / 全平台 public 預設 / 文案全形指令半形。任何要 render 教學影片或 publish 到 YT/IG/脆的 AI 動工前先讀。

2026-04-3031

threads-algorithm-rules

js0980420/code-to-video-remotion

Threads (Meta) 演算法紅線 R1–R12 + 信號 S1–S14 + 發文後策略 P1–P4 + 帳號層級 A1–A2 — 任何要寫脆貼文 / 改脆草稿 / 跑 daily-threads-post / 跑 publish-threads.mjs 的 AI,動工前先讀一遍做演算法對齊 self-check。內容改自 AK-Threads-Booster 的 knowledge/algorithm.md (MIT, 2026-03-31 版本)。

2026-04-2931

x-publishing-rules

js0980420/code-to-video-remotion

⚠️ DEFERRED 2026-04-27 — 本 channel 暫不發 X。Skill 內容保留(規則參考),但動工前先跟使用者確認真的要做 X 才執行,別自動把 X 列進跨平台發片清單。X (Twitter) 發 thread / single post 完整規則 — 2026-Q1 起 Grok 演算法接管、hashtag 上限 1–2 個、外連結 -30~50% 觸及、Thread 比單推 +63% 曝光。

2026-04-2731

name	youtube-publishing-rules
description	YouTube Data API v3 發片完整規則 — description 不能含 < > 字元(`>>` `&&` 會被退稿)、Shorts 自動歸類條件、quota 1600/upload、refresh_token 7 天過期沒辦法 cron 自動 refresh、視覺與標題長度限制。任何要寫 YT 自動發片或改 metadata 的 AI 應該先讀。

YouTube Publishing — Data API v3 完整規則

1. ⚠️ Description 字元黑名單(最容易踩)

YT API 會 reject 含特定 ASCII 字元的 description,回傳 invalidDescription:

< 跟 >(出於 XSS 防護,connector 字元)
影響範圍:不能直接貼 shell 指令裡的 >>(redirect)、<file>(stdin)、HTML-like syntax

解法

影片用到的 shell 指令 不要直接貼 description,改成「指令到 GitHub README 複製」
或用 Unicode 替代字元(≫ U+226B 看起來像 >> 但合法)
或用敘述式:「把 export 那行 append 到 ~/.zshrc 並 source 一次」

其他字元限制

長度上限 5000 字元(含換行)
emoji / Unicode box drawing(──)/ 中文標點都 OK
URL 自動 hyperlink(IG 不會,YT 會)

2. Title / Tags 規格

欄位	上限	備註
Title	100 字元	過長 API 退稿
Description	5000 字元	見上
Tags(個別)	30 字元	API 不擋,但 YT UI 會截
Tags(總長度)	500 字元(所有 tag 加逗號)	超過 API 退稿

3. Shorts 自動歸類

YT 沒有 isShort API flag。Shorts 是自動判定:

符合三條件 → 自動進 Shorts feed:

垂直比 9:16(1080×1920 之類,正方形也勉強算)
長度 ≤ 3 分鐘(2024 起放寬,以前 60s)
(推薦,但非必要)title / description 含 #Shorts

4. Token 生命週期(踩坑警告)

Testing mode 下 refresh_token 7 天死

youtube.upload scope 是 restricted scope,Testing mode 下 refresh_token 只活 7 天
⚠️ 用 refresh_token 換 access_token 不會延長 refresh_token 自身的 7 天倒數 — cron 自動 refresh 沒用
拿新 refresh_token 必須重做整套 OAuth(瀏覽器人工同意),不可 headless

實務最佳解

接受每週手動跑一次 node scripts/youtube-oauth.mjs(30 秒)
永久不死 → Google verification(送審 4-6 週)或 Workspace + Internal app type

5. Quota

預設 每天 10,000 點
videos.insert(上傳新影片):1,600 點/支 → 一天最多 6 支
videos.update(改 metadata):50 點/次
thumbnails.set:50 點/次
超過要去 Cloud Console 申請 quota(要寫使用情境)

改 metadata 不算重發 — title / description / tags / category / 縮圖都可透過 videos.update + thumbnails.set 更新,只有影片 binary 不能換(要刪重發)。

6. 視覺規格

縮圖:JPG / PNG,< 2MB,1280×720 16:9
影片:mp4,< 256GB,< 12 小時(個人發片不會碰到上限)
categoryId 常用:
- 28 = Science & Technology(本專案 default)
- 27 = Education
- 22 = People & Blogs

7. API / 腳本邊界

實作走 scripts/publish-youtube.mjs(已存在)。跟 IG/Threads 不同 — YT 直接 binary 上傳,不用先 host。

Visibility 預設 private 安全

--visibility 不帶就是 private,確認 metadata 都對才改 public。改 visibility 用 videos.update 50 quota 點,很便宜。

三段操作(本專案 publish-youtube.mjs 的流程)

refresh_token → access_token(換一小時臨時 token)
POST videos.insert?uploadType=multipart&part=snippet,status(JSON metadata + 影片 binary)
(選填)POST thumbnails.set 上自訂縮圖

8. 失敗處理

錯誤	解法
`invalidDescription`	找 `<` `>` 字元 / 超 5000 字 / 內容違規(政治 / 暴力 / 兒少不宜),最常見 `>>` `<` 在貼 shell 指令時
`invalid_grant` 換 access_token 時	refresh_token 過期 → 重跑 `youtube-oauth.mjs`
`accessNotConfigured`	YouTube Data API v3 沒在 Google Cloud project 啟用 → 去 Cloud Console enable
`quotaExceeded`	今天 quota 用完(發 6 支或大量 update),等 24h 或申請增加
`selfDeclaredMadeForKids` 必填	metadata 一定要含 `status.selfDeclaredMadeForKids: false`(本專案已固定 false)

9. 跟其他平台共版時

YT description 可以放完整連結(IG 不行、脆有字數限制)→ 把 GitHub repo / 圖文教學 / 影片提到的指令(避開 >>)都塞 description
YT title 用 ASCII | 沒問題(脆要 ｜)
YT 不用 hashtag 區塊(IG 規則),tags 走 metadata 欄位即可