google-cloud-retail
Google Cloud Retail API client library
Decision gist · record as of 2026-08-14
Yes. This is an official, actively maintained Google Cloud client library for a managed service. Install it if you are building on Google Cloud Retail or Vertex AI Search for commerce. The low install friction, permissive license, current Python version support (3.10+), and zero known vulnerabilities make it a safe choice. The main constraint is that it requires Google Cloud project setup and API enablement—it is not a standalone library.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python >= 3.10.
- Requires Google Cloud project setup, billing enabled, Vertex AI Search for commerce API enabled, and authentication credentials (typically via GOOGLE_APPLICATION_CREDENTIALS environment variable or Application Default Credentials).
- Low friction installation with a pure-Python wheel.
License · maintenance · safety
Apache-2.0 (permissive) — Licensed under Apache-2.0 (permissive), allowing use in commercial and proprietary projects with minimal restrictions beyond attribution and liability disclaimers.
last release 2026-06-22 (53 days) · last repo commit 2026-08-14 · 5,373 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 233,854 downloads/mo, #9,032 on PyPI
Alternatives
Verify before relying
pip install google-cloud-retail
from google.cloud import retail_v2
client = retail_v2.SearchServiceClient()
# Configure credentials via GOOGLE_APPLICATION_CREDENTIALS or Application Default Credentials- Whether the package supports async/await patterns for high-concurrency use cases
- Performance characteristics and rate limits for production search and recommendation workloads
- Whether offline or local deployment modes are supported beyond cloud-hosted API calls
What it is and what it does
This package is the official Python client library for Google Cloud Retail API, part of Vertex AI Search for commerce. It wraps the gRPC-based Retail API to let you call search, browse, and recommendation services from Python code. The library handles authentication, serialization, and network communication with Google's managed retail service.
You use it to integrate personalized product discovery into e-commerce applications—search results ranked by ML models, category browsing with recommendations, and personalized suggestions based on user behavior. It requires an active Google Cloud project with the Retail API enabled and proper authentication credentials; all actual computation and model serving happens on Google's infrastructure, not locally.
Use it for
- Build a personalized product search endpoint for an e-commerce website using ML-ranked results from Google's Retail API.
- Implement category browse pages with AI-driven product recommendations tailored to individual users.
- Log user interactions (clicks, purchases, views) to the Retail API to improve recommendation models over time.
- Integrate product discovery into a mobile app with search and recommendation features powered by Google's retail ML models.
- Migrate an existing search system to Google Cloud Retail to leverage pre-trained recommendation and ranking models.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
This is an official, actively maintained Google Cloud client library for a managed service. Install it if you are building on Google Cloud Retail or Vertex AI Search for commerce. The low install friction, permissive license, current Python version support (3.10+), and zero known vulnerabilities make it a safe choice. The main constraint is that it requires Google Cloud project setup and API enablement—it is not a standalone library.
Install
google-cloud-retail on PyPI
Before you install
Low friction installation with a pure-Python wheel. Actively maintained as of 2026-06-22 with recent activity; depends on standard Google Cloud libraries (google-api-core, google-auth, grpcio, proto-plus, protobuf) that are widely used and stable.
Requires Python >= 3.10. Requires Google Cloud project setup, billing enabled, Vertex AI Search for commerce API enabled, and authentication credentials (typically via GOOGLE_APPLICATION_CREDENTIALS environment variable or Application Default Credentials).
License in practice
Licensed under Apache-2.0 (permissive), allowing use in commercial and proprietary projects with minimal restrictions beyond attribution and liability disclaimers.
Quickstart
pip install google-cloud-retail
from google.cloud import retail_v2
client = retail_v2.SearchServiceClient()
# Configure credentials via GOOGLE_APPLICATION_CREDENTIALS or Application Default CredentialsVerify before relying
- Whether the package supports async/await patterns for high-concurrency use cases
- Performance characteristics and rate limits for production search and recommendation workloads
- Whether offline or local deployment modes are supported beyond cloud-hosted API calls
Package facts
| License | Apache-2.0 permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 5 packagesgoogle-api-coregoogle-authgrpcioproto-plusprotobuf |
| Maintenance | Actively maintained 53 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 233,854 / month, #9,032 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableIntended 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 |
Evidence: google_cloud_retail-2.11.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “google cloud retail api python”
- google-cloud-retailProvides Python bindings to Google Cloud Retail API for implementing…
- google-cloud-runtimeconfigPython client library for Google Cloud Runtime Configurator API,…
- google-cloud-iamconnectorcredentialsProvides a Python client library for Google Cloud's IAM Connector…
Give your agent the search over MCP, or paste the wish link into any chat.
More Internet packages
Botocore provides low-level, data-driven access to Amazon Web Services APIs, serving as the foundation for the AWS CLI and boto3 libraries.
Install it if you need programmatic access to AWS services.
Provides an async client for AWS services using botocore and aiohttp, allowing you to call AWS APIs asynchronously within asyncio-based applications.
Install it if you need to call AWS services from async Python code; it is the standard way to do so.
Pydantic validates Python data structures against type hints, coercing and checking input at runtime to ensure it matches a declared schema.
Provides a platform-independent file locking mechanism to coordinate access to files across processes and threads.
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides common Protocol Buffer message definitions used across Google Cloud APIs, enabling Python clients to interact with Google services.
See also google-cloud-recommendations-ai · google-cloud-recommender · google-cloud-workflows · google-cloud-notebooks · google-cloud-billing · google-cloud-discoveryengine · google-cloud-dlp · google-shopping-type · google-cloud-monitoring · google-cloud-vectorsearch