הזמנת תוצאות ממאגרי נתונים מובְנים (מאגרים מדור קודם)

בדף הזה מוסבר איך לסדר את התוצאות של שאילתת חיפוש שבוצעה במאגרי נתונים מובְנים ובמאגרי נתונים לא מובְנים עם מטא-נתונים.

סוגי נתונים נתמכים לסידור התוצאות

אלה סוגי השדות שאתם יכולים להשתמש בהם כדי לסדר את תוצאות החיפוש:

  • string
  • number
  • datetime
  • geolocation

לפני שמתחילים

מוודאים שיש לכם אפליקציה עם מאגר נתונים שמכיל נתונים מובְנים או נתונים לא מובְנים עם מטא-נתונים.

סידור תוצאות החיפוש

כדי לסדר את תוצאות החיפוש במאגר נתונים מובְנים או במאגר נתונים לא מובְנים עם מטא-נתונים, פועלים לפי השלבים הבאים:

REST

כדי להשתמש ב-API כדי לסדר את תוצאות החיפוש של אפליקציה עם נתונים מובְנים או נתונים לא מובְנים עם מטא-נתונים, משתמשים ב-method‏ engines.servingConfigs.search:

  1. מוצאים את מזהה האפליקציה. אם כבר יש לכם את מזהה האפליקציה, דלגו לשלב הבא.

    1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .

      מעבר אל "אפליקציות"

    2. בדף Apps, מאתרים את שם האפליקציה ומעתיקים את המזהה שלה מהעמודה ID.

  2. מבצעים שאילתת חיפוש וכוללים את השדה 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"
    }'
    

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫PROJECT_ID: מזהה הפרויקט.
    • ‫APP_ID: מזהה האפליקציה.
    • ‫QUERY: טקסט השאילתה לחיפוש.
    • ORDER_BY: הסדר שבו התוצאות מסודרות. סדר המיון המוגדר כברירת מחדל הוא בסדר עולה. לדוגמה, אם מציינים date, יוחזרו תוצאות מהישנה ביותר לחדשה ביותר. כדי לקבל סדר מיון יורד, מוסיפים את הערך desc לערך של date, לדוגמה date desc. דוגמאות נוספות מופיעות במאמר דוגמאות ל-orderBy.

‫orderBy דוגמאות

כדי להזמין בשדה מחרוזת שנקרא title:

  • ‫"orderBy": "title" כדי להחזיר את המסמכים בסדר אלפביתי עולה לפי הכותרת.

  • ‫"orderBy": "title desc" כדי להחזיר את המסמכים ממוינים בסדר אלפביתי הפוך (מ-Z עד A) לפי הכותרת.

כדי לסדר לפי שדה מספר שנקרא rating:

  • "orderBy": "rating" כדי למיין את המסמכים מהדירוג הנמוך ביותר לגבוה ביותר.

  • ‫"orderBy": "rating desc" כדי לסדר את המסמכים מהדירוג הגבוה ביותר לנמוך ביותר.

כדי למיין לפי שדה תאריך ושעה שנקרא available_date:

  • "orderBy": "available_date" כדי לסדר את המסמכים מהתאריך הקרוב ביותר ועד לתאריך הרחוק ביותר.

  • "orderBy": "available_date desc" כדי לסדר את המסמכים לפי תאריך הזמינות, מהרחוק ביותר ועד הקרוב ביותר.

כדי לסדר לפי מיקום גיאוגרפי בשדה שנקרא location:

  • ‫"orderBy": "GEO_DISTANCE(location, \"Mountain View, CA\")" ממיין את המסמכים לפי המרחק מ-Mountain View, מהקרוב ביותר לרחוק ביותר.

  • ‫"orderBy": "GEO_DISTANCE(location, 37.38, -122.08) desc" ממיין את המסמכים לפי המרחק מהמיקום ‎37.38°N ו-‎122.08°W, מהרחוק ביותר לקרוב ביותר.