Schema

Bir veri kaynağının şema tanımı.

JSON gösterimi
{
  "objectDefinitions": [
    {
      object (ObjectDefinition)
    }
  ],
  "operationIds": [
    string
  ]
}
Alanlar
objectDefinitions[]

object (ObjectDefinition)

Veri kaynağının en üst düzey nesnelerinin listesi. Maksimum öğe sayısı 10'dur.

operationIds[]

string

Şu anda bu şema için çalışan uzun süreli işlemlerin (LROs) kimlikleri. Şemayı değiştirdikten sonra, ek içerikleri dizine eklemeden önce işlemlerin tamamlanmasını bekleyin.

ObjectDefinition

Bir veri kaynağındaki nesnenin tanımı.

JSON gösterimi
{
  "name": string,
  "options": {
    object (ObjectOptions)
  },
  "propertyDefinitions": [
    {
      object (PropertyDefinition)
    }
  ]
}
Alanlar
name

string

Nesnenin adı. Bu ad, nesnenin türünü tanımlar. Öğe dizine ekleme istekleri, objectType alanını bu değere eşit olarak ayarlamalıdır. Örneğin, ad Belge ise Belge türündeki öğeler için dizine ekleme istekleri objectType değerini Belge olarak ayarlamalıdır. Her nesne tanımı, bir şemada benzersiz bir şekilde adlandırılmalıdır. Ad bir harfle başlamalıdır ve yalnızca harf (A-Z, a-z) veya rakam (0-9) içerebilir. Maksimum uzunluk 256 karakterdir.

options

object (ObjectOptions)

Nesneye özel isteğe bağlı seçenekler.

propertyDefinitions[]

object (PropertyDefinition)

Nesnenin özellik tanımları. Maksimum öğe sayısı 1.000'dir.

ObjectOptions

Bir nesneyle ilgili seçenekler.

JSON gösterimi
{
  "freshnessOptions": {
    object (ObjectOptions.FreshnessOptions)
  },
  "displayOptions": {
    object (ObjectDisplayOptions)
  },
  "suggestionFilteringOperators": [
    string
  ]
}
Alanlar
freshnessOptions

object (ObjectOptions.FreshnessOptions)

Bir nesnenin tazelik seçenekleri.

displayOptions

object (ObjectDisplayOptions)

Nesnenin Cloud Search sonuç sayfasında nasıl gösterileceğini belirleyen seçenekler.

suggestionFilteringOperators[]

string

Önerileri filtrelemek için kullanılabilecek operatörler. query.suggest API için yalnızca burada belirtilen operatörler FilterOptions'te kabul edilir. Yalnızca TEXT ve ENUM operatörleri desteklenir.

NOT: "objecttype", "type" ve "mimetype" zaten desteklenmektedir. Bu özellik, şemaya özgü operatörleri yapılandırmak için kullanılır.

Bu bir dizi olsa da yalnızca bir operatör belirtilebilir. Bu, gelecekte genişletilebilirlik için kullanılan bir dizidir.

Aynı nesne içindeki birden fazla mülkle eşleşen operatörler desteklenmez. Operatör farklı nesne türlerini kapsıyorsa bu seçeneğin her nesne tanımı için bir kez ayarlanması gerekir.

ObjectOptions.FreshnessOptions

Bir öğenin arama sıralaması ayarlanırken hangi tazelik özelliğinin kullanılacağını belirtir. Daha yeni tarihler, daha yüksek kaliteyi gösterir. Verilerinizle en iyi çalışan güncellik seçeneği özelliğini kullanın. Dosya paylaşımı yapılan dokümanlar için en alakalı bilgi son değiştirilme zamanıdır. Takvim etkinliği verileri için etkinliğin gerçekleştiği saat daha alakalı bir tazelik göstergesidir. Bu sayede, arama sorgusunun zamanına daha yakın gerçekleşen takvim etkinlikleri daha yüksek kaliteli olarak kabul edilir ve buna göre sıralanır.

JSON gösterimi
{
  "freshnessProperty": string,
  "freshnessDuration": string
}
Alanlar
freshnessProperty

string

Bu özellik, dizindeki nesnenin tazelik düzeyini gösterir. Ayarlanırsa bu özellik property definitions içinde üst düzey bir özellik olmalı ve timestamp type veya date type olmalıdır. Aksi takdirde Dizine Ekleme API'si, tazelik göstergesi olarak updateTime değerini kullanır. Maksimum uzunluk 256 karakterdir.

Güncelliği hesaplamak için bir mülk kullanıldığında değer varsayılan olarak geçerli zamandan itibaren 2 yıl olarak belirlenir.

freshnessDuration

string (Duration format)

Bir nesnenin eski kabul edilmesi için geçmesi gereken süre. Varsayılan değer 180 gündür (saniye cinsinden).

En fazla dokuz kesirli basamak içeren ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".

ObjectDisplayOptions

Bir nesnenin görüntüleme seçenekleri.

JSON gösterimi
{
  "objectDisplayLabel": string,
  "metalines": [
    {
      object (ObjectDisplayOptions.Metaline)
    }
  ]
}
Alanlar
objectDisplayLabel

string

Öğenin türünü belirtmek için arama sonucunda gösterilecek kullanıcı dostu etiket. Bu İSTEĞE BAĞLI bir parametredir. Sağlanmazsa arama sonuçlarının bağlam satırında bir nesne etiketi gösterilmez. Maksimum uzunluk 64 karakterdir.

metalines[]

object (ObjectDisplayOptions.Metaline)

Arama sonuçlarının meta satırlarında gösterilen özellikleri tanımlar. Mülk değerleri burada verilen sırada gösterilir. Bir mülkte birden fazla değer varsa değerlerin tümü sonraki mülklerden önce gösterilir. Bu nedenle, bu listedeki tekil özellikleri tekrarlanan özelliklerden önce belirtmeniz önerilir. Tüm mülkler isReturnable değerini doğru olarak ayarlamalıdır. Maksimum meta satır sayısı 3'tür.

ObjectDisplayOptions.Metaline

Metaline, bağlam sağlamak için arama sonucuyla birlikte gösterilen mülklerin listesidir.

JSON gösterimi
{
  "properties": [
    {
      object (ObjectDisplayOptions.DisplayedProperty)
    }
  ]
}
Alanlar
properties[]

object (ObjectDisplayOptions.DisplayedProperty)

Metal için görüntülenen özelliklerin listesi. Maksimum mülk sayısı 5'tir.

ObjectDisplayOptions.DisplayedProperty

Nesnedeki, arama sonuçlarında gösterilmesi gereken üst düzey bir mülke referans. Seçilen mülklerin değerleri, arama sonuçlarında söz konusu mülk için belirtilen display label ile birlikte gösterilir. Görünen etiket belirtilmezse yalnızca değerler gösterilir.

JSON gösterimi
{
  "propertyName": string
}
Alanlar
propertyName

string

Nesnenin özellik tanımında tanımlandığı şekliyle en üst düzey mülkün adı. Ad, şemada tanımlanmış bir özellik değilse şema güncellenmeye çalışırken hata verilir.

PropertyDefinition

Bir nesnenin özelliğinin tanımı.

JSON gösterimi
{
  "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.
}
Alanlar
name

string

Tesisin adı. Dizine Ekleme API'sine gönderilen öğe dizine ekleme istekleri, property name değerini bu değere eşit olarak ayarlamalıdır. Örneğin, ad subject_line ise konu alanları içeren doküman öğelerine yönelik dizine ekleme istekleri, söz konusu alanın name değerini subject_line olarak ayarlamalıdır. Nesne mülkünün tanımlayıcı olarak adını kullanın. Bir nesne için mülk olarak kaydedilen bu adı, söz konusu nesnedeki başka bir mülk için yeniden kullanamazsınız. Ad bir harfle başlamalıdır ve yalnızca harf (A-Z, a-z) veya rakam (0-9) içerebilir. Maksimum uzunluk 256 karakterdir.

isReturnable

boolean

Mülkün, arama sonuçlarında döndürülmesi gereken verileri Query API aracılığıyla tanımladığını belirtir. true olarak ayarlanırsa Query API kullanıcılarının sonuçlarda eşleşen mülk alanlarını kullanabileceğini gösterir. Ancak alanları depolamak daha fazla alan ayırmayı gerektirir ve arama sorguları için daha fazla bant genişliği kullanır. Bu da büyük veri kümelerindeki performansı etkiler. Buradaki değeri yalnızca alan arama sonuçları için gerekliyse true olarak ayarlayın. Türü nesne olan mülkler için doğru olamaz.

isRepeatable

boolean

Mülk için birden fazla değere izin verildiğini gösterir. Örneğin, bir dokümanın yalnızca bir açıklaması ancak birden fazla yorumu olabilir. Türü boole olan mülkler için doğru olamaz. Yanlış olarak ayarlanırsa birden fazla değer içeren mülkler, söz konusu öğe için dizine ekleme isteğinin reddedilmesine neden olur.

isSortable

boolean

Özelliğin sıralama için kullanılabileceğini gösterir. Tekrarlanabilir özellikler için doğru olamaz. Türü nesne olan mülkler için doğru olamaz. Bu seçeneğin ayarlanması için IsReturnable değerinin doğru olması gerekir. Yalnızca doğru/yanlış, tarih, çift, tam sayı ve zaman damgası özellikleri için desteklenir.

isFacetable

boolean

Özelliğin, yönler oluşturmak için kullanılabileceğini belirtir. Türü nesne olan mülkler için doğru olamaz. Bu seçeneğin ayarlanması için IsReturnable değerinin doğru olması gerekir. Yalnızca boole, enum, tam sayı ve metin mülkleri için desteklenir.

isSuggestable

boolean

Mülkün, sorgu önerileri oluşturmak için kullanılabileceğini belirtir.

isWildcardSearchable

boolean

Kullanıcıların bu mülk için joker karakter araması yapabileceğini belirtir. Yalnızca metin mülkleri için desteklenir. Bu seçeneğin ayarlanması için IsReturnable değerinin doğru olması gerekir. Belirli bir veri kaynağında en fazla 5 mülk isWildcardSearchable olarak işaretlenebilir. Daha fazla bilgi için Nesne özelliklerini tanımlama başlıklı makaleyi inceleyin.

displayOptions

object (PropertyDisplayOptions)

Nesnenin display options bölümünde gösterilmesi belirtilmişse mülkün Cloud Search sonuçları sayfasında nasıl gösterileceğini belirleyen seçenekler.

Birlik alanı property_options. Tesisin nasıl dizine ekleneceğini ve kullanılacağını belirleyen türe özel seçenekler. Seçenekler bir tür için varsayılan seçenekler olmalıdır. Bu durumda da bu alan türlerden birine ayarlanmalıdır. Bu alan ayarlanmazsa şema güncellemeleri reddedilir. property_options yalnızca aşağıdakilerden biri olabilir:
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)

IntegerPropertyOptions

Tam sayı mülkleri için seçenekler.

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

enum (IntegerPropertyOptions.OrderedRanking)

Tam sayı için sıralı sıralamayı belirtmek üzere kullanılır. Yalnızca isRepeatable yanlışsa kullanılabilir.

minimumValue

string (Int64Value format)

Özelliğin minimum değeri. Mülkün minimum ve maksimum değerleri, sonuçları ordered ranking'ye göre sıralamak için kullanılır. Minimum değerden düşük değerlere sahip dizine ekleme istekleri kabul edilir ve minimum değerle dizine eklenen öğelerle aynı ağırlıkla sıralanır.

maximumValue

string (Int64Value format)

Özelliğin maksimum değeri. Mülkün minimum ve maksimum değerleri, sonuçları ordered ranking'ye göre sıralamak için kullanılır. Maksimumdan daha yüksek değerlere sahip dizine ekleme istekleri kabul edilir ve maksimum değerle dizine eklenen öğelerle aynı ağırlıkla sıralanır.

operatorOptions

object (IntegerPropertyOptions.IntegerOperatorOptions)

Ayarlanırsa tam sayının arama operatörü olarak nasıl kullanılacağını açıklar.

integerFacetingOptions

object (IntegerFacetingOptions)

Ayarlanırsa, belirtilen tam sayı özelliği için tam sayı kırma seçeneklerini açıklar. İlgili tam sayı özelliği isFacetable olarak işaretlenmelidir.

IntegerPropertyOptions.OrderedRanking

Bir tamsayı değerinin diğer değerlere göre nasıl sıralanacağını belirtmek için kullanılır. Sıralı sıralamada daha yüksek bir tam sayı, daha yüksek önemi gösterir. Örneğin, bazı veri kaynaklarında daha düşük öncelik daha yüksek önemi, diğerlerinde ise daha yüksek öncelik daha yüksek önemi gösterir.

Sıralamalar
NO_ORDER Tesis için sıralama sırası yok. Sonuçlar bu mülkün değerine göre ayarlanmaz.
ASCENDING Bu mülk artan düzende sıralanır. Düşük değerler, daha düşük sıralamayı gösterir.
DESCENDING Bu özellik azalan düzende sıralanır. Düşük değerler daha yüksek sıralamayı gösterir.

IntegerPropertyOptions.IntegerOperatorOptions

Tam sayı mülkleri için bir arama operatörü sağlamak amacıyla kullanılır. Bu isteğe bağlıdır. query.search operatörleri, kullanıcıların sorguyu aranan öğe türüyle alakalı belirli alanlarla kısıtlamasına olanak tanır.

JSON gösterimi
{
  "operatorName": string,
  "lessThanOperatorName": string,
  "greaterThanOperatorName": string
}
Alanlar
operatorName

string

Tam sayı özelliğini ayırmak için sorguda gereken operatör adını belirtir. Örneğin, operatorName priority ve mülkün adı priorityVal ise priority:<value> gibi sorgular yalnızca priorityVal adlı mülkün değerinin <value> ile eşleştiği sonuçları gösterir. Buna karşılık, operatör olmadan aynı <value> değerini kullanan bir arama, <value> değerinin herhangi bir dize mülkünün değeriyle veya öğenin içerik alanındaki metinle eşleştiği tüm öğeleri döndürür. Operatör adı yalnızca küçük harf (a-z) içerebilir. Maksimum uzunluk 32 karakterdir.

lessThanOperatorName

string

Tam sayı mülkünü küçüktür operatörünü kullanarak ayırmak için sorguda gereken operatör adını belirtir. Örneğin, lessThanOperatorName prioritybelow ve mülkün adı priorityVal ise prioritybelow:<value> gibi sorgular yalnızca priorityVal adlı mülkün değerinin <value> değerinden az olduğu sonuçları gösterir. Operatör adı yalnızca küçük harf (a-z) içerebilir. Maksimum uzunluk 32 karakterdir.

greaterThanOperatorName

string

Tam sayı özelliğini büyüktür operatörünü kullanarak ayırmak için sorguda gereken operatör adını belirtir. Örneğin, greaterThanOperatorName priorityabove ve mülkün adı priorityVal ise priorityabove:<value> gibi sorgular yalnızca priorityVal adlı mülkün değerinin <value> değerinden büyük olduğu sonuçları gösterir. Operatör adı yalnızca küçük harf (a-z) içerebilir. Maksimum uzunluk 32 karakterdir.

DoublePropertyOptions

Çift mülkler için seçenekler.

JSON gösterimi
{
  "operatorOptions": {
    object (DoublePropertyOptions.DoubleOperatorOptions)
  }
}
Alanlar
operatorOptions

object (DoublePropertyOptions.DoubleOperatorOptions)

Ayarlanırsa çifte işaretin arama operatörü olarak nasıl kullanılacağını açıklar.

DoublePropertyOptions.DoubleOperatorOptions

Çift mülkler için arama operatörü sağlamak amacıyla kullanılır. Bu isteğe bağlıdır. query.search operatörleri, kullanıcıların sorguyu aranan öğe türüyle alakalı belirli alanlarla kısıtlamasına olanak tanır.

JSON gösterimi
{
  "operatorName": string
}
Alanlar
operatorName

string

Çift özelliğinin sıralamada veya bir yön olarak kullanılması için sorguda gereken operatör adını belirtir. Operatör adı yalnızca küçük harf (a-z) içerebilir. Maksimum uzunluk 32 karakterdir.

TimestampPropertyOptions

Zaman damgası özellikleri için seçenekler.

JSON gösterimi
{
  "operatorOptions": {
    object (TimestampPropertyOptions.TimestampOperatorOptions)
  }
}
Alanlar
operatorOptions

object (TimestampPropertyOptions.TimestampOperatorOptions)

Ayarlanırsa zaman damgasının arama operatörü olarak nasıl kullanılacağını açıklar.

TimestampPropertyOptions.TimestampOperatorOptions

Zaman damgası özellikleri için bir arama operatörü sağlamak amacıyla kullanılır. Bu isteğe bağlıdır. query.search operatörleri, kullanıcıların sorguyu aranan öğe türüyle alakalı belirli alanlarla kısıtlamasına olanak tanır.

JSON gösterimi
{
  "operatorName": string,
  "lessThanOperatorName": string,
  "greaterThanOperatorName": string
}
Alanlar
operatorName

string

Zaman damgası özelliğini ayırmak için sorguda gereken operatör adını belirtir. Örneğin, operatorName closedon ve mülkün adı closeDate ise closedon:<value> gibi sorgular yalnızca closeDate adlı mülkün değerinin <value> ile eşleştiği sonuçları gösterir. Buna karşılık, operatör olmadan aynı <value> değerini kullanan bir arama, <value> değerinin herhangi bir dize özelliğinin değeriyle veya öğenin içerik alanındaki metinle eşleştiği tüm öğeleri döndürür. Operatör adı yalnızca küçük harf (a-z) içerebilir. Maksimum uzunluk 32 karakterdir.

lessThanOperatorName

string

Daha küçük operatörünü kullanarak zaman damgası özelliğini ayırmak için sorguda gereken operatör adını belirtir. Örneğin, lessThanOperatorName closedbefore ve mülkün adı closeDate ise closedbefore:<value> gibi sorgular yalnızca closeDate adlı mülkün değerinin <value> değerinden önce olduğu sonuçları gösterir. Operatör adı yalnızca küçük harf (a-z) içerebilir. Maksimum uzunluk 32 karakterdir.

greaterThanOperatorName

string

Büyüktür operatörünü kullanarak zaman damgası özelliğini ayırmak için sorguda gereken operatör adını belirtir. Örneğin, greaterThanOperatorName closedafter ve mülkün adı closeDate ise closedafter:<value> gibi sorgular yalnızca closeDate adlı mülkün değerinin <value> değerinden sonraki sonuçları gösterir. Operatör adı yalnızca küçük harf (a-z) içerebilir. Maksimum uzunluk 32 karakterdir.

BooleanPropertyOptions

Boole özellikleri için seçenekler.

JSON gösterimi
{
  "operatorOptions": {
    object (BooleanPropertyOptions.BooleanOperatorOptions)
  }
}
Alanlar
operatorOptions

object (BooleanPropertyOptions.BooleanOperatorOptions)

Ayarlanırsa boole değerinin arama operatörü olarak nasıl kullanılacağını açıklar.

BooleanPropertyOptions.BooleanOperatorOptions

Boole mülkleri için bir arama operatörü sağlamak amacıyla kullanılır. Bu isteğe bağlıdır. query.search operatörleri, kullanıcıların sorguyu aranan öğe türüyle alakalı belirli alanlarla kısıtlamasına olanak tanır.

JSON gösterimi
{
  "operatorName": string
}
Alanlar
operatorName

string

Boole özelliğini izole etmek için sorguda gereken operatör adını belirtir. Örneğin, operatorName closed ve mülkün adı isClosed ise closed:<value> gibi sorgular yalnızca isClosed adlı mülkün değerinin <value> ile eşleştiği sonuçları gösterir. Buna karşılık, operatör olmadan aynı <value> değerini kullanan bir arama, <value> değerinin herhangi bir dize özelliğinin veya öğenin içerik alanındaki metnin değeriyle eşleştiği tüm öğeleri döndürür. Operatör adı yalnızca küçük harf (a-z) içerebilir. Maksimum uzunluk 32 karakterdir.

ObjectPropertyOptions

Nesne özellikleri için seçenekler.

JSON gösterimi
{
  "subobjectProperties": [
    {
      object (PropertyDefinition)
    }
  ]
}
Alanlar
subobjectProperties[]

object (PropertyDefinition)

Alt nesnenin özellikleri. Bu özellikler iç içe yerleştirilmiş bir nesneyi temsil eder. Örneğin, bu mülk bir posta adresini temsil ediyorsa alt nesne özellikleri cadde, şehir ve eyalet olarak adlandırılabilir. Maksimum öğe sayısı 1.000'dir.

EnumPropertyOptions

Kullanıcı sorgularını eşleştirmek için kısıtlanmış bir dize grubu tanımlamanıza, bu dize değerleri için sıralamalar belirlemenize ve kullanıcıların sonuçları yalnızca belirli bir değere sahip öğelerle daraltabilmesi için bu dizelerle eşlenecek bir operatör adı tanımlamanıza olanak tanıyan enum özellikleri seçenekleri. Örneğin, öncelik bilgileri içeren bir istek izleme sisteminde p0 değerini izin verilen bir enum değeri olarak tanımlayabilir ve bu enum'u priority operatör adına bağlayabilirsiniz. Böylece arama kullanıcıları, sonuç kümesini yalnızca p0 değeriyle dizine eklenen öğelerle kısıtlamak için sorgularına priority:p0 ekleyebilir.

JSON gösterimi
{
  "possibleValues": [
    {
      object (EnumPropertyOptions.EnumValuePair)
    }
  ],
  "orderedRanking": enum (EnumPropertyOptions.OrderedRanking),
  "operatorOptions": {
    object (EnumPropertyOptions.EnumOperatorOptions)
  }
}
Alanlar
possibleValues[]

object (EnumPropertyOptions.EnumValuePair)

Listeleme mülkü için olası değerlerin listesi. Tüm EnumValuePairs bir dize değeri sağlamalıdır. Bir EnumValuePair için tam sayı değeri belirtirseniz tüm olası EnumValuePairs için tam sayı değeri sağlanmalıdır. Hem dize değeri hem de tam sayı değeri, tüm olası değerler arasında benzersiz olmalıdır. Olası değerler ayarlandıktan sonra kaldırılamaz veya değiştirilemez. Sıralı bir sıralama sağlarsanız ve gelecekte başka enum değerleri ekleyebileceğinizi düşünüyorsanız daha önce kayıtlı değerler arasına değer eklemenize olanak tanımak için ilk tam sayı değerlerinde boşluk bırakın. Maksimum öğe sayısı 100'dür.

orderedRanking

enum (EnumPropertyOptions.OrderedRanking)

Olası EnumValuePairs değerlerinde sağlanan tam sayı değerlerinin sonuçları sıralamak için nasıl kullanılacağını belirleyen, listeleme için sıralı sıralamayı belirtmek amacıyla kullanılır. Belirtilen durumlarda, bu özellik için verilen tüm olası EnumValuePair değerleri için tam sayı değerleri sağlanmalıdır. Yalnızca isRepeatable yanlışsa kullanılabilir.

operatorOptions

object (EnumPropertyOptions.EnumOperatorOptions)

Ayarlanırsa enum'un arama operatörü olarak nasıl kullanılacağını açıklar.

EnumPropertyOptions.EnumValuePair

Listeleme değeri çifti iki şeyi tanımlar: zorunlu bir dize değeri ve isteğe bağlı bir tam sayı değeri. Dize değeri, söz konusu öğeyi almak için gereken sorgu terimini tanımlar (ör. öncelikli öğe için p0). Tam sayı değeri, bu dize değerinin aynı mülk için diğer listelenmiş değerlere göre sıralamasını belirler. Örneğin, p0 değerini 0 ile ilişkilendirebilir ve p1 ve 1 gibi başka bir enum çifti tanımlayabilirsiniz. Belirli bir değerin sıralamasını, aynı mülk adı için diğer numaralandırılmış değerlere göre ayarlamak üzere tamsayı değerini ordered ranking ile birlikte kullanmanız gerekir. Burada, öncelik özellikleri için AZALAN bir sıralama düzeni, p1 değeriyle dizine eklenen öğelere kıyasla p0 değeriyle dizine eklenen öğelerin sıralamasında artışa neden olur. Belirtilen bir sıralama sırası olmadan tam sayı değerinin öğe sıralaması üzerinde hiçbir etkisi yoktur.

JSON gösterimi
{
  "stringValue": string,
  "integerValue": integer
}
Alanlar
stringValue

string

EnumValuePair öğesinin dize değeri. Maksimum uzunluk 32 karakterdir.

integerValue

integer

EnumValuePair değerinin sıfırdan büyük olması gereken tam sayı değeri. İsteğe bağlı.

EnumPropertyOptions.OrderedRanking

Diğer EnumValuePair tamsayı değerlerine göre bir EnumValuePair tamsayının sıralama yönünü belirtmek için kullanılır. Bazı mülkler için daha düşük tam sayı değerleri daha yüksek önemi, diğerlerinde ise daha yüksek tam sayı değerleri daha yüksek önemi gösterir.

Sıralamalar
NO_ORDER Tesis için sıralama sırası yok. Sonuçlar bu mülkün değerine göre ayarlanmaz.
ASCENDING Bu mülk artan düzende sıralanır. Düşük değerler, daha düşük sıralamayı gösterir.
DESCENDING Bu özellik azalan düzende sıralanır. Düşük değerler daha yüksek sıralamayı gösterir.

EnumPropertyOptions.EnumOperatorOptions

Listeli mülk için arama operatörü sağlamak amacıyla kullanılır. Bu isteğe bağlıdır. query.search operatörleri, kullanıcıların sorguyu aranan öğe türüyle alakalı belirli alanlarla kısıtlamasına olanak tanır. Örneğin, p0 ve p1 olası değerlerine sahip bir priority enum mülkü için hiçbir operatör sağlamazsanız p0 terimini içeren bir sorgu, priority mülkünün değeri olarak p0'a sahip öğelerin yanı sıra diğer alanlarda p0 dizesini içeren tüm öğeleri döndürür. Liste için priority gibi bir operatör adı sağlarsanız arama kullanıcıları, priority:p0 sorgusuyla sonuçları yalnızca bu mülkün değeri p0 olan öğelerle hassaslaştırmak için bu operatörü kullanabilir.

JSON gösterimi
{
  "operatorName": string
}
Alanlar
operatorName

string

enum özelliğini ayırmak için sorguda gereken operatör adını belirtir. Örneğin, operatorName priority ve mülkün adı priorityVal ise priority:<value> gibi sorgular yalnızca priorityVal adlı mülkün değerinin <value> ile eşleştiği sonuçları gösterir. Buna karşılık, operatör olmadan aynı <value> değerini kullanan bir arama, <value> değerinin herhangi bir dize mülkünün değeriyle veya öğenin içerik alanındaki metinle eşleştiği tüm öğeleri döndürür. Operatör adı yalnızca küçük harf (a-z) içerebilir. Maksimum uzunluk 32 karakterdir.

DatePropertyOptions

Tarih özellikleriyle ilgili seçenekler.

JSON gösterimi
{
  "operatorOptions": {
    object (DatePropertyOptions.DateOperatorOptions)
  }
}
Alanlar
operatorOptions

object (DatePropertyOptions.DateOperatorOptions)

Ayarlanırsa tarihin arama operatörü olarak nasıl kullanılacağını açıklar.

DatePropertyOptions.DateOperatorOptions

İsteğe bağlı. Tarih özellikleri için bir arama operatörü sağlar. query.search operatörleri, kullanıcıların sorguyu aranan öğe türüyle alakalı belirli alanlarla kısıtlamasına olanak tanır.

JSON gösterimi
{
  "operatorName": string,
  "lessThanOperatorName": string,
  "greaterThanOperatorName": string
}
Alanlar
operatorName

string

Tarih özelliğini ayırmak için sorguda gereken gerçek dizeyi belirtir. Örneğin, bir sorun izleme şeması nesnesinde closeDate adlı bir mülk olduğunu ve bu mülkün closedon adlı bir operatör adı içerdiğini varsayalım. Bu verilerle ilgili aramalarda closedon:<value> gibi sorgular yalnızca closeDate mülkünün değerinin <value> ile eşleştiği sonuçları gösterir. Buna karşılık, aynı <value> değerini operatör olmadan kullanan bir arama, <value> değerinin dizine eklenen veri kaynağının içerik alanındaki herhangi bir dize mülkünün veya metnin değeriyle eşleştiği tüm öğeleri döndürür. Operatör adı yalnızca küçük harf (a-z) içerebilir. Maksimum uzunluk 32 karakterdir.

lessThanOperatorName

string

Tarih özelliğini küçüktür operatörünü kullanarak ayırmak için sorguda gereken operatör adını belirtir. Örneğin, lessThanOperatorName closedbefore ve mülkün adı closeDate ise closedbefore:<value> gibi sorgular yalnızca closeDate adlı mülkün değerinin <value> değerinden önce olduğu sonuçları gösterir. Operatör adı yalnızca küçük harf (a-z) içerebilir. Maksimum uzunluk 32 karakterdir.

greaterThanOperatorName

string

Büyüktür operatörünü kullanarak tarih özelliğini ayırmak için sorguda gereken operatör adını belirtir. Örneğin, greaterThanOperatorName closedafter ve mülkün adı closeDate ise closedafter:<value> gibi sorgular yalnızca closeDate adlı mülkün değerinin <value> değerinden sonraki sonuçları gösterir. Operatör adı yalnızca küçük harf (a-z) içerebilir. Maksimum uzunluk 32 karakterdir.

TextPropertyOptions

Metin mülkleri için seçenekler.

JSON gösterimi
{
  "retrievalImportance": {
    object (RetrievalImportance)
  },
  "operatorOptions": {
    object (TextPropertyOptions.TextOperatorOptions)
  }
}
Alanlar
retrievalImportance

object (RetrievalImportance)

Alandaki jetonların, getirme için kullanıldığında arama kalitesi açısından önemini belirtir.

operatorOptions

object (TextPropertyOptions.TextOperatorOptions)

Ayarlanırsa mülkün arama operatörü olarak nasıl kullanılması gerektiğini açıklar.

RetrievalImportance

JSON gösterimi
{
  "importance": enum (RetrievalImportance.Importance)
}
Alanlar
importance

enum (RetrievalImportance.Importance)

Mülk, getirme sırasında eşleştiğinde mülke verilen sıralama önemini gösterir. Bir mülkün jeton önemi ayarlandıktan sonra değiştirilemez.

RetrievalImportance.Importance

Sıralamalar
DEFAULT Eşleşmeyi gövde metni eşleşmesi gibi değerlendirin.
HIGHEST Eşleşmeyi, öğenin başlığıyla eşleşme olarak değerlendirin.
HIGH Eşlemeyi gövde metninden daha önemli olarak değerlendirin.
LOW Eşleşmeyi gövde metnine göre daha az önemli olarak değerlendirin.
NONE Getirme sırasında bu alanla eşleşmez. Mülk, operatör eşleştirme, kırma ve istenirse öneri için kullanılmaya devam edebilir.

TextPropertyOptions.TextOperatorOptions

Metin özellikleri için bir arama operatörü sağlamak amacıyla kullanılır. Bu isteğe bağlıdır. query.search operatörleri, kullanıcıların sorguyu aranan öğe türüyle alakalı belirli alanlarla kısıtlamasına olanak tanır.

JSON gösterimi
{
  "operatorName": string,
  "exactMatchWithOperator": boolean
}
Alanlar
operatorName

string

Metin özelliğini ayırmak için sorguda gereken operatör adını belirtir. Örneğin, operatorName subject ve mülkün adı subjectLine ise subject:<value> gibi sorgular yalnızca subjectLine adlı mülkün değerinin <value> ile eşleştiği sonuçları gösterir. Buna karşılık, operatör olmadan aynı <value> değerini kullanan bir arama, <value> değerinin herhangi bir metin özelliğinin değeriyle veya öğenin içerik alanındaki metinle eşleştiği tüm öğeleri döndürür. Operatör adı yalnızca küçük harf (a-z) içerebilir. Maksimum uzunluk 32 karakterdir.

exactMatchWithOperator

boolean

Doğru ise metin değeri, operatör aramalarında ve yöne göre eşleşmelerde tek bir atomik değer olarak jetonlara ayrılır. Örneğin, operatör adı "tür" ve değer "bilim kurgu" ise "tür:bilim" ve "tür:kurgu" sorgu kısıtlamaları öğeyle eşleşmez; "tür:bilim kurgu" kısıtlaması eşleşir. Metin değeri eşleştirmesi büyük/küçük harfe duyarlıdır ve özel karakterleri kaldırmaz. Yanlış ise metin jetonlara ayrılır. Örneğin, değer "bilim kurgu" ise "tür:bilim" ve "tür:kurgu" sorguları öğeyle eşleşir.

HtmlPropertyOptions

HTML mülkleri için seçenekler.

JSON gösterimi
{
  "retrievalImportance": {
    object (RetrievalImportance)
  },
  "operatorOptions": {
    object (HtmlPropertyOptions.HtmlOperatorOptions)
  }
}
Alanlar
retrievalImportance

object (RetrievalImportance)

Alandaki jetonların, getirme için kullanıldığında arama kalitesi açısından önemini belirtir. Yalnızca VARSAYILAN veya YOK olarak ayarlanabilir.

operatorOptions

object (HtmlPropertyOptions.HtmlOperatorOptions)

Ayarlanırsa mülkün arama operatörü olarak nasıl kullanılması gerektiğini açıklar.

HtmlPropertyOptions.HtmlOperatorOptions

HTML mülkleri için bir arama operatörü sağlamak amacıyla kullanılır. Bu isteğe bağlıdır. query.search operatörleri, kullanıcıların sorguyu aranan öğe türüyle alakalı belirli alanlarla kısıtlamasına olanak tanır.

JSON gösterimi
{
  "operatorName": string
}
Alanlar
operatorName

string

HTML mülkünü ayırmak için sorguda gereken operatör adını belirtir. Örneğin, operatorName subject ve mülkün adı subjectLine ise subject:<value> gibi sorgular yalnızca subjectLine adlı mülkün değerinin <value> ile eşleştiği sonuçları gösterir. Buna karşılık, operatör olmadan aynı <value> değerini kullanan bir arama, <value> değerinin öğenin içerik alanındaki herhangi bir html özelliğinin veya metnin değeriyle eşleştiği tüm öğeleri döndürür. Operatör adı yalnızca küçük harf (a-z) içerebilir. Maksimum uzunluk 32 karakterdir.

PropertyDisplayOptions

Bir mülkün görüntüleme seçenekleri.

JSON gösterimi
{
  "displayLabel": string
}
Alanlar
displayLabel

string

Mülkün ObjectDisplayOptions'ta gösterileceği belirtilirse mülk için kullanılan kullanıcı dostu etiket. Gösterilen etiket, sağlanırsa tesis nesne görüntüleme seçeneklerinin bir parçası olduğunda tesis değerlerinin önünde gösterilir. Örneğin, mülk değeri "1" ise değer tek başına kullanıcı için yararlı bir bağlam olmayabilir. Verilen görünen ad "öncelik" ise kullanıcı, arama sonuçlarında "öncelik : 1" ifadesini görür. Bu ifade, arama yapan kullanıcılara net bir bağlam sağlar. Bu İSTİĞE BAĞLIDIR; belirtilmezse yalnızca mülk değerleri gösterilir. Maksimum uzunluk 64 karakterdir.