# 學校信箱亂糟糟？❌ 這招讓成大 Gmail 公告信『自動分類』變超整齊！📂✨

> [!Caution]
> 本專案基於大神[nyraa](https://github.com/nyraa/moodle-calendar/blob/rest/README.zh.md#moodle-calendar) ，並非我做的，只是參考並把內容說明優化而已

---

## 第一步：先幫學校公告信『集合』起來！📥 (建立總收件箱標籤)

這個步驟的目的是，先把所有從學校寄出的公告信貼上一個共同的「總標籤」
（例如：`公告` 📌），這樣小幫手才知道哪些信是它該處理的。

1. 打開你的**學校 Gmail** 帳號。📧
2. 點擊右上角的**齒輪 ⚙️ (設定圖示)** > 然後選擇『查看所有設定』。
3. 點擊最上方的選單，切換到『篩選器和已封鎖的地址』這一頁。
4. 找到並點擊『建立新篩選器』。➕
5. 在『寄件者』這個欄位**複製貼上**學校公告信的信箱：
`[e-mail]` 👈 (這是成大發公告信的統一寄件者喔！)
6. 點擊『建立篩選器』。
7. 跳到下一頁後，找到並**勾選『套用標籤』** ，然後點旁邊的「選擇標籤...」> 『新標籤...』。
8. 彈出的小視窗中，標籤名稱就打 `公告` 🏷️ (或你喜歡的總名稱，但後面的教學都會用 `公告` 作為例子，建議統一)。然後按下『建立』。
9. 💡 **重點：** 最後！最後！一定要**勾選** 最下方的 **『同時將篩選器套用至 XXX 個相符的會話群組』**。這樣以前的公告信也會被統一整理起來！
10. 點擊 **『建立篩選器』** 完成設定。

<br>

## 第二步：讓小幫手動起來！跑程式、做分類（第一次操作必看）🏃‍♂️

這個步驟我們會去開啟一個由Google提供的「自動化程式碼」，然後讓它幫你處理信箱裡所有已經有「公告」標籤的信件，自動幫它們分更細的類，同時會取得你的授權才能讀取你的信箱。🔐

1. 點擊這裡打開自動整理的程式碼頁面 👉 [傳送門](https://script.google.com/d/1qbvvdGtI5CiiZcUPqwyXTnuff4L8QQFQdhY-0yHCDWUcBV_19shVjlCG/edit?usp=sharing)
>[!Warning]重要提醒
記得用**你的學校Google帳號**登入喔！🧑‍💻

2. 頁面打開後，在左側選單找到 **『總覽』** -> 然後點選『建立複本』按鈕 把程式碼複製到你自己的帳號下。
* (請依圖示找到並點選這個按鈕 ⬆️)

3. 複製完後，自動會跳轉到你自己的程式碼編輯頁面。💻
* 然後到左側選單點選 **『編輯器』** (圖示是 `< >` ) > 接著點開 **`main.gs`** 這個檔案。📂

4. **修改程式碼：** ✍️
* 請找到**第 4 行**的文字，長得像這樣：

        const main_label_name = "在這輸入要處理的公告總標籤名稱";

* 把 `""` 裡面那句 `在這輸入要處理的公告總標籤名稱`，**整個替換成**你第一步設定的總標籤名稱。如果前面你是打 `公告`，那修改後就會像這樣：

        const main_label_name = "公告"; // 像這樣 ✅

* 確認無誤後，請儲存檔案，點上方 **『儲存』的圖示 💾。

5. **開始執行程式！** ▶️
* 確認最上方綠色橫條，功能選單顯示的是 `process_email`。
* 然後點旁邊的 **▶️ 執行** 按鈕。

6. **同意授權（很常看到，別緊張！）** 🛑
* 第一次執行時，Google 會跳出一個「需要授權」的視窗，請點**『審查權限』**。🔍
* 選擇你的**學校 Google 帳號**。👤
* 你可能會看到一個警告：「Google尚未驗證這個應用程式」。😱 別擔心，Google沒驗證是因為這是你自己建立的程式，但這是安全的！👍
* 請點**『進階』**，然後點 **『前往 [你的專案名稱] (不安全)』**。
別緊張，這裡的「不安全」只是 Google 的提示，因為這不是公開應用程式，對你的個人資料沒有威脅。🛡️
* 最後，勇敢的按下 **『允許』**，程式就可以操作你的Gmail了！✅

7. 等待程式執行：⏳
* 成功的話，你就會看到下方出現**『執行紀錄』**，程式會開始跑，這可能需要十幾分鐘，因為它在處理你所有信件。📜
* **如果第一次執行時，下方顯示類似 `Requested entity was not found` 的錯誤**：❌
* 這是一個很常見的小狀況，可能是Google伺服器資料同步需要時間。
通常再點一次 ▶️ 就會正常了，放心多試幾次。就算最後沒成功妳的gmail如果有標籤就代表成功了
* 執行完成後，去看看你的 Gmail 信箱，側邊欄應該已經多了許多依照單位自動分類好的標籤囉！

<br>

## 第三步：讓小幫手每天自動上班！設定自動更新排程 ⏰

都設定好了，當然希望這個自動整理功能是持續有效的，而不是只執行一次就停。這個步驟就是讓小幫手每天自動整理新信件，以後都不用管它！

1. 在程式碼編輯器左側，點擊 **『觸發條件』圖示 (就是那個鬧鐘 ⏰ 圖示)**，進入「觸發條件」頁面。
2. 點擊右下角的**『＋新增觸發條件』**。🆕
3. 依照下面這些項目來設定：
* **『選擇要執行的功能』：** 選 `process_email` (應該會是預設選項) ฟังก์ชัน 🏃‍♂️
* **『選取活動來源』：** 選 `時間驅動` 🕰️
* **『選取時間型根據類型』：** 選 `日計時器` 📅
* **『選取時段』：** 建議選 **`午夜 12 點到凌晨 1 點`** (這是離峰時間，比較不會影響你白天使用電腦)
4. 點擊右下角的 **『儲存』**。✅

恭喜你！到這裡，自動分類的魔法就完成了！以後，你的學校公告信都會被乖乖的分類好囉！🪄

<br>

## 第四步：把常用標籤排到最上面（可省略）⬆️

Gmail 的標籤預設是照筆畫順序排的，如果想把最常用的單位（例如：「電機系」）排在列表最上面，可以這樣做：📌

1. **建立優先標籤：** ✨
* 在 Gmail 左側標籤列表的最下方，點擊「建立新標籤」。
* 為了讓這個標籤排在最前面，名稱可以加上特殊符號或數字，例如：`*電機系` 🌟 或 `01-電機系` 🥇。

2. **修改篩選器：** ✏️
* 回到 Gmail「設定」>「篩選器和已封鎖的地址」這一頁。🗑️
* 找到小幫手為「電機工程學系」自動建立的那個篩選器（它可能會叫做 `From (no-reply@...) contains (電機工程學系) has:label (公告)` ），點擊右邊的**『編輯』**。✍️
* 直接點 **『繼續』**，進入設定下一步的動作頁面。➡️
* 找到舊標籤的選項 (例如 `公告/電機系`)，把**勾勾取消掉**。✖️
* 然後在「套用標籤」中，**勾選**你剛剛建立的『*電機系』（也就是新的優先標籤）。✅
* 點擊 **『更新篩選器』**。🔄

3. **(可選) 刪除舊標籤：** 🚮
* 為了讓標籤列表更整潔，你可以回到 Gmail 側邊欄，找到那個你不再需要的舊標籤（例如 `公告/電機系`），滑鼠移過去會有三個點點 `⋮`，點下去選擇「移除標籤」。🗑️

這樣就大功告成啦！你的學校Gmail，從此煥然一新！是不是覺得自己突然變得超會整理啦？🤩