Esta página foi traduzida pela API Cloud Translation.

Ordenar resultados da pesquisa na Web

Esta página explica como ordenar os resultados de uma consulta de pesquisa na Web por data.

Para repositórios de dados que usam a pesquisa básica no site, você pode fazer o pedido por Datas de página inferidas pelo Google.
Para repositórios de dados que usam indexação avançada de sites, você pode ordenar por atributos de dados personalizados ou datas de página inferidas pelo Google que são adicionados ao um esquema de repositório de dados. Para mais informações, consulte Usar dados estruturados para a indexação avançada de sites.

Antes de começar

Faça o seguinte:

Criar um repositório de dados com os dados do site. Para mais informações, consulte Site URLs.
Crie um app de pesquisa e conecte-o ao repositório de dados. Para mais informações, consulte Criar um app de pesquisa.

Ordenar resultados da pesquisa básica em sites

Para ordenar os resultados da pesquisa de um repositório de dados de site com com uma pesquisa básica no site, siga estas etapas:

REST

O exemplo a seguir mostra como ordenar os resultados da pesquisa na Web para um app com a pesquisa básica em sites. Este exemplo usa o Método engines.servingConfigs.search:

Observação: é possível pesquisar em um app usando o método engines.servingConfigs.search e em um repositório de dados usando o método dataStores.servingConfigs.search. Para o procedimento a seguir, o Google recomenda pesquisar usando o método engines.servingConfigs.search.

Encontre o ID do app. Se você já tiver o ID do app, pule para a próxima etapa.
1. No Console do Google Cloud, acesse a página Criador de agentes.
  
  Acessar "Apps".
2. Na página Apps, localize o nome do seu app e acesse o ID dele na a coluna ID;
Faça uma consulta de pesquisa e inclua o campo orderBy.

Termo-chave: na Vertex AI Search, o termo app pode ser usado de forma intercambiável com o termo engine no contexto de APIs.
```
curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search:search" \
-d '{
"servingConfig": "projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search",
"query": "QUERY",
"orderBy": "ORDER_BY"
}'
```
Substitua:
- PROJECT_ID: o ID do seu projeto do Google Cloud.
- APP_ID: o ID do app da Vertex AI para Pesquisa.
- QUERY: o texto da consulta a ser pesquisada.
- ORDER_BY: a ordem em que os resultados são organizados. Por exemplo, para ordenar cronologicamente, especifique date para retornar páginas da Web classificadas pela data da página inferida pelo Google. Para mais informações sobre a data da página inferida pelo Google, consulte a postagem do blog Como ajudar a Pesquisa Google a saber qual a melhor data para sua página da Web. A ordem de classificação padrão é decrescente, em que as páginas com as datas mais recentes são retornadas primeiro. Para obter a ordem de classificação crescente, anexe :a ao valor date: date:a.

Ordenar os resultados da pesquisa para a indexação avançada de sites

Para ordenar os resultados da pesquisa de um repositório de dados de site com a indexação avançada de sites, siga estas etapas:

REST

O exemplo a seguir mostra como ordenar os resultados da pesquisa na Web para um app com indexação avançada de sites. Este exemplo usa o Método engines.servingConfigs.search:

Encontre o ID do app. Se você já tiver o ID do app, pule para a próxima etapa.
1. No Console do Google Cloud, acesse a página Criador de agentes.
  
  Acessar "Apps".
2. Na página Apps, encontre o nome do app e confira o ID dele na coluna ID.
Faça uma consulta de pesquisa e inclua o campo orderBy.

Termo-chave: na Vertex AI Search, o termo app pode ser usado de forma intercambiável com o termo engine no contexto de APIs.
```
curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search:search" \
-d '{
"servingConfig": "projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search",
"query": "QUERY",
"orderBy": "ORDER_BY"
}'
```
Substitua:
- PROJECT_ID: o ID do seu projeto do Google Cloud.
- APP_ID: o ID do app da Vertex AI para Pesquisa.
- QUERY: o texto da consulta a ser pesquisada.
- ORDER_BY: a ordem em que os resultados são organizados. O campo pode ter valores que são dos seguintes tipos de dados: datetime, inteiro ou número. Para ordenar cronologicamente, especifique a data personalizada especificado no esquema ou a data da página inferida pelo Google para retornar páginas da Web classificadas por data. Por exemplo, para ordenar por um atributo date_edited PageMap, especifique o campo orderBy como "orderBy": "date_edited". A ordem de classificação padrão é crescente, em que as páginas mais antigas são retornadas primeiro. Para exibir os resultados em ordem decrescente ordem, anexe desc ao valor do atributo personalizado, por exemplo, "orderBy":"date_edited desc".