Esta página foi traduzida pela API Cloud Translation.

Ordenar os 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 de sites, é possível ordenar por datas de páginas inferidas pelo Google.
Para repositórios de dados que usam a indexação avançada de sites, é possível ordenar por atributos de dados personalizados ou datas de páginas inferidas pelo Google que são adicionadas ao esquema do 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:

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

Ordenar os resultados da pesquisa básica no site

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

REST

O exemplo a seguir mostra como ordenar os resultados da pesquisa da Web para um app com a pesquisa básica do site. 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 pesquisar 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, 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 projeto Google Cloud .
- APP_ID: o ID do app Vertex AI para Pesquisa.
- QUERY: o texto da consulta a ser pesquisado.
- 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 receber 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 sites com indexação avançada, siga estas etapas:

REST

O exemplo a seguir mostra como ordenar os resultados da pesquisa da Web para um app com indexação avançada de 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, 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 projeto Google Cloud .
- APP_ID: o ID do app Vertex AI para Pesquisa.
- QUERY: o texto da consulta a ser pesquisado.
- ORDER_BY: a ordem em que os resultados são organizados. O campo pode ter valores dos seguintes tipos de dados: datetime, integer ou number. Para ordenar cronologicamente, especifique o atributo de data personalizado especificado no esquema ou a data da página inferida pelo Google para retornar páginas da Web classificadas por data. Por exemplo, para classificar por um atributo date_edited do 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 receber os resultados em ordem decrescente, anexe desc ao valor do atributo personalizado, por exemplo, "orderBy":"date_edited desc".