#Google Configuration

#Prerequisites

For users to connect their Google Mail accounts to NocoBase, it must be deployed on a server that can access Google services, as the backend will call the Google API.

#Register an Account

1. Open https://console.cloud.google.com/welcome to go to Google Cloud.
2. You will need to agree to the terms and conditions on your first visit.

#Create an App

1. Click "Select a project" at the top.

2. Click the "NEW PROJECT" button in the pop-up.

3. Fill in the project information.

4. After the project is created, select it.

#Enable the Gmail API

1. Click the "APIs & Services" button.

2. Go to the APIs & Services dashboard.

3. Search for "mail".

4. Click the "ENABLE" button to enable the Gmail API.

#Configure OAuth consent screen

1. Click the "OAuth consent screen" menu on the left.

2. Select "External".

3. Fill in the project information (this will be displayed on the authorization page) and click save.

4. Fill in the Developer contact information and click continue.

5. Click continue.

6. Add test users for testing before the app is published.

7. Click continue.

8. Review the summary information and return to the dashboard.

#Create Credentials

1. Click the "Credentials" menu on the left.

2. Click the "CREATE CREDENTIALS" button and select "OAuth client ID".

3. Select "Web application".

4. Fill in the application information.

5. Enter the final deployment domain of the project (the example here is a NocoBase test address).

6. Add the authorized redirect URI. It must be domain + "/admin/settings/mail/oauth2". For example: https://pr-1-mail.test.nocobase.com/admin/settings/mail/oauth2

7. Click create to view the OAuth information.

8. Copy the Client ID and Client secret and paste them into the email configuration page.

9. Click save to complete the configuration.

#Publish the App

After completing the above process and testing features like test user authorization login and email sending, you can publish the app.

1. Click the "OAuth consent screen" menu.

2. Click the "EDIT APP" button, then click the "SAVE AND CONTINUE" button at the bottom.

3. Click the "ADD OR REMOVE SCOPES" button to select the user permission scopes.

4. Search for "Gmail API", then check "Gmail API" (confirm the Scope value is the Gmail API with "https://mail.google.com/").

5. Click the "UPDATE" button at the bottom to save.

6. Click the "SAVE AND CONTINUE" button at the bottom of each page, and finally click the "BACK TO DASHBOARD" button to return to the dashboard page.

7. Click the "PUBLISH APP" button. A confirmation page will appear, listing the required information for publishing. Then click the "CONFIRM" button.

8. Return to the console page, and you will see the publishing status is "In production".

9. Click the "PREPARE FOR VERIFICATION" button, fill in the required information, and click the "SAVE AND CONTINUE" button (the data in the image is for demonstration purposes only).

10. Continue to fill in the necessary information (the data in the image is for demonstration purposes only).

11. Click the "SAVE AND CONTINUE" button.

12. Click the "SUBMIT FOR VERIFICATION" button to submit for verification.

13. Wait for the approval result.

14. If the approval is still pending, users can click the unsafe link to authorize and log in.