Create a 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 for Gmail or Troubleshoot Synchronization and Connect Add-in Issues for Outlook help topics 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/getting-started?pli=1) 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 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.
  13. On the Edit App Registration page, enter the following information:
    OptionDescription
    App Name Vantagepoint Connect
    Support Email Select the email address in your organization where users should ask for help with the add-in. This is typically your Vantagepoint administrator or an IT email.
    Logo Upload the Connect for GMail logo that was saved as the pre-requisite step to this procedure.

    See Download and save the custom Connect for Gmail logo for more information.

    Application Home Page https://www.deltek.com/
    Application Privacy Policy Link https://www.deltek.com/en/legal
    Application Terms of Service Link https://www.deltek.com/en/legal/terms
  14. Under Authorized Domains, click Add Domain 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.
  18. On the Manually Add Scopes dialog box, 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:
    OptionDescription
    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 that you just created.
    This file will be uploaded to Vantagepoint.

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