Create Custom Google App in Google Cloud Platform

Use the Google Cloud platform to create a new project and enable APIs and Services. These are required to use Gmail with Vantagepoint Connect.

Pre-requisites:

  • To use Vantagepoint Connect in your Gmail account, you must have a Google Workspace account (formally G Suite). You cannot use a personal .gmail.com email with Vantagepoint Connect.
  • You must use Chrome with Vantagepoint Connect for Gmail.
  • To use Connect, the Vantagepoint application must be exposed to the internet via a publicly facing URL. If your network or firewall is configured to only allow certain IP addresses to access Vantagepoint, it will be necessary to add Connect IP addresses to the Allow list. See the Troubleshoot Synchronization and Connect Add-in Issues help topic for the list of IP addresses.
  • The security role for the individual who is responsible for configuring Connect must have access to Connect Administration. In Settings > Security > Roles, on the Overview tab, make sure that Connect Administration is selected under Utilities > Integrations.
  • The individual who is responsible for configuring Connect (selecting the Connect Administration option in Utilities > Integrations), must have an employee record associated with their user record in Settings > Security > Users. The employee record must also have a valid email address.
  • Each employee who will use Connect must have an employee record that includes an email address and is associated with a user record in Settings > Security > Users.
  • Windows authentication for the on-premises application is not supported with Vantagepoint Connect.
  • You must have a Client ID and Secret in API Authorization in Utilities > Integrations. Note: You only need to generate the secret once for all integrations. If you generate a new secret any time thereafter, all current integrations using the old secret will be broken until you refresh your access token for those integrations.

To create a custom Google app in the Google Cloud platform:

  1. In Chrome, go to the Google Cloud Platform (https://console.cloud.google.com/) and select API & Services from the menu:
  2. Create a project:
    • If this is your first custom app, click New Project.
    • If you have created an app in the past, use the Select a Project drop-down at the top to create another project.
  3. Enter a name for the project. For example, Vantagepoint Connect.
    A notification displays that the project was created.
  4. Click Select Project.
  5. Leave the defaults for the organization and location for your organization's instance of Gmail as defaulted, and click Create Project.
  6. Click Enable APIs and Services.
  7. Search for Contacts and select the Google People API.
  8. Click Enable.
  9. Repeat steps 5-7 for the following APIs: Gmail, Google Calendar, Google Drive, and Tasks
    You must enable all of these APIs before proceeding.
  10. Return to the main menu and select APIs & Services again.
  11. Select OAuth Consent Screen.
  12. For the User Type, select Internal and then click Create.
    The Edit App Registration page displays.
  13. Enter the following information on the Edit App Registration page:
  14. Click Add Domain under Authorized Domains and add the following:
    • deltek.com
    • vpconnect.io
    • Your own company's domain. For example, XYZ Company could have a domain of xyzcompany.com.
  15. In Developer Contact Information, enter an email address to be contacted by Google if there are any changes to the project in Google Cloud Platform.
    This is likely the same as the support email that was entered on the Edit App Registration page (step 12 above).
  16. Click Save and Continue.
  17. Click Add or Remove Scopes.
    The Manually Add Scopes dialog box displays.
  18. Copy and paste the following URLs into the Manually Add Scopes box:

    https://www.googleapis.com/auth/userinfo.email

    https://www.googleapis.com/auth/gmail.labels

    https://www.googleapis.com/auth/gmail.modify https://www.googleapis.com/auth/tasks

    https://www.google.com/m8/feeds https://www.googleapis.com/auth/calendar

    https://www.googleapis.com/auth/admin.directory.resource.calendar.readonly

  19. Click Add to Table.
  20. Click Update.
  21. Scroll to the bottom and select Save and Continue.
  22. Click Credentials in the menu.
  23. Click + Create Credentials and select OAuth client ID from the menu.
    The OAuth Client ID fields display.
  24. Complete the following:
    • Application type: Web Application
    • Name: Give this app a name to identify it in the console in the future. For example, Vantagepoint Connect Web Client.
  25. Under Authorized Redirect URIs, click Add URI and add https://vpc-deltek-prod-sync.vpconnect.io/ui/redirect.html
  26. Click Create at the bottom of the form.
  27. Click OK to the pop-up giving you a Client ID and Secret.
  28. Click the Download icon for the OAuth Client ID you just created.
    This file will be uploaded to Vantagepoint.

Next Step: Configure Connect in Vantagepoint for your Google Workspace account.