Hasil pesanan dari penyimpanan data terstruktur (Lama)

Halaman ini menjelaskan cara mengurutkan hasil kueri penelusuran yang dibuat di penyimpanan data terstruktur dan di penyimpanan data tidak terstruktur dengan metadata.

Jenis data yang didukung untuk mengurutkan hasil

Berikut adalah jenis kolom yang dapat Anda gunakan untuk mengurutkan hasil penelusuran:

  • string
  • number
  • datetime
  • geolocation

Sebelum memulai

Pastikan Anda memiliki aplikasi dengan penyimpanan data yang berisi data terstruktur atau data tidak terstruktur dengan metadata.

Mengurutkan hasil penelusuran

Untuk mengurutkan hasil penelusuran untuk penyimpanan data terstruktur atau untuk penyimpanan data tidak terstruktur dengan metadata, ikuti langkah-langkah berikut:

REST

Untuk menggunakan API guna mengurutkan hasil penelusuran untuk aplikasi dengan data terstruktur atau data tidak terstruktur dengan metadata, gunakan metode engines.servingConfigs.search:

  1. Temukan ID aplikasi Anda. Jika Anda sudah memiliki ID aplikasi, lanjutkan ke langkah berikutnya.

    1. Di konsol Google Cloud , buka halaman Gemini Enterprise.

      Buka Aplikasi

    2. Di halaman Apps, temukan nama aplikasi Anda dan dapatkan ID aplikasi dari kolom ID.

  2. Buat kueri penelusuran dan sertakan kolom orderBy.

    curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://discoveryengine.googleapis.com/v1alpha/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"
    }'
    

    Ganti kode berikut:

    • PROJECT_ID: ID project Anda.
    • APP_ID: ID aplikasi.
    • QUERY: teks kueri yang akan ditelusuri.
    • ORDER_BY: urutan penyusunan hasil. Tata urutan defaultnya adalah menaik. Misalnya, menentukan date akan menampilkan hasil dari yang terlama hingga yang terbaru. Untuk mendapatkan tata urutan menurun, tambahkan desc ke nilai date—misalnya, date desc. Untuk contoh lainnya, lihat contoh orderBy.

orderBy contoh

Untuk mengurutkan kolom string bernama title:

  • "orderBy": "title" untuk menampilkan dokumen dalam urutan abjad menaik sesuai dengan judul.

  • "orderBy": "title desc" untuk menampilkan dokumen yang diurutkan dalam urutan abjad terbalik (dari Z ke A) sesuai dengan judul.

Untuk mengurutkan pada kolom angka bernama rating:

  • "orderBy": "rating" untuk mengurutkan dari dokumen dengan rating terendah hingga tertinggi.

  • "orderBy": "rating desc" untuk mengurutkan dari dokumen dengan rating tertinggi hingga terendah.

Untuk mengurutkan kolom datetime bernama available_date:

  • "orderBy": "available_date" untuk mengurutkan dari dokumen yang tersedia paling cepat hingga yang paling lama.

  • "orderBy": "available_date desc" untuk mengurutkan dari dokumen dengan tanggal tersedia paling jauh hingga yang paling cepat tersedia.

Untuk mengurutkan menurut geolokasi pada kolom bernama location:

  • "orderBy": "GEO_DISTANCE(location, \"Mountain View, CA\")" mengurutkan dokumen dari yang terdekat dengan Mountain View hingga yang terjauh dari Mountain View.

  • "orderBy": "GEO_DISTANCE(location, 37.38, -122.08) desc" mengurutkan dokumen dari yang terjauh hingga terdekat dengan lokasi 37,38°LU dan 122,08°BB.