Retail API: Cloud Retail service enables customers to build end-to-end personalized
recommendation systems without requiring a high level of expertise in
machine learning, recommendation system, or Google Cloud.
Install this library in a virtualenv using pip. virtualenv is a tool to
create isolated Python environments. The basic problem it addresses is one of
dependencies and versions, and indirectly permissions.
With virtualenv, it’s possible to install this library without needing system
install permissions, and without clashing with the installed system
dependencies.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[],[],null,["Version latestkeyboard_arrow_down\n\n- [2.5.0 (latest)](/python/docs/reference/retail/latest)\n- [2.4.0](/python/docs/reference/retail/2.4.0)\n- [2.3.0](/python/docs/reference/retail/2.3.0)\n- [2.2.0](/python/docs/reference/retail/2.2.0)\n- [2.1.0](/python/docs/reference/retail/2.1.0)\n- [2.0.0](/python/docs/reference/retail/2.0.0)\n- [1.25.0](/python/docs/reference/retail/1.25.0)\n- [1.24.0](/python/docs/reference/retail/1.24.0)\n- [1.23.1](/python/docs/reference/retail/1.23.1)\n- [1.22.0](/python/docs/reference/retail/1.22.0)\n- [1.21.2](/python/docs/reference/retail/1.21.2)\n- [1.20.1](/python/docs/reference/retail/1.20.1)\n- [1.19.1](/python/docs/reference/retail/1.19.1)\n- [1.18.0](/python/docs/reference/retail/1.18.0)\n- [1.17.0](/python/docs/reference/retail/1.17.0)\n- [1.16.3](/python/docs/reference/retail/1.16.3)\n- [1.15.1](/python/docs/reference/retail/1.15.1)\n- [1.14.1](/python/docs/reference/retail/1.14.1)\n- [1.13.0](/python/docs/reference/retail/1.13.0)\n- [1.12.0](/python/docs/reference/retail/1.12.0)\n- [1.11.0](/python/docs/reference/retail/1.11.0)\n- [1.10.2](/python/docs/reference/retail/1.10.2)\n- [1.9.0](/python/docs/reference/retail/1.9.0)\n- [1.8.1](/python/docs/reference/retail/1.8.1)\n- [1.7.0](/python/docs/reference/retail/1.7.0)\n- [1.6.1](/python/docs/reference/retail/1.6.1)\n- [1.5.0](/python/docs/reference/retail/1.5.0)\n- [1.4.1](/python/docs/reference/retail/1.4.1)\n- [1.3.0](/python/docs/reference/retail/1.3.0)\n- [1.2.1](/python/docs/reference/retail/1.2.1)\n- [1.1.0](/python/docs/reference/retail/1.1.0)\n- [1.0.2](/python/docs/reference/retail/1.0.2)\n- [0.4.2](/python/docs/reference/retail/0.4.2)\n- [0.3.1](/python/docs/reference/retail/0.3.1)\n- [0.2.0](/python/docs/reference/retail/0.2.0)\n- [0.1.0](/python/docs/reference/retail/0.1.0) \n\nPython Client for Retail API\n============================\n\n[](https://github.com/googleapis/google-cloud-python/blob/master/README.rst#beta-support) [](https://pypi.org/project/google-cloud-retail/) [](https://pypi.org/project/google-cloud-retail/)\n\n[Retail API](https://cloud.google.com/retail/docs): Cloud Retail service enables customers to build end-to-end personalized\nrecommendation systems without requiring a high level of expertise in\nmachine learning, recommendation system, or Google Cloud.\n\n- [Client Library Documentation](https://googleapis.dev/python/retail/latest)\n\n- [Product Documentation](https://cloud.google.com/retail/docs)\n\nQuick Start\n-----------\n\nIn order to use this library, you first need to go through the following steps:\n\n1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)\n\n2. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)\n\n3. [Enable the Retail API.](https://cloud.google.com/retail/docs)\n\n4. [Setup Authentication.](https://googleapis.dev/python/google-api-core/latest/auth.html)\n\n### Installation\n\nInstall this library in a [virtualenv](https://virtualenv.pypa.io/en/latest/) using pip. [virtualenv](https://virtualenv.pypa.io/en/latest/) is a tool to\ncreate isolated Python environments. The basic problem it addresses is one of\ndependencies and versions, and indirectly permissions.\n\nWith [virtualenv](https://virtualenv.pypa.io/en/latest/), it's possible to install this library without needing system\ninstall permissions, and without clashing with the installed system\ndependencies.\n\n#### Mac/Linux\n\n pip install virtualenv\n virtualenv \u003cyour-env\u003e\n source \u003cyour-env\u003e/bin/activate\n \u003cyour-env\u003e/bin/pip install google-cloud-retail\n\n#### Windows\n\n pip install virtualenv\n virtualenv \u003cyour-env\u003e\n \u003cyour-env\u003e\\Scripts\\activate\n \u003cyour-env\u003e\\Scripts\\pip.exe install google-cloud-retail\n\n### Next Steps\n\n- Read the [Client Library Documentation](https://googleapis.dev/python/retail/latest) for Retail API\n to see other available methods on the client.\n\n- Read the [Retail API Product documentation](https://cloud.google.com/retail/docs) to learn\n more about the product and see How-to Guides.\n\n- View this [README](https://github.com/googleapis/google-cloud-python/blob/master/README.rst) to see the full list of Cloud\n APIs that we cover."]]