Create a custom search experience

To tailor the search experience for the business needs of your organization, you can create custom search applications for Google Cloud Search. Search applications control the content users can search and let users refine their search to get more relevant results. Work with a developer to create search applications for specific user requirements and to integrate them into your Cloud Search solution.

Before you begin

Create a search application

If you don’t create custom search applications, Cloud Search automatically uses the default search application.

  1. Sign in to your Google Admin console.

    Sign in using your administrator account (does not end in @gmail.com).

  2. From the Admin console Home page, go to Apps and thenG Suite and thenCloud Search and thenSearch Settings.

    To see Apps, you might have to click More controls at the bottom.

    Requires having the Services Cloud Search administrator privilege.

  3. Click the Search Applications card.
    A list of your organization’s search applications appears.
  4. At the top, click Add Add.
  5. For Display Name, enter a name for this search application and click Create.
    The search application appears in the list, including its autogenerated application ID.
  6. Point to the search application you created and click Edit Edit.
  7. Point to Data sources and click Edit Edit.
    A list of all data sources in your organization appears.
  8. Next to the data sources you want to turn on for this search application, click On On.
  9. (Optional) Define the search options for each data source and click Done. Learn about search options below.
  10. (Optional) If you don't want Cloud Search to apply personalized ranking* to search results, turn it off:
    1. Under Tuning parameters, point to Personalized ranking.
    2. Click Edit Edit, then click Off Off.
    3. Click Save.
  11. (Optional) If you want to add this search application to a web application:
    Next to Embed search, click the link. Learn how to set up the search widget.

*Personalized ranking increases the priority of search results that have a personal connection to the user. For example, documents shared specifically with a user rank higher than documents shared with a group the user is a member of.

After you add the search application, it appears in the list of search applications. Your developer needs the application ID to use with the search widget or the Query API. Learn more about search interfaces.

Search options for data sources

When you create search applications, you can set different search options for each data source you turn on. These search options depend on what your developer sets up for the data source when they create and register a schema.

Filters

Search filters let you limit the results your users see based on specific criteria, such as the content type. For example, you might want your support team to see only results for support cases.
In the Configuration column, next to a data source you turned on in step 8 above:
  1. Click Filters.
  2. Working with the developer who set up your schema, enter the JSON code for the filter configuration you want to use for this data source. Learn how to add filters.
  3. Click Save.

Search quality

Search quality sets the importance level of results and the number of results to display sequentially for a given data source. The source importance influences the ranking of search results returned by Cloud Search. For example, you might want code design documents to appear high in search results for your engineering group, while you might want product specifications to appear higher for your marketing group.

For G Suite services, the search quality is automatically set.

In the Configuration column, next to a data source you turned on in step 8 above:

  1. Click Search quality.
  2. Under Source importance, click the Down arrowDown Arrow. Select the importance level of search results from this data source compared to results from other sources:
    • Default—Importance level isn't changed. If you’re not sure what to set for source importance, use the default
    • Low—Results from this data source are ranked lower than results from sources set to high or the default.
    • High—Results from this data source are ranked higher than results from sources set to low or the default.
  3. Under Results crowding limit, click the Up arrow Up arrowor Down arrow Down Arrow to select the maximum number of results from this data source to display in the first page of results.
  4. Click Save.

Display options

Display options determine the facets to display in search results. Facets are categories that describe the properties of an item. For example, in a search for shoes, facets might include color, size, and style. Users select facets to further refine their search results. For G Suite services, facets aren't available.
In the Configuration column, next to a data source you turned on in step 8 above:
  1. Click Display options.
  2. Check the box next to the facets you want to show for this data source.
    (Learn how to use the Query API to refine results with facets.)
  3. Click Save.

What is the default search application?

Cloud Search has a default search application used for searches on cloudsearch.google.com and the Cloud Search mobile app. The default application searches G Suite services, such as Gmail and Drive.

Use the default search application as is or customize it to fit your business needs. For example, you might want to add third-party data sources, such as a database repository, to the default search application.

Edit or delete a search application

Edit a search application

You can change the name, data sources, and tuning parameters for a search application.

  1. Sign in to your Google Admin console.

    Sign in using your administrator account (does not end in @gmail.com).

  2. Go to Apps and then G Suite and then Cloud Search and then Search Settings.
  3. Click the Search applications card.
    A list of your organization’s search applications appears.
  4. Point to the search application you want to change and click Edit Edit.
  5. Point to the option you want to change and click Edit Edit.
  6. When finished making changes, click Save or Done.

Delete a search application

  1. Sign in to your Google Admin console.

    Sign in using your administrator account (does not end in @gmail.com).

  2. Go to Apps and then G Suite and then Cloud Search and then Search Settings.
  3. Click the Search applications card.
    A list of your organization’s search applications appears.
  4. Choose the search applications to delete:
    • To delete one application, point to the search application.
    • To delete several applications, check the box next to each search application.
  5. Click Delete Delete.