Filtra y ordena los resultados

En esta página, se describe el filtrado y el ordenamiento con la búsqueda.

Instructivo de filtrado

En este instructivo, se muestra la función de filtrado. Te permite ajustar mejor las solicitudes de búsqueda según tus necesidades o las del cliente. Puedes filtrar por uno o varios campos, por campos de texto o numéricos, o por ambos. Puedes usar un lenguaje de expresión para construir un predicado para cada campo o combinar diferentes expresiones con operadores lógicos. Por ejemplo, un comprador que busca zapatos puede usar filtros para limitar su búsqueda a la marca y el color que prefiere.

Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:

GUIARME

Instructivo de ordenamiento

En este instructivo, se muestra cómo ordenar elementos en una respuesta de búsqueda. Cuando un usuario final busca un producto en tu sitio, se le muestran resultados ordenados por varios campos. Por ejemplo, un usuario busca un vestido con el mejor precio y descuento. El precio y el descuento son varios campos aquí. El usuario verá los vestidos ordenados por precio y, en el caso de los vestidos con el mismo precio, ordenados por descuento.

Para seguir la guía paso a paso sobre esta tarea directamente en el editor de Cloud Shell, haz clic en Guiarme:

GUIARME

Conjunto de datos de ejemplo

En esta página, se usa el siguiente conjunto de datos como ejemplo. Solo se incluyen los campos necesarios para el ejemplo.

Filtro

import com.google.cloud.retail.v2.SearchRequest;
import com.google.cloud.retail.v2.SearchResponse;
import com.google.cloud.retail.v2.SearchServiceClient;

public static void searchFilteredProducts(String query, int pageSize,
    String filter) throws IOException, InterruptedException {
  SearchRequest searchRequest = SearchRequest.newBuilder()
      .setPlacement(DEFAULT_SEARCH_PLACEMENT_NAME)
      .setBranch(DEFAULT_BRANCH_NAME)
      .setVisitorId(VISITOR_ID)
      .setQuery(query)
      .setPageSize(pageSize)
      .setFilter(filter)
      .build();

  try (SearchServiceClient searchClient = SearchServiceClient.create()) {
    SearchResponse response = searchClient.search(searchRequest).getPage().getResponse();
    System.out.println("Search response: " + searchResponse);
  }
}

Se puede resumir la sintaxis de la expresión de filtro con la siguiente EBNF:

  # A single expression or multiple expressions that are joined by "AND" or "OR".
  filter = expression, { " AND " | "OR", expression };

  # Expressions can be prefixed with "-" or "NOT" to express a negation.
  expression = [ "-" | "NOT " ],
    # A parenthetical expression.
    | "(", expression, ")"
    # A simple expression applying to a text field.
    # Function "ANY" returns true if the field contains any of the literals.
    ( text_field, ":", "ANY", "(", literal, { ",", literal }, ")"
    # A simple expression applying to a numerical field. Function "IN" returns true
    # if a field value is within the range. By default, lower_bound is inclusive and
    # upper_bound is exclusive.
    | numerical_field, ":", "IN", "(", lower_bound, ",", upper_bound, ")"
    # A simple expression that applies to a numerical field and compares with a double value.
    | numerical_field, comparison, double );

  # A lower_bound is either a double or "*", which represents negative infinity.
  # Explicitly specify inclusive bound with the character 'i' or exclusive bound
  # with the character 'e'.
  lower_bound = ( double, [ "e" | "i" ] ) | "*";

  # An upper_bound is either a double or "*", which represents infinity.
  # Explicitly specify inclusive bound with the character 'i' or exclusive bound
  # with the character 'e'.
  upper_bound = ( double, [ "e" | "i" ] ) | "*";

  # Supported comparison operators.
  comparison = "<=" | "<" | ">=" | ">" | "=";

  # A literal is any double quoted string. You must escape backslash (\) and
  # quote (") characters.
  literal = double quoted string;

  text_field = see the table below;

  numerical_field = see the table below;

Los campos de texto admitidos se resumen en la siguiente tabla.

Los campos numéricos compatibles se resumen en la siguiente tabla.

Se permiten como máximo 10 conjunciones o disyunciones anidadas.

Por ejemplo, para buscar un producto de Google en las siguientes situaciones, respectivamente, puedes establecer query como “Google” y filter como los valores que se muestran en la siguiente tabla:

Pedido

import com.google.cloud.retail.v2.SearchRequest;
import com.google.cloud.retail.v2.SearchResponse;
import com.google.cloud.retail.v2.SearchServiceClient;

public static void searchOrderedProducts(String query, int pageSize,
    String orderBy) throws IOException, InterruptedException {
  SearchRequest searchRequest = SearchRequest.newBuilder()
      .setPlacement(DEFAULT_SEARCH_PLACEMENT_NAME)
      .setBranch(DEFAULT_BRANCH_NAME)
      .setVisitorId(VISITOR_ID)
      .setQuery(query)
      .setPageSize(pageSize)
      .setOrderBy(orderBy)
      .build();

  try (SearchServiceClient searchClient = SearchServiceClient.create()) {
    SearchResponse response = searchClient.search(searchRequest).getPage().getResponse();
    System.out.println("Search response: " + searchResponse);
  }
}

Los campos ordenables admitidos se resumen en la siguiente tabla.

De forma predeterminada, el orden es ascendente. El orden descendente se puede especificar mediante el sufijo "desc", como "rating desc".

En el caso de un campo numérico con varios valores, por ejemplo, un campo repetido o un campo configurado para productos de variante, se usa el valor mínimo para ordenar de forma ascendente y el valor máximo para ordenar de forma descendente.

El orden de múltiples campos se admite mediante el uso de campos separados por comas en orden de prioridad. Los campos de prioridad más baja se usan para ordenar elementos con valores iguales para campos de prioridad más alta. Por ejemplo, "rating desc, price" ordenaría elementos con la misma calificación por precio.