如果你是行銷人，一定已經開始使用 Threads 來經營品牌，然而，與 Instagram 或 Facebook 相比，Threads 的後台功能相對簡陋，目前甚至沒有提供貼文數據查詢或下載功能，對社群經營者來說，會面臨 2 個大問題：

• 想查看歷史貼文表現，得一篇一篇點開看。
• 要製作成效報告，需要人工整理多個數據。

但每天處理其他庶務的時間都不夠，怎麼會有時間整理這些繁瑣的數據？因此此篇文章將教你如何利用 Meta 提供的 Threads API，自己打造一個自動化報表系統。這樣做有以下好處：

• 完全客製化：只擷取你真正需要的數據。
• 省時又高效：省去翻找報表的麻煩，輕鬆掌握精準數據。

即便日後 Meta 提供 Threads 的數據分析工具，在你了解如何透過 API 自己串接資料後，就能省去翻找報表的時間，只抓你想看的數據出來。

什麼是 API ?

API 就像外送平台，而你是訂餐的顧客，當你在外送平台下單時，外送平台（API）會把你的需求傳達給餐廳（系統後台），餐廳會準備餐點（數據結果），再由外送員（API）送到你面前。因此只需要將數據需求送出，API 就會幫忙拉出資料。

實作前，先認識 Threads API 文件可取得哪些資料

Threads API 提供豐富的數據分析功能。在開始實作前，建議先了解可收集的數據類型及其定義。例如在 Threads Insights API 中，你可以取得以下常見的貼文數據：

• 觀看數
• 互動回覆數
• 分享數

在使用 Threads API 時，請注意以下重要限制：

• 2024年6月1日前的使用者數據分析功能不保證可靠性。
• 無法查詢 2024年4月13日之前的歷史數據。
• 只有粉絲數達到 100 人以上的帳號才能使用數據分析功能。

首先，需要先完成基本前置作業

第一步：設定 Meta 應用程式

前往 Meta for Developers，使用你的 Facebook 帳號登入，如果還沒有開發者帳號，流程中會引導你完成帳號註冊。

登入後，建立新應用程式：
1.在首頁點擊右上角的「建立應用程式」按鈕。

2.填寫應用程式名稱（例如：Threads_品牌名稱）。
3.填寫聯絡信箱：使用你的主要聯絡信箱。

4.新增使用案例：選擇「存取 Threads API」。
5.選擇想連結應用程式到哪個商家資產管理組合：可選擇企業帳號或選擇不想連結。

然後，進入應用程式主控版： 1.點擊右側欄位「主控版」，存取 Threads API 並新增以下權限：

• threads_basic
• threads_manage_insights
• threads_read_replies

2.點選右側欄位「應用程式角色」新增用戶：將想要拉出數據的 Threads 帳號加進來，並到 Threads 帳號裡面「授權網站權限」。

3.點選右側欄位「測試」：點選「測試使用案例」，並開啟「圖形 API 測試工具」，將網址切換到 Threads.net 後 Generates Threads Access Token，再按提交，看是否能正常跑出資料，如都正常，則已完成初步設定。

第二步：取得存取權杖（Access Token）

先理解 Token 是什麼？ Token 就像是一張門禁卡，當你要進入大樓時，需要刷門禁卡來確認你的身份，在使用 API 時，Token 就是你的門禁卡，它告訴 API 這個請求是來自經過授權的使用者，因此需要好好保存！ 不要傳給他人或在網路上分享！Token 是你的「通行證」，拿到的人就能「假冒」你、使用你的權限，比如輸出機密數據、刪除貼文等等！

什麼是長期＆短期 Token？

• 短期 Token 就像是一張期限很短的門禁卡，可以讓你進入某處，但過期後需要重新申請，適合臨時使用或測試。
• 長期 Token 則是期限較長的門禁卡，功能與短期 Token 一樣，但省去頻繁更新的麻煩，更適合需要長期運作的場景，例如自動化數據撈取。

取得長期 Token 有兩個步驟：

1. 先取得短期 Token

a. 先取得「應用程式密鑰」 i. 進入應用程式主控板，點選「應用程式設定」- 「基本資料」後，下滑找到 Threads 應用程式密鑰欄位並點擊「顯示」，此串代碼即為應用程式密鑰。

b. 再取得「短期 Token」 i. 進入此串網址：https://developers.facebook.com/tools/explorer/。 ii. 右側 Meta 應用程式選擇剛建立的應用程式。 iii. 將左側的網址切成 threads.net。 iv. 點擊「 Generates Threads Access Token」，上方的存取權杖即為短期 Token。 備註：若先前已經在基礎設定時完成圖形 API 測試，那當時產出的存取權杖即為短期 Token。

c. 將以下 URL中的 <你的應用程式密鑰> 和 <短期 Token> 位置填入相應內容，再將完整的 URL 貼到瀏覽器網址欄中執行，就會看到一個長期 Token。

2. 將短期 Token 換成長期 Token

a. 將剛剛取得的短期 Token 填入以下網址中的 <剛才網頁上取得的TOKEN>，並將完整的 URL 貼到瀏覽器中執行。

完成以後先將整串長期 Token 筆記下來，等等串接 API 時會用到！ 也再次提醒，不要傳給他人或在網路上分享！

接下來，兩個步驟完成 Threads API 串接

第一步：透過 AI 產出 Google Apps Script 所需指令

以撈貼文數據為例，假設理想中的流程是： 透過 Google Sheets 自動匯入 Threads 資料，並能選定特定日期區間的數據。

指令就可以這樣下（可依照需求修改）：

○ 概述需求： 幫我生成一段 Google Apps Script 指令，從 Threads API 中拉出特定日期範圍的貼文數據。

○ 需要匯入的數據： 從 Threads API 中擷取以下數據：

• 貼文 ID
• 貼文發布時間
• 貼文內容
• 觀看數
• 按讚數
• 回覆數
• 轉發數
• 引用數
• 分享數

○ 程式碼需要包含以下功能：

• 增加前台執行選單，選項包括擷取數據。
• 用戶輸入日期範圍（格式為 YYYY/MM/DD - YYYY/MM/DD）後，程式會根據日期範圍，篩選貼文並擷取數據。
• 將數據匯入 Google Sheets，包含標題列（如貼文 ID、觀看數等）並自動格式化欄位（例如數字格式）。

○ 參數設定： 程式碼須包含以下參數，確保執行過程順利。

• ACCESS_TOKEN：用於 API 驗證的 Token。
• USER_ID：Threads 帳號的使用者 ID。
• SPREADSHEET_ID：Google 試算表的 ID。
• APP_SECRET：API 應用程式密鑰。

第二步：將指令放入 Google Sheet 裡面

• 完成後，你會得到類似下圖的指令：

（備註：圖片僅為示意，非完整程式碼）

• 打開 Google Sheets 中的「擴充功能」並選擇 App Script ，並將 ChatGPT 提供的程式碼貼上。

• 將需要替換的參數貼上後儲存，按下執行並授權權限，跑出數據的話就成功了！

參數怎麼替換？

• ACCESS_TOKEN
  填入剛剛設定的長期 Token。
• USER_ID
  填入前面測試圖形 API 時跑出的 ID。
• SPREADSHEET_ID
  填入 Google Sheets 網址中的試算表 ID （https://docs.google.com/spreadsheets/d/<試算表 ID>/edit ）。
• APP_SECRET
  填入 Meta for Developers 裡，應用程式設定 -> 基本資料 -> Threads 應用程式密鑰。

無法正常新增前台執行選單？ 需要注意變成函式（function） 後的程式碼如何顯示，例如「新增 Google Sheets 選單」的函式為 「onOpen() 」，需要確認確實為相對應的函式後再按下執行，否則會無法新增成功！

還想學習其他自動化情境來優化工作流程嗎？

如果你有定期寄 Email 的任務，推薦你看這篇文章，不用程式背景即可一次處理全部信件，所有流程在 Google Sheets 上就能搞定！

看完這篇 API 數據整理術，是不是覺得自動化報表沒那麼難？如果你還想學習更多數據報表整理技巧，推薦你看看這篇，就能一次整合多個社群媒體平台，並計算出必要的 KPI！