{"id":2052,"library":"google-cloud","title":"Google Cloud Meta-Package for Python","description":"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.","status":"abandoned","version":"0.34.0","language":"en","source_language":"en","source_url":"https://github.com/GoogleCloudPlatform/google-cloud-python","tags":["google cloud","cloud","meta-package","deprecated","api client"],"install":[{"cmd":"pip install google-cloud","lang":"bash","label":"Deprecated Installation (Not Recommended)"},{"cmd":"pip install google-cloud-storage","lang":"bash","label":"Recommended: Install a specific client library"}],"dependencies":[{"reason":"The `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.","package":"google-cloud-*-client","optional":true}],"imports":[{"note":"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`).","wrong":"from google.cloud import client","symbol":"Client","correct":"from google.cloud import storage\nstorage_client = storage.Client()"},{"note":"This is the correct pattern for importing a specific Google Cloud service client. You then instantiate the client (e.g., `storage.Client()`).","symbol":"storage","correct":"from google.cloud import storage"}],"quickstart":{"code":"import os\nfrom google.cloud import storage\n\n# Ensure GOOGLE_APPLICATION_CREDENTIALS environment variable is set\n# or gcloud is configured for Application Default Credentials.\n# For example: export GOOGLE_APPLICATION_CREDENTIALS=\"/path/to/key.json\"\n\ntry:\n    # Instantiates a client for Google Cloud Storage\n    storage_client = storage.Client()\n\n    # List all buckets in the project\n    buckets = list(storage_client.list_buckets())\n    if buckets:\n        print(\"Buckets:\")\n        for bucket in buckets:\n            print(f\"  - {bucket.name}\")\n    else:\n        print(\"No buckets found in the project.\")\n\nexcept Exception as e:\n    print(f\"An error occurred: {e}\")\n    print(\"Please ensure you have authenticated properly (e.g., 'gcloud auth application-default login')\")\n    print(\"and have the necessary permissions for the Google Cloud project.\")","lang":"python","description":"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."},"warnings":[{"fix":"Do 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`).","message":"The `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.","severity":"breaking","affected_versions":"0.34.0 and earlier"},{"fix":"Ensure `gcloud auth application-default login` has been run or the `GOOGLE_APPLICATION_CREDENTIALS` environment variable points to a valid service account key file.","message":"Google 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.","severity":"gotcha","affected_versions":"All versions of individual `google-cloud-*` client libraries"},{"fix":"Always check the specific client library's GitHub repository or documentation for its changelog and migration guides before major version upgrades.","message":"Individual `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.","severity":"gotcha","affected_versions":"Specific `google-cloud-*` client libraries (e.g., `google-cloud-bigquery` v2.0.0, v3.0.0)"},{"fix":"Upgrade your Python environment to a currently supported version (e.g., Python 3.9+). Refer to Google Cloud's official Python version support documentation.","message":"Google 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.","severity":"gotcha","affected_versions":"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."}],"env_vars":null,"last_verified":"2026-04-09T00:00:00.000Z","next_check":"2026-07-08T00:00:00.000Z"}