MetadataFilter

משתמש סיפק מסנן להגבלת השליפה לפי ערכי מטא-נתונים ברמה Chunk או Document. דוגמה (ז'אנר = דרמה או ז'אנר = פעולה): מפתח = תנאים מסוג "document.custom_metadata.genre" = [{stringValue = "drama", Operations = EQUAL}, {stringValue = "action", Action = EQUAL}]

ייצוג JSON
{
  "key": string,
  "conditions": [
    {
      object (Condition)
    }
  ]
}
שדות
key

string

חובה. מפתח המטא-נתונים שלפיהם רוצים לסנן.

conditions[]

object (Condition)

חובה. ערכי Condition של המפתח הנתון שיפעילו את המסנן הזה. מספרי Condition מרובים מצורפים באמצעות OR לוגי.

תנאי

תנאי הסינון רלוונטי למפתח יחיד.

ייצוג JSON
{
  "operation": enum (Operator),

  // Union field value can be only one of the following:
  "stringValue": string,
  "numericValue": number
  // End of list of possible types for union field value.
}
שדות
operation

enum (Operator)

חובה. האופרטור הוחל על צמד המפתח/ערך הנתון כדי להפעיל את התנאי.

שדה איחוד value. סוג הערך חייב להיות תואם לסוג הערך המוגדר בשדה של המפתח התואם. אם סוגי הערכים לא עקביים, התוצאה תהיה קבוצה ריקה. אם בשדה CustomMetadata יש ערך מסוג StringList, תנאי הסינון צריך להשתמש ב-string_value בשילוב עם פעולת הכללה/החרגה, אחרת גם התוצאה תהיה קבוצה ריקה. הערך של value יכול להיות רק אחת מהאפשרויות הבאות:
stringValue

string

ערך המחרוזת שלפיו יש לסנן את המטא-נתונים.

numericValue

number

הערך המספרי שלפיו יש לסנן את המטא-נתונים.

מפעיל

מגדירה את האופרטורים החוקיים שניתן להחיל על צמד מפתח/ערך.

טיפוסים בני מנייה (enums)
OPERATOR_UNSPECIFIED ערך ברירת המחדל. הערך הזה לא בשימוש.
LESS נתמכת באמצעות ערך מספרי.
LESS_EQUAL נתמכת באמצעות ערך מספרי.
EQUAL נתמך באמצעות מחרוזת וספרה.
GREATER_EQUAL נתמכת באמצעות ערך מספרי.
GREATER נתמכת באמצעות ערך מספרי.
NOT_EQUAL נתמך באמצעות מחרוזת וספרה.
INCLUDES נתמכת במחרוזת רק כאשר סוג הערך CustomMetadata למפתח הנתון כולל stringListValue.
EXCLUDES נתמכת במחרוזת רק כאשר סוג הערך CustomMetadata למפתח הנתון כולל stringListValue.