Google Drive

Overview

The Google Drive integration provides structured file delivery and organization for your podcast production workflow. preroll.io automatically creates and maintains a folder hierarchy for each client, show, and episode, making it easy to share final deliverables with clients.

OAuth2 Setup

Register Your Application

1. Go to the Google Cloud Console
2. Create a new project (or select an existing one)
3. Enable the Google Drive API under APIs & Services
4. Configure the OAuth consent screen (External or Internal based on your needs)
5. Create OAuth 2.0 credentials (Web application type):

6. Note your Client ID and Client Secret

Environment Variables

GOOGLE_CLIENT_ID=your_client_id
GOOGLE_CLIENT_SECRET=your_client_secret

Connecting Your Account

1. Go to Settings → Integrations
2. Click Connect next to Google Drive
3. Authorize preroll.io to access your Google Drive
4. Select a root folder where preroll.io will organize files (or let it create one)

The connection uses the drive.file scope, which only grants access to files and folders that preroll.io creates — it cannot access your other Drive files.

Folder Hierarchy

preroll.io automatically creates and maintains a structured folder hierarchy:

PreRoll/
├── Acme Corp/
│   ├── The Morning Show/
│   │   ├── EP001 - Pilot/
│   │   ├── EP002 - The Interview/
│   │   └── EP003 - Season Finale/
│   └── Tech Talks/
│       └── EP001 - AI in Podcasting/
└── Beta Client/
    └── Weekly Roundup/
        └── EP001 - First Episode/

Folders are created on demand when files are first delivered to a client/show/episode combination.

File Upload

preroll.io uses Google Drive's resumable upload protocol for reliable file transfers, especially for large files:

• Files under 5 MB use simple upload
• Files over 5 MB use resumable upload with automatic retry on network interruption
• Upload progress is tracked and displayed in the UI

Supported File Types

Any file type can be uploaded to Google Drive. Common podcast production deliverables include:

Sharing Delivered Files

When a deliverable is uploaded to Google Drive, preroll.io can automatically share the file or folder with the client:

1. Per-file sharing — individual files are shared with the client's email address
2. Folder sharing — the episode folder is shared, giving the client access to all files within it

Sharing permissions default to Viewer access. You can configure this per-client in the client settings.

Client Portal Integration

Files delivered via Google Drive appear in the client portal with direct download links. Clients can access their files without needing a Google account — preroll.io generates shareable links with appropriate permissions.

Troubleshooting