The `google-cloud` Python package was historically a meta-package designed to install all client libraries for Google Cloud services. However, it was deprecated in June 2018 and marked as inactive/archived. Users are strongly advised to install individual, product-specific client libraries (e.g., `google-cloud-storage`) rather than this meta-package. Its last released version is 0.34.0, from July 2018.
Install & Compatibility
Where this runs
tested against v0.34.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
py 3.10
9/10 runs
9/10 runs
py 3.11
9/10 runs
9/10 runs
py 3.12
9/10 runs
9/10 runs
py 3.13
9/10 runs
9/10 runs
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
Client
✓ from google.cloud import storage
storage_client = storage.Client()
✗ from google.cloud import client
The `google-cloud` meta-package does not provide a top-level `client` module; client objects are imported from specific service modules (e.g., `google.cloud.storage`).
storage
✓ from google.cloud import storage
This is the correct pattern for importing a specific Google Cloud service client. You then instantiate the client (e.g., `storage.Client()`).
This quickstart demonstrates how to list Google Cloud Storage buckets using the `google-cloud-storage` client library. It relies on Application Default Credentials for authentication, which can be set up via the `gcloud CLI` or by setting the `GOOGLE_APPLICATION_CREDENTIALS` environment variable.
import os
from google.cloud import storage
# Ensure GOOGLE_APPLICATION_CREDENTIALS environment variable is set
# or gcloud is configured for Application Default Credentials.
# For example: export GOOGLE_APPLICATION_CREDENTIALS="/path/to/key.json"
try:
# Instantiates a client for Google Cloud Storage
storage_client = storage.Client()
# List all buckets in the project
buckets = list(storage_client.list_buckets())
if buckets:
print("Buckets:")
for bucket in buckets:
print(f" - {bucket.name}")
else:
print("No buckets found in the project.")
except Exception as e:
print(f"An error occurred: {e}")
print("Please ensure you have authenticated properly (e.g., 'gcloud auth application-default login')")
print("and have the necessary permissions for the Google Cloud project.")
Debug
Known issues
breakingThe `google-cloud` PyPI package is deprecated and marked as inactive since June 2018. It no longer bundles individual client libraries. Installing it will not provide the expected functionality for modern Google Cloud interactions.fixDo not install `google-cloud`. Instead, identify the specific Google Cloud service you need (e.g., Cloud Storage, BigQuery) and install its dedicated client library (e.g., `pip install google-cloud-storage`).
affects: 0.34.0 and earlier
gotchaGoogle Cloud client libraries use Application Default Credentials (ADC) for authentication. Failing to set up ADC (e.g., `gcloud auth application-default login` or `GOOGLE_APPLICATION_CREDENTIALS` env var) is a common reason for authentication errors.fixEnsure `gcloud auth application-default login` has been run or the `GOOGLE_APPLICATION_CREDENTIALS` environment variable points to a valid service account key file.
affects: All versions of individual `google-cloud-*` client libraries
gotchaIndividual `google-cloud-*` client libraries have their own release cycles and major version updates can introduce breaking changes. The changelog for each specific library should be consulted before upgrading.fixAlways check the specific client library's GitHub repository or documentation for its changelog and migration guides before major version upgrades.
affects: Specific `google-cloud-*` client libraries (e.g., `google-cloud-bigquery` v2.0.0, v3.0.0)
gotchaGoogle Cloud Client Libraries for Python are compatible with actively maintained Python versions. Using End-of-Life (EOL) Python versions (e.g., Python 3.7, 3.8) can lead to lack of support, security patches, and compatibility issues.fixUpgrade your Python environment to a currently supported version (e.g., Python 3.9+). Refer to Google Cloud's official Python version support documentation.
affects: Python 3.7 and older are EOL; Python 3.8 is EOL as of October 2024 for BigQuery clients. Impact varies by specific client library.
Audit
Dependencies
google-cloud-*-clientoptionalThe `google-cloud` package itself is a deprecated meta-package. Modern applications should install specific `google-cloud-service-name` client libraries, which have their own dependencies.