Python Client for Google Cloud Storage

imageimageimage

Google Cloud Storage allows you to store data onGoogle infrastructure with very high reliability, performance andavailability, and can be used to distribute large data objects to usersvia direct download.

Quick Start

In order to use this library, you first need to go through the following steps:

  1. Select or create a Cloud Platform project.

  2. Enable billing for your project.

  3. Enable the Google Cloud Storage API.

  4. Setup Authentication.

Installation

Set up a Python development environment and install this library in a venv.venv is a tool to create isolated Python environments. The basic problem itaddresses is one of dependencies and versions, and indirectly permissions.

Make sure you’re using Python 3.7 or later, which includesvenv by default.With venv, it’s possible to install this library without needing systeminstall permissions, and without clashing with the installed systemdependencies.

Supported Python Versions

Python >= 3.7

Deprecated Python Versions

Unsupported Python Versions

Python == 3.6: the last released version which supported Python 3.6 wasgoogle-cloud-storage 2.0.0, released 2022-01-12.

Python == 3.5: the last released version which supported Python 3.5 wasgoogle-cloud-storage 1.32.0, released 2020-10-16.

Python == 2.7: the last released version which supported Python 2.7 wasgoogle-cloud-storage 1.44.0, released 2022-01-05.

Mac/Linux

python -m venv envsource env/bin/activatepip install google-cloud-storage

Windows

py -m venv env.\env\Scripts\activatepip install google-cloud-storage

Example Usage

# Imports the Google Cloud client libraryfrom google.cloud importstorage# Instantiates a clientclient =storage.Client()# Creates a new bucket and uploads an objectnew_bucket = client.create_bucket('new-bucket-id')new_blob = new_bucket.blob('remote/path/storage.txt')new_blob.upload_from_filename(filename='/local/path.txt')# Retrieve an existing bucket# https://console.cloud.google.com/storage/browser/[bucket-id]/bucket = client.get_bucket('bucket-id')# Then do other things...blob = bucket.get_blob('remote/path/to/file.txt')print(blob.download_as_bytes())blob.upload_from_string('New contents!')

What’s Next

Now that you’ve set up your Python client for Cloud Storage,you can get started runningStorage samples.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-11-05 UTC.