Schema

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

string

اسم الكائن الذي يحدد بعد ذلك نوعه. يجب أن تؤدي طلبات فهرسة العناصر إلى ضبط الحقل objectType على مساوٍ لهذه القيمة. على سبيل المثال، إذا كان name هو مستند، يجب أن تؤدي طلبات الفهرسة للعناصر من النوع "مستند" إلى ضبط objectType على قيمة مستندة. يجب تسمية كل تعريف كائن بشكل فريد داخل المخطط. يجب أن يبدأ الاسم بحرف ويمكن أن يحتوي فقط على أحرف (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. وبخلاف ذلك، تستخدم واجهة برمجة التطبيقات للفهرسة updateTime كمؤشر على حداثة المحتوى. الحد الأقصى للطول هو 256 حرفًا.

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

string (Duration format)

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

مدة بالثواني مؤلفة من تسعة أرقام كسور وتنتهي بـ "s". مثال: "3.5s".

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

string

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

object (ObjectDisplayOptions.Metaline)

تحدد الخصائص التي يتم عرضها في الأسطر الوصفية لنتائج البحث. ويتم عرض قيم الخصائص بالترتيب الموضح هنا. إذا كان أحد المواقع يحتوي على قيم متعدّدة، سيتم عرض جميع القيم قبل المواقع التالية. لهذا السبب، يُعدّ تحديد خصائص المفرد قبل السمات المتكرّرة في هذه القائمة ممارسة جيدة. ويجب ضبط جميع السمات isReturnable على true. الحد الأقصى لعدد الأسطر الوصفية هو 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، يشير ذلك إلى أنّه يمكن لمستخدمي واجهة برمجة تطبيقات طلبات البحث استخدام حقول الخصائص المطابقة في النتائج. ومع ذلك، يتطلب تخزين الحقول تخصيص المزيد من المساحة ويستخدم المزيد من معدّل نقل البيانات لطلبات البحث، ما يؤثر في الأداء على مجموعات البيانات الكبيرة. اضبط القيمة على true هنا فقط إذا كان الحقل مطلوبًا لنتائج البحث. لا يمكن أن يكون true بالنسبة إلى المواقع التي يكون نوعها كائنًا.

boolean

يشير إلى السماح بقِيَم متعددة للسمة. على سبيل المثال، يحتوي المستند على وصف واحد فقط ولكن يمكن أن يكون له تعليقات متعددة. لا يمكن أن يكون صحيحًا للمواقع التي يكون نوعها منطقيًا. في حال ضبط هذه السياسة على "خطأ"، ستتسبب السمات التي تحتوي على أكثر من قيمة واحدة في رفض طلب الفهرسة لهذا العنصر.

boolean

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

boolean

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

boolean

تشير إلى أنّه يمكن استخدام الموقع لإنشاء اقتراحات طلب البحث.

boolean

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

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

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

string

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

string

يشير إلى اسم عامل التشغيل المطلوب في الاستعلام لعزل خاصية العدد الصحيح باستخدام عامل التشغيل "أكبر من". على سبيل المثال، إذا كان أعلى ThanOperatorName بالقيمة priorityabove واسم الموقع الإلكتروني هو priorityVal، لن تعرض طلبات البحث مثل priorityabove:<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

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

string

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

string

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

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

object (BooleanPropertyOptions.BooleanOperatorOptions)

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

{
  "operatorName": string
}

string

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

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

object (PropertyDefinition)

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

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

object (EnumPropertyOptions.EnumValuePair)

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

enum (EnumPropertyOptions.OrderedRanking)

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

object (EnumPropertyOptions.EnumOperatorOptions)

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

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

string

قيمة سلسلة EnumValuePartner الحد الأقصى لعدد الأحرف المسموح به هو 32 حرفًا.

integer

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

{
  "operatorName": string
}

string

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

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

object (DatePropertyOptions.DateOperatorOptions)

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

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

string

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

string

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

string

يشير إلى اسم عامل التشغيل المطلوب في الطلب لعزل خاصية التاريخ باستخدام عامل التشغيل "أكبر من". على سبيل المثال، إذا كانت قيمة bigThanOperatorName 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

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

boolean

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

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

object (RetrievalImportance)

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

object (HtmlPropertyOptions.HtmlOperatorOptions)

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

{
  "operatorName": string
}

string

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

{
  "displayLabel": string
}

string

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