Configure access to the Google Cloud Search REST API

You must configure access to the Google Cloud Search REST API before you can use this API either directly or through an SDK. This document covers the steps required to use the Google Cloud Search REST API.

1. Create an API project

To enable the API, you must first create an Google Cloud Platform project. This project forms the basis for creating, enabling, and using all Google Cloud Platform (GCP) services, including managing APIs, enabling billing, adding and removing collaborators, and managing permissions.

  1. Open the Google Cloud Console.

  2. At the top of the page, click to the right of "Google Cloud Console." A dialog listing current projects appears.

  3. Click NEW PROJECT. The "New Project" screen appears.

  4. Enter a project name in the Project Name field.

  5. (optional) Click Edit to edit the Project ID. The project ID can't be changed after the project is created, so choose an ID that meets your needs for the lifetime of the project.

  6. To browse locations for the project, click BROWSE.

  7. Click on a location for your project and click Select.

  8. Click Create. The console navigates to the Dashboard page. The project is created within a few minutes.

For further information on creating and managing projects, refer to Creating and Managing Projects.

2. Enable the API

You need to enable the Cloud Search REST API and create a service account to obtain credentials.

  1. To ensure you are on the newly created project, click the icon to the right of the Google Cloud Console banner and select your newly-created project.
  2. Click ENABLE APIS AND SERVICES. The "Welcome to API Library" page appears.
  3. Navigate to the Google Cloud Search API.
  4. Click Enable. The "Overview" page appears.

For further information on enabling and disabling APIs, refer to Manage APIs in the Google Cloud Console

3. Create service account credentials

  1. In the Cloud Platform Console, click Credentials in the left navigation. The Credential page appears.
  2. From the Create credentials drop-down list, select Service account. The "Create service account" page appears.
  3. Enter a name in the Service account name field.
  4. (optional) Edit the service account ID.
  5. Click Create. A "Service account permissions" screen appears.
  6. Click Continue. A "Grant users access to this service account" screen appears.
  7. Click CREATE KEY and click Done. A "Private key saved to your computer" dialog appears and a copy of the private key downloads to your computer.
  8. Click Close.

For further information on service accounts, refer to Service accounts, web applications, and installed applications

4. Identify email address

  1. From the Cloud Platform Console, select the project you created at the top of the page.
  2. Click the Navigation menu to the left of the Google Cloud Console banner.
  3. Click IAM and Admin > Service accounts.
  4. In the list, under "Service account ID," make note of the generated email address that identifies the service account you configured. This email address is used when adding a data source to Cloud Search.

Next Steps

Here are few next steps you might take:

  1. If you plan on using Google Cloud Search with a non-Google data repository, such as Microsoft® SharePoint®, you must create a data source. For instructions on adding a data source, refer to Add a data source to search.

  2. Once you set up your data source, you can create and register schema to identify how Google Cloud Search should represent the data in the repository.