To use Google nodes such as Gmail, Google Sheets, and Google Calendar, you must first issue Google credentials and register them in Agentria.

This process requires logging in with your Google account.

Credential Registration Goal

To register credentials in Agentria, you’ll need the following information:

Client ID , Client Secret , and Refresh Token.

By following this guide, you’ll learn how to issue these values and register your Google credentials in Agentria.

This guide is based on registering credentials for the Gmail Node, but note that the same Google Client ID and Client Secret can be reused across multiple Google-based nodes.

Step 1: Access Google Cloud Console

Open the Google Cloud Console Auth Platform in your browser.

If this is your first time accessing the console, click Create Project to set up a new project.

Step 2: OAuth Management

OAuth is an open standard protocol for user authentication and authorization on the internet.

To issue Google credentials, you must go through the OAuth flow.

2-1 ) Create Project

Start by setting a project name and selecting an organization.

If you’re an individual user, select No organization and click Create.

2-2 ) Project Configuration

Click the Get Started button to configure your project.

Step 1

• App information : Set the application name.

• User Email : Enter your email address.

Step 2

• Internal : Restricts access to users within your Google Workspace organization. (Recommended for internal organizational apps.)

• External : Allows access to any Google account added to the test user list. (Recommended for apps intended for public or external use.)

Step 3

• Enter an email address to receive notifications about project updates. (You may use the same address as the user email.)

Step 4

• Review and agree to Google’s policies, then create the project.

Once you click Create, the OAuth project setup is complete.

Step 3: Generate an OAuth Client ID

To create user authentication credentials, you must first generate a Client ID.

During this process, your Client ID and Client Secret will be displayed — make sure to copy and store them in a secure location.

3-1 ) Create an OAuth Client

From the Overview tab, click Create OAuth Client to generate your ID.

Alternatively, you can go to the Clints tab and click +Create Client to follow the same process.

3-2 ) Generate a Client ID

• Set the application type to Web application for use in Agentria.

• Enter a name for the Client ID.

• You may leave the JavaScript origins field empty.

• Next, you’ll need to enter the Redirect URL.

A Redirect URL (Callback URL) is required to return the result of the authentication process — whether successful or not.

Keep the Google Cloud Console page open for now, and go to the Agentria page to add the authorized Redirect URL.

Step 4: Add Credentials in Agentria

In your Agentria project page, open the sidebar and select Credentials.

Click the +Add Credential button at the top right to create new credentials.

Select the appropriate Google template.

For this guide, we’ll use the Gmail template.

Credentials must be created separately for each Google template.

Copy the Callback URL from the SET 1 section — you will use it in Step 5.

At this point, you cannot save the credential popup, so keep the Agentria page open and return to the Google Cloud Console.

Step 5: Register the Callback URL

In the Google Cloud Console, where you were creating your Client ID, click +Add URI under Authorized redirect URIs.

A new input field will appear — paste the Callback URL you copied from Step 4.

Click Create to save your settings.

This completes the creation of your OAuth client.

You can close this pop-up window.

Step 6: Store Your Secret (Important)

You can handle client IDs in the Clients tab.

Be sure to store your Client ID and Client Secret in a safe place.

You can also download and save it in JSON file format.

You will use this information in Step 8, so it is a good idea to copy it.

Step 7: Add Data Access Scopes

7-1 ) Data Access

In the sidebar, select the Data Access tab.

Click Add or Remove Scopes. Then follow the link to the Google API Library.

Use the search bar to find the APIs you need.

(For example : Gmail API, Google Sheets API)

This guide is based on the Gmail API.

7-2 ) API Usage

Select the API you want and click Enable.

Step 8: Complete Credential Setup

Return to the Agentria credential popup.

Enter the Client ID and Client Secret you recorded in Step 6.

Click Google Connect and link your Google account.

Once you grant access, a Refresh Token will be generated automatically.

If you want to add multiple clients, you can do so with +ADD SET.

Click SAVE at the bottom right to finish credential setup.

After your first registration, the button will change to ADD.

Step 9: Add a Google Template Node

On the canvas, add the Google template node.

The template must match the credential you registered.

For example, if you created credentials using the Gmail template, they can only be used in a Gmail node.

Step 10: Register Credentials in the Node

Double-click the node to open the Node Editor.

Select the registered credential.

You can now start using Google nodes in Agentria.

Next Steps

Client information can be reused when setting up Google credentials again.

If your access expires after six months of inactivity, simply re-authorize access and complete authentication again.