This guide explains how to connect your Google Cloud Storage (GCS) buckets to Mixpeek, enabling automated data ingestion and processing.
Prerequisites
- An active Google Cloud project.
- A GCS bucket containing the data you want Mixpeek to process.
- Permissions to create service accounts and manage IAM policies in your Google Cloud project.
Configuration Steps
Connecting Mixpeek to GCS requires granting Mixpeek read access to your bucket. We recommend using a service account with appropriate IAM roles for enhanced security.1
Create Service Account
First, create a service account that Mixpeek will use to access your GCS bucket.
- Navigate to the IAM & Admin > Service Accounts section in your Google Cloud Console.
- Click Create Service Account.
- Enter a name for the service account (e.g.,
mixpeek-gcs-access
). - Click Create and Continue.
- Grant the service account the following roles:
Storage Object Viewer
(roles/storage.objectViewer)Storage Legacy Bucket Reader
(roles/storage.legacyBucketReader)
- Click Done.
2
Create and Download Service Account Key
To authenticate with GCS, you’ll need to create and download a service account key.
- Find your newly created service account in the list and click on it.
- Go to the Keys tab.
- Click Add Key > Create new key.
- Choose JSON as the key type.
- Click Create.
- Important: The JSON key file will be downloaded to your computer. Store this file securely as you’ll need it to configure the connection in Mixpeek.
3
Add GCS Connection in Mixpeek
- Navigate to the Integrations or Data Sources section in your Mixpeek dashboard (or Mixpeek Studio).
- Click Add Connection or New Source and select Google Cloud Storage.
- Enter the required details:
- Bucket Name: The name of your GCS bucket (e.g.,
YOUR_BUCKET_NAME
). - Project ID: Your Google Cloud project ID.
- Service Account Key: Upload the JSON key file you downloaded in the previous step.
- Optionally, specify a Prefix if you only want Mixpeek to process files within a specific folder in your bucket.
- Bucket Name: The name of your GCS bucket (e.g.,
- Click Test Connection (if available) to verify the credentials and permissions.
- Click Save or Connect.