使用您自己的 Google 應用程式
透過您自己建立的 Google 應用程式連接 Gmail、Google 日曆和 Google 雲端硬碟，由您決定 Haruno 可以做什麼。
這是什麼
當您連接 Gmail、Google 日曆或 Google 雲端硬碟時，Haruno 會先向 Google 請求您的授權。通常它是透過 Haruno 自己的 Google 應用程式來請求，而該應用程式刻意只要求很小的一組權限。
您也可以改為註冊自己的 Google 應用程式。這是免費的，在 Google 自己的網站上一次完成。之後 Haruno 會透過您的應用程式連接，授權畫面就屬於您。若您願意，可以授予更多權限：閱讀郵件，以及存取整個 Google 雲端硬碟，而不只是一個 Haruno 資料夾。
您需要準備什麼
- 一個 Google 帳戶。一般的 Gmail 位址就足夠，不需要 Google Workspace。
- 大約 15 到 30 分鐘，只需一次。
- 不需付費。建立自己的 Google 應用程式是免費的。
- 已在 Mac 或 PC 上安裝的 Haruno，以及最後 Google 提供給您的檔案。
這項設定只做一次。之後連接 Gmail、Google 日曆和 Google 雲端硬碟的方式與以前完全相同。
開始之前：需要有心理準備的兩件事
在花時間之前，有兩點值得先了解，兩者都取決於您在步驟 3 中的一個選擇。
在該警告畫面上，請選擇「進階」，然後選擇繼續。Google 警告的這個應用程式就是您自己的。
您也可以請 Google 審核並發布您的應用程式，以取消每週重新登入。但審核需要時間，而且要求閱讀郵件的應用程式還必須通過一項安全評估，這需要由您自行安排並負擔費用。對於個人自用的應用程式，維持測試狀態並每週重新登入通常比較簡單。
建立您的 Google 應用程式
- 開啟 Google Cloud 主控台，用您想使用的 Google 帳戶登入。建立一個新專案，名稱可以自訂，例如「Haruno」。
- 在新專案中開啟「API 與服務」，啟用其中三項：Gmail API、Google Calendar API 和 Google Drive API。即使您只打算連接其中一項，也請三項都啟用，以免之後還要回頭處理。
- 開啟授權畫面（同意畫面）設定，填寫應用程式名稱和您的電子郵件地址。在目標對象中，若使用一般 Gmail 帳戶請選擇「外部」；若您有 Google Workspace 並希望免去每週重新登入，請選擇「內部」。
- 如果選擇了「外部」，請找到測試使用者清單，將您打算連接到 Haruno 的每一個 Google 帳戶都加進去，包括您自己的帳戶。這是最容易被忽略的一步。不在清單中的帳戶無法登入，無論其他設定多麼正確——而且每新增一個要連接的帳戶，都需要在這裡個別加入。
- 開啟「憑證」，選擇建立憑證，選擇「OAuth 用戶端 ID」，並將應用程式類型選為「電腦版應用程式」。網頁應用程式類型的用戶端無法與 Haruno 搭配使用。
- 在用戶端建立後 Google 立即提供的下載按鈕處，馬上下載 JSON 檔案。密鑰只會顯示這一次。
- 在 Haruno 中開啟「設定」，接著是「連接器」，選擇使用您自己的 Google 應用程式。上傳剛才下載的檔案，或從中複製用戶端 ID 和用戶端密鑰。之後照常連接 Gmail、Google 日曆或 Google 雲端硬碟——您看到的授權畫面現在屬於您自己的應用程式。
Google 會不時修改這些畫面的名稱。如果某個畫面的用詞與上述步驟略有不同，請依含義尋找，而不是逐字對照。
每項權限分別解鎖什麼
連接時，Google 會顯示一份附核取方塊的權限清單，您可以逐項選擇。取消勾選某一項，只是表示 Haruno 無法執行該列中的操作。
| Google 畫面上的權限 | Haruno 因此可以做什麼 |
|---|---|
| 代表您傳送郵件 | 撰寫並傳送郵件，以及傳送您已核准的回覆。 |
| 閱讀、撰寫和刪除您的郵件 | 搜尋和閱讀郵件、開啟附件、在對話中回覆、用標籤整理郵件，以及將郵件移到垃圾桶。 |
| 管理您的郵件標籤 | 建立、重新命名和套用標籤。如果已授予上一列權限，則已包含在內。 |
| 查看和編輯您所有日曆上的活動 | 查看行程，並建立、修改或取消活動。 |
| 僅查看、編輯、建立和刪除您在此應用程式中使用的 Google 雲端硬碟檔案 | 在雲端硬碟中的一個 Haruno 資料夾內作業，外加您自己選定的檔案。 |
| 查看、編輯、建立和刪除您全部的 Google 雲端硬碟檔案 | 使用整個 Google 雲端硬碟，並讓您選擇的資料夾保持同步。 |
切換回去或移除您的應用程式
您隨時可以改變主意。在 Haruno 的設定中移除您的 Google 應用程式後，新建立的連接會重新使用 Haruno 內建的應用程式。
已經建立的連接會繼續使用建立它們的那個應用程式，所以切換的當下不會有任何東西中斷。當某個連接確實需要移轉時，Haruno 會在該連接器上說明原因，而重新登入只需要幾秒鐘。
遇到問題時
| 您看到的內容 | 含義與處理方式 |
|---|---|
| Error 403: access_denied | 您登入所用的帳戶不在應用程式的測試使用者清單中。請在 Google Cloud 主控台中新增——每個要連接的帳戶都需要個別新增——然後再試一次。 |
| 瀏覽器顯示錯誤頁面，而不是 Google 的登入畫面 | 您建立的用戶端是網頁應用程式類型。請重新建立一個，並將應用程式類型選為「電腦版應用程式」。 |
| Haruno 大約每週要求您重新登入 Google | 您的應用程式仍處於測試狀態。這是 Google 的規則，不是故障。重新登入只需幾秒鐘；使用 Google Workspace 的內部應用程式可以完全取消這項限制。 |
| 訊息中出現 accessNotConfigured | 三項服務中有一項未在您的專案中啟用。請回到「API 與服務」，啟用 Gmail、Google Calendar 和 Google Drive API。 |
| 「Google 尚未驗證這個應用程式」 | 這在此處是預期且安全的：這是您自己的應用程式，只是尚未經過 Google 審核。請選擇「進階」，然後繼續。 |
| Haruno 要求您重新登入以完成切換 | 該連接是用另一個應用程式建立的——可能是 Haruno 內建的應用程式，或您先前的應用程式。在該連接器上重新登入即可移轉。 |