Questa pagina spiega come ordinare i risultati di una query di ricerca web per data.
- Per i datastore che utilizzano la ricerca di base del sito web, puoi ordinare in base alle date delle pagine dedotte da Google.
- Per gli archivi dati che utilizzano l'indicizzazione avanzata dei siti web, puoi ordinare in base agli attributi dei dati personalizzati o alle date delle pagine dedotte da Google aggiunte allo schema dell'archivio datastore. Per ulteriori informazioni, consulta la pagina Utilizzare i dati strutturati per l'indicizzazione avanzata dei siti web.
Prima di iniziare
Assicurati di svolgere le seguenti operazioni:
Crea un datastore con i dati del sito web. Per ulteriori informazioni, consulta URL del sito web.
Crea un'app di ricerca e collegala al datastore. Per ulteriori informazioni, consulta Creare un'app di ricerca.
Ordinare i risultati di ricerca per la ricerca di base sul sito web
Per ordinare i risultati di ricerca per un datastore del sito web con la ricerca di siti web di base:
REST
Il seguente esempio mostra come ordinare i risultati di ricerca web per un'app con la ricerca di base del sito web. Questo esempio utilizza il metodo
engines.servingConfigs.search
:
Trova l'ID app. Se hai già l'ID app, vai al passaggio successivo.
Nella console Google Cloud, vai alla pagina Agent Builder.
Nella pagina App, trova il nome della tua app e recupera l'ID dall'app la colonna ID.
Esegui una query di ricerca e includi il campo
orderBy
.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" }'
Sostituisci quanto segue:
- PROJECT_ID: l'ID del tuo progetto Google Cloud.
- APP_ID: l'ID dell'app Vertex AI Search.
- QUERY: il testo della query da cercare.
- ORDER_BY: l'ordine in cui sono disposti i risultati. Ad esempio, per ordinare in ordine cronologico, specifica
date
per restituire le pagine web ordinate in base alla data dedotta da Google. Per ulteriori informazioni sulla data della pagina dedotta da Google, consulta il post del blog Aiutare la Ricerca Google a conoscere la data migliore per la pagina web. L'ordinamento predefinito è decrescente, in cui le pagine con le date più recenti vengono restituite per prime. Per ottenere l'ordinamento crescente, aggiungi:a
al valoredate
:date:a
.
Ordinare i risultati di ricerca per l'indicizzazione avanzata dei siti web
Per ordinare i risultati di ricerca per un datastore del sito web con l'indicizzazione avanzata del sito web:
REST
Il seguente esempio mostra come ordinare i risultati di ricerca web per un'app con l'indicizzazione avanzata del sito web. Questo esempio utilizza il metodo
engines.servingConfigs.search
:
Trova l'ID app. Se hai già l'ID app, vai al passaggio successivo.
Nella console Google Cloud, vai alla pagina Agent Builder.
Nella pagina App, trova il nome della tua app e recupera l'ID dall'app la colonna ID.
Esegui una query di ricerca e includi il campo
orderBy
.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" }'
Sostituisci quanto segue:
- PROJECT_ID: l'ID del tuo progetto Google Cloud.
- APP_ID: l'ID dell'app Vertex AI Search.
- QUERY: il testo della query da cercare.
- ORDER_BY: l'ordine in cui sono disposti i risultati. Il
campo può avere valori dei seguenti tipi di dati: datetime,
intero o numero. Per l'ordinamento cronologico, specifica l'attributo della data personalizzata specificato nello schema o la data della pagina dedotta da Google per restituire le pagine web ordinate per data. Ad esempio, per ordinare in base a un attributo PageMap
date_edited
, puoi specificare il campoorderBy
come"orderBy": "date_edited"
. L'ordinamento predefinito è crescente, pertanto le pagine meno recenti vengono restituite per prime. Per visualizzare i risultati in ordine decrescente, accodadesc
al valore dell'attributo personalizzato, ad esempio"orderBy":"date_edited desc"
.