Google OAuth Setup
Connect your Google Merchant Center account
Google OAuth Setup
Connect your Google Merchant Center account to enable feed submission and performance monitoring.
Prerequisites
Before connecting, ensure you have:
- A valid Google account
- An existing Google Merchant Center account
- Admin access to the Merchant Center
- The Google account email verified
If you don't have a Google Merchant Center account, create one at merchants.google.com before proceeding.
Connection Steps
Navigate to the app dashboard or Settings page.
Look for the Setup Guide or Google Integration section.
Click the "Sign in with Google" or "Connect to Google" button.
A popup window will open for Google authentication.
In the popup:
- Choose the Google account associated with your Merchant Center
- If you have multiple Google accounts, select the correct one
- Make sure this account has access to your Merchant Center
Review and approve the requested permissions:
| Permission | Purpose |
|---|---|
| View Merchant Center accounts | List available accounts |
| Manage product data | Submit and update feeds |
| View performance data | Display analytics |
Click "Allow" to grant access.
After authorization:
- The popup will close automatically
- Dashboard will refresh to show connected status
- Your Merchant Center accounts will appear in the selector
Verify Connection
Success Indicators
- Green "Connected" status on dashboard
- Health Metrics shows "Connection Status: Connected"
- Account selector shows your Merchant Center accounts
- Performance metrics load correctly
Multi-Account Support
If your Google account has access to multiple Merchant Center accounts:
- All accounts appear in the dropdown
- Each account shows its status
- Select the account you want to manage
Troubleshooting
Connection Failed
| Issue | Solution |
|---|---|
| Popup blocked | Allow popups for the app domain |
| Wrong account | Sign out of Google and retry |
| No Merchant Center | Create a Merchant Center account first |
| Permission denied | Contact Merchant Center admin |
OAuth Errors
| Error | Cause | Solution |
|---|---|---|
access_denied | User cancelled | Retry and allow permissions |
invalid_grant | Expired authorization | Clear cache and retry |
nonce_mismatch | Security validation failed | Clear cookies and retry |
Token Issues
| Issue | Solution |
|---|---|
| Token expired | Reconnect Google account |
| Permission revoked | Re-authorize in Google settings |
| Account suspended | Resolve GMC issues first |
Disconnect Account
To disconnect your Google account:
- Go to Settings > General
- Click "Disconnect Google Account"
- Confirm the disconnection
Disconnecting will:
- Remove stored OAuth tokens
- Stop automatic feed sync
- Preserve existing feed files
- Require reconnection to use Google features
Security Information
What We Store
| Data | Storage | Purpose |
|---|---|---|
| Access Token | Encrypted | API calls to Google |
| Refresh Token | Encrypted | Obtain new access tokens |
| Database | Account identification | |
| Account IDs | Database | Account selection |
What We Don't Store
- Your Google password
- Full OAuth credentials
- Merchant Center financial data
Token Security
- Tokens are encrypted at rest
- Tokens are transmitted over HTTPS only
- Access tokens expire after 1 hour
- Refresh tokens are long-lived but revocable
Reconnecting
If you need to reconnect:
- Disconnect the existing connection
- Clear browser cache
- Click "Connect to Google" again
- Complete the OAuth flow
Force Re-authorization
To force a fresh authorization:
- Go to myaccount.google.com/permissions
- Find "Max AI: Google Feed Ascend"
- Remove access
- Reconnect in the app
Need Help?
If you continue to experience issues:
- Check Google Integration documentation
- Review FAQ for common solutions
- Contact [email protected]