EP-57｜Threads 洞察報告不夠用？用 Threads API＋Google Sheets 建立可分析的數據儀表板

這篇文章教你用 Threads API 搭配 Google Apps Script，自動抓取貼文與洞察數據並寫入 Google 試算表。你可以把資料交給 Gemini 分析，快速找出哪些貼文帶來更多回覆、轉發、引用與觀看，反推更有效的 Threads 經營策略。

你正在經營 Threads 嗎？或者正在考慮經營自媒體？

話說我最近的 Threads 追蹤終於到 1 萬粉了，但是若要問我怎麼成長的？我也說不出個所以然。

畢竟我的經營策略就是沒有策略，想到什麼發什麼。

可是這樣是不行的，我們最後會發現時間越來越不夠。所以每一篇發文，最好都能精準打擊。

此時我們就需要抓取過往的資料，查看哪一篇文章效果最好，之後就往那篇文章的內容發展。

有經驗的人此時可能會說，那就看洞察報告啊！

是的，在 Threads 的個人首頁上，有個按鈕叫做洞察報告，按下去可以看到 Threads 官方幫你準備的數據。

例如底下這張圖顯示了我的帳號過去一個月的互動，據說演算法最喜歡回覆、轉發、引用，最後才是按讚。

使用 Threads 官方的洞察報告是一個好方法，可惜我們無法進一步分析。

假設我有許多篇文章成效很好，原因是為什麼？我要拿去問 AI ，還得另外截圖，超級麻煩。

我這裡提出更好的方法，就是使用 Threads 官方提供的 API ，我們在 Google Apps Script 寫個自動化腳本，定期抓取資料，放入 Google 試算表。

如果你還有訂閱 Google AI Pro ，你還能在 Google 試算表內，在側邊欄與 Gemini 對話。

是不是爽歪了？

看底下影片查看我怎麼與 Gemini 對話。

Threads API＋Google Apps Script 自動抓取洞察數據

你不一定要裝任何 AI 程式編輯器，只要善用 ChatGPT 或 Gemini 這類免費工具，你就能用「產品經理」的方式把需求講清楚，請 AI 產出程式碼，最後再把程式碼複製貼上到 Google Apps Script 編輯器執行。

抓數據前置需求：Access Token、Spreadsheet ID、Apps Script

1. Threads 的 Access Token （沒有的話底下文章會教你）

2. 一份 Google 試算表，並記下試算表 ID

   Google 試算表網址結構如下：

   https://docs.google.com/spreadsheets/d/這裡是試算表id/edit?gid=xxxxx

3. Google Apps Script 專案（從試算表開啟→擴充功能→Apps Script）

提示詞範本：讓 AI 產出可直接貼上的 Apps Script

如果你希望 AI 產出的程式碼，接近本文介紹的的版本，你的提示詞要像寫規格一樣，把 功能清單、資料欄位、分頁、錯誤處理、寫入格式 都講清楚。

你可以直接複製下面這段提示詞，貼到 ChatGPT 或 Gemini。

請你扮演資深 Google Apps Script 工程師，幫我產出一個「完整的 Google Apps Script 專案程式碼」，我要把它直接複製貼上到 Google Apps Script 編輯器執行。
A. 專案目的

使用 Threads 官方 API 抓取我自己的 Threads 貼文資料與洞察數據，寫入 Google 試算表，並提供試算表選單方便操作。

B. 必要設定（請用 Script Properties）

1. 請不要把敏感資訊寫死在程式碼內。

2. 請用 PropertiesService.getScriptProperties() 讀取兩個指令碼屬性：

• THREADS_ACCESS_TOKEN

• SPREADSHEET_ID

C. 試算表結構（請固定欄位）

1. 建立或取得分頁 Threads_Data。

2. 第一列為標題列，欄位依序為：

• 日期（yyyy-MM-dd HH:mm:ss）

• 文章內容

• 按讚數

• 回覆數

• 轉發數

• 引用數

• 觀看數

• 網址連結

• ID

3. 資料寫入策略：保留標題列，清除舊資料後覆寫（Snapshot 模式）。

4. 目標筆數 limit 預設 20，但允許使用者指定，例如抓 500。

5. 請注意 Threads API 單次請求上限通常為 100，所以分頁時以每批 100 為主。

E. 每篇貼文的 Insights（逐篇抓）

1. 針對每篇貼文呼叫 /{postId}/insights。

2. metric 需要：likes,replies,views,reposts,quotes。

3. 如果 Insights 權限不足或 API 回傳錯誤，不要整個程式中斷，該篇貼文的數據就用 0。

4. 為了避免觸發 rate limit，請加入簡單節流（例如每 10 篇 sleep 100ms）。

F. 用戶洞察與月度趨勢（可選）

1. 在試算表 onOpen() 建立自訂選單 Threads API，至少包含：

• 「抓取預設資料（20筆）」

• 「抓取最近 500 筆資料」

• 「抓取用戶洞察報告」

• 「產生月度趨勢」

2. 「用戶洞察報告」寫入分頁 User_Insights：

• 先抓 /me?fields=id,username,threads_profile_picture_url 取得 userId

• 抓 /{userId}/threads_insights 的 followers_count、likes、replies、reposts、quotes

• views 指標請不要用長時間範圍，改用 API 預設近期資料

• 另外抓 follower_demographics 的 breakdown：country、city、age、gender（若無資料就跳過）

3. 「月度趨勢」寫入分頁 Monthly_Trend：

• 抓近 12 個月 likes、replies、reposts、quotes（依月份 since/until）

• 早於 2024/04/14 的月份跳過

G. 程式結構要求

1. 請把程式拆成清楚的函式，例如：

2. 重要步驟都要有 Logger 紀錄，例如抓到幾筆、分頁進度、錯誤原因。

H. 交付格式

請直接輸出「一份完整可貼上的 Apps Script 程式碼」。不要只給片段。

Apps Script 指令碼屬性設定

我們有兩筆資料需要在 Apps Script 自己設定，

• THREADS_ACCESS_TOKEN

• SPREADSHEET_ID

請在 Apps Script 上面，到專案設定→指令碼屬性，把相關的值填上。

Apps Script 常見錯誤排除：如何提供錯誤訊息讓 AI 幫你修

程式碼出錯很正常，重點是學會怎麼抓錯誤訊息給 AI 看。

在哪裡找錯誤訊息

1. 執行後若出錯，Apps Script 編輯器底部會跳出紅色錯誤訊息

2. 點選左側選單的「執行項目」，可以看到每次執行的詳細紀錄

3. 如果在程式碼中有使用 Logger.log() 輸出，也可在「執行項目」裡展開查看

怎麼問 AI 排除問題

把以下三樣東西一起貼給 AI：

1. 完整的錯誤訊息

2. 出錯的那段程式碼（或整份程式碼）

3. 你做了什麼操作（例如：按了哪個選單、執行哪個函式）

範例提示詞：

我在 Google Apps Script 執行 fetchThreadsPosts 函式時出現以下錯誤：
[貼上錯誤訊息]
這是我的程式碼：
[貼上程式碼]
請幫我找出問題並修正。

Threads API 申請與 Access Token 取得教學（Meta for Developers）

要建立 Threads API ，必須去Meta for Developers。

1. 你要有一個 Facebook 帳號當作 Meta 開發者帳號。

2. 點擊右上角的「我的應用程式」。

3. 點擊「建立應用程式」按鈕。

4. 在選擇應用程式類型時，點選「其他」，然後選擇「存取 Threads API」。

5. 輸入您的「應用程式名稱」（例如：我的 Threads 工具），並提供您的「應用程式聯絡電子郵件」。

6. 若您有 Meta 企業管理平台帳號，可以選擇連結，否則可暫時跳過。

7. 點擊「建立應用程式」，完成後會進入應用程式主控板。

8. 接著你在左邊的「應用程式設定」 -> 「基本資料」，可以看到「應用程式密鑰」。

9. 在左邊的「使用案例」，應該會看到「存取 Threads API」，點進去把 threads_basic、threads_content_publish 等等權限都全部打開。

10. 在左邊的「應用程式角色」->角色，加入你的 Threads 帳號，作為測試人員。然後回到Threads，找到設定 -> 帳號 -> 網站權限 -> 邀請

11. 接著找左邊的「測試」，然後進入「圖形 API 測試工具」，選擇threads.net，然後生成存取權杖，這個權杖是短期的，記得是 1 小時。

12. 把短期權杖換成長期權杖，請用把底下網址貼到瀏覽器

<https://graph.threads.net/access_token?grant_type=th_exchange_token&client_secret=你的應用程式密鑰&access_token=你的短期權杖>

把上面的兩個值換成你自己的：

• 你的應用程式密鑰：在 Meta 開發者後台 → 應用程式設定 → 基本資料 → 應用程式密鑰

• 你的短期權杖：剛剛在圖形 API 測試工具生成的那組

貼到瀏覽器網址列後按 Enter，會回傳一組 JSON：

{
  "access_token": "這就是你的長期權杖",
  "token_type": "bearer",
  "expires_in": 5184000
}

雖然你得到了長期權杖，但是也才兩個月啦，之後定期都得幹這件事，很煩。

請把 Meta 官方文件丟給 AI 讀，告訴 AI 要如何使用 GET /refresh_access_token 端點，定期重新整理未過期的長期 Threads 用戶存取權杖。它就會教你怎麼做了。

我自己是用 Google App Script 自動更新在 Google Sheets 上。

---

其實你就是老闆最便宜的自動化工具。

---

想把 Threads 數據分析做成固定工作流？

如果你想把『抓數據→分析→產出內容策略』做成固定工作流，我創立了付費社群「社畜進化論」，專為想用 AI 提升工作效率的上班族設計。

💎 會員專屬權益

• 基礎課程：涵蓋 AI 知識管理、AI Coding、AI 自動化

• 深度內容：每月至少 2 篇研究筆記、實戰腳本或講解影片

• 交流討論：遇到問題可以在社群提問，一起找解方

• 優惠方案：進階課程享會員專屬折扣

💰 訂閱方案

• 月費制：$5 USD / 月

• 年費制：$50 USD / 年（省 $10）