Schema

Definicja schematu źródła danych.

Zapis JSON 
{
  "objectDefinitions": [
    {
      object (ObjectDefinition)
    }
  ],
  "operationIds": [
    string
  ]
}
Pola
objectDefinitions[]

object (ObjectDefinition)

Lista obiektów najwyższego poziomu w źródle danych. Maksymalna liczba elementów to 10.
operationIds[]

string

Identyfikatory długotrwałych operacji (LROs) obecnie wykonywanych w ramach tego schematu. Po zmodyfikowaniu schematu poczekaj na zakończenie operacji, zanim zaczniesz indeksować dodatkowe treści.

ObjectDefinition

Definicja obiektu w źródle danych.

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

string

Nazwa obiektu, która określa jego typ. W żądaniach indeksowania elementów należy ustawić pole objectType na tę wartość. Jeśli na przykład name to Document, to żądania indeksowania elementów typu Document powinny ustawiać objectType na Document. Każda definicja obiektu musi mieć unikalną nazwę w schemacie. Nazwa musi zaczynać się od litery i może zawierać tylko litery (A–Z, a–z) lub cyfry (0–9). Maksymalna długość to 256 znaków.
options

object (ObjectOptions)

Opcjonalne opcje dotyczące obiektu.
propertyDefinitions[]

object (PropertyDefinition)

Definicje właściwości obiektu. Maksymalna liczba elementów to 1000.

ObjectOptions

Opcje obiektu.

Zapis JSON 
{
  "freshnessOptions": {
    object (ObjectOptions.FreshnessOptions)
  },
  "displayOptions": {
    object (ObjectDisplayOptions)
  },
  "suggestionFilteringOperators": [
    string
  ]
}
Pola
freshnessOptions

object (ObjectOptions.FreshnessOptions)

Opcje dotyczące świeżości obiektu.
displayOptions

object (ObjectDisplayOptions)

Opcje określające sposób wyświetlania obiektu na stronie wyników Cloud Search.
suggestionFilteringOperators[]

string

Operatory, których można używać do filtrowania sugestii. W przypadku interfejsu API query.suggest tylko operatorzy wymienieni tutaj będą obsługiwani w interfejsie FilterOptions. Obsługiwane są tylko operatory TEXT i ENUM.

UWAGA: parametry „objecttype”, „type” i „mimetype” są już obsługiwane. Ta właściwość służy do konfigurowania operatorów specyficznych dla schematu.

Mimo że jest to tablica, można podać tylko 1 operatora. Jest to tablica na potrzeby przyszłej rozszerzalności.

Operatory mapujące na wiele właściwości w tym samym obiekcie nie są obsługiwane. Jeśli operator obejmuje różne typy obiektów, tę opcję należy ustawić raz dla każdej definicji obiektu.

ObjectOptions.FreshnessOptions

Wskazuje, której właściwości dotyczącej świeżości użyć podczas dostosowywania rankingu wyszukiwania produktu. Im nowsze daty, tym wyższa jakość. Użyj właściwości opcji świeżości, która najlepiej pasuje do Twoich danych. W przypadku dokumentów udostępnianych w sieci najbardziej istotny jest czas ostatniej modyfikacji. W przypadku danych o wydarzeniu w kalendarzu bardziej odpowiednim wskaźnikiem aktualności jest czas wystąpienia zdarzenia. Dzięki temu wydarzenia w kalendarzu, które mają miejsce bliżej czasu zapytania, są uznawane za wyższej jakości i odpowiednio klasyfikowane.

Zapis JSON 
{
  "freshnessProperty": string,
  "freshnessDuration": string
}
Pola
freshnessProperty

string

Ta właściwość wskazuje poziom aktualności obiektu w indeksie. Jeśli jest ustawiona, musi być właściwością najwyższego poziomu w usługi property definitions i musi być typu timestamp type lub date type. W przeciwnym razie interfejs Indexing API używa wartości updateTime jako wskaźnika aktualności. Maksymalna długość to 256 znaków.

Gdy do obliczenia świeżości używana jest usługa, domyślnie przyjmuje się wartość 2 lata od bieżącej daty.
freshnessDuration

string (Duration format)

Czas, po którym obiekt powinien być uznany za nieaktualny. Wartość domyślna to 180 dni (w sekundach).

Czas w sekundach z maksymalnie 9 miejscami po przecinku, zakończony literą „s”. Przykład: "3.5s".

ObjectDisplayOptions

Opcje wyświetlania obiektu.

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

string

Przyjazna dla użytkownika etykieta wyświetlana w wynikach wyszukiwania, która wskazuje typ produktu. To pole jest OPCJONALNE. Jeśli nie zostanie podane, etykieta obiektu nie będzie wyświetlana w wierszu kontekstowym wyników wyszukiwania. Maksymalna długość to 64 znaki.
metalines[]

object (ObjectDisplayOptions.Metaline)

Określa właściwości wyświetlane w metaliniach wyników wyszukiwania. Wartości właściwości są wyświetlane w kolejności podanej tutaj. Jeśli dana właściwość zawiera wiele wartości, wszystkie wartości są wyświetlane przed kolejnymi właściwościami. Z tego powodu na liście warto określać właściwości pojedyncze przed właściwościami powtarzającymi się. Wszystkie właściwości muszą mieć wartość Prawda.isReturnable Maksymalna liczba metalinii to 3.

ObjectDisplayOptions.Metaline

Metalinia to lista właściwości wyświetlanych wraz z wynikiem wyszukiwania w celu zapewnienia kontekstu.

Zapis JSON 
{
  "properties": [
    {
      object (ObjectDisplayOptions.DisplayedProperty)
    }
  ]
}
Pola
properties[]

object (ObjectDisplayOptions.DisplayedProperty)

Lista wyświetlanych właściwości metalinii. Maksymalna liczba usług to 5.

ObjectDisplayOptions.DisplayedProperty

Odwołuje się do właściwości najwyższego poziomu w obiekcie, która powinna być wyświetlana w wynikach wyszukiwania. Wartości wybranych właściwości są wyświetlane w wynikach wyszukiwania wraz z wartością display label tej właściwości, jeśli została określona. Jeśli nie podasz etykiety wyświetlania, będą widoczne tylko wartości.

Zapis JSON 
{
  "propertyName": string
}
Pola
propertyName

string

Nazwa właściwości najwyższego poziomu zdefiniowana w definicji właściwości obiektu. Jeśli nazwa nie jest zdefiniowaną właściwością w schemacie, podczas próby zaktualizowania schematu pojawi się błąd.

PropertyDefinition

Definicja właściwości w obiekcie.

Zapis JSON 
{
  "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.
}
Pola
name

string

Nazwa nieruchomości. Żądania indeksowania produktów wysyłane do interfejsu Indexing API powinny mieć parametr property name ustawiony na tę wartość. Jeśli na przykład nazwa to subject_line, żądania indeksowania elementów dokumentu z polami tematu powinny ustawiać wartość name dla tego pola na subject_line. Użyj nazwy jako identyfikatora właściwości obiektu. Gdy nazwa zostanie zarejestrowana jako właściwość obiektu, nie możesz jej ponownie użyć w przypadku innej właściwości tego obiektu. Nazwa musi zaczynać się od litery i może zawierać tylko litery (A–Z, a–z) lub cyfry (0–9). Maksymalna długość to 256 znaków.
isReturnable

boolean

Wskazuje, że usługa identyfikuje dane, które powinny być zwracane w wynikach wyszukiwania za pomocą interfejsu Query API. Jeśli ta opcja ma wartość true, oznacza to, że użytkownicy interfejsu Query API mogą używać w wynikach pól właściwości dopasowujących. Jednak przechowywanie pól wymaga przydzielenia większej ilości miejsca i używania większej przepustowości na potrzeby zapytań, co wpływa na wydajność w przypadku dużych zbiorów danych. Ustaw jako true tylko wtedy, gdy pole jest potrzebne do wyników wyszukiwania. Nie można ustawić tej wartości na „PRAWDA” w przypadku właściwości, których typ to obiekt.
isRepeatable

boolean

Wskazuje, że w przypadku tej właściwości dozwolone są liczne wartości. Na przykład dokument ma tylko jeden opis, ale może mieć wiele komentarzy. Nie można ustawić tej wartości na „PRAWDA” w przypadku właściwości, których typ to „logiczna”. Jeśli ta opcja jest ustawiona na wartość false, właściwości zawierające więcej niż jedną wartość powodują odrzucenie żądania indeksowania tego elementu.
isSortable

boolean

Wskazuje, że właściwość może być używana do sortowania. Nie może być ustawiona na wartość Prawda w przypadku właściwości, które można powtarzać. Nie może być ustawiona na wartość Prawda w przypadku właściwości, których typ to obiekt. Aby ustawić tę opcję, musisz ustawić parametr IsReturnable na wartość true (prawda). Obsługiwane są tylko właściwości typu logicznego, daty, podwójnej precyzji, liczby całkowitej i sygnatury czasowej.
isFacetable

boolean

Wskazuje, że właściwość może być używana do generowania aspektów. Nie może być ustawiona na wartość Prawda w przypadku właściwości, których typ to obiekt. Aby ustawić tę opcję, musisz ustawić parametr IsReturnable na wartość true (prawda). Obsługiwane są tylko właściwości typu logicznego, wyliczeniowego, całkowitego i tekstowego.
isSuggestable

boolean

Wskazuje, że właściwości można używać do generowania sugestii zapytań.
isWildcardSearchable

boolean

Wskazuje, że użytkownicy mogą wyszukiwać w tej usłudze za pomocą symboli wieloznakowych. Obsługiwane tylko w przypadku właściwości tekstowych. Aby ustawić tę opcję, musisz ustawić parametr IsReturnable na wartość true (prawda). W danej usłudze źródłowej można oznaczyć jako „isWildcardSearchable” maksymalnie 5 usług. Więcej informacji znajdziesz w artykule Definiowanie właściwości obiektów.
displayOptions

object (PropertyDisplayOptions)

Opcje określające sposób wyświetlania usługi na stronie wyników wyszukiwania w usłudze Cloud Search, jeśli jest ona wyświetlana w display options obiektu.
Pole unii property_options. Opcje związane z typem, które określają sposób indeksowania i używania usługi. W przypadku, gdy opcje powinny być opcjami domyślnymi dla danego typu, to pole musi być ustawione na jeden z tych typów. Jeśli to pole nie jest ustawione, aktualizacje schematu są odrzucane. property_options może być tylko jednym z tych elementów:
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

Opcje właściwości liczb całkowitych.

Zapis JSON 
{
  "orderedRanking": enum (IntegerPropertyOptions.OrderedRanking),
  "minimumValue": string,
  "maximumValue": string,
  "operatorOptions": {
    object (IntegerPropertyOptions.IntegerOperatorOptions)
  },
  "integerFacetingOptions": {
    object (IntegerFacetingOptions)
  }
}
Pola
orderedRanking

enum (IntegerPropertyOptions.OrderedRanking)

Służy do określenia uporządkowanej kolejności liczb całkowitych. Można go używać tylko wtedy, gdy wartość isRepeatable jest równa fałsz.
minimumValue

string (Int64Value format)

Minimalna wartość właściwości. Minimalne i maksymalne wartości właściwości służą do porządkowania wyników według atrybutu ordered ranking. Żądania indeksowania z wartościami mniejszymi niż minimalna są akceptowane i umieszczane w rankingu z tą samą wagą co elementy z minimalną wartością.
maximumValue

string (Int64Value format)

Maksymalna wartość właściwości. Minimalne i maksymalne wartości właściwości służą do porządkowania wyników według atrybutu ordered ranking. Żądania indeksowania z wartościami większymi niż maksymalna są akceptowane i umieszczane w rankingu z tą samą wagą co elementy indeksowane z wartością maksymalną.
operatorOptions

object (IntegerPropertyOptions.IntegerOperatorOptions)

Jeśli jest ustawiona, opisuje, jak liczba całkowita powinna być używana jako operator wyszukiwania.
integerFacetingOptions

object (IntegerFacetingOptions)

Jeśli jest ustawiona, opisuje opcje podziału na wymiary liczbowe dla danej właściwości liczbowej. Odpowiednia właściwość liczb całkowitych powinna być oznaczona jako isFacetable.

IntegerPropertyOptions.OrderedRanking

Służy do określenia, jak wartość całkowita powinna być klasyfikowana w stosunku do innych wartości. Im wyższa liczba całkowita, tym większa ważność. Na przykład w niektórych źródłach danych niższy priorytet oznacza większą wagę, a w innych – odwrotnie.

Wartości w polu enum
NO_ORDER Brak kolejności wyświetlania obiektu. Wyniki nie są dostosowywane do wartości tej właściwości.
ASCENDING Ta usługa jest uszeregowana w kolejności rosnącej. Im niższa wartość, tym niższa pozycja.
DESCENDING Ta usługa jest uszeregowana w kolejności malejącej. Im niższa wartość, tym wyższa pozycja.

IntegerPropertyOptions.IntegerOperatorOptions

Służy do podawania operatora wyszukiwania w przypadku właściwości typu liczba całkowita. To polecenie jest opcjonalne. Operatory query.search umożliwiają użytkownikom ograniczenie zapytania do określonych pól związanych z typem wyszukiwanego produktu.

Zapis JSON 
{
  "operatorName": string,
  "lessThanOperatorName": string,
  "greaterThanOperatorName": string
}
Pola
operatorName

string

Wskazuje nazwę operatora wymaganą w zapytaniu, aby wyodrębnić właściwość całkowitą. Jeśli na przykład operatorName to priority, a nazwa właściwości to priorityVal, zapytania takie jak priority:<value> zwracają wyniki tylko wtedy, gdy wartość właściwości o nazwie priorityVal pasuje do wartości <value>. Natomiast wyszukiwanie, które używa tego samego ciągu <value> bez operatora, zwraca wszystkie elementy, w których <value> pasuje do wartości dowolnej właściwości typu String lub tekstu w polu treści elementu. Nazwa operatora może zawierać tylko małe litery (a–z). Maksymalna długość to 32 znaki.
lessThanOperatorName

string

Wskazuje nazwę operatora wymaganą w zapytaniu, aby wyodrębnić właściwość całkowitą za pomocą operatora mniejszości. Jeśli np. lessThanOperatorName to prioritybelow, a nazwa właściwości to priorityVal, to zapytania takie jak prioritybelow:<value> wyświetlają wyniki tylko wtedy, gdy wartość właściwości o nazwie priorityVal jest mniejsza niż <value>. Nazwa operatora może zawierać tylko małe litery (a–z). Maksymalna długość to 32 znaki.
greaterThanOperatorName

string

Wskazuje nazwę operatora wymaganą w zapytaniu, aby wyodrębnić właściwość całkowitą za pomocą operatora „większe niż”. Jeśli na przykład nazwa operatora greaterThanOperatorName to priorityabove, a nazwa usługi to priorityVal, to zapytania takie jak priorityabove:<value> wyświetlają wyniki tylko wtedy, gdy wartość właściwości o nazwie priorityVal jest większa niż <value>. Nazwa operatora może zawierać tylko małe litery (a–z). Maksymalna długość to 32 znaki.

DoublePropertyOptions

Opcje podwójnych usług

Zapis JSON 
{
  "operatorOptions": {
    object (DoublePropertyOptions.DoubleOperatorOptions)
  }
}
Pola
operatorOptions

object (DoublePropertyOptions.DoubleOperatorOptions)

W przypadku ustawienia opisuje, jak podwójny znak cudzysłowu powinien być używany jako operator wyszukiwania.

DoublePropertyOptions.DoubleOperatorOptions

Służy do podawania operatora wyszukiwania w przypadku właściwości podwójnych. To polecenie jest opcjonalne. Operatory query.search umożliwiają użytkownikom ograniczenie zapytania do określonych pól związanych z typem wyszukiwanego elementu.

Zapis JSON 
{
  "operatorName": string
}
Pola
operatorName

string

Wskazuje nazwę operatora wymaganą w zapytaniu, aby można było używać podwójnej właściwości do sortowania lub jako aspektu. Nazwa operatora może zawierać tylko małe litery (a–z). Maksymalna długość to 32 znaki.

TimestampPropertyOptions

Opcje właściwości sygnatury czasowej.

Zapis JSON 
{
  "operatorOptions": {
    object (TimestampPropertyOptions.TimestampOperatorOptions)
  }
}
Pola
operatorOptions

object (TimestampPropertyOptions.TimestampOperatorOptions)

W przypadku ustawienia opisuje, jak sygnatura czasowa powinna być używana jako operator wyszukiwania.

TimestampPropertyOptions.TimestampOperatorOptions

Służy do podawania operatora wyszukiwania w przypadku właściwości sygnatury czasowej. To polecenie jest opcjonalne. Operatory query.search umożliwiają użytkownikom ograniczenie zapytania do określonych pól związanych z typem wyszukiwanego elementu.

Zapis JSON 
{
  "operatorName": string,
  "lessThanOperatorName": string,
  "greaterThanOperatorName": string
}
Pola
operatorName

string

Wskazuje nazwę operatora wymaganą w zapytaniu, aby wyodrębnić właściwość sygnatury czasowej. Jeśli np. operatorName to closedon, a nazwa właściwości to closeDate, to zapytania takie jak closedon:<value> wyświetlają wyniki tylko wtedy, gdy wartość właściwości o nazwie closeDate jest zgodna z <value>. Natomiast wyszukiwanie, które używa tego samego parametru <value> bez operatora, zwraca wszystkie elementy, w których parametr <value> jest zgodny z wartością dowolnej właściwości typu String lub tekstu w polu treści elementu. Nazwa operatora może zawierać tylko małe litery (a–z). Maksymalna długość to 32 znaki.
lessThanOperatorName

string

Wskazuje nazwę operatora wymaganą w zapytaniu, aby wyodrębnić właściwość sygnatury czasowej za pomocą operatora „mniejszego niż”. Jeśli np. lessThanOperatorName to closedbefore, a nazwa właściwości to closeDate, to zapytania takie jak closedbefore:<value> wyświetlają wyniki tylko wtedy, gdy wartość właściwości o nazwie closeDate jest wcześniejsza niż <value>. Nazwa operatora może zawierać tylko małe litery (a–z). Maksymalna długość to 32 znaki.
greaterThanOperatorName

string

Wskazuje nazwę operatora wymaganą w zapytaniu, aby wyodrębnić właściwość sygnatury czasowej za pomocą operatora większego. Jeśli na przykład nazwa operatora greaterThanOperatorName to closedafter, a nazwa usługi to closeDate, to zapytania takie jak closedafter:<value> wyświetlają wyniki tylko wtedy, gdy wartość właściwości o nazwie closeDate jest późniejsza niż <value>. Nazwa operatora może zawierać tylko małe litery (a–z). Maksymalna długość to 32 znaki.

BooleanPropertyOptions

Opcje właściwości wartości logicznych.

Zapis JSON 
{
  "operatorOptions": {
    object (BooleanPropertyOptions.BooleanOperatorOptions)
  }
}
Pola
operatorOptions

object (BooleanPropertyOptions.BooleanOperatorOptions)

W przypadku ustawienia opisuje, jak wartość logiczna powinna być używana jako operator wyszukiwania.

BooleanPropertyOptions.BooleanOperatorOptions

Służy do podawania operatora wyszukiwania w przypadku właściwości logicznych. To polecenie jest opcjonalne. Operatory query.search umożliwiają użytkownikom ograniczenie zapytania do określonych pól związanych z typem wyszukiwanego elementu.

Zapis JSON 
{
  "operatorName": string
}
Pola
operatorName

string

Wskazuje nazwę operatora wymaganą w zapytaniu, aby wyodrębnić właściwość logiczną. Jeśli np. operatorName to closed, a nazwa właściwości to isClosed, zapytania takie jak closed:<value> zwracają wyniki tylko wtedy, gdy wartość właściwości o nazwie isClosed jest zgodna z wartością parametru <value>. Natomiast wyszukiwanie, które używa tego samego parametru <value> bez operatora, zwraca wszystkie elementy, w których parametr <value> jest zgodny z wartością dowolnej właściwości typu String lub tekstu w polu treści elementu. Nazwa operatora może zawierać tylko małe litery (a–z). Maksymalna długość to 32 znaki.

ObjectPropertyOptions

Opcje właściwości obiektu.

Zapis JSON 
{
  "subobjectProperties": [
    {
      object (PropertyDefinition)
    }
  ]
}
Pola
subobjectProperties[]

object (PropertyDefinition)

Właściwości obiektu podrzędnego. Te właściwości reprezentują obiekt zagnieżdżony. Jeśli na przykład ta usługa reprezentuje adres pocztowy, atrybuty podrzędne mogą mieć nazwy ulica, miasto i województwo. Maksymalna liczba elementów to 1000.

EnumPropertyOptions

opcje właściwości typu enum, które umożliwiają zdefiniowanie ograniczonego zbioru ciągów znaków do dopasowywania do zapytań użytkowników, ustawienie rankingu tych wartości ciągu znaków i zdefiniowanie nazwy operatora, która będzie do nich dopasowywana, aby użytkownicy mogli ograniczyć wyniki tylko do elementów o określonej wartości; Na przykład w przypadku elementów w systemie śledzenia zapytań z informacjami o priorytetach możesz zdefiniować p0 jako dozwoloną wartość wyliczaną i powiązać tę wartość wyliczaną z nazwą operatora priorytet, aby użytkownicy wyszukiwarki mogli dodawać do zapytań priorytet:p0 i ograniczać zestaw wyników tylko do elementów zindeksowanych z wartością p0.

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

object (EnumPropertyOptions.EnumValuePair)

Lista możliwych wartości właściwości zbioru. Wszystkie elementy EnumValuePairs muszą zawierać wartość ciągu znaków. Jeśli dla jednego elementu EnumValuePair podasz wartość całkowitą, wszystkie możliwe pary wartości enum muszą zawierać wartości całkowite. Zarówno wartość ciągu znaków, jak i wartość liczby całkowitej muszą być unikalne w śród wszystkich możliwych wartości. Po ustawieniu wartości nie można ich usuwać ani modyfikować. Jeśli podasz uporządkowany ranking i myślisz, że w przyszłości możesz wstawić dodatkowe wartości enumeracji, pozostaw luki w początkowych wartościach całkowitych, aby umożliwić dodanie wartości między wcześniej zarejestrowanymi wartościami. Maksymalna liczba elementów to 100.
orderedRanking

enum (EnumPropertyOptions.OrderedRanking)

Służy do określenia uporządkowanego rankingu wyliczania, który określa, jak wartości całkowite podane w możliwych parach wartości wyliczonych są używane do porządkowania wyników. Jeśli tak, należy podać wartości liczb całkowitych dla wszystkich możliwych wartości EnumValuePair podanych dla tej właściwości. Można go używać tylko wtedy, gdy wartość isRepeatable jest równa fałsz.
operatorOptions

object (EnumPropertyOptions.EnumOperatorOptions)

W przypadku ustawienia określa, jak należy używać wyliczenia jako operatora wyszukiwania.

EnumPropertyOptions.EnumValuePair

Para wartości z użyciem wyliczenia definiuje 2 rzeczy: wymaganą wartość ciągu znaków i opcjonalną wartość całkowitą. Wartość ciągu znaków określa niezbędny termin zapytania wymagany do pobrania tego elementu, np. p0 w przypadku elementu priorytetowego. Wartość liczby całkowitej określa pozycję tej wartości ciągu znaków w porównaniu z innymi wartościami wyliczonymi dla tej samej właściwości. Możesz na przykład powiązać p0 z 0 i zdefiniować kolejną parę wyliczenia, np. p1 i 1. Aby ustawić ranking danej wartości w stosunku do innych wartości wyliczeniowych dla tej samej nazwy właściwości, musisz użyć wartości całkowitej w połączeniu z wartością ordered ranking. W tym przypadku kolejność malejąca właściwości priority powoduje zwiększenie pozycji elementów zindeksowanych z wartością p0 w porównaniu z elementami zindeksowanymi z wartością p1. Bez określonej kolejności rankingu wartość liczby całkowitej nie ma wpływu na ranking produktów.

Zapis JSON 
{
  "stringValue": string,
  "integerValue": integer
}
Pola
stringValue

string

Wartość ciągu w elementach EnumValuePair. Maksymalna długość to 32 znaki.
integerValue

integer

Wartość całkowita elementu EnumValuePair, która musi być nieujemna. Opcjonalnie:

EnumPropertyOptions.OrderedRanking

Służy do określania kierunku rankingu dla liczby całkowitej EnumValuePair w stosunku do innych wartości liczb całkowitych EnumValuePair. W przypadku niektórych właściwości niższe wartości całkowite oznaczają większe znaczenie, a w przypadku innych – większe wartości całkowite.

Wartości w polu enum
NO_ORDER Brak kolejności wyświetlania obiektu. Wyniki nie są dostosowywane do wartości tej właściwości.
ASCENDING Ta usługa jest uszeregowana w kolejności rosnącej. Im niższa wartość, tym niższa pozycja.
DESCENDING Ta usługa jest uszeregowana w kolejności malejącej. Im niższa wartość, tym wyższa pozycja.

EnumPropertyOptions.EnumOperatorOptions

Służy do udostępniania operatora wyszukiwania w przypadku właściwości typu enum. To polecenie jest opcjonalne. Operatory query.search umożliwiają użytkownikom ograniczenie zapytania do określonych pól związanych z typem wyszukiwanego elementu. Jeśli np. nie podasz operatora dla właściwości zbioru atrybutów priorytet z możliwymi wartościami p0 i p1, zapytanie zawierające termin p0 zwróci elementy, które mają wartość p0 jako wartość właściwości priorytet, a także wszystkie elementy, które zawierają ciąg znaków p0 w innych polach. Jeśli podasz nazwę operatora dla typu enum, np. priority, użytkownicy wyszukiwarki mogą użyć tego operatora, aby zawęzić wyniki tylko do elementów, które mają wartość p0 w tej właściwości, za pomocą zapytania priority:p0.

Zapis JSON 
{
  "operatorName": string
}
Pola
operatorName

string

Wskazuje nazwę operatora wymaganą w zapytaniu, aby wyodrębnić właściwość enum. Jeśli na przykład operatorName to priority, a nazwa właściwości to priorityVal, zapytania takie jak priority:<value> zwracają wyniki tylko wtedy, gdy wartość właściwości o nazwie priorityVal pasuje do wartości <value>. Natomiast wyszukiwanie, które używa tego samego ciągu <value> bez operatora, zwraca wszystkie elementy, w których wartość ciągu znaków <value> pasuje do wartości dowolnej właściwości typu String lub tekstu w polu treści elementu. Nazwa operatora może zawierać tylko małe litery (a–z). Maksymalna długość to 32 znaki.

DatePropertyOptions

Opcje właściwości daty.

Zapis JSON 
{
  "operatorOptions": {
    object (DatePropertyOptions.DateOperatorOptions)
  }
}
Pola
operatorOptions

object (DatePropertyOptions.DateOperatorOptions)

W przypadku ustawienia określa, jak data powinna być używana jako operator wyszukiwania.

DatePropertyOptions.DateOperatorOptions

Opcjonalnie: Udostępnia operatora wyszukiwania dla właściwości daty. Operatory query.search umożliwiają użytkownikom ograniczenie zapytania do określonych pól związanych z typem wyszukiwanego elementu.

Zapis JSON 
{
  "operatorName": string,
  "lessThanOperatorName": string,
  "greaterThanOperatorName": string
}
Pola
operatorName

string

Wskazuje rzeczywisty ciąg znaków wymagany w zapytaniu, aby wyodrębnić właściwość daty. Załóżmy na przykład, że obiekt schematu śledzenia problemów ma właściwość o nazwie closeDate, która określa operatora o nazwie operatorName równej closedon. W przypadku wyszukiwania tych danych zapytania takie jak closedon:<value> wyświetlają wyniki tylko wtedy, gdy wartość właściwości closeDate jest zgodna z <value>. Natomiast wyszukiwanie, które używa tego samego parametru <value> bez operatora, zwraca wszystkie elementy, w których <value> jest zgodny z wartością dowolnej właściwości typu String lub tekstu w polu treści dla zindeksowanego źródła danych. Nazwa operatora może zawierać tylko małe litery (a–z). Maksymalna długość to 32 znaki.
lessThanOperatorName

string

Wskazuje nazwę operatora wymaganą w zapytaniu, aby wyodrębnić właściwość daty za pomocą operatora „mniejszego niż”. Jeśli np. lessThanOperatorName to closedbefore, a nazwa właściwości to closeDate, to zapytania takie jak closedbefore:<value> wyświetlają wyniki tylko wtedy, gdy wartość właściwości o nazwie closeDate jest wcześniejsza niż <value>. Nazwa operatora może zawierać tylko małe litery (a–z). Maksymalna długość to 32 znaki.
greaterThanOperatorName

string

Wskazuje nazwę operatora wymaganą w zapytaniu, aby wyodrębnić właściwość daty za pomocą operatora większego. Jeśli na przykład nazwa operatora greaterThanOperatorName to closedafter, a nazwa usługi to closeDate, to zapytania takie jak closedafter:<value> wyświetlają wyniki tylko wtedy, gdy wartość właściwości o nazwie closeDate jest późniejsza niż <value>. Nazwa operatora może zawierać tylko małe litery (a–z). Maksymalna długość to 32 znaki.

TextPropertyOptions

Opcje właściwości tekstowych.

Zapis JSON 
{
  "retrievalImportance": {
    object (RetrievalImportance)
  },
  "operatorOptions": {
    object (TextPropertyOptions.TextOperatorOptions)
  }
}
Pola
retrievalImportance

object (RetrievalImportance)

Wskazuje znaczenie dla jakości wyszukiwania tokenów w polu podczas ich używania do wyszukiwania.
operatorOptions

object (TextPropertyOptions.TextOperatorOptions)

W przypadku, gdy jest ustawiona, opisuje, jak należy używać tej właściwości jako operatora wyszukiwania.

RetrievalImportance

Zapis JSON 
{
  "importance": enum (RetrievalImportance.Importance)
}
Pola
importance

enum (RetrievalImportance.Importance)

Wskazuje znaczenie rankingu przypisane do usługi, gdy jest ona dopasowywana podczas pobierania. Po ustawieniu wagi tokena właściwości nie można jej zmienić.

RetrievalImportance.Importance

Wartości w polu enum
DEFAULT Traktuj dopasowanie jak dopasowanie tekstu głównego.
HIGHEST Traktuj dopasowanie jako dopasowanie do tytułu produktu.
HIGH Traktuj dopasowanie jako mające wyższy priorytet niż tekst główny.
LOW Uwzględnij dopasowanie z mniejszym priorytetem niż tekst główny.
NONE Nie dopasowuj tego pola podczas pobierania. W razie potrzeby można nadal używać tej właściwości do dopasowywania operatorów, tworzenia wymiarów i podpowiadania.

TextPropertyOptions.TextOperatorOptions

Służy do podawania operatora wyszukiwania w przypadku właściwości tekstowych. To polecenie jest opcjonalne. Operatory query.search umożliwiają użytkownikom ograniczenie zapytania do określonych pól związanych z typem wyszukiwanego elementu.

Zapis JSON 
{
  "operatorName": string,
  "exactMatchWithOperator": boolean
}
Pola
operatorName

string

Wskazuje nazwę operatora wymaganą w zapytaniu w celu wyodrębnienia właściwości tekstowej. Jeśli np. operatorName to subject, a nazwa właściwości to subjectLine, zapytania takie jak subject:<value> zwracają wyniki tylko wtedy, gdy wartość właściwości o nazwie subjectLine pasuje do <value>. Natomiast wyszukiwanie, które używa tej samej wartości <value> bez operatora, zwraca wszystkie elementy, w których <value> pasuje do wartości dowolnych właściwości tekstowych lub tekstu w polu treści elementu. Nazwa operatora może zawierać tylko małe litery (a–z). Maksymalna długość to 32 znaki.
exactMatchWithOperator

boolean

Jeśli ta opcja jest zaznaczona, wartość tekstowa jest dzielona na tokeny jako jedna wartość atomowa w wyszukiwaniach operatora i dopasowaniach aspektów. Jeśli na przykład nazwa operatora to „genre”, a wartość to „science-fiction”, ograniczenia zapytania „genre:science” i „genre:fiction” nie pasują do elementu, ale „genre:science-fiction” pasuje. W dopasowaniu wartości tekstowych wielkość liter ma znaczenie, a znaki specjalne nie są usuwane. Jeśli wartość to Fałsz, tekst jest dzielony na tokeny. Jeśli na przykład wartość to „science-fiction”, zapytania „genre:science” i „genre:fiction” pasują do elementu.

HtmlPropertyOptions

Opcje właściwości HTML.

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

object (RetrievalImportance)

Wskazuje znaczenie dla jakości wyszukiwania tokenów w polu podczas ich używania do wyszukiwania. Może przyjmować tylko wartości DOWOLNA lub ŻADNA.
operatorOptions

object (HtmlPropertyOptions.HtmlOperatorOptions)

W przypadku, gdy jest ustawiona, opisuje, jak należy używać tej właściwości jako operatora wyszukiwania.

HtmlPropertyOptions.HtmlOperatorOptions

Służy do podawania operatora wyszukiwania w przypadku właściwości HTML. To polecenie jest opcjonalne. Operatory query.search umożliwiają użytkownikom ograniczenie zapytania do określonych pól związanych z typem wyszukiwanego elementu.

Zapis JSON 
{
  "operatorName": string
}
Pola
operatorName

string

Wskazuje nazwę operatora wymaganą w zapytaniu w celu wyodrębnienia właściwości html. Jeśli np. operatorName to subject, a nazwa właściwości to subjectLine, zapytania takie jak subject:<value> zwracają wyniki tylko wtedy, gdy wartość właściwości o nazwie subjectLine pasuje do <value>. Natomiast wyszukiwanie, które używa tej samej wartości <value> bez operatora, zwraca wszystkie elementy, w których wartość <value> pasuje do wartości dowolnych właściwości HTML lub tekstu w polu treści elementu. Nazwa operatora może zawierać tylko małe litery (a–z). Maksymalna długość to 32 znaki.

PropertyDisplayOptions

Opcje wyświetlania usługi.

Zapis JSON 
{
  "displayLabel": string
}
Pola
displayLabel

string

Przyjazna dla użytkownika etykieta właściwości, która jest używana, jeśli określono, że ma być wyświetlana w sekcji Opcje wyświetlania obiektu. Jeśli jest podana, etykieta wyświetlania jest widoczna przed wartościami właściwości, gdy właściwości te są częścią opcji wyświetlania obiektu. Jeśli np. wartość właściwości to „1”, sama w sobie może nie stanowić przydatnego kontekstu dla użytkownika. Jeśli wyświetlana nazwa to „priorytet”, użytkownik zobaczy w wynikach wyszukiwania „priorytet : 1”, co zapewni użytkownikom wyszukiwarki jasny kontekst. To pole jest OPCJONALNE. Jeśli nie zostanie podane, wyświetlane są tylko wartości właściwości. Maksymalna długość to 64 znaki.