Schema

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

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

object (ObjectDefinition)

Veri kaynağı için üst düzey nesnelerin listesi. Maksimum öğe sayısı 10'dur.

operationIds[]

string

Bu şema için şu anda çalışan Uzun Süreli İşlemlerin (LRO'lar) kimlikleri. Şemayı değiştirdikten sonra, ek içeriği dizine eklemeden önce işlemlerin tamamlanmasını bekleyin.

ObjectDefinition

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

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 olacak şekilde ayarlamalıdır. Örneğin, ad Doküman ise Doküman türündeki öğeler için dizine ekleme istekleri, objectType değerine eşit olarak Doküman değerine ayarlanmalıdır. Her nesne tanımı bir şema içinde 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 özgü isteğe bağlı seçenekler.

propertyDefinitions[]

object (PropertyDefinition)

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

ObjectOptions

Bir nesneye ilişkin seçenekler.

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

object (ObjectOptions.FreshnessOptions)

Bir nesne için güncellik seçenekleri.

displayOptions

object (ObjectDisplayOptions)

Nesnenin Cloud Search sonuçlar sayfasında nasıl görüntüleneceğini belirleyen seçenekler.

suggestionFilteringOperators[]

string

Önerileri filtrelemek için kullanılabilecek operatörler. query.suggest API için FilterOptions kapsamında yalnızca burada belirtilen operatörler dikkate alınır. 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çindir.

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

Aynı nesne içinde birden çok mülkle eşleme yapan 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ını ayarlarken kullanılacak güncellik özelliğini belirtir. Daha güncel ve yakın tarihler daha yüksek kaliteyi gösterir. Verileriniz için en uygun güncellik seçeneği özelliğini kullanın. Dosya paylaşımı dokümanları için son değiştirilme zamanı en alakalı olanıdır. Takvim etkinliği verilerinde, etkinliğin gerçekleşme zamanı daha alakalı bir güncellik göstergesidir. Böylece arama sorgusu zamanına daha yakın zamanda gerçekleşen takvim etkinlikleri daha kaliteli kabul edilir ve buna göre sıralanır.

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

string

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

Güncelliği hesaplamak için bir özellik kullanıldığında bu değer varsayılan olarak şu anki tarihten 2 yıl sonrasına ayarlanır.

freshnessDuration

string (Duration format)

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

En fazla dokuz kesir basamağı içeren ve "s" ile biten saniye cinsinden bir süre. Örnek: "3.5s".

ObjectDisplayOptions

Bir nesne için 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örüntülenecek kullanıcı dostu etiket. Bu İSTEĞE BAĞLIDIR; sağlanmazsa arama sonuçlarının bağlam satırında bir nesne etiketi görüntülenmez. Maksimum uzunluk 64 karakterdir.

metalines[]

object (ObjectDisplayOptions.Metaline)

Arama sonuçlarının meta satırlarında görüntülenen özellikleri tanımlar. Özellik değerleri burada verilen sırayla görüntülenir. Bir mülk birden fazla değer içeriyorsa değerlerin tamamı sonraki özelliklerden önce görüntülenir. Bu nedenle, bu listede yinelenen özelliklerden önce tekil özelliklerin belirtilmesi iyi bir uygulamadır. Tüm özellikler, isReturnable değerini doğru olarak ayarlamalıdır. Maksimum metaline sayısı 3'tür.

ObjectDisplayOptions.Metaline

Metaline, bağlam bilgisi sağlamak için arama sonucuyla birlikte görüntülenen özelliklerin listesidir.

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

object (ObjectDisplayOptions.DisplayedProperty)

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

ObjectDisplayOptions.DisplayedProperty

Nesnenin içinde bulunan ve arama sonuçlarında görüntülenmesi gereken üst düzey bir mülke başvuru. Seçilen özelliklerin değerleri, belirtilmişse arama sonuçlarında o mülk için display label ile birlikte görüntülenir. Bir görüntü etiketi belirtilmezse yalnızca değerler gösterilir.

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

string

Nesnenin özellik tanımında tanımlanan üst düzey mülkün adı. Ad, şemada tanımlı bir özellik değilse şema güncellenmeye çalışılırken hata mesajı verilir.

PropertyDefinition

Bir nesne içindeki özelliğin 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

Mülkün 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ı olan doküman öğelerine ilişkin dizine ekleme istekleri, bu alan için name değerini subject_line değerine eşit olarak ayarlamalıdır. Adı, nesne özelliğinin tanımlayıcısı olarak kullanın. Bir nesne için özellik olarak kaydedildikten sonra, bu adı söz konusu nesne içinde başka bir özellik 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, Sorgu API'si aracılığıyla arama sonuçlarında döndürülmesi gereken verileri tanımladığını belirtir. true (doğru) olarak ayarlanması, Query API kullanıcılarının sonuçlarda eşleşen mülk alanlarını kullanabileceğini belirtir. Ancak, alanları depolamak daha fazla alan ayırma gerektirir ve arama sorguları için daha fazla bant genişliği kullanır. Bu da büyük veri kümelerinde performansı etkiler. Bu alan, yalnızca arama sonuçları için gerekliyse true değerine ayarlayın. Türü nesne olan mülkler için doğru olamaz.

isRepeatable

boolean

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

isSortable

boolean

Özelliğin sıralama için kullanılabileceğini belirtir. Tekrarlanabilir özellikler için doğru olamaz. Türü nesne olan mülkler için doğru olamaz. Bu seçeneği ayarlamak için IsReturnable değeri doğru olmalıdır. Yalnızca boole, tarih, çift, tamsayı ve zaman damgası özellikleri için desteklenir.

isFacetable

boolean

Özelliğin özellik oluşturmak için kullanılabileceğini belirtir. Türü nesne olan mülkler için doğru olamaz. Bu seçeneği ayarlamak için IsReturnable değeri doğru olmalıdır. Yalnızca boole, enum, tamsayı ve metin özellikleri için desteklenir.

isSuggestable

boolean

Özelliğin sorgu önerileri oluşturmak için kullanılabileceğini belirtir.

isWildcardSearchable

boolean

Kullanıcıların bu özellik için joker karakterle arama yapabileceğini belirtir. Yalnızca Metin özellikleri için desteklenir. Bu seçeneği ayarlamak için IsReturnable değeri doğru olmalıdır. Belirli bir veri kaynağında en fazla 5 özellik isWildcardSearchable olarak işaretlenebilir. Daha fazla ayrıntı için Nesne özelliklerini tanımlama bölümüne bakın.

displayOptions

object (PropertyDisplayOptions)

Nesnenin display options içinde görüntüleneceği belirtilmişse mülkün Cloud Search sonuçlar sayfasında nasıl görüntüleneceğini belirleyen seçenekler.

property_options alanı. Mülkün nasıl dizine ekleneceğini ve kullanılacağını belirleyen türe özel seçenekler. Seçeneklerin bir tür için varsayılan seçenekler olması gereken durumlarda, bu alan yine de türlerden birine ayarlanmalıdır. Bu alan ayarlanmazsa şema güncellemeleri reddedilir. property_options şunlardan yalnızca 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ı özellikleri 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 amacıyla kullanılır. Yalnızca isRepeatable yanlış olduğunda kullanılabilir.

minimumValue

string (Int64Value format)

Mülkün minimum değeri. Tesisin minimum ve maksimum değerleri, sonuçları ordered ranking'a göre sıralamak için kullanılır. Minimumun altında değerlere sahip dizine ekleme istekleri kabul edilir ve minimum değerle dizine eklenen öğelerle aynı ağırlığa göre sıralanır.

maximumValue

string (Int64Value format)

Mülkün maksimum değeri. Tesisin minimum ve maksimum değerleri, sonuçları ordered ranking'a göre sıralamak için kullanılır. Maksimum değerin üzerinde değerlere sahip dizine ekleme istekleri kabul edilir ve maksimum değerle dizine eklenen öğelerle aynı ağırlığa göre sıralanır.

operatorOptions

object (IntegerPropertyOptions.IntegerOperatorOptions)

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

integerFacetingOptions

object (IntegerFacetingOptions)

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

IntegerPropertyOptions.OrderedRanking

Bir tam sayı değerinin diğer değerlere göre nasıl sıralanması gerektiğini belirtmek için kullanılır. Sıralamada daha yukarıda olan bir tam sayı daha büyük öneme sahip olduğunu gösterir. Örneğin, bazı veri kaynaklarında düşük öncelik, diğerlerinde yüksek öncelik düzeyi daha yüksek öneme işaret eder.

Sıralamalar
NO_ORDER Mülk için sıralama yoktur. Sonuçlar, bu mülkün değerine göre ayarlanmaz.
ASCENDING Bu mülk, artan düzende sıralanmıştır. Düşük değerler sıralamanın düşük olduğunu gösterir.
DESCENDING Bu tesis azalan düzende sıralandı. Düşük değerler sıralamanın daha yüksek olduğunu gösterir.

IntegerPropertyOptions.IntegerOperatorOptions

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

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

string

Tam sayı özelliğini izole etmek için sorguda gereken operatör adını belirtir. Örneğin, operatörünName önceliği 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 durumlarda sonuçları gösterir. Buna karşılık, operatör olmadan aynı <value> operatörünün kullanıldığı bir aramada <value> işlevi, dize özelliklerinin veya metin içindeki metin içinde bulunan metinle eşleşen tüm öğeleri döndürür. Operatör adı yalnızca küçük harfler (a-z) içerebilir. Maksimum uzunluk 32 karakterdir.

lessThanOperatorName

string

Küçüktür operatörünü kullanarak tam sayı özelliğini ayırmak için sorguda gerekli olan operatör adını belirtir. Örneğin, lessThanOperatorName öncelikli ve özelliğin adı PriorityVal ise Priorityaşağıda:<value> gibi sorgularda sonuçlar yalnızca PriorityVal adlı özelliğin değeri <value> değerinden küçük olduğunda gösterilir. Operatör adı yalnızca küçük harfler (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 gerekli olan operatör adını belirtir. Örneğin, daha büyükThanOperatorName öncelik düzeyi ve mülkün adı PriorityVal ise öncelik:<value> gibi sorgularda sonuçlar yalnızca PriorityVal adlı özelliğin değeri <value> değerinden büyük olduğunda gösterilir. Operatör adı yalnızca küçük harfler (a-z) içerebilir. Maksimum uzunluk 32 karakterdir.

DoublePropertyOptions

Çift mülklerle ilgili seçenekler.

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

object (DoublePropertyOptions.DoubleOperatorOptions)

Ayarlanırsa, çift anahtarın bir arama operatörü olarak nasıl kullanılması gerektiğini 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 öğenin türüyle alakalı belirli alanlarla sınırlamasına olanak tanır.

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

string

Çift özelliği sıralama veya özellik olarak kullanmak için sorguda gereken operatör adını belirtir. Operatör adı yalnızca küçük harfler (a-z) içerebilir. Maksimum uzunluk 32 karakterdir.

TimestampPropertyOptions

Zaman damgası özelliklerine ilişkin seçenekler.

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

object (TimestampPropertyOptions.TimestampOperatorOptions)

Ayarlanırsa zaman damgasının bir arama operatörü olarak nasıl kullanılması gerektiğini 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 öğenin türüyle alakalı belirli alanlarla sınırlaması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, transactionName 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 durumlarda sonuçları gösterir. Buna karşılık, aynı <value> işleci olmadan aynı <value> kullanan bir arama, <value> değerinin dize özelliklerinin veya içerik içindeki metin içindeki metinle eşleştiği tüm öğeleri döndürür. Operatör adı yalnızca küçük harfler (a-z) içerebilir. Maksimum uzunluk 32 karakterdir.

lessThanOperatorName

string

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

greaterThanOperatorName

string

Zaman damgası özelliğini büyüktür operatörünü kullanarak ayırmak için sorguda gerekli olan operatör adını belirtir. Örneğin, daha büyükThanOperatorName closedAfter ve mülkün adı closeDate ise closedsonra:<value> gibi sorgular yalnızca closeDate adlı özelliğin değeri <value> değerinden sonra olduğunda sonuçları gösterir. Operatör adı yalnızca küçük harfler (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'nin, arama operatörü olarak nasıl kullanılması gerektiğini açıklar.

BooleanPropertyOptions.BooleanOperatorOptions

Boole özellikleri için bir arama operatörü sağlamak üzere kullanılır. Bu isteğe bağlıdır. query.search operatörleri, kullanıcıların sorguyu aranan öğenin türüyle alakalı belirli alanlarla sınırlaması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, transactionName closed ise 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 durumlarda sonuçları gösterir. Buna karşılık, aynı <value> işleci olmadan aynı <value> kullanılan arama, <value> içeriği dize özelliklerinin içeriğindeki metin veya dize özelliklerinin değeriyle eşleşen tüm öğeleri döndürür. Operatör adı yalnızca küçük harfler (a-z) içerebilir. Maksimum uzunluk 32 karakterdir.

ObjectPropertyOptions

Nesne özellikleriyle ilgili 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 özellik bir posta adresini temsil ediyorsa altobjectÖzellikleri street, city ve state 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ğerlerinin sıralamalarını ayarlamanıza ve kullanıcıların, sonuçları yalnızca belirli bir değere sahip öğelerle daraltabilmesi için bu dizelerle eşleştirilecek bir operatör adı tanımlamanıza olanak tanıyan numaralandırma özelliklerinin seçenekleri. Örneğin, öncelik bilgilerine sahip bir istek izleme sistemindeki öğeler için p0'u izin verilen bir enum değeri olarak tanımlayabilir ve bu sıralamayı öncelik operatör adına bağlayabilirsiniz. Böylece, arama kullanıcıları, sonuç grubunu 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)

Sıralama özelliği için olası değerlerin listesi. Tüm EnumValueEşlemeler bir dize değeri sağlamalıdır. Bir EnumValuepair için bir tam sayı değeri belirtirseniz mümkün olan tüm EnumValuepairs bir tam sayı değeri sağlamalıdır. Hem dize değeri hem de tam sayı değeri, olası tüm 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 önceden kaydedilen değerler arasına değer eklenmesine olanak tanımak için ilk tam sayı değerlerinde boşluklar bırakın. Maksimum öğe sayısı 100'dür.

orderedRanking

enum (EnumPropertyOptions.OrderedRanking)

Olası EnumValuepairs içinde sağlanan tam sayı değerlerinin, sonuçları sıralamak için nasıl kullanıldığını belirleyen numaralandırmanın sıralı sıralamasını belirtmek için kullanılır. Belirtilirse bu özellik için verilen olası tüm EnumValueEşleme değerleri için tam sayı değerleri sağlanmalıdır. Yalnızca isRepeatable yanlış olduğunda kullanılabilir.

operatorOptions

object (EnumPropertyOptions.EnumOperatorOptions)

Ayarlanırsa, numaralandırmanın bir arama operatörü olarak nasıl kullanılması gerektiğini açıklar.

EnumPropertyOptions.EnumValuePair

Sıralama değer çifti iki şeyi tanımlar: gerekli bir dize değeri ve isteğe bağlı bir tam sayı değeri. Dize değeri, bu öğeyi almak için gereken sorgu terimini tanımlar (örneğin, öncelikli öğe için p0). Tam sayı değeri, dize değerinin aynı özellik için diğer numalandırılmış değerlere göre sıralamasını belirler. Örneğin, p00 ile ilişkilendirebilir ve p1 ve 1 gibi başka bir enum çifti tanımlayabilirsiniz. Belirli bir değerin sıralamasını, aynı özellik adına ilişkin diğer numalandırılmış değerlere göre ayarlamak için tam sayı değerini ordered ranking ile birlikte kullanmanız gerekir. Burada, öncelikli özellikler için DESCENDING sıralaması, p0 değeriyle dizine eklenen öğelerin, p1 değeriyle dizine eklenen öğelere kıyasla bir sıralamada yükselmesini sağlar. Sıralama sıralaması belirtilmemişse tam sayı değerinin öğe sıralaması üzerinde hiçbir etkisi olmaz.

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

string

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

integerValue

integer

EnumValuepair öğesinin negatif olmaması gereken tam sayı değeri. İsteğe bağlı.

EnumPropertyOptions.OrderedRanking

Diğer EnumValueEşleme tam sayı değerlerine göre EnumValuePair tam sayısının sıralama yönünü belirtmek için kullanılır. Bazı özellikler için küçük tam sayı değerleri daha yüksek önem düzeyini gösterirken, diğerlerinde yüksek tam sayı değerleri daha yüksek önem derecesini belirtir.

Sıralamalar
NO_ORDER Mülk için sıralama yoktur. Sonuçlar bu mülkün değerine göre ayarlanmamıştır.
ASCENDING Bu mülk, artan düzende sıralanmıştır. Düşük değerler sıralamanın düşük olduğunu gösterir.
DESCENDING Bu tesis azalan düzende sıralandı. Düşük değerler sıralamanın daha yüksek olduğunu gösterir.

EnumPropertyOptions.EnumOperatorOptions

Enum özellikleri için bir arama operatörü sağlamak üzere kullanılır. Bu isteğe bağlıdır. query.search operatörleri, kullanıcıların sorguyu aranan öğenin türüyle alakalı belirli alanlarla sınırlamasına olanak tanır. Örneğin, p0 ve p1 olası değerlerine sahip öncelik enum özelliği için hiçbir operatör sağlamazsanız p0 terimini içeren bir sorgu, öncelik özelliğinin değeri olarak p0 olan öğeleri ve diğer alanlarda p0 dizesini içeren öğeleri döndürür. Sıralama için öncelik gibi bir operatör adı sağlarsanız arama kullanıcıları sonuçları yalnızca öncelik:p0 sorgusuyla bu özelliğin değeri p0 olan öğelere göre hassaslaştırmak için bu operatörü kullanabilir.

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

string

Enum özelliğini izole etmek için sorguda gereken operatör adını belirtir. Örneğin, operatörünName önceliği 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 durumlarda sonuçları gösterir. Buna karşılık, operatör olmadan aynı <value> operatörünün kullanıldığı bir aramada <value> işlevi, dize özelliklerinin veya metin içindeki metin içinde bulunan metinle eşleşen tüm öğeleri döndürür. Operatör adı yalnızca küçük harfler (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ılması gerektiğini 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 aranmakta olan öğenin türüyle alakalı belirli alanlarla sınırlaması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 şema nesnesinin closeDate adlı bir mülke sahip olduğunu ve bu operatörün, closedon olan bir işlecini belirttiğini varsayalım. Bu verilerle ilgili aramalarda closedon:<value> gibi sorgular, yalnızca closeDate özelliğinin değeri <value> ile eşleştiğinde sonuçları gösterir. Buna karşılık, operatör olmadan aynı <value> kullanan bir arama, <value> değerinin, dizine eklenen veri kaynağının içerik alanındaki herhangi bir Dize özelliklerinin veya metinle eşleştiği tüm öğeleri döndürür. Operatör adı yalnızca küçük harfler (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 gerekli olan operatör adını belirtir. Örneğin, lessThanOperatorName closedbefore ve mülkün adı closeDate ise closedbefore:<value> gibi sorgular yalnızca closeDate adlı özelliğin değeri <value> değerinden önce olduğunda sonuçları gösterir. Operatör adı yalnızca küçük harfler (a-z) içerebilir. Maksimum uzunluk 32 karakterdir.

greaterThanOperatorName

string

Tarih özelliğini büyüktür operatörünü kullanarak ayırmak için sorguda gerekli olan operatör adını belirtir. Örneğin, daha büyükThanOperatorName closedAfter ve mülkün adı closeDate ise closedsonra:<value> gibi sorgular yalnızca closeDate adlı özelliğin değeri <value> değerinden sonra olduğunda sonuçları gösterir. Operatör adı yalnızca küçük harfler (a-z) içerebilir. Maksimum uzunluk 32 karakterdir.

TextPropertyOptions

Metin özelliklerine ilişkin seçenekler.

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

object (RetrievalImportance)

Alma için kullanıldığında alandaki jetonların arama kalitesi önemini belirtir.

operatorOptions

object (TextPropertyOptions.TextOperatorOptions)

Ayarlanırsa mülkün bir 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)

Tesis alma sırasında eşleştiğinde tesise verilen sıralama önemini belirtir. 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ığına karşı bir eşleşme gibi değerlendirin.
HIGH Eşleşmeyi, gövde metninden daha önemli olacak şekilde değerlendirin.
LOW Eşleşmeyi, gövde metninden daha düşük öneme sahip olacak şekilde değerlendirin.
NONE Alma sırasında bu alanla eşleştirme. Bu mülk; operatör eşleştirme, özellik belirleme ve istenirse öneride bulunmaya devam edebilir.

TextPropertyOptions.TextOperatorOptions

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

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

string

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

exactMatchWithOperator

boolean

Doğru ise metin değeri, operatör aramalarında ve özellik eşleşmelerinde tek bir atom değeri olarak tokenlere ayrılır. Örneğin, operatör adı "genre" (tür) ve değeri "bilim-kurgu" ise "genre:science" ve "genre:özellikler" sorgu kısıtlamaları öğeyle eşleşmez; "tür:bilim-kurgu" ile eşleşmez. Metin değeri eşleştirmesi büyük/küçük harfe duyarlıdır ve özel karakterleri kaldırmaz. False (yanlış) değerine ayarlanırsa metin jetonlara ayrılır. Örneğin, değer "bilim-kurgu" ise "genre:science" ve "genre:benzeyen" sorguları öğeyle eşleşir.

HtmlPropertyOptions

HTML özellikleri için seçenekler.

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

object (RetrievalImportance)

Alma için kullanıldığında alandaki jetonların arama kalitesi önemini belirtir. Yalnızca VARSAYILAN veya YOK olarak ayarlanabilir.

operatorOptions

object (HtmlPropertyOptions.HtmlOperatorOptions)

Ayarlanırsa mülkün bir 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 üzere kullanılır. Bu isteğe bağlıdır. query.search operatörleri, kullanıcıların sorguyu aranan öğenin türüyle alakalı belirli alanlarla sınırlamasına olanak tanır.

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

string

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

PropertyDisplayOptions

Bir mülke ait görüntüleme seçenekleri.

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

string

Mülkün ObjectDisplayOptions içinde gösterileceği belirtilirse kullanılan kullanıcı dostu etiketidir. Sağlanırsa, mülk nesne görüntüleme seçeneklerinin bir parçası olduğunda görüntü etiketi özellik değerlerinin önünde gösterilir. Örneğin, özellik 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 ve bu, arama kullanıcılarına net bağlam sağlar. Bu İSTEĞE BAĞLIDIR; sağlanmamışsa yalnızca özellik değerleri gösterilir. Maksimum uzunluk 64 karakterdir.