Schema

{
  "name": string,
  "options": {
    object (ObjectOptions)
  },
  "propertyDefinitions": [
    {
      object (PropertyDefinition)
    }
  ]
}

string

اسم الكائن، والذي يحدد نوعه بعد ذلك. يجب ضبط الحقل objectType لطلبات فهرسة العناصر على قيمة مساوٍ لهذه القيمة. على سبيل المثال، إذا كان name هو Document، ينبغي ضبط طلبات فهرسة العناصر من نوع "Document" على objectType تساوي Document. يجب تسمية كل تعريف كائن بشكل فريد داخل مخطط. يجب أن يبدأ الاسم بحرف ويمكن أن يحتوي فقط على أحرف (A-Z أو a-z) أو أرقام (0-9). ويجب ألّا يزيد عدد الأحرف عن 256 حرفًا.

object (ObjectOptions)

تمثّل هذه السمة الخيارات الاختيارية الخاصة بالكائن.

object (PropertyDefinition)

تعريفات السمة للعنصر. الحد الأقصى لعدد العناصر هو 1000.

{
  "freshnessOptions": {
    object (ObjectOptions.FreshnessOptions)
  },
  "displayOptions": {
    object (ObjectDisplayOptions)
  },
  "suggestionFilteringOperators": [
    string
  ]
}

object (ObjectOptions.FreshnessOptions)

خيارات تحديث العنصر

object (ObjectDisplayOptions)

الخيارات التي تحدد كيفية عرض العنصر في صفحة نتائج Cloud Search.

string

عوامل التشغيل التي يمكن استخدامها لفلترة الاقتراحات بالنسبة إلى واجهة برمجة تطبيقات query.suggest، سيتم فقط الالتزام بعوامل التشغيل المذكورة هنا في FilterOptions. يتم توفير عاملي التشغيل TEXT وENUM فقط.

ملاحظة: "نوع الكائن"، "النوع" و"mimetype" متاحة حاليًا. هذه السمة مخصصة لإعداد عوامل التشغيل الخاصة بالمخطط.

على الرغم من أن هذه مصفوفة، يمكن تحديد عامل تشغيل واحد فقط. هذا صفيف قابل للتوسع في المستقبل.

لا تتوفّر عوامل التشغيل التي يتم ربطها بمواقع متعددة ضمن العنصر نفسه. إذا كان العامل يمتد عبر أنواع مختلفة من الكائنات، يجب تعيين هذا الخيار مرة واحدة لكل تعريف كائن.

{
  "freshnessProperty": string,
  "freshnessDuration": string
}

string

تشير هذه السمة إلى مستوى حداثة العنصر في الفهرس. وفي حال ضبطها، يجب أن تكون هذه السمة موقعًا من المستوى الأعلى ضمن property definitions كما يجب أن تكون timestamp type أو date type. بخلاف ذلك، تستخدم Indexing API updateTime كمؤشر حداثة. ويجب ألّا يزيد عدد الأحرف عن 256 حرفًا.

عند استخدام سمة لاحتساب مدى الحداثة، يتم ضبط القيمة تلقائيًا على عامَين من الوقت الحالي.

string (Duration format)

المدة التي يجب بعد انقضائها أن يصبح العنصر قديمًا. القيمة التلقائية هي 180 يومًا (بالثواني).

مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى وتنتهي بالأرقام "s" مثال: "3.5s"

{
  "objectDisplayLabel": string,
  "metalines": [
    {
      object (ObjectDisplayOptions.Metaline)
    }
  ]
}

string

تشير هذه السمة إلى تصنيف سهل الاستخدام ليتم عرضه في نتيجة البحث للإشارة إلى نوع العنصر. هذا اختياري؛ وإذا لم يتم توفيرها، لن يتم عرض تصنيف الكائن في سطر السياق لنتائج البحث. يجب ألّا يزيد عدد الأحرف عن 64 حرفًا.

object (ObjectDisplayOptions.Metaline)

تحدد السمات التي يتم عرضها في العلامات الوصفية لنتائج البحث. يتم عرض قيم الخصائص بالترتيب الموضح هنا. وإذا كان أحد المواقع يحتوي على قيم متعددة، سيتم عرض جميع القيم قبل السمات التالية. لهذا السبب، من الممارسات الجيدة تحديد خصائص المفرد قبل الخصائص المتكررة في هذه القائمة. يجب ضبط isReturnable على "صحيح" في كل السمات. الحد الأقصى لعدد السطور التعريفية هو 3.

{
  "properties": [
    {
      object (ObjectDisplayOptions.DisplayedProperty)
    }
  ]
}

object (ObjectDisplayOptions.DisplayedProperty)

هذه قائمة بالسمات المعروضة الخاصة بالمجموعة الوصفية. يبلغ الحدّ الأقصى لعدد المواقع 5 مواقع.

{
  "propertyName": string
}

string

اسم خاصية المستوى الأعلى كما هو محدّد في تعريف السمة للعنصر. إذا لم يكن الاسم سمة محدّدة في المخطط، سيظهر خطأ عند محاولة تعديل المخطط.

{
  "name": string,
  "isReturnable": boolean,
  "isRepeatable": boolean,
  "isSortable": boolean,
  "isFacetable": boolean,
  "isSuggestable": boolean,
  "isWildcardSearchable": boolean,
  "displayOptions": {
    object (PropertyDisplayOptions)
  },

  // Union field property_options can be only one of the following:
  "integerPropertyOptions": {
    object (IntegerPropertyOptions)
  },
  "doublePropertyOptions": {
    object (DoublePropertyOptions)
  },
  "timestampPropertyOptions": {
    object (TimestampPropertyOptions)
  },
  "booleanPropertyOptions": {
    object (BooleanPropertyOptions)
  },
  "objectPropertyOptions": {
    object (ObjectPropertyOptions)
  },
  "enumPropertyOptions": {
    object (EnumPropertyOptions)
  },
  "datePropertyOptions": {
    object (DatePropertyOptions)
  },
  "textPropertyOptions": {
    object (TextPropertyOptions)
  },
  "htmlPropertyOptions": {
    object (HtmlPropertyOptions)
  }
  // End of list of possible types for union field property_options.
}

string

تمثّل هذه السمة اسم المكان المخصّص للاستئجار. إنّ طلبات فهرسة العناصر التي تم إرسالها إلى Indexing API يجب أن تضبط property name على قيمة مساوية لهذه القيمة. على سبيل المثال، إذا كان الاسم هو subject_line، فإن طلبات فهرسة عناصر المستندات التي تحتوي على حقول مواضيع يجب ضبط name لهذا الحقل على مساوية لـ subject_line. استخدِم الاسم كمعرّف لخاصية الكائن. بعد التسجيل كملكية لكائن، لا يمكنك إعادة استخدام هذا الاسم لموقع آخر داخل ذلك الكائن. يجب أن يبدأ الاسم بحرف ويمكن أن يحتوي فقط على أحرف (A-Z أو a-z) أو أرقام (0-9). ويجب ألّا يزيد عدد الأحرف عن 256 حرفًا.

boolean

تشير هذه السمة إلى أنّ السمة تحدّد البيانات التي يجب عرضها في نتائج البحث من خلال Query API. في حال ضبط هذه السياسة على true، يشير ذلك إلى أنّ مستخدمي Query API يمكنهم استخدام حقول السمات المطابقة في النتائج. ومع ذلك، يتطلب تخزين الحقول تخصيص المزيد من المساحة ويستخدم معدل نقل بيانات أكبر لطلبات البحث، ما يؤثر في الأداء على مجموعات البيانات الكبيرة. اضبط القيمة على true هنا فقط إذا كان الحقل مطلوبًا لنتائج البحث. لا يمكن أن يكون هذا الحقل صحيحًا بالنسبة إلى المواقع الإلكترونية التي يكون نوعها كائنًا.

boolean

تشير هذه السمة إلى أنّه يُسمح باستخدام عدة قيم للسمة. على سبيل المثال، يمكن أن يحتوي المستند على وصف واحد فقط، ولكن يمكن أن يتضمّن تعليقات متعددة. لا يمكن أن تكون القيمة true للخصائص التي يكون نوعها قيمة منطقية. وفي حال ضبط هذه السياسة على "خطأ"، فإنّ الخصائص التي تحتوي على أكثر من قيمة تؤدي إلى رفض طلب الفهرسة لهذا العنصر.

boolean

يشير هذا الحقل إلى أنّه يمكن استخدام السمة للترتيب. لا يمكن أن يكون هذا الحقل صحيحًا للسمات القابلة للتكرار. لا يمكن أن يكون صحيحًا بالنسبة إلى المواقع التي يكون نوعها كائنًا. يجب أن تكون سمة IsReturnable true لإعداد هذا الخيار. هذا الخيار متاح فقط للسمات المنطقية والتاريخ والمزدوج والعدد الصحيح والطابع الزمني.

boolean

تشير إلى إمكانية استخدام الخاصية لإنشاء الواجهات. لا يمكن أن يكون صحيحًا بالنسبة إلى المواقع التي يكون نوعها كائنًا. يجب أن تكون سمة IsReturnable true لإعداد هذا الخيار. لا يمكن استخدامها إلا للسمات المنطقية والتعداد والعدد الصحيح والنص.

boolean

تشير إلى إمكانية استخدام السمة لإنشاء اقتراحات لطلب البحث.

boolean

يشير هذا الرمز إلى أنّه يمكن للمستخدمين البحث بحرف البدل عن هذا الموقع. يمكن استخدام هذه السمة فقط للخصائص النصية. يجب أن تكون سمة IsReturnable true لإعداد هذا الخيار. في مصدر بيانات معيّن، يمكن تصنيف 5 مواقع كحدّ أقصى على أنّها isWildcardSearchable. لمزيد من التفاصيل، راجِع تحديد خصائص العنصر.

object (PropertyDisplayOptions)

تشير هذه السمة إلى الخيارات التي تحدِّد كيفية عرض السمة في صفحة نتائج Cloud Search إذا كان محدّدًا لعرضها في display options للعنصر.

object (IntegerPropertyOptions)

object (DoublePropertyOptions)

object (TimestampPropertyOptions)

object (BooleanPropertyOptions)

object (ObjectPropertyOptions)

object (EnumPropertyOptions)

object (DatePropertyOptions)

object (TextPropertyOptions)

object (HtmlPropertyOptions)

{
  "orderedRanking": enum (IntegerPropertyOptions.OrderedRanking),
  "minimumValue": string,
  "maximumValue": string,
  "operatorOptions": {
    object (IntegerPropertyOptions.IntegerOperatorOptions)
  },
  "integerFacetingOptions": {
    object (IntegerFacetingOptions)
  }
}

enum (IntegerPropertyOptions.OrderedRanking)

يُستخدَم لتحديد الترتيب المُرتَّب لعدد صحيح. لا يمكن استخدام هذه السياسة إلا إذا كانت قيمة السمة isRepeatable خاطئة.

string (Int64Value format)

تمثّل هذه السمة القيمة الصغرى للسمة. يتم استخدام القيم الدنيا والقصوى للسمة لترتيب النتائج وفقًا للنوع ordered ranking. يتم قبول طلبات الفهرسة التي تتضمّن قيمًا أقل من الحد الأدنى، ويتم ترتيبها بالأهمية نفسها التي تحظى بها السلع المفهرسة باستخدام الحدّ الأدنى من القيمة.

string (Int64Value format)

تمثّل هذه السمة الحدّ الأقصى لقيمة الموقع. يتم استخدام القيم الدنيا والقصوى للسمة لترتيب النتائج وفقًا للنوع ordered ranking. يتم قبول طلبات الفهرسة التي تزيد قيمتها عن الحد الأقصى ويتم ترتيبها بالوزن نفسه كالسلع المُفهرَسة ذات القيمة القصوى.

object (IntegerPropertyOptions.IntegerOperatorOptions)

في حال تحديده، يصف كيف يجب استخدام العدد الصحيح كعامل تشغيل بحث.

object (IntegerFacetingOptions)

في حال تحديد هذه السمة، تقدّم وصفًا لخيارات تحديد واجهات الأعداد الصحيحة لخاصية العدد الصحيح. يجب وضع علامة isFacetable على خاصية العدد الصحيح.

{
  "operatorName": string,
  "lessThanOperatorName": string,
  "greaterThanOperatorName": string
}

string

تشير إلى اسم عامل التشغيل المطلوب في طلب البحث لعزل خاصية العدد الصحيح. على سبيل المثال، إذا كانت قيمة filterName هي priority، وكان اسم الموقع هو priorityVal، تعرض طلبات البحث مثل priority:<value> نتائج فقط عندما تتطابق قيمة السمة priorityVal مع <value>. في المقابل، يؤدي البحث الذي يستخدم &lt;value&gt; نفسها بدون عامل تشغيل إلى عرض جميع العناصر التي تتطابق فيها &lt;value&gt; مع قيمة أي خصائص سلسلة أو نص داخل حقل المحتوى للعنصر. لا يمكن أن يحتوي اسم عامل التشغيل إلا على أحرف صغيرة (a-z). يجب ألّا يزيد عدد الأحرف عن 32 حرفًا.

string

تشير هذه السمة إلى اسم عامل التشغيل المطلوب في طلب البحث لعزل خاصية العدد الصحيح باستخدام عامل التشغيل أقل من. على سبيل المثال، إذا كانت قيمة lessThanOperatorName هي priority below واسم الموقع الإلكتروني priorityVal، تعرِض طلبات البحث مثل priority below:<value> نتائج فقط عندما تكون قيمة السمة المسمّاة priorityVal أقل من <value>. لا يمكن أن يحتوي اسم عامل التشغيل إلا على أحرف صغيرة (a-z). يجب ألّا يزيد عدد الأحرف عن 32 حرفًا.

string

تشير هذه السمة إلى اسم عامل التشغيل المطلوب في طلب البحث لعزل خاصية العدد الصحيح باستخدام عامل التشغيل "أكبر من". على سبيل المثال، إذا كان اسم السمة maxThanOperatorName هو priority above واسم الموقع الإلكتروني priorityVal، تعرِض طلبات البحث مثل priority above:<value> نتائج فقط عندما تكون قيمة السمة المسمّاة priorityVal أكبر من <value>. لا يمكن أن يحتوي اسم عامل التشغيل إلا على أحرف صغيرة (a-z). يجب ألّا يزيد عدد الأحرف عن 32 حرفًا.

{
  "operatorOptions": {
    object (DoublePropertyOptions.DoubleOperatorOptions)
  }
}

object (DoublePropertyOptions.DoubleOperatorOptions)

وفي حال ضبطها، تصف كيفية استخدام القيمة المزدوجة كعامل تشغيل بحث.

{
  "operatorName": string
}

string

يشير إلى اسم عامل التشغيل المطلوب في الاستعلام من أجل استخدام الخاصية المزدوجة في الفرز أو كواجهة. لا يمكن أن يحتوي اسم عامل التشغيل إلا على أحرف صغيرة (a-z). يجب ألّا يزيد عدد الأحرف عن 32 حرفًا.

{
  "operatorOptions": {
    object (TimestampPropertyOptions.TimestampOperatorOptions)
  }
}

object (TimestampPropertyOptions.TimestampOperatorOptions)

في حال ضبط هذه السمة، يوضِّح كيفية استخدام الطابع الزمني كعامل تشغيل بحث.

{
  "operatorName": string,
  "lessThanOperatorName": string,
  "greaterThanOperatorName": string
}

string

يشير إلى اسم عامل التشغيل المطلوب في طلب البحث لعزل خاصية الطابع الزمني. على سبيل المثال، إذا كان عامل التشغيل userName هو closedon وكان اسم الموقع هو CloseDate، تعرض طلبات البحث مثل closedon:<value> نتائج فقط تتطابق فيها قيمة السمة المُسمّاة CloseDate مع <value>. في المقابل، يؤدي البحث الذي يستخدم &lt;value&gt; نفسها بدون عامل تشغيل إلى عرض جميع العناصر التي تتطابق فيها &lt;value&gt; مع قيمة أي خصائص سلسلة أو نص داخل حقل المحتوى للعنصر. لا يمكن أن يحتوي اسم عامل التشغيل إلا على أحرف صغيرة (a-z). يجب ألّا يزيد عدد الأحرف عن 32 حرفًا.

string

تشير هذه السمة إلى اسم عامل التشغيل المطلوب في طلب البحث لعزل خاصية الطابع الزمني باستخدام عامل التشغيل أقل من. على سبيل المثال، إذا كانت عملية lessThanOperatorName هي closedbefore وكان اسم الخاصية CloseDate، تعرض طلبات البحث مثل closedbefore:<value> نتائج فقط تكون فيها قيمة الخاصية المُسماة CloseDate أقدم من <value>. لا يمكن أن يحتوي اسم عامل التشغيل إلا على أحرف صغيرة (a-z). يجب ألّا يزيد عدد الأحرف عن 32 حرفًا.

string

تشير هذه السمة إلى اسم عامل التشغيل المطلوب في طلب البحث لعزل خاصية الطابع الزمني باستخدام عامل التشغيل "أكبر من". على سبيل المثال، إذا تم ضبط اسم أكبر ThanOperatorName على closedafter وكان اسم الموقع هو CloseDate، تعرض طلبات البحث مثل closedafter:<value> نتائج فقط تكون فيها قيمة الخاصية المُسمّاة CloseDate بعد <value>. لا يمكن أن يحتوي اسم عامل التشغيل إلا على أحرف صغيرة (a-z). يجب ألّا يزيد عدد الأحرف عن 32 حرفًا.

{
  "operatorOptions": {
    object (BooleanPropertyOptions.BooleanOperatorOptions)
  }
}

object (BooleanPropertyOptions.BooleanOperatorOptions)

في حال ضبطها، تصف كيفية استخدام القيمة المنطقية كعامل تشغيل بحث.

{
  "operatorName": string
}

string

تشير إلى اسم عامل التشغيل المطلوب في طلب البحث لعزل الخاصية المنطقية. على سبيل المثال، إذا كان filterName مغلقًا وكان اسم الموقع isclosed، تعرض طلبات البحث مثل closed:<value> نتائج فقط عندما تتطابق قيمة السمة isClosed مع <value>. في المقابل، يؤدي البحث الذي يستخدم &lt;value&gt; نفسها بدون عامل تشغيل إلى عرض جميع العناصر التي تتطابق فيها &lt;value&gt; مع قيمة أي خصائص سلسلة أو نص داخل حقل المحتوى للعنصر. لا يمكن أن يحتوي اسم عامل التشغيل إلا على أحرف صغيرة (a-z). يجب ألّا يزيد عدد الأحرف عن 32 حرفًا.

{
  "subobjectProperties": [
    {
      object (PropertyDefinition)
    }
  ]
}

object (PropertyDefinition)

خصائص الكائن الفرعي. تمثل هذه الخصائص كائنًا مدمجًا. على سبيل المثال، إذا كانت هذه السمة تمثّل عنوانًا بريديًا، يمكن تسمية عناصر SubobjectProperties street وcity وstate. الحد الأقصى لعدد العناصر هو 1000.

{
  "possibleValues": [
    {
      object (EnumPropertyOptions.EnumValuePair)
    }
  ],
  "orderedRanking": enum (EnumPropertyOptions.OrderedRanking),
  "operatorOptions": {
    object (EnumPropertyOptions.EnumOperatorOptions)
  }
}

object (EnumPropertyOptions.EnumValuePair)

قائمة القيم المحتملة لخاصية التعداد. يجب أن توفّر كل EnumValueValues قيمة سلسلة. إذا حددت قيمة عدد صحيح لزوج واحد من قيم زوج التساوي، يجب أن توفر كل أزواج قيم القيم المحتملة عددًا صحيحًا. يجب أن تكون قيمة السلسلة وقيمة العدد الصحيح فريدة على جميع القيم المحتملة. بعد الضبط، لا يمكن إزالة القيم المحتملة أو تعديلها. إذا قدّمت ترتيبًا مرتَّبًا وتعتقد أنّه يمكنك إدراج قيم تعداد إضافية في المستقبل، اترك فجوات في قيم الأعداد الصحيحة الأولية للسماح بإضافة قيمة بين القيم المسجَّلة سابقًا. الحد الأقصى لعدد العناصر هو 100.

enum (EnumPropertyOptions.OrderedRanking)

يُستخدَم لتحديد الترتيب المرتَّب للتعداد الذي يحدد كيفية استخدام قيم الأعداد الصحيحة المقدَّمة في أزواج قيم القيم المحتملة المتاحة لترتيب النتائج. في حال تحديد قيم عدد صحيح، يجب تقديم قيم عدد صحيح لجميع قيم EnumValue اللازمة المقدّمة لهذه السمة. لا يمكن استخدام هذه السياسة إلا إذا كانت قيمة السمة isRepeatable خاطئة.

object (EnumPropertyOptions.EnumOperatorOptions)

في حال ضبط هذه السمة، يصف كيفية استخدام التعداد كعامل تشغيل.

{
  "stringValue": string,
  "integerValue": integer
}

string

قيمة السلسلة لـ EnumValue الواردة. يجب ألّا يزيد عدد الأحرف عن 32 حرفًا.

integer

قيمة العدد الصحيح لـ EnumValue الواردة والتي يجب أن تكون غير سالبة. اختياريّ.

{
  "operatorName": string
}

string

يشير إلى اسم عامل التشغيل المطلوب في طلب البحث لعزل خاصية enum. على سبيل المثال، إذا كانت قيمة filterName هي priority، وكان اسم الموقع هو priorityVal، تعرض طلبات البحث مثل priority:<value> نتائج فقط عندما تتطابق قيمة السمة priorityVal مع <value>. في المقابل، يؤدي البحث الذي يستخدم &lt;value&gt; نفسها بدون عامل تشغيل إلى عرض جميع العناصر التي تتطابق فيها &lt;value&gt; مع قيمة أي خصائص سلسلة أو نص داخل حقل المحتوى للعنصر. لا يمكن أن يحتوي اسم عامل التشغيل إلا على أحرف صغيرة (a-z). يجب ألّا يزيد عدد الأحرف عن 32 حرفًا.

{
  "operatorOptions": {
    object (DatePropertyOptions.DateOperatorOptions)
  }
}

object (DatePropertyOptions.DateOperatorOptions)

في حال تحديده، يصف كيف يجب استخدام التاريخ كعامل تشغيل بحث.

{
  "operatorName": string,
  "lessThanOperatorName": string,
  "greaterThanOperatorName": string
}

string

تشير إلى السلسلة الفعلية المطلوبة في طلب البحث لعزل خاصية التاريخ. على سبيل المثال، لنفترض أنّ كائن مخطط تتبُّع المشاكل يحتوي على خاصية باسم closeDate التي تحدّد عامل تشغيل يتضمّن عامل التشغيل closeDate. وعند إجراء عمليات بحث عن هذه البيانات، لا تعرض طلبات البحث مثل closedon:&lt;value&gt; نتائج إلا عندما تتطابق قيمة السمة closedon:&lt;value&gt; مع closedon:&lt;value&gt;. في المقابل، يؤدي البحث الذي يستخدم &lt;value&gt; نفسها بدون عامل تشغيل إلى عرض جميع العناصر التي تتطابق فيها &lt;value&gt; مع قيمة أي سمات سلسلة أو نص ضمن حقل المحتوى لمصدر البيانات المفهرَس. لا يمكن أن يحتوي اسم عامل التشغيل إلا على أحرف صغيرة (a-z). يجب ألّا يزيد عدد الأحرف عن 32 حرفًا.

string

تشير إلى اسم عامل التشغيل المطلوب في طلب البحث لعزل خاصية التاريخ باستخدام عامل التشغيل أقل من. على سبيل المثال، إذا كانت عملية lessThanOperatorName هي closedbefore وكان اسم الخاصية CloseDate، تعرض طلبات البحث مثل closedbefore:<value> نتائج فقط تكون فيها قيمة الخاصية المُسماة CloseDate أقدم من <value>. لا يمكن أن يحتوي اسم عامل التشغيل إلا على أحرف صغيرة (a-z). يجب ألّا يزيد عدد الأحرف عن 32 حرفًا.

string

تشير إلى اسم عامل التشغيل المطلوب في طلب البحث لعزل خاصية التاريخ باستخدام عامل التشغيل "أكبر من". على سبيل المثال، إذا تم ضبط اسم أكبر ThanOperatorName على closedafter وكان اسم الموقع هو CloseDate، تعرض طلبات البحث مثل closedafter:<value> نتائج فقط تكون فيها قيمة الخاصية المُسمّاة CloseDate بعد <value>. لا يمكن أن يحتوي اسم عامل التشغيل إلا على أحرف صغيرة (a-z). يجب ألّا يزيد عدد الأحرف عن 32 حرفًا.

{
  "retrievalImportance": {
    object (RetrievalImportance)
  },
  "operatorOptions": {
    object (TextPropertyOptions.TextOperatorOptions)
  }
}

object (RetrievalImportance)

يشير إلى أهمية جودة البحث للرموز المميزة داخل الحقل عند استخدامها للاسترجاع.

object (TextPropertyOptions.TextOperatorOptions)

في حال تحديد هذه السمة، سنوضّح كيفية استخدام السمة كعامل تشغيل بحث.

{
  "importance": enum (RetrievalImportance.Importance)
}

enum (RetrievalImportance.Importance)

ويشير إلى أهمية الترتيب الممنوحة للخاصية عند مطابقتها أثناء الاسترجاع. وبعد الضبط، لا يمكن تغيير أهمية الرمز المميّز لإحدى السمات.

{
  "operatorName": string,
  "exactMatchWithOperator": boolean
}

string

يشير إلى اسم عامل التشغيل المطلوب في طلب البحث لعزل الخاصية النصية. على سبيل المثال، إذا كانت قيمة filterName هي subject واسم الخاصية subjectLine، تعرض طلبات البحث مثل subject:<value> نتائج فقط حيث تتطابق قيمة السمة subjectLine مع <value>. في المقابل، يؤدي البحث الذي يستخدم نفس &lt;value&gt; بدون عامل تشغيل إلى عرض جميع العناصر التي تتطابق فيها &lt;value&gt; مع قيمة أي خصائص نصية أو نص داخل حقل محتوى العنصر. لا يمكن أن يحتوي اسم عامل التشغيل إلا على أحرف صغيرة (a-z). يجب ألّا يزيد عدد الأحرف عن 32 حرفًا.

boolean

إذا كانت القيمة true، يتم تحويل القيمة النصية إلى رمز مميّز كقيمة بسيطة واحدة في عمليات البحث عن عوامل التشغيل وتطابقات الواجهات. على سبيل المثال، إذا كان اسم عامل التشغيل هو "genre" والقيمة هي "الخيال العلمي" قيود طلب البحث "genre:science" و"genre:خيال" لا تتطابق مع العنصر؛ "genre:خيال علمي" بالفعل. تُعدّ مطابقة القيمة النصية حسّاسة لحالة الأحرف ولا تزيل الرموز الخاصة. أما إذا كانت القيمة "false"، فسيتم تحويل النص إلى رمز مميّز. على سبيل المثال، إذا كانت القيمة هي "الخيال العلمي" طلبات البحث "genre:science" و"genre:خيال" يطابق العنصر.

{
  "retrievalImportance": {
    object (RetrievalImportance)
  },
  "operatorOptions": {
    object (HtmlPropertyOptions.HtmlOperatorOptions)
  }
}

object (RetrievalImportance)

يشير إلى أهمية جودة البحث للرموز المميزة داخل الحقل عند استخدامها للاسترجاع. لا يمكن ضبطها إلا على DEFAULT أو NONE.

object (HtmlPropertyOptions.HtmlOperatorOptions)

في حال تحديد هذه السمة، سنوضّح كيفية استخدام السمة كعامل تشغيل بحث.

{
  "operatorName": string
}

string

تشير إلى اسم عامل التشغيل المطلوب في طلب البحث لعزل خاصية html. على سبيل المثال، إذا كانت قيمة filterName هي subject واسم الخاصية subjectLine، تعرض طلبات البحث مثل subject:<value> نتائج فقط حيث تتطابق قيمة السمة subjectLine مع <value>. في المقابل، يؤدي البحث الذي يستخدم نفس &lt;value&gt; بدون عامل تشغيل إلى عرض جميع العناصر التي تتطابق فيها &lt;value&gt; مع قيمة أي خصائص html أو نص داخل حقل المحتوى للعنصر. لا يمكن أن يحتوي اسم عامل التشغيل إلا على أحرف صغيرة (a-z). يجب ألّا يزيد عدد الأحرف عن 32 حرفًا.

{
  "displayLabel": string
}

string

تشير هذه السمة إلى تصنيف سهل الاستخدام للسمة، ويتم استخدامه إذا كانت السمة محدَّدة ليتم عرضها في ObjectDisplayOptions. وفي حال توفير هذه السمة، سيظهر تصنيف العرض أمام قيم الخصائص عندما تكون السمة جزءًا من خيارات عرض العناصر. على سبيل المثال، إذا كانت قيمة السمة هي "1"، قد لا تكون القيمة في حد ذاتها سياقًا مفيدًا للمستخدم. إذا كان الاسم المعروض الذي تم تقديمه هو "الأولوية"، يرى المستخدم "الأولوية : 1". في نتائج البحث مما يوفر سياقًا واضحًا لمستخدمي البحث. هذا اختياري؛ وإذا لم يتم تقديمها، فسيتم عرض قيم الخصائص فقط. يجب ألّا يزيد عدد الأحرف عن 64 حرفًا.