Creating a Web App in Your Google Cloud Console

Introduction

In order for Gravity SMTP to send messages from your Google / Gmail account, you will need to create an application in Google Cloud Console and provide the plugin with a token. You must complete this step before configuring the Google/Gmail integration in Gravity SMTP. This article outlines the steps to create a web app in the Google Cloud Console.

Prerequisites

  • A Google account with access to Google Cloud Console. A billing account is not required to enable the Gmail API or send mail at normal volumes.

Step 1: Create a Project

  1. Visit Google Cloud Console
    Open your browser and go to Google Cloud Console.
  2. Create or Select a Project
    Click on the project dropdown menu in the top navigation bar. You can create a new project or select an existing one.
Image showing the Google Cloud Console dashboard.
  1. Switch to the Preferred Project
    Once the project is created or selected, ensure it’s active by selecting it from the dropdown menu.
Image showing the Google Cloud Console screen to select an existing project or create a new project.

Step 2: Enable the Gmail API

  1. Navigate to APIs & Services
    In the Google Cloud Console, go to the “APIs & Services” section and click on “Library.”
Image showing the Google Cloud Console Library menu
  1. Search for Gmail API
    Type “Gmail API” in the search bar and select it from the search results.
Image showing Gmail API in the Google Cloud Console
  1. Enable the API
    Click the “Enable” button to activate the Gmail API for your project.

Step 3: OAuth2 – App Registration

Note: This step is only required to register a new app. If you have already created an app, you can skip to Step 4 to create a Client for the app.

  1. Go to Google Auth Platform
    In the Cloud Console, open the left-hand menu and select “Google Auth Platform.” On a new project, you will see “Google Auth platform not configured yet.” Click “Get Started”.
Image showing the Google Auth Platform dashboard
  1. App Information
    Enter your app name and a user support email.
Image showing the Google Auth Platform dashboard
  1. Audience
    Select “External” and click “Next.”
Image showing the Google Auth Platform dashboard
  1. Contact Information
    Enter the developer’s contact email.
Image showing the Google Auth Platform dashboard
  1. Finish
    Review and accept the Google API Services User Data Policy, then click “Continue” and “Create.”
Image showing the Google Auth Platform dashboard

Step 4: Set Up OAuth2 Credentials

  1. Navigate to Clients
    Within Google Auth Platform, click the “Clients” tab in the left-hand menu.
  2. Create Client
    Click “Create Client.”
Image showing the OAuth Client dashboard
  1. Choose Application Type
    Select “Web application” as the application type.
  2. Enter Client Details
    Provide a name for your OAuth client and add an Authorized Redirect URI. You will use the one provided by Gravity SMTP in the Google / Gmail connection settings.
  1. Create the Client
    Click “Create” to generate your OAuth credentials.
Image showing Credentials for an OAuth client

Step 5: Publish your App

  1. Go to Audience. Click on Publish App.
Image showing Audience settings for unpublished app.
  1. Confirm publishing
    Click “Push to Production” in the dialog that appears.
Image showing confirmation dialog to publish an app to production in the Google Cloud Console

Note: Until your app passes Google’s formal verification process, users authorizing it, including you, will see an “unverified app” screen.