#Google の設定

This feature is provided by the commercial plugin «メール管理», please purchase to use

#前提条件

ユーザーが Google メールアカウントを NocoBase に連携できるようにするには、Google サービスにアクセス可能なサーバーに NocoBase をデプロイする必要があります。NocoBase のバックエンドが Google API を呼び出すためです。

#アカウントの登録

1. https://console.cloud.google.com/welcome を開いて Google Cloud にアクセスします。
2. 初めてアクセスする場合は、関連する規約に同意する必要があります。

#アプリの作成

1. 上部の「Select a project」をクリックします。

2. ポップアップ内の「NEW PROJECT」ボタンをクリックします。

3. プロジェクト情報を入力します。

4. プロジェクト作成後、そのプロジェクトを選択します。

#Gmail API の有効化

1. 「APIs & Services」ボタンをクリックします。

2. APIs & Services ダッシュボードに移動します。

3. 「mail」と検索します。

4. 「ENABLE」ボタンをクリックして、Gmail API を有効にします。

#OAuth 同意画面の設定

1. 左側の「OAuth consent screen」メニューをクリックします。

2. 「External」を選択します。

3. プロジェクト情報（承認ページに表示されます）を入力し、「保存」をクリックします。

4. 開発者の連絡先情報を入力し、「続行」をクリックします。

5. 「続行」をクリックします。

6. アプリ公開前のテスト用にテストユーザーを追加します。

7. 「続行」をクリックします。

8. 概要情報を確認し、ダッシュボードに戻ります。

#認証情報（Credentials）の作成

1. 左側の「Credentials」メニューをクリックします。

2. 「CREATE CREDENTIALS」ボタンをクリックし、「OAuth client ID」を選択します。

3. 「Web application」を選択します。

4. アプリケーション情報を入力します。

5. プロジェクトの最終的なデプロイ先ドメインを入力します（ここでは NocoBase のテストアドレスを例としています）。

6. 承認済みリダイレクト URI を追加します。これは「ドメイン + "/admin/settings/mail/oauth2"」の形式である必要があります。例：https://pr-1-mail.test.nocobase.com/admin/settings/mail/oauth2

7. 「作成」をクリックすると、OAuth 情報を確認できます。

8. Client ID と Client secret をそれぞれコピーし、メール設定ページに貼り付けます。

9. 「保存」をクリックすると、設定が完了します。

#アプリの公開

上記の手順が完了し、テストユーザーによる認証ログインやメール送信などの機能テストが完了したら、アプリを公開できます。

1. 「OAuth consent screen」メニューをクリックします。

2. 「EDIT APP」ボタンをクリックし、その後、下部の「SAVE AND CONTINUE」ボタンをクリックします。

3. 「ADD OR REMOVE SCOPES」ボタンをクリックし、ユーザーの権限スコープを選択します。

4. 「Gmail API」と入力して検索し、「Gmail API」にチェックを入れます（スコープ値が「https://mail.google.com/」である Gmail API であることを確認してください）。

5. 下部の「UPDATE」ボタンをクリックして保存します。

6. 各ページ下部の「SAVE AND CONTINUE」ボタンをクリックし、最後に「BACK TO DASHBOARD」ボタンをクリックしてダッシュボードページに戻ります。

7. 「PUBLISH APP」ボタンをクリックすると、公開に必要な関連コンテンツがリストされた公開確認ページが表示されます。その後、「CONFIRM」ボタンをクリックします。

8. 再びコンソールページに戻ると、公開ステータスが「In production」になっていることを確認できます。

9. 「PREPARE FOR VERIFICATION」ボタンをクリックし、必須情報を入力して「SAVE AND CONTINUE」ボタンをクリックします（図中のデータは例です）。

10. 必要な関連情報を引き続き入力します（図中のデータは例です）。

11. 「SAVE AND CONTINUE」ボタンをクリックします。

12. 「SUBMIT FOR VERIFICATION」ボタンをクリックして、認証（Verification）を提出します。

13. 承認結果を待ちます。

14. 承認がまだ保留中の場合でも、ユーザーは「unsafe」リンクをクリックして認証ログインを行うことができます。