Skip to main content

Google Cloud Storage

You can add your existing Google Cloud bucket as a datasource in PixelBin. This allows you to use PixelBin's real-time file delivery and transformation features on all existing files stored in the drive.

For PixelBin to be able to access your Google Cloud Storage, you will need to create a new Google Service Account and assign it the Storage Object Viewer role for the bucket that you wish to integrate with PixelBin. This tutorial will help you do that. Learn more about Google Cloud Storage's Identity and Access Management.


If the original file has been uploaded to GCS with gzip compression, then content-length header won't be set for this file when fetching it via Pixelbin.

In such cases, GCS doesn't store the original file's metadata, which is required for setting headers like content-length. Setting incorrect value for content-length can break the response.

This is only applicable to images and files larger than 10MB.

Setting up Google cloud


In case you find the following instructions invalid/outdated, you can refer to Google's official, albeit more verbose instructions on these pages:

  1. Creating and managing service accounts.
  2. Creating and managing service account keys.
  3. Assign the bucket reader role to the service account.

1. Create a service account

The service account is a separate virtual identity that will be used by PixelBin to access the files in your drive's folder.

  1. In the Cloud Console, go to the Service Accounts page. Go to the Service Accounts page.
  2. Click Select a project, choose your project, and click Open.
  3. Click Create a Service Account.
  4. Enter a service account name (e.g. for-pixelbin-access), and an optional description.
  5. Click Save.

2. Create access keys for the Service Account

We need to create access keys that will be used by PixelBin to authenticate itself to the Google Cloud Storage APIs.

  1. In the Cloud Console, go to the Service Accounts page. Go to the Service Accounts page.
  2. Click Select a project, choose a project, and click Open.
  3. Click on the service account that we created in Step 1.
  4. On the page for the service account, click on the Add key button in the Keys section.
  5. Select JSON as the key type and click Create. This will download a JSON file.
  6. You will need to paste the contents of this file to the PixelBin dashboard.

Make sure to store this file securely, as it cannot be downloaded again.

3. Assign the Bucket Reader role to the Service Account

  1. In the Cloud Console, navigate to the bucket that you wish to integrate with PixelBin.
  2. Click on the Permissions tab.
  3. Click on Add members button.
  4. Enter the email id of the service account we created in Step 1, and select the Cloud Storage -> Storage Object Viewer role in the Select a role option.
  5. Click Save.

Configure Datasource

We have now created a virtual identity for PixelBin and granted it the Reader role for your bucket.

  1. After entering basic details for the datasource, choose Google Cloud Storage from the set of datasource types.
  2. Enter the name of the bucket you want to integrate with PixelBin.
  3. Copy-paste the contents of the keyFile.json you downloaded from your created service account.
  4. Click Save.

We do not start copying files from your storage as soon as you add the datasource. Instead, we will fetch the particular file when you request it through the PixelBin URL endpoint. The files accessed from this origin will not appear in your Storage library.

Transform and enhance your images using our powerful AI technology. Organize your images in more efficient manner and our extensible APIs enables seamless integration with your system unleashing the power of our platform. Join the large community of users who use PixelBin to transform their image libraries and achieve excellent performance

Is this page useful?