如果你是行銷人，一定已經開始使用 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！
