google-cloud-run

Google Cloud Run API client library

google-cloud-run Permissive license Apache-2.0 Active ★ 5,370 v0.16.1 released 2026-06-22

Install

google-cloud-run on PyPI

pip

pip install google-cloud-run

uv

uv add google-cloud-run

poetry

poetry add google-cloud-run

Package facts

License	Apache-2.0 (permissive)
Python support	supports the current Python release (>=3.10)
Install friction	low — pure-Python wheel
Runtime dependencies	6 — google-api-core, google-auth, grpcio, proto-plus, protobuf, grpc-google-iam-v1
Maintenance	actively maintained — 52 days since the last release
Last repo commit	2026-08-13
First released	2022-04-04
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: google_cloud_run-0.16.1-py3-none-any.whl

Development Status :: 4 - BetaIntended Audience :: DevelopersLicense :: OSI Approved :: Apache Software LicenseOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Topic :: Internet

About google-cloud-run

from the package's own PyPI description — quoted content, verbatim

Python Client for Cloud Run Admin

Cloud Run Admin_: Deploy and manage user provided container images that scale automatically based on incoming requests. The Cloud Run Admin API v1 follows the Knative Serving API specification, while v2 is aligned with Google Cloud AIP-based API standards, as described in https://google.aip.dev/.

Client Library Documentation_
Product Documentation_

.. |preview| image:: https://img.shields.io/badge/support-preview-orange.svg :target: https://github.com/googleapis/google-cloud-python/blob/main/README.rst#stability-levels .. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-run.svg :target: https://pypi.org/project/google-cloud-run/ .. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-run.svg :target: https://pypi.org/project/google-cloud-run/ .. _Cloud Run Admin: https://cloud.google.com/run/docs .. _Client Library Documentation: https://cloud.google.com/python/docs/reference/run/latest/summary_overview .. _Product Documentation: https://cloud.google.com/run/docs

Quick Start

In order to use this library, you first need...

Read as markdown · JSON record · Source repository · Homepage

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

Official Python client library for Google Cloud Run Admin API, enabling programmatic deployment and management of containerized applications with automatic scaling.

Low friction: pure Python wheel with six well-maintained Google Cloud dependencies (google-api-core, google-auth, grpcio, proto-plus, protobuf, grpc-google-iam-v1). Active maintenance with last commit 2026-08-13 and 5370 repository stars.

Apache-2.0 permissive license allows commercial use, modification, and distribution with minimal restrictions—standard for Google Cloud client libraries.

Usage

pip install google-cloud-run

from google.cloud.run_v2 import ServicesClient
from google.auth import default

credentials, project = default()
client = ServicesClient(credentials=credentials)
# List services in a region
services = client.list_services(parent=f"projects/{project}/locations/us-central1")

Requires Python >= 3.10; Google Cloud project with Cloud Run Admin API enabled and valid credentials (via Application Default Credentials or explicit auth setup).

Verdict: Stable, actively maintained official client for Cloud Run Admin with no known vulnerabilities. Low install friction and broad Python version support (3.10–3.14) make it a safe choice for serverless container deployment workflows. Permissive Apache-2.0 license poses no compliance barrier.

Needs verification

Whether the library's preview/beta status (Development Status :: 4 - Beta) implies API stability guarantees or breaking-change risk in minor versions.
Performance characteristics and rate-limiting behavior when managing large numbers of Cloud Run services.
Specific authentication flow requirements beyond Application Default Credentials for non-GCP environments.

google cloud run python clientdeploy containers to cloud runcloud run admin api pythonserverless container managementgoogle cloud run sdkcloud run service deploymentcontainer orchestration google cloud