- Zapis JSON
- 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
Definicja schematu źródła danych.
Zapis JSON |
---|
{
"objectDefinitions": [
{
object ( |
Pola | |
---|---|
objectDefinitions[] |
Lista obiektów najwyższego poziomu dla źródła danych. Maksymalna liczba elementów to 10. |
operationIds[] |
Identyfikatory długo trwających operacji (LRO) uruchomionych obecnie dla tego schematu. Po zmodyfikowaniu schematu poczekaj na zakończenie operacji, zanim zindeksujesz dodatkową treść. |
ObjectDefinition
Definicja obiektu w źródle danych.
Zapis JSON |
---|
{ "name": string, "options": { object ( |
Pola | |
---|---|
name |
Nazwa obiektu, która następnie określa jego typ. W przypadku próśb o zindeksowanie produktów pole |
options |
Opcjonalne opcje związane z obiektem. |
propertyDefinitions[] |
Definicje właściwości obiektu. Maksymalna liczba elementów to 1000. |
ObjectOptions
Opcje obiektu.
Zapis JSON |
---|
{ "freshnessOptions": { object ( |
Pola | |
---|---|
freshnessOptions |
Opcje aktualności obiektu. |
displayOptions |
Opcje określające sposób wyświetlania obiektu na stronie wyników Cloud Search. |
suggestionFilteringOperators[] |
Operatory, których można używać do filtrowania sugestii. W przypadku interfejsu UWAGA: parametry „objecttype”, „type” i „mimetype” są już obsługiwane. Ta właściwość służy do konfigurowania operatorów związanych ze schematem. Mimo że jest to tablica, można określić tylko jeden operator. To jest tablica pozwalająca na rozszerzanie jej w przyszłości. Mapowanie na większą liczbę właściwości w tym samym obiekcie nie jest 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 właściwość dotyczącą aktualności, która ma być używana podczas dostosowywania pozycji w rankingu wyników wyszukiwania. Nowsze, nowsze daty oznaczają wyższą jakość. Używaj opcji częstotliwości aktualizacji, która najlepiej sprawdza się w przypadku Twoich danych. W przypadku dokumentów udziału plików najbardziej istotny jest czas ostatniej modyfikacji. W przypadku danych o wydarzeniach w kalendarzu bardziej trafnym wskaźnikiem aktualności jest godzina, w której ma ono miejsce. W ten sposób wydarzenia w kalendarzu, które mają miejsce bliżej chwili wyszukiwania, są uważane za wyższą jakość i odpowiednio pozycjonowane.
Zapis JSON |
---|
{ "freshnessProperty": string, "freshnessDuration": string } |
Pola | |
---|---|
freshnessProperty |
Ta właściwość wskazuje poziom aktualności obiektu w indeksie. Jeśli jest skonfigurowana, ta właściwość musi być usługą najwyższego poziomu w obrębie obiektu Gdy do obliczania aktualności danych używana jest usługa, wartość domyślna to 2 lata od bieżącej daty. |
freshnessDuration |
Czas, po którym obiekt powinien być uznawany za nieaktualny. Wartość domyślna to 180 dni (w sekundach). Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku, kończącym się cyframi „ |
ObjectDisplayOptions
Opcje wyświetlania obiektu.
Zapis JSON |
---|
{
"objectDisplayLabel": string,
"metalines": [
{
object ( |
Pola | |
---|---|
objectDisplayLabel |
Etykieta przyjazna dla użytkownika wyświetlana w wynikach wyszukiwania, która wskazuje typ elementu. Ta wartość jest OPCJONALNA. Jeśli jej nie podasz, etykieta obiektu nie będzie wyświetlana w wierszu kontekstu wyników wyszukiwania. Maksymalna długość to 64 znaki. |
metalines[] |
Określa właściwości wyświetlane w metawierszach wyników wyszukiwania. Wartości właściwości są wyświetlane w podanej tu kolejności. Jeśli usługa zawiera wiele wartości, wszystkie są wyświetlane przed kolejnymi usługami. Z tego powodu zaleca się określenie właściwości liczby pojedynczej, a nie powtórzenie ich z tej listy. Wszystkie właściwości muszą ustawić |
ObjectDisplayOptions.Metaline
Metawiersz to lista właściwości wyświetlanych wraz z wynikiem wyszukiwania w celu określenia kontekstu.
Zapis JSON |
---|
{
"properties": [
{
object ( |
Pola | |
---|---|
properties[] |
Lista wyświetlanych właściwości metadanych. Maksymalna liczba właściwości to 5. |
ObjectDisplayOptions.DisplayedProperty
Odwołanie 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 wyświetlają się w wynikach wyszukiwania razem z właściwością display label
, jeśli została ona określona. Jeśli nie określisz etykiety wyświetlanej, wyświetlą się tylko wartości.
Zapis JSON |
---|
{ "propertyName": string } |
Pola | |
---|---|
propertyName |
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 aktualizacji 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 ( |
Pola | |
---|---|
name |
Nazwa usługi. Żądania indeksowania produktów wysyłane do interfejsu Indexing API powinny mieć ustawioną wartość |
isReturnable |
Wskazuje, że właściwość identyfikuje dane, które powinny być zwracane w wynikach wyszukiwania przez interfejs Query API. Jeśli ma wartość true, oznacza to, że użytkownicy interfejsu Query API mogą używać w wynikach pasujących pól właściwości. Przechowywanie pól wymaga jednak większej przestrzeni i większej przepustowości łącza na zapytania, co wpływa na wydajność w dużych zbiorach danych. Ustaw tutaj wartość true (prawda) tylko wtedy, gdy to pole jest wymagane dla wyników wyszukiwania. Wartość nie może mieć wartości prawda w przypadku właściwości, których typ jest obiektem. |
isRepeatable |
Wskazuje, że dla właściwości może być widocznych wiele wartości. Na przykład dokument ma tylko 1 opis, ale może zawierać wiele komentarzy. Wartość nie może mieć wartości prawda w przypadku właściwości, których typ jest wartością logiczną. Jeśli zasada ma wartość Fałsz, właściwości zawierające więcej niż 1 wartość powodują odrzucenie prośby o zindeksowanie danego elementu. |
isSortable |
Wskazuje, że tej właściwości można używać do sortowania. Wartość nie może mieć wartości prawda w przypadku właściwości, które są powtarzalne. Wartość nie może mieć wartości prawda w przypadku właściwości, których typ to obiekt. Aby ustawić tę opcję, atrybut IsReturnable musi mieć wartość true (prawda). Obsługiwane tylko w przypadku właściwości logicznej, daty, liczby zmiennoprzecinkowej, liczby całkowitej i sygnatury czasowej. |
isFacetable |
Wskazuje, że tej właściwości można używać do generowania aspektów. Wartość nie może mieć wartości prawda w przypadku właściwości, których typ to obiekt. Aby ustawić tę opcję, atrybut IsReturnable musi mieć wartość true (prawda). Obsługiwane tylko w przypadku właściwości logicznych, wyliczeniowych, liczb całkowitych i tekstowych. |
isSuggestable |
Wskazuje, że tej właściwości można używać do generowania sugestii dotyczących zapytań. |
isWildcardSearchable |
Wskazuje, że użytkownicy mogą wyszukiwać tę właściwość przy użyciu symboli wieloznacznych. Obsługiwane tylko w przypadku właściwości Tekst. Aby ustawić tę opcję, atrybut IsReturnable musi mieć wartość true (prawda). W danym źródle danych jako wartość isWildcardSearchable można oznaczyć maksymalnie 5 właściwości. Więcej informacji znajdziesz w sekcji Definiowanie właściwości obiektu. |
displayOptions |
Opcje określające sposób wyświetlania właściwości na stronie wyników Cloud Search, jeśli została określona do wyświetlania w obiekcie |
Pole sumy property_options . Opcje specyficzne dla danego typu, które określają sposób indeksowania i używania usługi. W przypadku, gdy te opcje powinny być domyślną opcją dla danego typu, to pole nadal musi być ustawione na jeden z typów. Jeśli to pole nie jest skonfigurowane, aktualizacje schematu są odrzucane. property_options może mieć tylko jedną z tych wartości: |
|
integerPropertyOptions |
|
doublePropertyOptions |
|
timestampPropertyOptions |
|
booleanPropertyOptions |
|
objectPropertyOptions |
|
enumPropertyOptions |
|
datePropertyOptions |
|
textPropertyOptions |
|
htmlPropertyOptions |
|
IntegerPropertyOptions
Opcje właściwości liczb całkowitych.
Zapis JSON |
---|
{ "orderedRanking": enum ( |
Pola | |
---|---|
orderedRanking |
Służy do określania uporządkowanego rankingu liczby całkowitej. Tej opcji można użyć tylko wtedy, gdy |
minimumValue |
Minimalna wartość nieruchomości. Minimalne i maksymalne wartości właściwości służą do ustalania pozycji wyników w rankingu zgodnie z zasadą |
maximumValue |
Maksymalna wartość właściwości. Minimalne i maksymalne wartości właściwości służą do ustalania pozycji wyników w rankingu zgodnie z zasadą |
operatorOptions |
Jeśli jest ustawiony, określa, jak należy używać liczby całkowitej jako operatora wyszukiwania. |
integerFacetingOptions |
Jeśli jest ustawiony, opisuje opcje określania aspektów liczb całkowitych dla danej właściwości liczby całkowitej. Odpowiednia właściwość liczby całkowitej powinna być oznaczona jako „Facetable”. |
IntegerPropertyOptions.OrderedRanking
Służy do określania sposobu wyznaczania pozycji liczby całkowitej w stosunku do innych wartości. Liczba całkowita z wyższą pozycją w rankingu oznacza większe znaczenie. Na przykład w niektórych źródłach danych niższy priorytet oznacza większe znaczenie, a w innych – wyższy.
Wartości w polu enum | |
---|---|
NO_ORDER |
Nie ma żadnej pozycji w rankingu dla usługi. Wyniki nie są dostosowywane według wartości tej właściwości. |
ASCENDING |
Ta usługa jest wyświetlana w kolejności rosnącej. Niższe wartości oznaczają niższą pozycję w rankingu. |
DESCENDING |
Ta usługa jest posortowana w kolejności malejącej. Niższe wartości oznaczają wyższą pozycję w rankingu. |
IntegerPropertyOptions.IntegerOperatorOptions
Służy do udostępniania operatora wyszukiwania właściwości liczb całkowitych. Jest to opcjonalne. Operatory query.search pozwalają użytkownikom ograniczyć zapytanie do określonych pól związanych z typem przeszukiwanego elementu.
Zapis JSON |
---|
{ "operatorName": string, "lessThanOperatorName": string, "greaterThanOperatorName": string } |
Pola | |
---|---|
operatorName |
Wskazuje nazwę operatora wymaganą w zapytaniu w celu wyodrębnienia właściwości liczby całkowitej. Jeśli na przykład operatorNameName ma wartość Priority, a nazwa właściwości to PriorityVal, zapytania typu Priority:<value> wyświetlają wyniki tylko wtedy, gdy wartość właściwości o nazwie PriorityVal odpowiada wartości <value>. Z kolei wyszukiwanie wykorzystujące ten sam element <value> bez operatora zwraca wszystkie elementy, w przypadku których <value> odpowiada wartości dowolnej właściwości ciągu znaków lub tekstu w polu treści. Nazwa operatora może zawierać tylko małe litery (a–z). Maksymalna długość to 32 znaki. |
lessThanOperatorName |
Wskazuje nazwę operatora wymaganą w zapytaniu, by wyodrębnić właściwość liczby całkowitej za pomocą operatora „mniejsze niż”. Na przykład jeśli wartość właściwości lessThanOperatorName ma wartość priorytet poniżej, a nazwa właściwości to PriorityVal, zapytania typu Priorytet poniżej:<wartość> wyświetlają wyniki tylko wtedy, gdy wartość właściwości o nazwie PriorityVal jest mniejsza niż wartość <value>. Nazwa operatora może zawierać tylko małe litery (a–z). Maksymalna długość to 32 znaki. |
greaterThanOperatorName |
Wskazuje nazwę operatora wymaganą w zapytaniu, by wyodrębnić właściwość liczb całkowitych za pomocą operatora „większe niż”. Na przykład jeśli wartość właściwości GreatThanOperatorName ma wyższy priorytet niż <value>, a nazwa właściwości to PriorityVal, zapytania typu PriorityVal 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 właściwości podwójnej precyzji.
Zapis JSON |
---|
{
"operatorOptions": {
object ( |
Pola | |
---|---|
operatorOptions |
Jeśli jest ustawiony, określa, jak należy używać liczby zmiennoprzecinkowej jako operatora wyszukiwania. |
DoublePropertyOptions.DoubleOperatorOptions
Służy do udostępniania operatora wyszukiwania właściwości podwójnego. Jest to opcjonalne. Operatory query.search pozwalają użytkownikom ograniczyć zapytanie do określonych pól związanych z typem przeszukiwanego elementu.
Zapis JSON |
---|
{ "operatorName": string } |
Pola | |
---|---|
operatorName |
Wskazuje nazwę operatora, która jest wymagana w zapytaniu, aby można było użyć właściwości podwójnego przy sortowaniu 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 ( |
Pola | |
---|---|
operatorOptions |
Jeśli jest ustawiony, określa, jak należy używać sygnatury czasowej jako operatora wyszukiwania. |
TimestampPropertyOptions.TimestampOperatorOptions
Służy do udostępniania operatora wyszukiwania właściwości sygnatury czasowej. Jest to opcjonalne. Operatory query.search pozwalają użytkownikom ograniczyć zapytanie do określonych pól związanych z typem przeszukiwanego elementu.
Zapis JSON |
---|
{ "operatorName": string, "lessThanOperatorName": string, "greaterThanOperatorName": string } |
Pola | |
---|---|
operatorName |
Wskazuje nazwę operatora wymaganą w zapytaniu w celu wyodrębnienia właściwości sygnatury czasowej. Jeśli na przykład operatorNameName to closedon, a nazwa właściwości to closeDate, zapytania w rodzaju closedon:<value> wyświetlą wyniki tylko wtedy, gdy wartość właściwości o nazwie closeDate będzie zgodna z wartością <value>. Z kolei wyszukiwanie wykorzystujące ten sam element <value> bez operatora zwraca wszystkie elementy, w których element <value> odpowiada wartości dowolnej właściwości ciągu znaków lub tekstu w polu treści. Nazwa operatora może zawierać tylko małe litery (a–z). Maksymalna długość to 32 znaki. |
lessThanOperatorName |
Wskazuje nazwę operatora wymaganą w zapytaniu, aby wyodrębnić właściwość sygnatury czasowej za pomocą operatora „mniej niż”. Na przykład jeśli wartość właściwości lessThanOperatorName to closedbefore i nazwa właściwości to closedDate, zapytania typu closedbefore:<value> wyświetlają wyniki tylko wtedy, gdy wartość właściwości o nazwie closeDate jest wcześniejsza niż wartość <value>. Nazwa operatora może zawierać tylko małe litery (a–z). Maksymalna długość to 32 znaki. |
greaterThanOperatorName |
Wskazuje nazwę operatora wymaganą w zapytaniu, aby wyodrębnić właściwość sygnatury czasowej za pomocą operatora „większe niż”. Na przykład jeśli wartość właściwości GreatThanOperatorName to closedafter, a nazwa właściwości to closedDate, zapytania typu closedafter:<value> wyświetlają wyniki tylko wtedy, gdy wartość właściwości o nazwie closeDate jest późniejsza niż wartość właściwości <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 ( |
Pola | |
---|---|
operatorOptions |
Jeśli jest ustawiony, określa, w jaki sposób wartość logiczna powinna być używana jako operator wyszukiwania. |
BooleanPropertyOptions.BooleanOperatorOptions
Służy do podawania operatora wyszukiwania właściwości logicznych. Jest to opcjonalne. Operatory query.search pozwalają użytkownikom ograniczyć zapytanie do określonych pól związanych z typem przeszukiwanego elementu.
Zapis JSON |
---|
{ "operatorName": string } |
Pola | |
---|---|
operatorName |
Wskazuje nazwę operatora wymaganą w zapytaniu w celu wyodrębnienia właściwości logicznej. Jeśli na przykład operatorNameName ma wartość closed, a nazwa właściwości to isClosed, zapytania takie jak closed:<value> wyświetlają wyniki tylko wtedy, gdy wartość właściwości o nazwie isClosed odpowiada parametrowi <value>. Natomiast wyszukiwanie wykorzystujące ten sam element <value> bez operatora zwraca wszystkie elementy, w których element <value> odpowiada wartości dowolnej właściwości ciągu znaków lub tekstu w polu treści. 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 ( |
Pola | |
---|---|
subobjectProperties[] |
Właściwości obiektu podrzędnego. Te właściwości reprezentują obiekt zagnieżdżony. Jeśli na przykład ta właściwość reprezentuje adres pocztowy, obiekt subobjectMethod może mieć nazwy street, city i state. Maksymalna liczba elementów to 1000. |
EnumPropertyOptions
Opcje właściwości wyliczenia, które umożliwiają zdefiniowanie ograniczonego zestawu ciągów znaków pasujących do zapytań użytkowników, ustawianie rankingów dla tych wartości ciągów oraz zdefiniowanie nazwy operatora, która zostanie powiązana z tymi ciągami, dzięki czemu użytkownicy będą mogli zawężać wyniki tylko do elementów o określonej wartości. Na przykład w przypadku elementów w systemie śledzenia żądań z informacjami o priorytecie możesz zdefiniować p0 jako dozwoloną wartość wyliczeniową i powiązać tę wartość z nazwą operatora Priority. Dzięki temu użytkownicy wyszukiwarki mogą dodać do zapytania Priorytet:p0 i ograniczyć zbiór wyników tylko do tych elementów zindeksowanych z wartością p0.
Zapis JSON |
---|
{ "possibleValues": [ { object ( |
Pola | |
---|---|
possibleValues[] |
Lista możliwych wartości właściwości wyliczenia. Wszystkie pary EnumValuepairs muszą zawierać wartość ciągu. Jeśli podasz liczbę całkowitą dla jednej wartości EnumValuepairs, wszystkie możliwe parametry EnumValuepairs muszą określać wartość całkowitą. Zarówno wartość ciągu, jak i liczba całkowita 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 uważasz, że w przyszłości można wstawić dodatkowe wartości wyliczeniowe, pozostaw luki w początkowych wartościach całkowitych, aby umożliwić dodanie wartości pomiędzy wcześniej zarejestrowanymi wartościami. Maksymalna liczba elementów to 100. |
orderedRanking |
Służy do określania uporządkowanego rankingu dla wyliczenia określającego sposób, w jaki wartości całkowite podane w możliwych parach EnumValuePary są używane do ustalania pozycji wyników. Jeśli zostanie określona, musisz podać wartości całkowite dla wszystkich możliwych wartości EnumValueSparuj dla tej właściwości. Tej opcji można użyć tylko wtedy, gdy |
operatorOptions |
Jeśli jest ustawiony, określa, w jaki sposób wyliczenie ma być używane jako operator wyszukiwania. |
EnumPropertyOptions.EnumValuePair
Para wartości wyliczeniowych definiuje 2 rzeczy: wymaganą wartość ciągu znaków i opcjonalną liczbę całkowitą. Wartość ciągu określa potrzebne hasło w zapytaniu wymagane do pobrania danego elementu, np. p0 w przypadku elementu priorytetowego. Wartość liczby całkowitej określa pozycję danej wartości ciągu w porównaniu z innymi wartościami wyliczonymi dla tej samej właściwości. Możesz np. powiązać wartość p0 z 0 i zdefiniować inną parę wyliczeniową, np. p1 i 1. Aby ustawić ranking danej wartości w odniesieniu do innych wartości wyliczonych dla tej samej nazwy właściwości, musisz użyć wartości całkowitej w połączeniu z właściwością ordered ranking
. W tym przypadku kolejność w rankingu DESCENDING dla właściwości priorytetu powoduje wyższą pozycję w rankingu elementów zindeksowanych z wartością p0 w porównaniu do elementów zindeksowanych z wartością p1. W przypadku braku określonej kolejności produktów wartość będąca liczbą całkowitą nie ma wpływu na ranking produktów.
Zapis JSON |
---|
{ "stringValue": string, "integerValue": integer } |
Pola | |
---|---|
stringValue |
Wartość ciągu znaków EnumValuePary. Maksymalna długość to 32 znaki. |
integerValue |
Wartość całkowita argumentu EnumValueSparuj, która nie może być ujemna. Opcjonalnie. |
EnumPropertyOptions.OrderedRanking
Służy do określania kierunku rankingu dla liczby całkowitej EnumValuePair
w odniesieniu do innych wartości całkowitych EnumValueSparuj. W przypadku niektórych usług mniejsze wartości całkowite oznaczają większe znaczenie, a w innych – większe.
Wartości w polu enum | |
---|---|
NO_ORDER |
Nie ma żadnej pozycji w rankingu dla usługi. Wyniki nie są dostosowywane według wartości tej właściwości. |
ASCENDING |
Ta usługa jest wyświetlana w kolejności rosnącej. Niższe wartości oznaczają niższą pozycję w rankingu. |
DESCENDING |
Ta usługa jest posortowana w kolejności malejącej. Niższe wartości oznaczają wyższą pozycję w rankingu. |
EnumPropertyOptions.EnumOperatorOptions
Służy do udostępniania operatora wyszukiwania właściwości wyliczenia. Jest to opcjonalne. Operatory query.search pozwalają użytkownikom ograniczyć zapytanie do określonych pól związanych z typem przeszukiwanego elementu. Jeśli na przykład nie podasz żadnego operatora dla właściwości priorytetu z możliwymi wartościami p0 i p1, zapytanie zawierające hasło p0 zwróci elementy, które mają p0 jako wartość właściwości Priority, a także elementy, które zawierają ciąg p0 w innych polach. Jeśli podasz w wyliczeniu nazwę operatora, np. Priority, użytkownicy będą mogli za jego pomocą zawęzić wyniki tylko do elementów, które mają jako wartość tej właściwości p0 i zapytanie Priority:p0.
Zapis JSON |
---|
{ "operatorName": string } |
Pola | |
---|---|
operatorName |
Wskazuje nazwę operatora wymaganą w zapytaniu w celu wyodrębnienia właściwości wyliczenia. Jeśli na przykład operatorNameName ma wartość Priority, a nazwa właściwości to PriorityVal, zapytania typu Priority:<value> wyświetlają wyniki tylko wtedy, gdy wartość właściwości o nazwie PriorityVal odpowiada wartości <value>. Z kolei wyszukiwanie wykorzystujące ten sam element <value> bez operatora zwraca wszystkie elementy, w przypadku których <value> odpowiada wartości dowolnej właściwości ciągu znaków lub tekstu w polu treści. 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 ( |
Pola | |
---|---|
operatorOptions |
Jeśli jest ustawiony, określa sposób użycia daty jako operatora wyszukiwania. |
DatePropertyOptions.DateOperatorOptions
Opcjonalnie. Udostępnia operator wyszukiwania właściwości daty. Operatory query.search pozwalają użytkownikom ograniczać zapytanie do określonych pól związanych z typem przeszukiwanego elementu.
Zapis JSON |
---|
{ "operatorName": string, "lessThanOperatorName": string, "greaterThanOperatorName": string } |
Pola | |
---|---|
operatorName |
Wskazuje rzeczywisty ciąg wymagany w zapytaniu w celu wyodrębnienia właściwości daty. Załóżmy, że obiekt schematu śledzenia problemów ma właściwość o nazwie closeDate, która określa operator z operatorem closedon. W przypadku wyszukiwań tych danych zapytania takie jak closedon:<value> wyświetlają wyniki tylko wtedy, gdy wartość właściwości closeDate jest zgodna z wartością <value>. Z kolei wyszukiwanie zawierające taki sam element <value> bez operatora zwraca wszystkie elementy, w których element <value> odpowiada wartości którejkolwiek właściwości ciągu lub tekstu znajdującego się w polu treści zindeksowanego źródła danych. Nazwa operatora może zawierać tylko małe litery (a–z). Maksymalna długość to 32 znaki. |
lessThanOperatorName |
Wskazuje nazwę operatora wymaganą w zapytaniu, aby wyodrębnić właściwość daty za pomocą operatora „mniej niż”. Na przykład jeśli wartość właściwości lessThanOperatorName to closedbefore i nazwa właściwości to closedDate, zapytania typu closedbefore:<value> wyświetlają wyniki tylko wtedy, gdy wartość właściwości o nazwie closeDate jest wcześniejsza niż wartość <value>. Nazwa operatora może zawierać tylko małe litery (a–z). Maksymalna długość to 32 znaki. |
greaterThanOperatorName |
Wskazuje nazwę operatora wymaganą w zapytaniu, aby wyodrębnić właściwość daty za pomocą operatora „większe niż”. Na przykład jeśli wartość właściwości GreatThanOperatorName to closedafter, a nazwa właściwości to closedDate, zapytania typu closedafter:<value> wyświetlają wyniki tylko wtedy, gdy wartość właściwości o nazwie closeDate jest późniejsza niż wartość właściwości <value>. Nazwa operatora może zawierać tylko małe litery (a–z). Maksymalna długość to 32 znaki. |
TextPropertyOptions
Opcje właściwości tekstu.
Zapis JSON |
---|
{ "retrievalImportance": { object ( |
Pola | |
---|---|
retrievalImportance |
Wskazuje znaczenie jakości wyszukiwania tokenów w polu używanych do pobierania. |
operatorOptions |
Jeśli jest ustawiony, określa, jak należy używać właściwości jako operatora wyszukiwania. |
RetrievalImportance
Zapis JSON |
---|
{
"importance": enum ( |
Pola | |
---|---|
importance |
Wskazuje znaczenie usługi w rankingu, gdy zostanie dopasowane podczas pobierania. Po ustawieniu znaczenia tokena usługi nie można już zmienić. |
RetrievalImportance.Importance
Wartości w polu enum | |
---|---|
DEFAULT |
Dopasuj tekst do treści. |
HIGHEST |
Dopasowanie do tytułu produktu należy potraktować jako dopasowanie do siebie. |
HIGH |
Traktuj dopasowanie o większym znaczeniu niż tekst główny. |
LOW |
Mniej ważne znaczenie niż tekst główny. |
NONE |
Nie dopasowuj do tego pola podczas pobierania. Tej właściwości można nadal używać do dopasowywania operatorów, określania aspektów i sugerowania w razie potrzeby. |
TextPropertyOptions.TextOperatorOptions
Służy do udostępniania operatora wyszukiwania właściwości tekstu. Jest to opcjonalne. Operatory query.search pozwalają użytkownikom ograniczyć zapytanie do określonych pól związanych z typem przeszukiwanego elementu.
Zapis JSON |
---|
{ "operatorName": string, "exactMatchWithOperator": boolean } |
Pola | |
---|---|
operatorName |
Wskazuje nazwę operatora wymaganą w zapytaniu w celu wyodrębnienia właściwości tekstowej. Jeśli na przykład operatorNameName to subject, a nazwa właściwości to subjectLine, zapytania w rodzaju subject:<value> wyświetlają wyniki tylko wtedy, gdy wartość właściwości o nazwie subjectLine jest zgodna z wartością <value>. Natomiast wyszukiwanie wykorzystujące ten sam element <value> bez operatora zwraca wszystkie elementy, w których element <value> odpowiada wartości dowolnej właściwości tekstowej lub tekstu znajdującego się w polu treści danego elementu. Nazwa operatora może zawierać tylko małe litery (a–z). Maksymalna długość to 32 znaki. |
exactMatchWithOperator |
Jeśli ma wartość prawda, wartość tekstowa jest tokenizowana jako jedna wartość niepodzielna podczas wyszukiwania operatorów i dopasowań aspektów. Jeśli np. nazwa operatora to „genre”, a wartością jest „science-fiction”, ograniczenia zapytania „genre:science” i „genre:fiction” nie pasują do elementu, natomiast operator „genre:science-fiction” tak. W dopasowaniu wartości tekstowych wielkość liter ma znaczenie i nie powoduje usunięcia znaków specjalnych. Jeśli ma wartość false (fałsz), tekst jest tokenizowany. Jeśli wartość to np. „science-fiction”, do zapytania pasują zapytania „genre:science” i „genre:fiction”. |
HtmlPropertyOptions
Opcje właściwości HTML.
Zapis JSON |
---|
{ "retrievalImportance": { object ( |
Pola | |
---|---|
retrievalImportance |
Wskazuje znaczenie jakości wyszukiwania tokenów w polu używanych do pobierania. Można ustawić tylko wartość DEFAULT lub BRAK. |
operatorOptions |
Jeśli jest ustawiony, określa, jak należy używać właściwości jako operatora wyszukiwania. |
HtmlPropertyOptions.HtmlOperatorOptions
Służy do udostępniania operatora wyszukiwania właściwości HTML. Jest to opcjonalne. Operatory query.search pozwalają użytkownikom ograniczyć zapytanie do określonych pól związanych z typem przeszukiwanego elementu.
Zapis JSON |
---|
{ "operatorName": string } |
Pola | |
---|---|
operatorName |
Wskazuje nazwę operatora wymaganą w zapytaniu w celu wyodrębnienia właściwości HTML. Jeśli na przykład operatorNameName to subject, a nazwa właściwości to subjectLine, zapytania w rodzaju subject:<value> wyświetlą wyniki tylko wtedy, gdy wartość właściwości o nazwie subjectLine będzie zgodna z wartością <value>. Natomiast wyszukiwanie wykorzystujące ten sam element <value> bez operatora zwraca wszystkie elementy, w których element <value> odpowiada wartości dowolnej właściwości HTML lub tekstu w polu treści. 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 |
Przyjazna dla użytkownika etykieta dla właściwości używanej, jeśli właściwość została określona do wyświetlenia w obiekcie ObjectDisplayOptions. Jeśli właściwość została podana, etykieta wyświetlana jest widoczna przed wartościami właściwości, gdy właściwość wchodzi w skład opcji wyświetlania obiektu. Jeśli np. wartość właściwości to „1”, sama wartość może nie być przydatnym kontekstem dla użytkownika. Jeśli nadano wyświetlaną nazwę typu „Priority”, użytkownik widzi w wynikach wyszukiwania pozycję „Priorytet : 1”, co zapewnia użytkownikom wyszukującym jasny kontekst. Jest to wartość OPCJONALNA. Jeśli jej nie podasz, wyświetlane będą tylko wartości właściwości. Maksymalna długość to 64 znaki. |