Overview
The Google Drive connector enables you to sync and manage translation files between your Google Drive and LILT platform. This connector provides automated translation workflows for your Google Drive content, making it easy to collaborate on multilingual projects within your existing Google Workspace environment.Setup
Prerequisites
Before setting up the Google Drive connector, ensure you have:- A Google Workspace account with admin privileges
- Access to Google Cloud Console for creating service accounts
- A Google Drive Shared Drive (Team Drive) for file organization
- Files in supported formats (see supported file types)
Automatic Authentication (Recommended)
For the most straightforward setup, we recommend using LILT’s Connect interface to authenticate. This method simplifies the authentication process by allowing a user with the appropriate permissions to authorize the connection directly by logging in with their Google credentials.- Navigate to the Connectors page in LILT and select the Google Drive connector.
- Click “Sign in with Google Drive” to initiate the Google OAuth 2.0 flow.
- Authorize Access: A Google sign-in window will appear. Log in with a Google account that has Content Manager access to the Shared Drive you want to connect. It is highly recommended to use a generic service account rather than an individual user’s account to avoid issues if the user leaves the company.
- Grant Permissions: Grant LILT the necessary permissions to access your Google Drive.
- Automatic Credential Population: Once authorized, the required authentication fields will be automatically populated.
- Complete Configuration: Fill in the remaining
google_drive_team_drive_id
andrclone_backend_path
fields as described in the manual setup instructions below. - Validate and Save: Click Validate to test the connection and then save the connector.
- The user account used for authentication must have “Content Manager” permissions for the target Shared Drive.
Manual Authentication
This method requires you to manually create and configure a Google Cloud Project and service account to generate the necessary credentials.Required Configuration Parameters
Authentication
Your Google API Client ID from the Google Cloud Console
Your Google API Client Secret from the Google Cloud Console
OAuth 2.0 refresh token for ongoing access to your Google Drive
Drive Configuration
The Team Drive ID where your translation files are stored
The full folder path from the root of the Shared Drive (e.g.,
Customer Folder/Production/Lilt
)The folder path for exported translated files. If not specified, files are exported to the same location as import
Manual Setup Instructions
Step 1: Create Google Cloud Project
- Go to the Google Cloud Console
- Create a new project or select an existing one
- Enable the Google Drive API for your project
- Navigate to APIs & Services → Credentials
Step 2: Create OAuth 2.0 Credentials
- Click Create Credentials → OAuth 2.0 Client ID
- Configure the consent screen if prompted
- Select Web application as the application type
- Add authorized redirect URIs:
https://developers.google.com/oauthplayground
- Any other URIs you need for testing
- Save the credentials and note down:
- Client ID
- Client Secret
Step 3: Create Service Account
- In the Google Cloud Console, go to IAM & Admin → Service Accounts
- Click Create Service Account
- Fill in the service account details
- Grant the service account Content Manager permissions
- Create and download a JSON key file (optional for advanced setups)
Step 4: Generate Refresh Token
- Visit the OAuth 2.0 Playground
- Click the settings gear icon and check Use your own OAuth credentials
- Enter your Client ID and Client Secret
- In the left panel, select Drive API v3 and choose:
https://www.googleapis.com/auth/drive
- Click Authorize APIs and complete the OAuth flow
- Click Exchange authorization code for tokens
- Copy the Refresh Token for your connector configuration
Step 5: Set Up Shared Drive
- Create a new Shared Drive in Google Drive or use an existing one
- Share the Shared Drive with your service account email
- Grant the service account Content Manager permissions
- Create the folder structure you want LILT to use
- Copy the Team Drive ID from the URL when viewing the Shared Drive
Step 6: Configure the Connector
- In LILT, navigate to Connectors → New Connector
- Select Google Drive from the connector list
- Fill in the configuration parameters:
- Client ID: From Step 2
- Client Secret: From Step 2
- Refresh Token: From Step 4
- Team Drive ID: From Step 5
- Folder Path: Full path from Shared Drive root
Step 7: Test the Connection
- Click Validate to test your configuration
- The connector will verify:
- Authentication credentials
- Drive access permissions
- Folder path validity
Optional Configuration Parameters
Content Filtering
List of glob patterns to include specific files (e.g.,
["**/*.docx", "**/*.json"]
)List of glob patterns to exclude specific files (e.g.,
["**/temp/*", "**/*.tmp"]
)Advanced Configuration
File Filtering
Control which files are processed:Folder Organization
Organize your content with clear folder structure:Best Practices
File Organization
- Use a consistent folder structure in your Shared Drive
- Create separate folders for source and translated files
- Use descriptive folder names that include project or language information
- Implement an archive system for completed projects
Security
- Use service accounts with minimal required permissions
- Regularly review and rotate OAuth credentials
- Enable two-factor authentication on Google accounts
- Monitor access logs through Google Admin Console
Performance
- Use include/exclude patterns to limit file scanning scope
- Organize files in logical folder structures to improve sync performance
- Consider file size limits when working with large documents
- Use Google Drive’s version control features for tracking changes
Collaboration
- Set up proper sharing permissions for team members
- Use Google Drive’s commenting and suggestion features for review workflows
- Implement naming conventions for files at different stages of translation
- Consider using Google Drive’s approval workflows for quality control
Troubleshooting
Authentication Issues
Error: “Invalid credentials”- Solution: Verify your Client ID and Client Secret are correct
- Solution: Ensure the OAuth consent screen is configured properly
- Solution: Check that the Google Drive API is enabled in your project
- Solution: Generate a new refresh token using the OAuth Playground
- Solution: Ensure the refresh token was copied completely without truncation
- - Solution: Check that the OAuth application has the correct scopes
Drive Access Issues
Error: “Drive not found”- Solution: Verify the Team Drive ID is correct
- Solution: Ensure the service account has been granted access to the Shared Drive
- Solution: Check that the Shared Drive hasn’t been deleted or moved
- Solution: Grant the service account Content Manager permissions
- Solution: Verify the service account email is shared with the correct Shared Drive
- Solution: Check that the account has access to the specific folders in the path
File Processing Issues
Error: “Folder path not found”- Solution: Verify the folder path exists and is spelled correctly
- Solution: Ensure the path is relative to the Shared Drive root
- Solution: Check that folders in the path haven’t been moved or deleted
- Solution: Check your include/exclude patterns are not too restrictive
- Solution: Verify file formats are supported by LILT
- Solution: Ensure files are not corrupted or empty
Performance Issues
Issue: Slow synchronization- Solution: Use more specific include patterns to reduce scanning scope
- Solution: Organize files in smaller, focused folders
- Solution: Check Google Drive API quota limits and usage
- Solution: Consider file size limits for your content type
- Solution: Break large files into smaller, manageable chunks
- Solution: Monitor Google Drive storage limits and usage
FAQ
Q: Can I use a personal Google account instead of Google Workspace? A: While technically possible, Google Workspace is recommended for better security, admin controls, and Shared Drive features. Q: What’s the difference between a regular folder and a Shared Drive? A: Shared Drives provide better collaboration features, centralized ownership, and are recommended for team-based translation workflows. Q: How do I find my Team Drive ID? A: The Team Drive ID is visible in the URL when you’re viewing the Shared Drive. It’s the long string after/folders/
in the URL.
Q: Can I connect multiple Google Drives?
A: Yes, you can set up multiple connectors for different Shared Drives or use different folder paths within the same Shared Drive.
Q: What file formats are supported?
A: The connector supports all file formats that LILT can process. See the supported formats guide for details.
Q: How often does the connector sync?
A: The sync frequency depends on your connector schedule configuration and can be set to run at regular intervals or triggered manually.
Q: Can I use this with Google Docs native format?
A: The connector works with uploaded files rather than native Google Docs format. Export Google Docs to supported formats like DOCX for translation.
Q: What happens if someone moves a file while it’s being processed?
A: The connector may encounter errors if files are moved during processing. It’s recommended to establish file handling procedures to avoid conflicts.