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 ç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ı.

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

string

Nesnenin adı ve daha sonra türünü tanımlayan ad. Öğe dizine ekleme isteklerinde objectType alanı bu değere eşit olmalıdır. Örneğin, ad Doküman ise, Doküman türündeki öğelere ilişkin dizine ekleme istekleri objectType değerine eşit olarak Doküman'a ayarlanmalıdır. Her nesne tanımı bir şema içinde benzersiz ş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. En çok 256 karakter kullanılabilir.

options

object (ObjectOptions)

İsteğe bağlı nesneye özel 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 güncellik seçenekleri.

displayOptions

object (ObjectDisplayOptions)

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

suggestionFilteringOperators[]

string

Önerileri filtrelemek için kullanılabilen operatörler. query.suggest API'si için FilterOptions'da yalnızca burada bahsedilen operatörler dikkate alınır. Yalnızca TEXT ve ENUM operatörleri desteklenir.

NOT: "objecttype", "type" ve "mimetype" zaten desteklenmektedir. Bu özellik, şemaya özel operatörleri yapılandırmak içindir.

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

Aynı nesne içinde birden fazla mülkle eşlenen 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 yenilik özelliğinin kullanılacağını belirtir. Daha güncel ve yakın tarihler daha yüksek kalite anlamına gelir. Verilerinize en uygun güncellik seçeneği özelliğini kullanın. Dosya paylaşımı dokümanları için, en son değiştirilme zamanı en alakalı zamandır. Takvim etkinliği verilerinde, etkinliğin gerçekleştiği zaman daha alakalı bir güncellik göstergesidir. Böylece, arama sorgusunun yapıldığı zamana daha yakın olan takvim etkinlikleri daha yüksek kaliteli olarak değerlendirilir ve buna göre sıralanır.

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

string

Bu özellik, dizindeki nesnenin yenilik düzeyini gösterir. Ayarlanırsa bu mülk, property definitions içinde üst düzey bir mülk olmalı ve timestamp type ya da date type olmalıdır. Aksi takdirde, Dizine Ekleme API'si güncellik göstergesi olarak updateTime değerini kullanır. En çok 256 karakter kullanılabilir.

Güncelliği hesaplamak için bir mülk kullanıldığında, değer varsayılan olarak geçerli zamandan 2 yıl sonraki bir tarihe ayarlanır.

freshnessDuration

string (Duration format)

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

En fazla dokuz kesir basamağı olan ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".

ObjectDisplayOptions

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; sağlanmazsa arama sonuçlarının bağlam satırında bir nesne etiketi görüntülenmez. En çok 64 karakter kullanılabilir.

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ğere sahipse tüm değerler sonraki mülklerden önce gösterilir. Bu nedenle, bu listede tekrarlanan özelliklerden önce tekil özelliklerin belirtilmesi iyi bir uygulamadır. isReturnable tüm özellikler doğru olarak ayarlanmalıdır. Maksimum meta satır sayısı 3'tür.

ObjectDisplayOptions.Metaline

Metaline, bağlam 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

Arama sonuçlarında görüntülenmesi gereken, nesnenin içindeki üst düzey bir mülke referans. Seçilen özelliklerin değerleri, belirtilmişse söz konusu özelliğin display label ile birlikte arama sonuçlarında görüntülenir. 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ımlandığı şekliyle üst düzey mülkün adı. Ad, şemada tanımlı bir özellik değilse şema güncellenmeye çalışılırken bir hata 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

Tesisin adı. Dizine Ekleme API'sine gönderilen öğe dizine ekleme isteklerinde property name bu değere eşit olmalıdır. Örneğin, ad subject_line ise konu alanlarına sahip doküman öğeleriyle ilgili dizine ekleme isteklerinde name ayarı subject_line değerine eşit olmalıdır. Adı, nesne özelliğinin tanımlayıcısı olarak kullanın. Bir nesnenin özelliği olarak kaydettirildikten sonra, bu adı o nesnenin içindeki 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. En çok 256 karakter kullanılabilir.

isReturnable

boolean

Mülkün, Query API aracılığıyla arama sonuçlarında döndürülmesi gereken verileri tanımladığını belirtir. true olarak ayarlanırsa Sorgu API kullanıcılarının sonuçlarda eşleşen özellik alanlarını kullanabileceğini belirtir. Bununla birlikte, alanların depolanması daha fazla alan tahsisi gerektirir ve arama sorguları için daha fazla bant genişliği kullanır. Bu da büyük veri kümelerinde performansı etkiler. Burada yalnızca arama sonuçları için alan gerekliyse true değerine 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 belirtir. Örneğin, bir dokümanda yalnızca bir açıklama bulunur, ancak birden fazla yorum olabilir. Türü boole olan mülkler için doğru olamaz. Politika, yanlış değerine ayarlanırsa birden fazla değer içeren özellikler, söz konusu öğeye yönelik dizine ekleme isteğinin reddedilmesine neden olur.

isSortable

boolean

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

isFacetable

boolean

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

isSuggestable

boolean

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

isWildcardSearchable

boolean

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

displayOptions

object (PropertyDisplayOptions)

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

Birleştirme alanı property_options. Mülkün nasıl dizine eklendiğini ve kullanıldığını belirleyen türe özel seçenekler. Seçeneklerin bir tür için varsayılan seçenekler olması gerektiği durumda 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ı özelliklerine ilişkin 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 için kullanılır. Yalnızca isRepeatable yanlış değerine ayarlanırsa kullanılabilir.

minimumValue

string (Int64Value format)

Mülkün minimum değeri. Tesisin minimum ve maksimum değerleri, sonuçları ordered ranking uyarınca sıralamak için kullanılır. Minimum değerin altında 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)

Mülkün maksimum değeri. Tesisin minimum ve maksimum değerleri, sonuçları ordered ranking uyarınca 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ıkla 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 tamsayı özelliği için tamsayı özellik seçeneklerini açıklar. Karşılık gelen tamsayı özelliği isFacetable olarak işaretlenmelidir.

IntegerPropertyOptions.OrderedRanking

Bir tam sayı değerinin diğer değerlere göre nasıl sıralanacağını belirtmek için kullanılır. Sıralaması daha yüksek olan tam sayılar, önemin daha yüksek olduğunu gösterir. Örneğin, bazı veri kaynaklarında düşük öncelik daha yüksek önem, bazılarında ise yüksek öncelik daha yüksek önem anlamına gelir.

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

IntegerPropertyOptions.IntegerOperatorOptions

Tam sayı ö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 sınırlamasına olanak tanır.

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

string

Tamsayı özelliğini izole etmek için sorguda gereken operatör adını belirtir. Örneğin, operatörAdı öncelik ise ve özelliğin adı öncelikVal ise öncelik:<değer> gibi sorgular, yalnızca öncelikliVal adlı özelliğin değerinin <değer> ile eşleştiği sonuçları gösterir. Buna karşılık, bir operatör olmadan aynı &lt;value&gt; değerini kullanan bir arama, &lt;value&gt; değerinin, öğenin içerik alanındaki herhangi bir Dize özelliklerinin değeriyle veya metinle eşleştiği tüm öğeleri döndürür. Operatör adı yalnızca küçük harf (a-z) içerebilir. En çok 32 karakter kullanılabilir.

lessThanOperatorName

string

Küçüktür operatörünü kullanarak tam sayı özelliğini izole etmek için sorguda gereken operatör adını belirtir. Örneğin, daha azThanOperatorName PriorityAşağıda geçerliyse ve mülkün adı öncelikVal ise, Priority below:<value> gibi sorgularda yalnızca PriorityVal adlı özelliğin değeri <value> değerinden küçük olan sonuçlar gösterilir. Operatör adı yalnızca küçük harf (a-z) içerebilir. En çok 32 karakter kullanılabilir.

greaterThanOperatorName

string

Tam sayı özelliğini büyüktür operatörü kullanarak ayırmak için sorguda gereken operatör adını belirtir. Örneğin, moreThanOperatorName Priorityabove (öncelikli öncelik) ve mülkün adı gerektiriyorVal ise, Priority above:<value> gibi sorgular yalnızca öncelikliVal adlı özelliğin değerinin <değer> değerinden büyük olduğu sonuçları gösterir. Operatör adı yalnızca küçük harf (a-z) içerebilir. En çok 32 karakter kullanılabilir.

DoublePropertyOptions

Çift tesisle ilgili seçenekler.

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

object (DoublePropertyOptions.DoubleOperatorOptions)

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

DoublePropertyOptions.DoubleOperatorOptions

Çift özelliklere ilişkin bir arama operatörü sağlamak için 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 sınırlamasına olanak tanır.

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

string

Sıralamada veya façeta olarak ikili özelliğinin kullanılması için sorguda gereken operatör adını belirtir. Operatör adı yalnızca küçük harf (a-z) içerebilir. En çok 32 karakter kullanılabilir.

TimestampPropertyOptions

Zaman damgası özellikleriyle ilgili 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 öğe 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ğinin izole edilmesi için sorguda gereken operatör adını belirtir. Örneğin, providerName closedon ise ve özelliğin adı closeDate ise closedon:<value> gibi sorgular yalnızca closeDate adlı özelliğin değerinin <value> ile eşleştiği sonuçları gösterir. Buna karşılık, bir operatör olmadan aynı &lt;value&gt; değerini kullanan bir arama, &lt;value&gt; değerinin, öğenin içerik alanındaki herhangi bir Dize özelliklerinin değeriyle veya metinle eşleştiği tüm öğeleri döndürür. Operatör adı yalnızca küçük harf (a-z) içerebilir. En çok 32 karakter kullanılabilir.

lessThanOperatorName

string

Küçüktür operatörünü kullanarak zaman damgası özelliğini izole etmek için sorguda gereken operatör adını belirtir. Örneğin, azThanOperatorName closedbefore değeriyse ve özelliğin adı closeDate ise closedbefore:<value> gibi sorgular yalnızca closeDate adlı özelliğin değerinin <value> değerinden önce olduğu sonuçları) gösterir. Operatör adı yalnızca küçük harf (a-z) içerebilir. En çok 32 karakter kullanılabilir.

greaterThanOperatorName

string

Zaman damgası özelliğini büyüktür operatörü kullanarak ayırmak için sorguda gereken operatör adını belirtir. Örneğin, moreThanOperatorName closedafter ise ve özelliğin adı closeDate ise, closedafter:<value> gibi sorgular yalnızca, closeDate adlı özelliğin değerinin <value> değerinden sonra olduğu sonuçları gösterir. Operatör adı yalnızca küçük harf (a-z) içerebilir. En çok 32 karakter kullanılabilir.

BooleanPropertyOptions

Boole özellikleriyle ilgili seçenekler.

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

object (BooleanPropertyOptions.BooleanOperatorOptions)

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

BooleanPropertyOptions.BooleanOperatorOptions

Boole ö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 sınırlamasına olanak tanır.

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

string

Boole özelliğinin izole edilmesi için sorguda gereken operatör adını belirtir. Örneğin, providerName closed ise ve özelliğin adı isClosed ise closed:<value> gibi sorgular, yalnızca isClosed adlı özelliğin değerinin <value> ile eşleştiği sonuçları gösterir. Buna karşılık, bir operatör olmadan aynı &lt;value&gt; değerini kullanan bir arama, &lt;value&gt; değerinin, öğenin içerik alanındaki herhangi bir Dize özelliklerinin değeriyle veya metinle eşleştiği tüm öğeleri döndürür. Operatör adı yalnızca küçük harf (a-z) içerebilir. En çok 32 karakter kullanılabilir.

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 altobjectProperties, street, city ve state olarak adlandırılabilir. Maksimum öğe sayısı 1.000'dir.

EnumPropertyOptions

Kullanıcı sorgularıyla eşleşecek kısıtlanmış bir dize grubu tanımlamanıza, bu dize değerleri için sıralamalar 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 enum özellikleri seçenekleri. Örneğin, öncelik bilgisi içeren bir istek izleme sistemindeki öğeler için p0'ı izin verilen bir enum değeri olarak tanımlayabilir ve bu enum'u ö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)

Numaralandırma özelliğine ilişkin olası değerlerin listesi. Tüm EnumValuePairs bir dize değeri sağlamalıdır. Bir EnumValuePair için tam sayı değeri belirtirseniz olası 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 açısından benzersiz olmalıdır. Olası değerler, ayarlandıktan sonra kaldırılamaz veya değiştirilemez. Sıralı bir sıralama sağlıyor ve gelecekte başka numaralandırma değerleri ekleyebileceğinizi düşünüyorsanız önceden kaydedilen değerlerin arasına bir değer eklenmesi 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 içinde sağlanan tam sayı değerlerinin, sonuçları sıralamak için nasıl kullanılacağını belirleyen numaralandırmanın sıralı sıralamasını belirtmek için kullanılır. Belirtilirse bu mülk için verilen tüm olası EnumValuePair değerleri için tam sayı değerleri sağlanmalıdır. Yalnızca isRepeatable yanlış değerine ayarlanırsa kullanılabilir.

operatorOptions

object (EnumPropertyOptions.EnumOperatorOptions)

Ayarlanırsa enum'un bir arama operatörü olarak nasıl kullanılması gerektiğini açıklar.

EnumPropertyOptions.EnumValuePair

Numaralandırma değeri çifti, zorunlu dize değeri ve isteğe bağlı tam sayı değeri olmak üzere iki şeyi tanımlar. Dize değeri, bu öğeyi almak için gereken gerekli sorgu terimini tanımlar (ör. bir öncelik öğesi için p0). Tam sayı değeri, söz konusu dize değerinin aynı mülk için diğer numaralanmış değerlere göre sıralamasını belirler. Örneğin, p0 değerini 0 ile ilişkilendirebilir ve p1 ile 1 gibi başka bir numaralandırma çifti tanımlayabilirsiniz. Belirli bir değerin sıralamasını aynı mülk adı için diğer numaralanmış değerlere göre ayarlamak için tam sayı değerini ordered ranking ile birlikte kullanmanız gerekir. Burada, öncelikli mülkler için DESCENDING değerine göre sıralama yapıldığında, p1 değeriyle dizine eklenen öğelere kıyasla p0 değeriyle dizine eklenen öğelerin sıralamasında yükselme artar. Belirtilen bir sıralama sırası olmadan, tam sayı değerinin öğe sıralaması üzerinde hiçbir etkisi olmaz.

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

string

EnumValuePair'in dize değeri. En çok 32 karakter kullanılabilir.

integerValue

integer

EnumValuePair için negatif olmayan tam sayı değeri. İsteğe bağlı.

EnumPropertyOptions.OrderedRanking

Diğer EnumValuePair 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 tamsayı değerleri daha yüksek önem, diğerlerinde ise yüksek tamsayılar daha yüksek önem teşkil eder.

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

EnumPropertyOptions.EnumOperatorOptions

Sıralama ö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 sınırlamasına olanak tanır. Örneğin, p0 ve p1 olası değerlerine sahip bir öncelik sıralama mülkü için operatör sağlamazsanız p0 terimini içeren bir sorgu, öncelik özelliğinin değeri olarak p0'a sahip 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 sonuçları bu özelliğin değeri p0 olan öğelere göre hassaslaştırmak için 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örAdı öncelik ise ve özelliğin adı öncelikVal ise öncelik:<değer> gibi sorgular, yalnızca öncelikliVal adlı özelliğin değerinin <değer> ile eşleştiği sonuçları gösterir. Buna karşılık, bir operatör olmadan aynı &lt;value&gt; değerini kullanan bir arama, &lt;value&gt; değerinin, öğenin içerik alanındaki herhangi bir Dize özelliklerinin değeriyle veya metinle eşleştiği tüm öğeleri döndürür. Operatör adı yalnızca küçük harf (a-z) içerebilir. En çok 32 karakter kullanılabilir.

DatePropertyOptions

Tarih özellikleriyle ilgili seçenekler.

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

object (DatePropertyOptions.DateOperatorOptions)

Ayarlanırsa, tarihin bir 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 aranan öğe 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 şeması nesnesinin, closedon operatörüne sahip bir operatörü belirten closeDate adlı bir özelliğe sahip olduğunu varsayalım. Bu verilerle ilgili aramalar için closedon:&lt;value&gt; gibi sorgular yalnızca closedon:&lt;value&gt; özelliğinin değerinin closedon:&lt;value&gt; ile eşleştiği sonuçları gösterir. Buna karşılık, aynı &lt;value&gt; öğesini bir operatör olmadan kullanan bir arama, &lt;value&gt; değerinin dizine eklenen veri kaynağının içerik alanındaki herhangi bir Dize özelliğinin değeriyle veya metinle eşleştiği tüm öğeleri döndürür. Operatör adı yalnızca küçük harf (a-z) içerebilir. En çok 32 karakter kullanılabilir.

lessThanOperatorName

string

Küçüktür operatörünü kullanarak tarih özelliğini ayırmak için sorguda gereken operatör adını belirtir. Örneğin, azThanOperatorName closedbefore değeriyse ve özelliğin adı closeDate ise closedbefore:<value> gibi sorgular yalnızca closeDate adlı özelliğin değerinin <value> değerinden önce olduğu sonuçları) gösterir. Operatör adı yalnızca küçük harf (a-z) içerebilir. En çok 32 karakter kullanılabilir.

greaterThanOperatorName

string

Tarih özelliğini büyüktür operatörünü kullanarak ayırmak için sorguda gereken operatör adını belirtir. Örneğin, moreThanOperatorName closedafter ise ve özelliğin adı closeDate ise, closedafter:<value> gibi sorgular yalnızca, closeDate adlı özelliğin değerinin <value> değerinden sonra olduğu sonuçları gösterir. Operatör adı yalnızca küçük harf (a-z) içerebilir. En çok 32 karakter kullanılabilir.

TextPropertyOptions

Metin özellikleriyle ilgili 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 için önemini gösterir.

operatorOptions

object (TextPropertyOptions.TextOperatorOptions)

Ayarlanırsa, özelliğin 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)

Alma sırasında eşleştirildiğinde mülke verilen sıralamanın önemini gösterir. Bir özelliğin jeton önem düzeyi 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ştirme gibi değerlendirin.
HIGH Eşleşmeyi, gövde metninden daha yüksek öneme sahip olacak şekilde değerlendirin.
LOW Eşleşmeyi, gövde metninden daha düşük önem düzeyinde değerlendirin.
NONE Alma sırasında bu alanla eşleştirmeyin. Bu mülk; operatör eşleştirme, özellik belirleme 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 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, providerName subject ise ve özelliğin adı subjectLine ise subject:<value> gibi sorgular, yalnızca subjectLine adlı özelliğin değerinin <value> ile eşleştiği sonuçları gösterir. Buna karşılık, bir operatör olmadan aynı &lt;value&gt; değerinin kullanıldığı bir arama, &lt;value&gt; değerinin öğenin içerik alanındaki herhangi bir metin özelliğinin veya metinle eşleştiği tüm öğeleri döndürür. Operatör adı yalnızca küçük harf (a-z) içerebilir. En çok 32 karakter kullanılabilir.

exactMatchWithOperator

boolean

True (doğru) ise metin değeri, operatör aramalarında ve özellik eşleşmelerinde tek bir atom değeri olarak belirtilir. Örneğin, operatör adı "tür" ise değeri ise "bilim kurgu"dur. "Tür:Bilim" sorgu kısıtlamaları ve "Tür:kurgu" öğe ile eşleşmemesi; "tür:bilim-kurgu" yapıyor. Metin değeri eşleşmesi büyük/küçük harfe duyarlıdır ve özel karakterleri kaldırmaz. Yanlış ise metin token atanmıştır. Örneğin, değer "bilim kurgu" ise "Tür:Bilim" sorguları ve "Tür:kurgu" öğe ile eşleşir.

HtmlPropertyOptions

HTML özellikleriyle ilgili 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 için önemini gösterir. Yalnızca DEFAULT veya NONE olarak ayarlanabilir.

operatorOptions

object (HtmlPropertyOptions.HtmlOperatorOptions)

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

HtmlPropertyOptions.HtmlOperatorOptions

HTML ö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 sınırlamasına olanak tanır.

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

string

HTML özelliğini izole etmek için sorguda gereken operatör adını belirtir. Örneğin, providerName subject ise ve özelliğin adı subjectLine ise subject:<value> gibi sorgular, yalnızca subjectLine adlı özelliğin değerinin <value> ile eşleştiği sonuçları gösterir. Buna karşılık, aynı &lt;value&gt; değişkenini bir operatör olmadan kullanan bir arama, &lt;value&gt; öğesinin, öğenin içerik alanındaki herhangi bir html özelliğinin veya metinle eşleştiği tüm öğeleri döndürür. Operatör adı yalnızca küçük harf (a-z) içerebilir. En çok 32 karakter kullanılabilir.

PropertyDisplayOptions

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

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

string

Özellik, ObjectDisplayOptions içinde görüntülenecek şekilde belirtilirse kullanılan özelliğin kullanıcı dostu etiketi. Görüntü etiketi sağlanmışsa özellik, nesne görüntüleme seçeneklerinin bir parçası olduğunda özellik değerlerinin önünde gösterilir. Örneğin, özellik değeri "1" ise bu değer tek başına kullanıcı için yararlı bir bağlam olmayabilir. Verilen görünen ad "öncelik" ise kullanıcı "öncelik : 1" değerini görür. Bunlar arama kullanıcılarına açık bağlam sağlayan bilgilerdir. Bu, İSTEĞE BAĞLI; sağlanmazsa yalnızca özellik değerleri gösterilir. En çok 64 karakter kullanılabilir.