Cette page a été traduite par l'API Cloud Translation.

Classer les résultats de recherche sur le Web

Cette page explique comment trier les résultats d'une requête de recherche sur le Web par date.

Pour les datastores qui utilisent la recherche de base sur le site Web, vous pouvez les trier en fonction des dates des pages inférées par Google.
Pour les magasins de données qui utilisent l'indexation avancée des sites Web, vous pouvez effectuer une commande par attributs de données personnalisés ou par dates de page inférées par Google qui sont ajoutées au schéma du magasin de données. Pour en savoir plus, consultez Utiliser des données structurées pour l'indexation avancée de sites Web.

Avant de commencer

Assurez-vous de procéder comme suit:

Créez un data store avec les données de votre site Web. Pour en savoir plus, consultez la section URL de site Web.
Créez une application de recherche et associez-la au data store. Pour en savoir plus, consultez Créer une application de recherche.

Trier les résultats de recherche pour la recherche de base sur un site Web

Pour trier les résultats de recherche d'un entrepôt de données de site Web avec une recherche de site Web de base, procédez comme suit:

REST

L'exemple suivant montre comment trier les résultats de recherche Web pour une application avec une recherche de site Web de base. Cet exemple utilise la méthode engines.servingConfigs.search:

Remarque:Vous pouvez effectuer une recherche dans une application à l'aide de la méthode engines.servingConfigs.search et dans un entrepôt de données à l'aide de la méthode dataStores.servingConfigs.search. Pour la procédure suivante, Google recommande d'effectuer une recherche à l'aide de la méthode engines.servingConfigs.search.

Recherchez votre ID d'application. Si vous disposez déjà de votre ID d'application, passez à l'étape suivante.
1. Dans la console Google Cloud, accédez à la page Agent Builder.
  
  Accédez à "Applications".
2. Sur la page Applications, recherchez le nom de votre application et obtenez son ID dans la colonne ID.
Envoyez une requête de recherche et incluez le champ orderBy.

Terme clé:Dans Vertex AI Search, le terme application peut être utilisé de manière interchangeable avec le terme moteur dans le contexte des API.
```
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"
}'
```
Remplacez les éléments suivants :
- PROJECT_ID: ID de votre Google Cloud projet.
- APP_ID: ID de l'application Vertex AI Search.
- QUERY: texte de la requête à rechercher.
- ORDER_BY: ordre dans lequel les résultats sont organisés. Par exemple, pour organiser les résultats par ordre chronologique, spécifiez date pour renvoyer les pages Web triées en fonction de la date estimée par Google. Pour en savoir plus sur la date de la page inférée par Google, consultez l'article de blog Aider la recherche Google à connaître la date la plus précise pour votre page Web. L'ordre de tri par défaut est décroissant, les pages les plus récentes étant renvoyées en premier. Pour obtenir un ordre de tri croissant, ajoutez :a à la valeur date : date:a.

Trier les résultats de recherche pour l'indexation avancée de site Web

Pour trier les résultats de recherche d'un entrepôt de données de site Web avec une indexation avancée du site Web, procédez comme suit:

REST

L'exemple suivant montre comment trier les résultats de recherche Web pour une application avec l'indexation avancée des sites Web. Cet exemple utilise la méthode engines.servingConfigs.search:

Recherchez votre ID d'application. Si vous disposez déjà de votre ID d'application, passez à l'étape suivante.
1. Dans la console Google Cloud, accédez à la page Agent Builder.
  
  Accédez à "Applications".
2. Sur la page Applications, recherchez le nom de votre application et obtenez son ID dans la colonne ID.
Envoyez une requête de recherche et incluez le champ orderBy.

Terme clé:Dans Vertex AI Search, le terme application peut être utilisé de manière interchangeable avec le terme moteur dans le contexte des API.
```
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"
}'
```
Remplacez les éléments suivants :
- PROJECT_ID: ID de votre Google Cloud projet.
- APP_ID: ID de l'application Vertex AI Search.
- QUERY: texte de la requête à rechercher.
- ORDER_BY: ordre dans lequel les résultats sont organisés. Le champ peut présenter des valeurs des types de données suivants: datetime, entier ou nombre. Pour effectuer un tri chronologique, spécifiez l'attribut de date personnalisé indiqué dans le schéma ou la date de la page inférée par Google pour afficher les pages Web triées par date. Par exemple, pour trier par un attribut PageMap date_edited, vous pouvez spécifier le champ orderBy comme "orderBy": "date_edited". L'ordre de tri par défaut est croissant, les pages les plus anciennes étant renvoyées en premier. Pour obtenir les résultats dans l'ordre décroissant, ajoutez desc à la valeur de l'attribut personnalisé (par exemple, "orderBy":"date_edited desc").