Skip to main content

Gmail API 串接

請依以下步驟將 Google Workspace Gmail 串連至 Google Cloud 專案。

1. Google Cloud - 前往【Google Cloud】並登入​

前往 https://console.cloud.google.com/projectcreate

2. Google Cloud -【建立】專案​

填寫【專案名稱】及【機構】欄位，並【建立】專案。

gmail-integration-01

3. Google Cloud - 前往 Google Cloud 專案【程式庫】​

等待專案建立完成後，點選【API 和服務】／【程式庫】。

gmail-integration-02

4. Google Cloud - 選擇【Gmail API】服務​

頁面下拉並選擇【Gmail API】服務。

gmail-integration-03

5. Google Cloud - 啟用【Gmail API】服務​

gmail-integration-04

6. Google Cloud - 設定 OAuth - 側邊欄選擇【OAuth 同意畫面】​

gmail-integration-05

7. Google Cloud - 設定 OAuth -【OAuth 同意畫面】-User Type 設定​

若之前有在 Google Workspace 設定機構，選擇【內部】，否則選擇【外部】。

gmail-integration-06

8. Google Cloud - 設定 OAuth -【OAuth 同意畫面】- 應用程式相關資訊 1​

設定【應用程式名稱】、【電子郵件】( 必填 ) 及【應用程式標誌】( 選填 )。

gmail-integration-07

9. Google Cloud - 設定 OAuth -【OAuth 同意畫面】 - 應用程式相關資訊 2​

【應用程式網域】為選填，可填入要 Gmail 代為收送信件的網站相關連結，【開發人員聯絡資訊】請填當前設定者 Email。
應用程式相關資訊全部都填寫完後點選【儲存並繼續】。

gmail-integration-08

10. Google Cloud - 設定 OAuth -【OAuth 同意畫面】- 範圍設定​

範圍可直接點選【儲存並繼續】。

gmail-integration-09

11. Google Cloud - 設定 OAuth -【OAuth 同意畫面】- 測試使用者​

測試使用者部分如果前面第 7 步【OAuth 同意畫面】User Type 是選擇【外部】，則需要填寫所有會使用到此 OAuth 驗證的相關使用者 Email ( 通常是有後台管理員權限的使用者 )。
若 User Type 是選擇【內部】，則不需要填寫，但之後 OAuth 驗證必須要使用 Google Workspace 機構內部的帳號。
設定完後點選【儲存並繼續】。

gmail-integration-10

12. Google Cloud - 設定 OAuth -【OAuth 同意畫面】 - 摘要​

檢查【OAuth 同意畫面】資訊是否設定正確。

gmail-integration-11

13. Google Cloud - 設定憑證​

側邊欄選擇【憑證】。 gmail-integration-13

14. Google Cloud - 設定憑證 - 設定 OAuth 用戶端 ID​

選擇上方【建立憑證】／【OAuth 用戶端 ID】。

gmail-integration-14

15. Google Cloud - 設定憑證 - 設定【應用程式類型】​

選擇網頁應用程式。

gmail-integration-15

16. Google Cloud - 設定憑證 - 設定 OAuth 用戶端【名稱】及【已授權的重新導向 URI】​

gmail-integration-17

17. Google Cloud - 設定憑證 - 【複製已授權的重新導向 URI】​

由管理者後台頁面複製已授權的重新導向 URI。

gmail-integration-18

18. Google Cloud - 設定憑證 - 建立憑證​

選擇【建立】。

gmail-integration-17

19. 後台管理頁面 - 複製【用戶端編號】及【用戶端密鑰】​

【複製】彈出畫面的【用戶端編號】及【用戶端密鑰】。

gmail-integration-19

20. 後台管理頁面 - 設定【寄件者電子郵件地址】、【寄件者名稱】、【用戶端 ID】及【用戶端密鑰】​

填入 Gmail 要代替寄件方寄送信件的 Email 地址及寄件方要顯示的名稱，並將前面在 Google Cloud 專案複製的【用戶端編號】及【用戶端密鑰】貼進來。
點選【儲存並驗證】。

gmail-integration-20

21. OAuth 驗證 - 選擇要進行 OAuth 驗證的【帳戶登入】​

請使用於 Google Cloud OAuth 設定中被允許的帳戶 ( OAuth 設定中 User Type 選【外部】) ，或 Google Workspace 機構下的帳戶 ( OAuth 設定中 User Type 選【內部】)。

gmail-integration-21

22. OAuth 驗證 - 錯誤代碼 403​

若之前在 Google Cloud OAuth 設定中未設定允許的帳戶，則會顯示錯誤代碼 403。
請返回 Google Cloud 的【OAuth 同意畫面】進行設定。

gmail-integration-22

23. OAuth 驗證 -【OAuth 同意畫面】設定【測試使用者】​

請返回 Google Cloud 的【OAuth 同意畫面】設定【測試使用者】。

gmail-integration-23

24. OAuth 驗證 - 應用程式未經 Google 驗證 ( 可由步驟 28 解決此問題 )​

設定完 OAuth 允許的帳戶，在管理者後台頁面點選儲存並驗證後若顯示如下畫面，請點選【繼續】。

gmail-integration-24

25. OAuth 驗證 - 允許 OAuth 授權​

點選【繼續】允許授權。

gmail-integration-25

26. OAuth 驗證 - 授權完成後畫面會顯示【Google OAuth 驗證成功】​

gmail-integration-26

27. 後台管理頁面 - 完成串接​

此時檢查後台管理者頁面中，驗證狀態是否顯示【已驗證】，及【目前 OAuth 連接的使用者帳號】是否與上步驟 Google OAuth 登入的帳號一致。
若驗證狀態顯示【已驗證】且【目前 OAuth 連接的使用者帳號】與 Google OAuth 登入的帳號一致則表示管理後台與 Gmail 串接完成。

gmail-integration-27

28. 備註： 解決【這個應用程式未通過 Google 驗證】問題​

方法一​

若出現【這個應用程式未通過 Google 驗證】的畫面如步驟 24 ，請至【OAuth 同意畫面】，選擇【發佈 APP】或【PUBLISH APP】，點選【確認】後發佈。
當【Publishing status】顯示【In production】表示發佈完成，此時進行 OAuth 驗證應可解決步驟 24 問題；若仍出現未驗證畫面則至方法二繼續解決此問題。

gmail-integration-28
gmail-integration-29
gmail-integration-30
gmail-integration-31

方法二​

若出現【這個應用程式未通過 Google 驗證】的畫面如下，則是因為在 OAuth 驗證設定時有【設定應用程式標誌】、【新增超過 10 個網域】、【請求機密或受限制範圍】等狀況。
此時請至【OAuth 同意畫面】申請驗證，驗證過程需要填入【應用程式首頁】及【應用程式隱私權政策】頁面連結，請確認您的網站是否已設置此兩種頁面。
驗證過程約 3-5 天，過程中可能需要使用前面 OAuth 驗證步驟中填入的開發人員 Email 做驗證流程確認，待驗證完成後即可解決此問題。

gmail-integration-32
gmail-integration-33
gmail-integration-34
gmail-integration-35
gmail-integration-36
gmail-integration-37