- JSON gösterimi
- ObjectDefinition
- ObjectOptions
- ObjectOptions.FreshnessOptions
- ObjectDisplayOptions
- ObjectDisplayOptions.Metaline
- ObjectDisplayOptions.DisplayedProperty
- PropertyDefinition
- IntegerPropertyOptions
- IntegerPropertyOptions.OrderedRanking
- IntegerPropertyOptions.IntegerOperatorOptions
- DoublePropertyOptions
- DoublePropertyOptions.DoubleOperatorOptions
- TimestampPropertyOptions
- TimestampPropertyOptions.TimestampOperatorOptions
- BooleanPropertyOptions
- BooleanPropertyOptions.BooleanOperatorOptions
- ObjectPropertyOptions
- EnumPropertyOptions
- EnumPropertyOptions.EnumValuePair
- EnumPropertyOptions.OrderedRanking
- EnumPropertyOptions.EnumOperatorOptions
- DatePropertyOptions
- DatePropertyOptions.DateOperatorOptions
- TextPropertyOptions
- RetrievalImportance
- RetrievalImportance.Importance
- TextPropertyOptions.TextOperatorOptions
- HtmlPropertyOptions
- HtmlPropertyOptions.HtmlOperatorOptions
- PropertyDisplayOptions
Bir veri kaynağının şema tanımıdır.
JSON gösterimi |
---|
{
"objectDefinitions": [
{
object ( |
Alanlar | |
---|---|
objectDefinitions[] |
Veri kaynağı için üst düzey nesnelerin listesi. Maksimum öğe sayısı 10'dur. |
operationIds[] |
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 ( |
Alanlar | |
---|---|
name |
Nesnenin adı ve daha sonra türünü tanımlayan ad. Öğe dizine ekleme isteklerinde |
options |
İsteğe bağlı nesneye özel seçenekler. |
propertyDefinitions[] |
Nesnenin özellik tanımları. Maksimum öğe sayısı 1.000'dir. |
ObjectOptions
Bir nesneyle ilgili seçenekler.
JSON gösterimi |
---|
{ "freshnessOptions": { object ( |
Alanlar | |
---|---|
freshnessOptions |
Bir nesnenin güncellik seçenekleri. |
displayOptions |
Nesnenin Cloud Search sonuç sayfasında nasıl görüntüleneceğini belirleyen seçenekler. |
suggestionFilteringOperators[] |
Önerileri filtrelemek için kullanılabilen operatörler. 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 |
Bu özellik, dizindeki nesnenin yenilik düzeyini gösterir. Ayarlanırsa bu mülk, 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 |
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 " |
ObjectDisplayOptions
Nesnenin görüntüleme seçenekleri.
JSON gösterimi |
---|
{
"objectDisplayLabel": string,
"metalines": [
{
object ( |
Alanlar | |
---|---|
objectDisplayLabel |
Öğ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[] |
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. |
ObjectDisplayOptions.Metaline
Metaline, bağlam sağlamak için arama sonucuyla birlikte görüntülenen özelliklerin listesidir.
JSON gösterimi |
---|
{
"properties": [
{
object ( |
Alanlar | |
---|---|
properties[] |
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 |
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 ( |
Alanlar | |
---|---|
name |
Tesisin adı. Dizine Ekleme API'sine gönderilen öğe dizine ekleme isteklerinde |
isReturnable |
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 |
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 |
Ö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 |
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 |
Mülkün sorgu önerileri oluşturmak için kullanılabileceğini gösterir. |
isWildcardSearchable |
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 |
Nesnenin |
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 |
|
doublePropertyOptions |
|
timestampPropertyOptions |
|
booleanPropertyOptions |
|
objectPropertyOptions |
|
enumPropertyOptions |
|
datePropertyOptions |
|
textPropertyOptions |
|
htmlPropertyOptions |
|
IntegerPropertyOptions
Tam sayı özelliklerine ilişkin seçenekler.
JSON gösterimi |
---|
{ "orderedRanking": enum ( |
Alanlar | |
---|---|
orderedRanking |
Tam sayı için sıralı sıralamayı belirtmek için kullanılır. Yalnızca |
minimumValue |
Mülkün minimum değeri. Tesisin minimum ve maksimum değerleri, sonuçları |
maximumValue |
Mülkün maksimum değeri. Tesisin minimum ve maksimum değerleri, sonuçları |
operatorOptions |
Ayarlanırsa tam sayının bir arama operatörü olarak nasıl kullanılması gerektiğini açıklar. |
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 |
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ı <value> değerini kullanan bir arama, <value> 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 |
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 |
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 ( |
Alanlar | |
---|---|
operatorOptions |
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 |
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 ( |
Alanlar | |
---|---|
operatorOptions |
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 |
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ı <value> değerini kullanan bir arama, <value> 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 |
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 |
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 ( |
Alanlar | |
---|---|
operatorOptions |
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 |
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ı <value> değerini kullanan bir arama, <value> 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 ( |
Alanlar | |
---|---|
subobjectProperties[] |
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 ( |
Alanlar | |
---|---|
possibleValues[] |
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 |
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 |
operatorOptions |
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 |
EnumValuePair'in dize değeri. En çok 32 karakter kullanılabilir. |
integerValue |
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 |
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ı <value> değerini kullanan bir arama, <value> 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 ( |
Alanlar | |
---|---|
operatorOptions |
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 |
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:<value> gibi sorgular yalnızca closedon:<value> özelliğinin değerinin closedon:<value> ile eşleştiği sonuçları gösterir. Buna karşılık, aynı <value> öğesini bir operatör olmadan kullanan bir arama, <value> 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 |
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 |
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 ( |
Alanlar | |
---|---|
retrievalImportance |
Alma için kullanıldığında alandaki jetonların arama kalitesi için önemini gösterir. |
operatorOptions |
Ayarlanırsa, özelliğin bir arama operatörü olarak nasıl kullanılması gerektiğini açıklar. |
RetrievalImportance
JSON gösterimi |
---|
{
"importance": enum ( |
Alanlar | |
---|---|
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 |
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ı <value> değerinin kullanıldığı bir arama, <value> 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 |
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 ( |
Alanlar | |
---|---|
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 |
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 |
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ı <value> değişkenini bir operatör olmadan kullanan bir arama, <value> öğ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 |
Ö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. |