Connect Gmail to Odoo using Google OAuthを使用してGmail¶
Odooは、GoogleのGmail用OAuthと互換性があります。カスタムドメインから安全なEメールを送信するには、Googleの Workspace プラットフォームとOdooデータベースのバックエンドで、いくつかの設定を行うだけで済みます。この設定は、個人用メールアドレスまたはカスタムドメインで作成されたアドレスを使用して機能します。
ちなみに
さらに詳しくはOAuthセットアップの Googleドキュメンテーション をご覧下さい。
Googleでの設定¶
新規プロジェクトを作成¶
まず、`Google APIコンソール <https://console.developers.google.com>`_にアクセスします。Google Workspace アカウントをお持ちの場合は、そのアカウントでログインして下さい。お持ちでない場合は、個人用Gmailアカウントでログインして下さい(これは、Odooで設定するEメールアドレスと一致している必要があります)。
その後、OAuth 同意画面 の右端にある プロジェクト作成 をクリックします。このアカウントでプロジェクトがすでに作成されている場合は、新規プロジェクト オプションが プロジェクトを選択 ドロップダウンメニューの下の右上に表示されます。
プロジェクト名 を Odoo
に変更し、ロケーション を参照します。ロケーション を Google Workspace 組織 に設定します。個人用 Gmail アカウントを使用している場合は、ロケーション を 組織なし のままにしておきます。
このステップを完了するには、作成 をクリックします。
OAuth同意スクリーン¶
ページが OAuth 同意画面 をクリックします。
オプションにリダイレクトされない場合は、左側のメニューにあるユーザータイプ のオプションから適切な ユーザータイプ を選択し、再度 作成 をクリックすると、最終的に ページに移動します。
警告
個人用 のGmailアカウントは、外部 ユーザタイプのみ許可されており、Googleによる承認が必要になる場合や、スコープ を追加する必要がある場合があります。しかし、Google WorkSpace アカウントを使用すると、内部 ユーザタイプを使用することができます。
また、API接続が 外部 テストモードにある間は、Googleからの承認は必要ありません。このテストモードにおけるユーザの制限は100ユーザに設定されています。
アプリ登録を編集¶
次に、プロジェクトのアプリ登録を設定します。
OAuth 同意画面 の手順で、アプリ情報 セクションの アプリ名 フィールドに Odoo
と入力します。ユーザサポート のEメールフィールドで、組織のEメールアドレスを選択します。
次に、ドメイン追加 をクリックし odoo.com
を入力します。
その後、開発者連絡先情報 セクションで、組織のEメールアドレスを入力します。Googleは、このEメールアドレスを使用して、プロジェクトに変更があったことを組織に通知します。
次に、保存して続行 ボタンをクリックします。次に、 ページをスクロールして一番下まで移動し、保存して続行 をクリックしてスキップします。
テストモード (外部) を継続する場合は、テストユーザ の段階で設定したEメールアドレスを、ユーザを追加 をクリックし、保存して続行 ボタンをクリックして追加します。アプリ登録の概要が表示されます。
最後に、一番下までスクロールし、ダッシュボードに戻る をクリックしてプロジェクトの設定を完了します。
認証情報の作成¶
プロジェクトの設定が完了したので、クライアントID と クライアントシークレット を含む認証情報を作成します。まず、左サイドバーメニューの:guilabel:認証情報
をクリックします。
次に、トップメニューの 認証情報の作成 をクリックし、ドロップダウンメニューから OAuthクライアントID を選択します。
アプリケーションタイプ の下にあるドロップダウンメニューから、ウェブアプリケーション を選択します。
名前 フィールドで
Odoo
を入力します。承認済みのリダイレクトURI のラベルの下にある URIを追加 ボタンをクリックし、URIs 1 フィールドに
https://yourdbname.odoo.com/google_gmail/confirm
と入力します。 URL の yourdbname 部分は、実際の Odoo データベース名に置き換えてください。次に、作成 をクリックして、OAuth の クライアントID と クライアントシークレット を生成します。最後に、Odoo の設定時に使用するために、生成された各値をコピーし、Odoo データベースに移動します。
Odooでのセットアップ¶
Google認証情報を入力する¶
まず、Odooを開き、アプリ モジュールに移動します。次に、検索バーから アプリ フィルタを削除し、Google`と入力します。:guilabel:`Google Gmail
モジュールをインストールします。
次に、ディスカス セクションで、カスタムEメールサーバ または 外部メールサーバ のチェックボックスがオンになっていることを確認します。これにより、Gmail認証情報 または Gmailサーバを使用 の新しいオプションが有効になります。次に、それぞれの値を クライアントID および クライアントシークレット フィールドにコピー&ペーストし、設定を 保存 します。
に移動し、送信メールサーバの設定¶
外部Gmailアカウントを設定するには、カスタムEメールサーバ`設定の一番上に戻り、:guilabel:`送信メールサーバ リンクをクリックします。
次に、新規作成 または:guilabel:作成
をクリックして新しいEメールサーバを作成し、名前、説明、Eメールの:guilabel:ユーザ名
(必要な場合)を入力します。
次に、Gmail OAuth認証 または Gmail`(:guilabel:`認証 または 接続 セクションの下) をクリックします。最後に、Gmailアカウントを接続 をクリックします。
:guilabel:`Google`とラベル付けされた新しいウィンドウが開き、認証プロセスが完了します。Odooで設定されている適切なEメールアドレスを選択します。
メールアドレスが個人アカウントの場合、追加のステップがポップアップ表示されます。:guilabel:`続行`をクリックして、検証を許可し、GmailアカウントをOdooに接続します。
次に、続行 または 許可 をクリックして、OdooにGoogleアカウントへのアクセスを許可します。その後、ページはOdooで新たに設定された送信メールサーバに移動します。設定によりOdooにトークンが自動的に読み込まれ、:guilabel:`Gmail トークン有効`というタグが緑色で表示されます。
最後に、接続テスト をクリックします。確認メッセージが表示されます。これで、OdooデータベースはOAuth認証を使用してGoogleを通じて安全なEメールを送信できるようになりました。
Google OAuth FAQ¶
本番 VS 公開ステータステスト¶
本番 を 公開ステータス (テスト) として選択すると以下の警告が表示されます:
To correct this warning, navigate to the Google API Platform. If the Publishing status is In Production, click Back to Testing to correct the issue.
テストユーザが追加されていません¶
OAuthの同意画面にテストユーザが追加されていない場合、403アクセス拒否エラーが表示されます。
このエラーを修正するには、API & サービス の OAuth 同意画面 に戻り、テストユーザをアプリに追加します。Odooで設定しているEメールを追加します。
Gmailモジュールが更新されていません¶
Odooの Google Gmail モジュールが最新バージョンに更新されていない場合、:guilabel:`Forbidden`エラーメッセージが表示されます。
このエラーを修正するには、Gmail
または Google
を検索し、Google Gmail モジュールを更新します。最後に、モジュール右上の3つの点をクリックし、更新 を選択します。
アプリケーションタイプ¶
When creating the credentials (OAuth Client ID and Client Secret), if Desktop App is selected for the Application Type, an Authorization Error appears.
このエラーを修正するには、すでに作成済みの認証情報を削除し、新しい認証情報を作成します。アプリケーションタイプ`として:guilabel:`ウェブアプリケーション を選択します。次に 認証済のリダイレクトURI の下で URI追加 をクリックし、: https://yourdbname.odoo.com/google_gmail/confirm
と入力します。URL内の yourdbname をOdooデータベース名に置換えることを忘れないで下さい。。