Service Account Requirements for Google Drive Integration

Service Account Requirements for Google Drive Integration

Why a Proper Google User Account is Required

To ensure a smooth and successful integration with Google Drive, a proper Google user account with a license is required. This account is needed for authentication using Google OAuth login and must have the same Google Drive and Shared Drive access as the users who need the integration.

🚨 Important: A Google Group or shared email address will not work because OAuth login requires an individual user account.


Why a Google Group or Shared Email Won’t Work

Many users ask if they can set up the integration using a Google Group or a shared email account instead of a user account. However, this approach is not supported due to the following reasons:

❌ 1. OAuth Authentication Requires a User Account

βœ… Our system logs in using a specific user to connect with Google Drive.
🚫 A Google Group is not an actual user, so it cannot authenticate via OAuth.

πŸ“Œ Example: If you try to log in using a Google Group email (e.g., team@yourcompany.com), you will receive an error because Google OAuth only works with individual user accounts.

❌ 2. Drive Access Must Match a User Account

βœ… The service account must have access to the same Shared Drives as the team members using the integration.
🚫 A Google Group may have permissions, but since it is not a real user, it cannot be used for authentication.


What Type of Google Account is Needed?

To set up the integration correctly, you need:

πŸ”Ή A Google user account with a license (not a Google Group)
πŸ”Ή At least a basic Google Workspace user account (as long as it has access to Google Drive)
πŸ”Ή Access to the same Shared Drives as the team using the integration

πŸ“Œ Note: This account does not need to be a high-tier Google Workspace accountβ€”a basic account is enough as long as it can authenticate via Google OAuth.


Google Admin Approval for SyncEzy App

When performing the OAuth login, you may see a request to approve the SyncEzy app in Google Admin Console.

βœ… If your organization restricts third-party app access, an admin must approve SyncEzy before you can complete the setup.


Step-by-Step Setup Checklist

βœ”οΈ Step 1: Create or assign a Google user account with a license
βœ”οΈ Step 2: Ensure it has access to the necessary Google Drives
βœ”οΈ Step 3: Log in with this account during the OAuth authentication process
βœ”οΈ Step 4: If prompted, ask your Google Admin to approve the SyncEzy app

By following these steps, your integration will work smoothly without authentication issues.


Conclusion

For a successful integration, always use a Google user account with a license. A Google Group or shared email address will not work because OAuth authentication requires a real user to log in.

Following these best practices will prevent login errors and ensure your integration runs efficiently.

πŸ“Œ Need Help? If you have any questions, contact  We offer three support channels: 

Chat - Live Chat (24x5 support) from within your integration portal.  

Phone - #1 for Support

AUS: +61 2 9136 9448

NZ: +64 9 303 2999

UK: +44 203 670 1109

US: +1 720 500 9302

Email - support@syncezy.com

    • Related Articles

    • QuickBooks Workforce to Google Drive integration FAQs

      This document addresses the variety of questions we encounter while helping clients. If you have a question that’s not addressed her please write to us at support@syncezy.com Please also visit our Integration Menu Overview article to learn more about ...
    • Procore to Dropbox 2-way integration FAQs

      This document addresses the variety of questions we encounter while helping clients. If you have a question that’s not addressed her please write to us at support@syncezy.com About the Procore to Dropbox integration Please also visit our Integration ...
    • Procore to Google Drive 2-way Integration FAQs

      About the Procore to Google Drive 2-way Integration This document addresses the variety of questions we encounter while helping clients. If you have a question that’s not addressed her please write to us at support@syncezy.com Please also visit our ...
    • simPRO to Google Drive integration FAQs

      This document addresses the variety of questions we encounter while helping clients. If you have a question that’s not addressed here please write to us at support@syncezy.com About the simPRO to Google Drive integration Please also visit our ...
    • Service account - Introduction and benefits

      Service accounts are usually created specifically for a particular service or application and are granted only the permissions necessary for that service to function properly. They are often used to access other resources such as databases, APIs, ...