使用 Google OAuth 將 Gmail 連線至 Odoo¶

Odoo 與 Google 的 Gmail OAuth 相容。若要從自訂網域傳送安全的電子郵件,只需在 Google Workspace 平台以及 Odoo 資料庫後端設定一些設定即可。此設定可使用個人電子郵件地址或自訂網域建立的地址。

小訣竅

如需更多資訊,請造訪 Google 的使用說明以了解如何設定 OAuth。

其他資料

在 Google 中設定¶

建立新專案¶

首先,請前往 Google API Console。如果您有 Google Workspace 帳戶,請使用該帳戶登入;否則請使用您的個人 Gmail 帳戶登入(這應與您要在 Odoo 中設定的電子郵件地址相符)。

接著,按一下建立專案,此按鈕位於 OAuth 同意畫面的最右側。如果此帳戶中已建立專案,則新專案選項將位於右上方的選取專案下拉式選單中。

在新專案畫面中,將專案名稱重新命名為 Odoo,並瀏覽位置。將位置設定為 Google Workspace 機構。如果您使用的是個人 Gmail 帳戶,請將位置保留為無機構。

按一下建立以完成此步驟。

編輯應用程式註冊¶

接下來我們將設定專案的應用程式註冊。

在 OAuth 同意畫面步驟中,於應用程式資訊區段下,在應用程式名稱欄位中輸入 Odoo。在使用者支援電子郵件欄位下選取機構的電子郵件地址。

接下來,在應用程式網域 ‣ 已授權的網域下,按一下新增網域並輸入 odoo.com。

然後,在開發人員聯絡資訊區段下,輸入機構的電子郵件地址。Google 會使用此電子郵件地址通知機構有關專案的任何變更。

接下來,按一下儲存並繼續按鈕。然後,捲動至底部並按一下儲存並繼續,以跳過範圍頁面。

如果繼續以測試模式 (External) 操作，請在 Test users 步驟中加入正在配置的電子郵件地址，按一下 Add Users，然後按一下 Save and Continue 按鈕。應用程式註冊摘要隨即顯示。

最後，捲動至底部並按一下 Back to Dashboard 以完成專案設定。

建立憑證¶

現在專案已設定完成，應建立憑證，其中包括 Client ID 和 Client Secret。首先，按一下左側選單中的 Credentials。

然後，按一下頂部選單中的 Create Credentials，並從下拉式選單中選擇 OAuth client ID。

在 Application Type 下，從下拉式選單中選擇 Web Application。
在 Name 欄位中，輸入 Odoo。
在 Authorized redirect URIs 標籤下，按一下 ADD URI 按鈕，然後在 URIs 1 欄位中輸入 https://yourdbname.odoo.com/google_gmail/confirm。請務必將網址中的 yourdbname 部分替換為實際的 Odoo 資料庫名稱。
接下來，按一下 Create 以產生 OAuth Client ID 和 Client Secret。最後，複製每個產生的值以便稍後在 Odoo 中配置時使用，然後導覽至 Odoo 資料庫。

Google OAuth 的 Client ID 和 Client Secret。

在 Odoo 中設定¶

輸入 Google 憑證¶

首先，開啟 Odoo 並導覽至 Apps 模組。然後，從搜尋列中移除 Apps 篩選條件並輸入 Google。安裝名為 Google Gmail 的模組。

接下來，導覽至 Settings ‣ General Settings，在 Discuss 區段下，確保已勾選 Custom Email Servers 或 External Email Servers 的勾選方格。這將顯示 Gmail Credentials 或 Use a Gmail Sever 的新選項。然後,將各自的值複製並貼上到 Client ID 和 Client Secret 欄位中,並儲存設定。

配置外寄郵件伺服器¶

若要配置外部 Gmail 帳戶，請返回 Custom Email Servers 設定頂部，然後按一下 Outgoing Email Servers 連結。

然後，按一下 New 或 Create 以建立新的電子郵件伺服器，並填寫 Name、Description 和電子郵件 Username (如有需要)。

接下來，按一下 Gmail OAuth Authentication 或 Gmail (在 Authenticate with 或 Connection 區段下)。最後，按一下 Connect your Gmail Account。

將開啟標示為 Google 的新視窗以完成授權程序。選擇正在 Odoo 中配置的適當電子郵件地址。

如果電子郵件地址是個人帳戶，則會彈出額外步驟，請按一下 Continue 以允許驗證並將 Gmail 帳戶連線至 Odoo。

然後，按一下 Continue 或 Allow 以允許 Odoo 存取 Google 帳戶。之後，頁面會導覽回 Odoo 中新配置的外寄電子郵件伺服器。配置會自動在 Odoo 中載入權杖，並以綠色顯示 Gmail Token Valid 標籤。

最後，測試連線。應該會出現確認訊息。Odoo 資料庫現在可以透過 Google 使用 OAuth 驗證傳送安全的電子郵件。

Google OAuth 常見問題¶

正式環境與測試發布狀態¶

選擇正式環境作為發布狀態`（而非 :guilabel:`測試）將顯示以下警告訊息：

要修正此警告，請前往 Google API Platform。如果發布狀態為正式環境，請按一下返回測試以修正此問題。

未加入測試使用者¶

如果 OAuth 同意畫面未加入測試使用者，則會出現 403 存取遭拒錯誤。

要修正此錯誤，請返回 API 與服務下的 OAuth 同意畫面，並將測試使用者加入應用程式。加入您在 Odoo 中設定的電子郵件。

Gmail 模組未更新¶

如果 Odoo 中的 Google Gmail 模組尚未更新至最新版本，則會出現禁止錯誤訊息。

要修正此錯誤，請前往應用程式模組並清除搜尋字詞。然後，搜尋 Gmail 或 Google 並升級 Google Gmail 模組。最後，按一下模組右上角的三個點並選擇升級。

應用程式類型¶

建立憑證（OAuth 用戶端 ID 和 用戶端密鑰）時，如果為應用程式類型選擇桌面應用程式，則會出現授權錯誤。

要修正此錯誤，請刪除已建立的憑證並建立新憑證，為應用程式類型選擇網頁應用程式。然後，在已授權的重新導向網址下，按一下加入網址並在欄位中輸入：https://yourdbname.odoo.com/google_gmail/confirm，務必將網址中的 yourdbname 替換為 Odoo 資料庫名稱。

在 GitHub 上編輯