Threads API 申請教學：
60 天 Token 到期不會通知你，錯誤訊息全對照

打開 console.cloud.google.com，用你的 Google 帳號登入。第一次進去會先要你選國家、勾選同意服務條款，照著按完就好。

登入後看畫面最上方，Google Cloud 標誌右邊有一個專案下拉選單。點開它，右上角選 New project（新增專案）。專案名稱隨便取，例如 n8n-auto-post。Organization（機構）欄位如果你是個人 Gmail，會顯示 No organization，這是正常的，不用改。按 Create。

點左上角的 ☰ 漢堡選單，選 APIs & Services 底下的 Library（程式庫）。

搜尋 Google Sheets API，點進去按 Enable。回到 Library，再搜尋 Google Drive API，一樣按 Enable。

這一步是在告訴 Google：待會會有一個程式來要權限，它叫什麼名字、誰在負責。

左側選單找 Google Auth Platform（舊版叫 OAuth consent screen，Google 已改版重整成這個名字）。第一次進去按 Get started，依序填：App name（隨便取，你自己看得懂就好）、User support email（選你自己的信箱）。

Audience（對象）這一步：個人 Gmail 帳號只能選 External，Internal 會是反灰的，因為那是給有 Google Workspace 組織的公司用的。選 External 繼續，填聯絡信箱、勾選同意政策，按 Create。

Branding 頁裡的 Authorized domains，如果你的 n8n 跑在本機沒有網域，留空不填即可。Data Access（scopes）那一頁也可以先不設定，n8n 授權的時候會自己帶。

這一步順序有點反直覺，但照做會省下很多時間。因為建立憑證時要填的「Redirect URI」，得先從 n8n 那邊複製過來。

先開另一個分頁進 n8n：左側選單 Credentials，按 Add credential，搜尋並選 Google Sheets OAuth2 API（注意不是 Google Sheets API，差一個 OAuth2）。視窗打開後，裡面會顯示一行 OAuth Redirect URL，把它複製起來，這個視窗先不要關、也不用儲存。

它長得像這樣，以你視窗上顯示的為準：

正式站：https://<你的n8n網域>/rest/oauth2-credential/callback
本機跑：http://localhost:5678/rest/oauth2-credential/callback

回到 Google Cloud，走 Google Auth Platform > Clients > Create client（舊版路徑是 APIs & Services > Credentials > + Create credentials > OAuth client ID，兩個入口都通）。Application type 選 Web application，往下找到 Authorized redirect URIs，按 Add URI，把剛剛複製的網址整段貼上，按 Create。

切回剛剛沒關的 n8n 憑證視窗，把 Client ID 貼進 Client ID 欄，Client Secret 貼進 Client Secret 欄，然後按 Sign in with Google。

會跳出 Google 登入視窗，選你的帳號。

同意權限之後視窗會自動關閉，回到 n8n 按 Save。

同一個 Google Cloud 專案裡，走 APIs & Services > Credentials > + Create credentials > Service account。

取個名字（例如 n8n-bot）按 Create and continue。接下來 Google 會問你要給什麼角色、要授權誰管理，這兩頁都可以直接略過，按 Continue、Done。

建好後在列表裡點這個帳號，切到 Keys 分頁，按 Add key > Create new key > 選 JSON > Create。瀏覽器會下載一個 .json 檔案。

用任何文字編輯器打開剛下載的 JSON 檔（記事本、VS Code 都可以），裡面找兩個欄位：

{
  "client_email": "n8n-bot@你的專案.iam.gserviceaccount.com",
  "private_key": "-----BEGIN PRIVATE KEY-----\nMIIEv...很長一串...\n-----END PRIVATE KEY-----\n"
}

在 n8n 新增憑證時一樣搜尋 Google Sheets，但認證方式選 Service Account 模式（不是前面那條路的 OAuth2），把 client_email 貼進 Service Account Email，private_key 貼進 Private Key。

這一步是 Service Account 路線最常被漏掉的關鍵：機器人帳號預設什麼都看不到，你得像分享給同事一樣把表格分享給它。

打開你要用的 Google Sheet，按右上角共用，把剛剛那個 client_email 貼進去，權限給編輯者（n8n 要寫入 ThreadId 回表格，唯讀不夠），送出。

打開 developers.facebook.com，用 Facebook 帳號登入，按註冊成為開發者。會要你驗證 email 和手機（收簡訊驗證碼）、同意條款、選一個職業別。免費，不用商業驗證。

進 My Apps > Create App。填 App 名稱（自己看得懂即可）與聯絡 email，如果問到 business portfolio（商業檔案）可以略過不選。

接著在用途（use case）清單裡選 Access the Threads API。這是關鍵的一步，選錯用途後面找不到 Threads 相關設定。

在 Use cases > Threads API > Customize 的權限清單裡：

• threads_basic：讀基本資料，必備，本來就不能移除
• threads_content_publish：發文用，要自己按 Add 加上去

如果之後想讓機器人自動回覆留言，可以一併加 threads_manage_replies；只是要發主文加留言的話，上面兩個就夠。

同一個 Settings 頁面有三個欄位一定要填：Redirect Callback URL、Deauthorize Callback URL、Data Deletion Request URL。新手到這裡通常會愣住，因為自己根本沒有網站。

你不需要真的架一個伺服器。這三欄可以填同一個你能打開的 https 網址，例如你自己的官網首頁，或任何一個你有權限的網域。它的作用只是「授權完成後把你送到哪裡」，等一下你要做的事，是從跳轉後的網址列把授權碼複製下來。

在 App 後台走 App roles > Roles > Add People，身分選 Threads Tester，輸入你自己的 Threads 帳號名稱，送出。

然後這一步絕對不能漏：打開 Threads App 或網頁版，進 設定 > 帳號 > 網站權限（Website permissions），在邀請清單裡按接受。

下面這串本來就是一行（畫面上會自動折行顯示），整段複製後把 <你的APP_ID> 與 <你登記的網址> 兩處換成自己的值，再貼進瀏覽器網址列。

https://threads.net/oauth/authorize?client_id=<你的APP_ID>&redirect_uri=<你登記的網址>&scope=threads_basic,threads_content_publish&response_type=code

按下同意之後，瀏覽器會跳到你填的那個網址，重點在網址列：後面會多出一段 ?code=AQBx...。把 code= 後面那一長串複製下來。

打開終端機（Mac 內建的「終端機」App），把下面指令的四個 <...> 換成你自己的值，整段貼上按 Enter。Windows 的使用者請用 WSL 或 Git Bash 執行，PowerShell 內建的 curl 不吃這個寫法。

curl -X POST "https://graph.threads.net/oauth/access_token" \
  -F "client_id=<你的APP_ID>" \
  -F "client_secret=<你的APP_SECRET>" \
  -F "grant_type=authorization_code" \
  -F "redirect_uri=<你登記的網址>" \
  -F "code=<剛剛複製的授權碼>"

拿上一步的短期 token，換成正式要用的那張。

curl -s "https://graph.threads.net/access_token?grant_type=th_exchange_token&client_secret=<你的APP_SECRET>&access_token=<上一步的短期TOKEN>"

n8n 沒有官方的 Threads 節點，發文要用 HTTP Request 節點自己打 API。憑證設定方式：Credentials > Add credential > 選 Header Auth，兩個欄位這樣填：

• Name 欄填：Authorization
• Value 欄填：Bearer <你的60天TOKEN>（Bearer 後面有一個半形空格）

存成一個好認的名字，之後所有 Threads 節點共用同一份憑證就好。

發文是兩步驟：先建草稿容器、再發布。用剛剛記下的 user_id。一樣在終端機執行，Windows 請走 WSL 或 Git Bash。

curl -X POST "https://graph.threads.net/v1.0/<你的USER_ID>/threads" \
  -F "media_type=TEXT" \
  -F "text=測試一下自動發文" \
  -F "access_token=<你的60天TOKEN>"

curl -X POST "https://graph.threads.net/v1.0/<你的USER_ID>/threads_publish" \
  -F "creation_id=<上一步回傳的容器ID>" \
  -F "access_token=<你的60天TOKEN>"

如果忘了記 user_id，可以用這個查：

curl -s "https://graph.threads.net/v1.0/me?fields=id,username&access_token=<你的60天TOKEN>"