- 3.5.0 (latest)
- 3.4.1
- 3.3.1
- 3.2.0
- 3.1.1
- 3.0.0
- 2.19.0
- 2.17.0
- 2.16.0
- 2.15.0
- 2.14.0
- 2.13.0
- 2.12.0
- 2.11.0
- 2.10.0
- 2.9.0
- 2.8.0
- 2.7.0
- 2.6.0
- 2.5.0
- 2.4.0
- 2.3.0
- 2.2.1
- 2.1.0
- 2.0.0
- 1.44.0
- 1.43.0
- 1.42.3
- 1.41.1
- 1.40.0
- 1.39.0
- 1.38.0
- 1.37.1
- 1.36.2
- 1.35.1
- 1.34.0
- 1.33.0
- 1.32.0
- 1.31.2
- 1.30.0
- 1.29.0
- 1.28.1
- 1.27.0
- 1.26.0
- 1.25.0
- 1.24.1
- 1.23.0
- 1.22.0
- 1.21.0
- 1.20.0
- 1.19.0
- 1.18.0
- 1.17.0
Python Client for Google Cloud Storage
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:
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-storageWindows
py -m venv env.\env\Scripts\activatepip install google-cloud-storageExample 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.