Breadcrumbs

Google Workspace – Internal Application Creation Guide

To enable user import or Print/Scan integrations between Google Workspace and OptimiDoc Cloud, you must first create an internal Google application using the Google Cloud Console.
This application is authorised using OAuth 2.0, and OptimiDoc Cloud accesses Google services through secure API calls.

Follow the steps below to configure your Google Workspace environment.

1. Access Google Cloud Console

  1. Sign in at:
    https://console.cloud.google.com/

  2. Log in using a Google Workspace administrator account.

image-20260325-101737.png


Important:
You must be logged into an organisation domain.
Running under “No organisation” will not allow internal application creation.

2. Create a New Project

  1. Click Select project and choose New Project.

  2. Enter the project name and required details.

    image-20260325-101809.png

  3. Click Create.

  4. Wait a few moments while Google creates the project.

  5. Open the project once it becomes available.


  1. Navigate to APIs & Services → OAuth consent screen.

    image-20260325-101855.png

  2. Select Internal as the application type.

    image-20260325-102254.png

  3. Click Create.

  4. Fill in the required details (App name, user support e‑mail, etc.).

  5. Click Save and continue.

  6. When asked for scopes:

    • No scopes are required at this stage.

    • Click Save and continue again.

  7. On the final page, click Back to dashboard.

4. Create OAuth Client Credentials

  1. Go to APIs & Services → Credentials.

  2. Click Create Credentials → OAuth client ID.

  3. Select Web application as the application type.

  4. Add Authorised redirect URIs depending on your data centre:

    image-20260325-102638.png

Authorised Redirect URIs

Replace eu with us or uk based on tenant location.

For Print/Scan integrations:

https://eu.optimidoc.cloud/Destinations/AuthorizeGoogleDrive

For User import:

https://eu.optimidoc.cloud/Users/ImportGoogleRedir

  1. Click Create.

  2. Copy the Client ID and Client Secret.

    image-20260325-102650.png

5. Add OAuth Credentials into OptimiDoc Cloud

  1. Open OptimiDoc Cloud Admin Portal.

  2. Navigate to Company Settings.

  3. Paste the Client ID and Client Secret into the corresponding Google Workspace configuration fields.

    image-20260325-102719.png

6. Enable Required APIs

In the Google Cloud Console, open APIs & Services → Library and enable:

  • Admin SDK API – required for User Import

  • Google Drive API – required for Print/Scan workflows

    image-20260325-102752.png

7. Authorise the Application in OptimiDoc Cloud

Depending on the functionality you are configuring:

  • Navigate to Document Workflows → for scanning destinations

  • Navigate to User Import → for user provisioning

Click the unauthorised key icon, select your Google admin account, and allow the application access.

Once authorised:

  • Scanning destinations will be operational

  • Print workflows can be used

  • User import from Google Workspace will be enabled

Troubleshooting “App Blocked” Issue

If Google blocks the application during authorisation, follow these steps:

1. Open Admin Console

Navigate to:
Security → API Controls → App Access Control

Check whether the OptimiDoc Cloud app is listed.

2. If the App Is Not Listed

  1. Click Configure new app.

  2. Choose OAuth App Name or Client ID.

  3. Search using this Client ID:

478856714290-eqgi9q9jj73qk8qmjlha c g5bohehcpcr.apps.googleusercontent.com

  1. When found, add the application.

3. Enable and Verify the Application

Once added:

  • Enable the application for the entire organisation.

  • Verify access.

  • Confirm it appears under “App Access Control”.

After verification, the application will no longer be blocked during authorisation.

Completion

After completing the above steps:

  • You can scan and deliver files to Google Drive.

  • You can print using Google‑authorised workflows.

  • You can import users from Google Workspace directly into OptimiDoc Cloud.