MetadataFilter

فلتر قدّمه المستخدم لتقييد الاسترداد استنادًا إلى قيم البيانات الوصفية على مستوى Chunk أو Document. مثال (النوع = الدراما OR النوع = الإجراء): key = "document.custom_metadata.genre" terms = [{stringValue = "drama", process = EQUAL}, {stringValue = "action", process = 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 المقترن بعملية INSERT/EXCLUDES، وإلّا ستكون النتيجة أيضًا مجموعة فارغة. يمكن أن تكون السمة "value" واحدة فقط مما يلي:
stringValue

string

قيمة السلسلة المطلوب فلترة البيانات الوصفية بناءً عليها.
numericValue

number

القيمة الرقمية المراد تصفية البيانات الوصفية بناءً عليها.

المؤثِّر

تحدد عوامل التشغيل الصالحة التي يمكن تطبيقها على زوج المفتاح/القيمة.

عمليات التعداد
OPERATOR_UNSPECIFIED القيمة التلقائية. هذه القيمة غير مستخدَمة.
LESS متاح بتنسيق رقمي.
LESS_EQUAL متاح بتنسيق رقمي.
EQUAL متوافق مع القيم الرقمية والسلسلة.
GREATER_EQUAL متاح بتنسيق رقمي.
GREATER متاح بتنسيق رقمي.
NOT_EQUAL متوافق مع القيم الرقمية والسلسلة.
INCLUDES يمكن استخدام هذه السمة في سلسلة فقط عندما يشتمل نوع قيمة CustomMetadata للمفتاح المحدّد على stringListValue.
EXCLUDES يمكن استخدام هذه السمة في سلسلة فقط عندما يشتمل نوع قيمة CustomMetadata للمفتاح المحدّد على stringListValue.