Skip to content

Authentication

Purpose

The editor needs permission to access the same private spreadsheets your Google account can access.

Use your own Google access for your team (recommended over Demo). This avoids shared usage limits and gives you control.

Find out more on OAuth Clients

First‑time entry

  • The first time you click Configure, you can paste the Client ID and Client Secret.
  • Later, you can update them in Project Settings → Plugins → Google DataTable Sync.

UeGoogleAuthConfig

When the browser confirms success, you can close the tab:

AuthSuccessful

Where it is remembered

Your sign‑in is remembered per user for the current project (per‑user settings, not committed to source control).

Switching account or resetting

Update credentials in Project Settings to switch; the plugin will prompt you to sign in again if the Client ID changes.

Creating your own Google Client ID / Secret (step-by‑step)

This detailed guide shows every click needed to generate your own credentials.

Step 1: Create a Google Cloud Project

First, we'll create a new project in the Google Cloud Console to house our API settings.

  1. Go to the Google Cloud Console.

  2. If you have existing projects, click the project selection dropdown at the top of the page, then click New project.

    1-NewProject

  3. Give your project a name (e.g., "My Game Data") and click Create.

    2-NewProject2

Step 2: Enable the Google Sheets API

Now, we need to activate the specific API that allows our plugin to interact with Google Sheets.

  1. Open the navigation menu (☰) and go to APIs & Services → Library.

    3-APIsAndServices

  2. In the search bar, type Google Sheet and select the Google Sheets API from the results.

    4-FindApi

  3. Click the Enable button to activate the API for your project.

    5-EnableApi

This screen is what users will see when the plugin asks for permission to access their Google account for the first time.

  1. After enabling the API, navigate to the OAuth consent screen tab on the left-hand menu.

    6-GoToAuthConsent

  2. If this is your first time, you may need to click Get started.

    7-StartAuth

  3. Fill out the required App Information (App name, User support email, Developer contact). You can leave the rest blank. Click Save and Continue through the "Scopes" and "Optional Info" sections.

  4. Choose External for the User Type and click Create.
  5. On the Test users step, add the Google accounts of everyone on your team who will use this plugin. Only these users will be able to sign in while the app is in "Testing" mode.

  6. Once you reach the end of the setup, click the Create button on the summary page.

    8-CreateProject

Step 4: Create the Client ID and Secret

This is the final step, where we generate the actual keys to paste into Unreal Engine.

  1. From the OAuth Overview page, click Create OAuth client.

    9-NewClient

  2. In the 'Application type' dropdown, select Desktop app. This is a mandatory step for the plugin to work correctly.

  3. Give it a recognizable name (e.g., "Unreal Plugin Desktop Client").

  4. Click Create.

    10-CreateClient

  5. Your credentials are now created. The list of clients will appear. To view the secret, click the edit icon (pencil) on the right.

    11-ShowClienfInfo

  6. You can now see your Client ID and Client secret. Use the copy icons next to each one. These are the values you will paste into Unreal Engine.

    12-CopyClinetInfo

Step 5: Enter Credentials in Unreal Engine

With the keys copied, return to Unreal Engine.

  1. Open Project Settings → Plugins → Google DataTable Sync.
  2. Unchek UseDemoCredentials.
  3. Paste the Client ID and Client Secret into their respective fields.
  4. Ensure the "Redirect Uri" is set to http://localhost:8080 (this is the default).
  5. Open any DataTable and click Export or Import. The plugin will now use your new credentials to prompt for a one-time sign-in in your browser.

Step 6 (Optional): Go to Production

By default, your app is in "Testing" mode, and only the test users you specified can sign in. To allow any user with a Google Account to use your credentials, you can publish the app.

  1. In the Google Cloud Console, navigate back to the OAuth consent screen and go to the Audience tab.

  2. Click Publish app.

    13-PublishApp

  3. Confirm the action.

    14-SuccessPublishApp

You're done!

Your project is now fully configured with its own secure credentials. You won't need to do this process again for this project.