Google APIs Credential Setup¶
This guide walks you through setting up OAuth credentials for Google APIs (such as Google Docs, Gmail, Google Drive, etc.) in Jentic One.
Overview¶
What you'll need¶
- A Google account with access to Google Cloud Console
- The Google API you want to use (e.g., Google Docs, Gmail, Google Drive)
What you'll do¶
- Find the Google API in the Jentic Public API Catalog
- Enable the API in Google Cloud Console
- Create OAuth credentials (Client ID and Client Secret) in Google Cloud Console
- Add a credential for the API by entering your Client ID and Client Secret, which includes it in your workspace
- Authorize access to complete the OAuth flow
Reusing credentials¶
Important: Once you've created OAuth credentials (Client ID and Client Secret) in Google Cloud Console, you can reuse them for multiple Google Suite APIs. You just need to ensure each API is enabled in Google Cloud Console. See the Reusing Credentials section below for details.
Step-by-Step Instructions¶
1. Find the Google API in the Jentic Public API Catalog¶
- In the Jentic One UI, open the Jentic Public API Catalog and search for the Google API you need (e.g., "Google Docs" or "Gmail")
- Select the API and click Add credential (adding a credential includes the API in your workspace)
- Keep this tab open — you'll need the Redirect URI shown here
2. Enable the API in Google Cloud Console¶
- Open a new tab and go to Google Cloud Console
- Log in with your Google account
- In the top search bar, search for the Google API you need (e.g., "docs" for Google Docs API)
- Click on the API result (e.g., "Google Docs API")
- Click the blue Enable button
- Once enabled, click Manage
3. Configure OAuth Consent Screen (First Time Only)¶
If this is your first time creating OAuth credentials, you'll need to configure the consent screen:
- Click Configure consent screen
- Fill out the required information:
- App name: Use a simple name like "Test" or your project name
- Accept the other default settings as prompted
- Complete the configuration
4. Create OAuth Credentials¶
- In the Google Cloud Console, click the Credentials tab
- On the right side, click the + Create credentials button
- Select OAuth client ID
- Configure the OAuth client:
- Application type: Select Web Application
- Name: Give it a descriptive name (e.g., "Jentic Google APIs")
- In the Authorized redirect URIs section:
- Paste the local Redirect URI you copied from Jentic One (from Step 1)
- Click Create
5. Copy Credentials to Jentic One¶
- When the popup appears in Google Cloud Console, you'll see:
- Client ID
- Client Secret
- Copy both values and paste them into the corresponding input fields in the Jentic One UI
- Store these credentials securely — they will disappear from the Google Cloud Console popup after a few days
Security tip: Save your Client ID and Client Secret in a secure password manager. You'll need them if you want to add more Google APIs later.
6. Configure Scopes and Connect¶
- In the Jentic One UI, review the available scopes
- Select specific scopes if you want to limit access
- Click Connect to complete the setup
7. Authorize Access¶
- A Google sign-in popup will appear
- Sign in with the same Google account you used to log into Google Cloud Console
- Review the permissions requested
- If you're comfortable with the permissions, click Allow
8. Verify Setup¶
If no errors occurred, the Google API should now be available in your workspace with credentials configured.
Reusing Credentials for Multiple Google APIs¶
Once you've created OAuth credentials (Client ID and Client Secret) in Google Cloud Console, you can reuse them for other Google Suite APIs:
- Enable the new API in Google Cloud Console (search for it and click "Enable")
- Find the API in the Jentic Public API Catalog
- When adding a credential for it, use the same Client ID and Client Secret you created earlier
Note: The Client ID and Client Secret are tied to your Google Cloud project, not to individual APIs. As long as you enable each API in Google Cloud Console, you can use the same credentials for all of them.
Troubleshooting¶
- "Redirect URI mismatch" error: Make sure you've copied the exact Redirect URI from Jentic One and pasted it correctly in Google Cloud Console
- "API not enabled" error: Ensure the API is enabled in Google Cloud Console before trying to use it
- Can't find the API: Make sure you're searching in the correct Google Cloud project and that you have the necessary permissions
Next Steps¶
After setting up your Google API credentials: - Use the API in your self-hosted Jentic One - Explore other Google APIs using the same credentials