Get started with Google Cloud Retail

Select your project and enable the Retail API

Google Cloud organizes resources into projects. This lets you collect all the related resources for a single application in one place.

If you don't have a Google Cloud project yet or you're not the Owner of an existing one, you can create a new project.

After the project is created, set your PROJECT_ID to a project variable.

1. Run the following command in Terminal:

   gcloud config set project <YOUR_PROJECT_ID>

2. Check that the Retail API is enabled for your Project in the Admin Console.

Set up authentication

To run a code sample from the Cloud Shell, you need to authenticate. To do this, use the Application Default Credentials.

1. Set your user credentials to authenticate your requests to the Retail API

   gcloud auth application-default login

2. Type Y and press Enter. Click the link in Terminal. A browser window should appear asking you to log in using your Google account.

3. Provide the Google Auth Library with access to your credentials and paste the code from the browser to the Terminal.

4. Run the code sample and check the Retail API in action.

Note: Click the copy button on the side of the code box to paste the command in the Cloud Shell terminal and run it.

Set the PROJECT_NUMBER environment variable

Because you are going to run the code samples in your own Google Cloud project, you should specify the project_number as an environment variable. It will be used in every request to the Retail API.

1. You can find the project_number in the Home/Dashboard/Project Info card.

2. Set the environment variable with the following command:

   export PROJECT_NUMBER=<YOUR_PROJECT_NUMBER>

Install Google Cloud Retail libraries

To install all the dependencies, run

cd cloudshell_open/retail-search-nodejs-samples
npm install

Running the code samples

Samples are in the search/, products/, events/ directories. To execute an individual code sample, invoke node with a file as a parameter at the command line prompt, e.g.:

node search/search_simple_query.js