Schema

데이터 소스의 스키마 정의입니다.

JSON 표현
{
  "objectDefinitions": [
    {
      object (ObjectDefinition)
    }
  ],
  "operationIds": [
    string
  ]
}
필드
objectDefinitions[]

object (ObjectDefinition)

데이터 소스의 최상위 객체 목록입니다. 최대 요소 수는 10개입니다.

operationIds[]

string

현재 이 스키마에 대해 실행 중인 장기 실행 작업 (LRO)의 ID입니다. 스키마를 수정한 후 작업이 완료될 때까지 기다렸다가 추가 콘텐츠의 색인을 생성합니다.

ObjectDefinition

데이터 소스 내 객체에 대한 정의입니다.

JSON 표현
{
  "name": string,
  "options": {
    object (ObjectOptions)
  },
  "propertyDefinitions": [
    {
      object (PropertyDefinition)
    }
  ]
}
필드
name

string

객체의 이름으로, 객체의 유형을 정의합니다. 항목 색인 생성 요청은 objectType 필드를 이 값과 동일하게 설정해야 합니다. 예를 들어 이름문서인 경우 문서 유형 항목에 대한 색인 생성 요청은 objectType문서와 같게 설정해야 합니다. 각 객체 정의는 스키마 내에서 고유한 이름을 지정해야 합니다. 이름은 문자로 시작해야 하며 문자 (A~Z, a~z) 또는 숫자 (0~9)만 포함할 수 있습니다. 최대 길이는 256자(영문 기준)입니다.

options

object (ObjectOptions)

선택적 객체별 옵션입니다.

propertyDefinitions[]

object (PropertyDefinition)

객체의 속성 정의입니다. 최대 요소 수는 1,000개입니다.

ObjectOptions

객체의 옵션입니다.

JSON 표현
{
  "freshnessOptions": {
    object (ObjectOptions.FreshnessOptions)
  },
  "displayOptions": {
    object (ObjectDisplayOptions)
  },
  "suggestionFilteringOperators": [
    string
  ]
}
필드
freshnessOptions

object (ObjectOptions.FreshnessOptions)

객체의 최신성 옵션입니다.

displayOptions

object (ObjectDisplayOptions)

객체가 Cloud Search 결과 페이지에 표시되는 방식을 결정하는 옵션입니다.

suggestionFilteringOperators[]

string

추천을 필터링하는 데 사용할 수 있는 연산자입니다. query.suggest API의 경우 여기에 언급된 연산자만 FilterOptions에 적용됩니다. TEXT 및 ENUM 연산자만 지원됩니다.

참고: 'objecttype', 'type' 'mimetype' 이미 지원되고 있습니다. 이 속성은 스키마별 연산자를 구성하기 위한 것입니다.

배열이지만 연산자는 하나만 지정할 수 있습니다. 이는 향후 확장을 위한 배열입니다.

동일한 객체 내의 여러 속성에 매핑되는 연산자는 지원되지 않습니다. 연산자가 여러 객체 유형에 걸쳐 있는 경우 이 옵션은 객체 정의마다 한 번씩 설정해야 합니다.

ObjectOptions.FreshnessOptions

항목의 검색 순위를 조정할 때 사용할 최신성 속성을 나타냅니다. 최신 날짜일수록 품질이 우수합니다. 데이터에 가장 적합한 최신성 옵션 속성을 사용하세요. 파일 공유 문서의 경우 마지막 수정 시간이 가장 중요합니다. 캘린더 일정 데이터의 경우 이벤트가 발생하는 시간이 더 관련성 높은 최신 상태 표시기입니다. 이렇게 하면 검색어가 검색된 시간에 가까워지면 캘린더 일정이 더 높은 품질로 간주되어 그에 따라 순위가 결정됩니다.

JSON 표현
{
  "freshnessProperty": string,
  "freshnessDuration": string
}
필드
freshnessProperty

string

이 속성은 색인에 있는 객체의 최신성 수준을 나타냅니다. 설정된 경우 이 속성은 property definitions 내의 최상위 속성이어야 하며 timestamp type 또는 date type이어야 합니다. 그렇지 않으면 Indexing API에서 updateTime를 최신 상태 표시기로 사용합니다. 최대 길이는 256자(영문 기준)입니다.

속성을 사용하여 최신성을 계산하는 경우 기본값은 현재 시간으로부터 2년 후입니다.

freshnessDuration

string (Duration format)

이 기간이 지난 후 객체를 비활성 상태로 간주해야 하는 기간입니다. 기본값은 180일 (초)입니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.

ObjectDisplayOptions

객체의 표시 옵션입니다.

JSON 표현
{
  "objectDisplayLabel": string,
  "metalines": [
    {
      object (ObjectDisplayOptions.Metaline)
    }
  ]
}
필드
objectDisplayLabel

string

항목의 유형을 나타내기 위해 검색 결과에 표시할 사용자 친화적인 라벨입니다. 선택사항입니다. 제공되지 않으면 검색 결과의 컨텍스트 행에 객체 라벨이 표시되지 않습니다. 최대 길이는 64자(영문 기준)입니다.

metalines[]

object (ObjectDisplayOptions.Metaline)

검색결과의 메타라인에 표시되는 속성을 정의합니다. 속성 값은 여기에 지정된 순서대로 표시됩니다. 속성에 값이 여러 개 있으면 모든 값이 다음 속성 앞에 표시됩니다. 따라서 이 목록에서 반복되는 속성 앞에 단일 속성을 지정하는 것이 좋습니다. 모든 속성은 isReturnable을 true로 설정해야 합니다. 메타라인은 최대 3개입니다.

ObjectDisplayOptions.Metaline

메타라인은 컨텍스트를 제공하기 위해 검색 결과와 함께 표시되는 속성 목록입니다.

JSON 표현
{
  "properties": [
    {
      object (ObjectDisplayOptions.DisplayedProperty)
    }
  ]
}
필드
properties[]

object (ObjectDisplayOptions.DisplayedProperty)

메타라인에 대해 표시되는 속성 목록입니다. 최대 속성 수는 5개입니다.

ObjectDisplayOptions.DisplayedProperty

검색결과에 표시되어야 하는 객체 내 최상위 속성에 대한 참조입니다. 선택한 속성의 값이 지정된 경우 해당 속성의 display label 값과 함께 검색 결과에 표시됩니다. 표시 라벨을 지정하지 않으면 값만 표시됩니다.

JSON 표현
{
  "propertyName": string
}
필드
propertyName

string

객체의 속성 정의에 정의된 최상위 속성의 이름입니다. 이름이 스키마에 정의된 속성이 아닌 경우 스키마를 업데이트하려고 하면 오류가 발생합니다.

PropertyDefinition

객체 내 속성의 정의입니다.

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.
}
필드
name

string

속성의 이름입니다. Indexing API로 전송된 항목 색인 생성 요청은 property name를 이 값과 동일하게 설정해야 합니다. 예를 들어 이름이 subject_line인 경우 제목 필드가 있는 문서 항목의 색인 생성 요청은 해당 필드의 namesubject_line과 동일하게 설정해야 합니다. 이름을 객체 속성의 식별자로 사용합니다. 객체의 속성으로 등록한 후에는 해당 객체 내의 다른 속성에 이 이름을 다시 사용할 수 없습니다. 이름은 문자로 시작해야 하며 문자 (A~Z, a~z) 또는 숫자 (0~9)만 포함할 수 있습니다. 최대 길이는 256자(영문 기준)입니다.

isReturnable

boolean

속성이 Query API를 통해 검색 결과에 반환되어야 하는 데이터를 식별함을 나타냅니다. true로 설정되면 Query API 사용자가 결과에서 일치하는 속성 필드를 사용할 수 있음을 나타냅니다. 그러나 필드를 저장하려면 더 많은 공간 할당이 필요하고 검색어에 더 많은 대역폭을 사용하므로 대규모 데이터 세트에 대한 성능에 영향을 미칩니다. 검색 결과에 필드가 필요한 경우에만 true로 설정합니다. 유형이 객체인 속성의 경우 true가 될 수 없습니다.

isRepeatable

boolean

속성에 여러 값이 허용됨을 나타냅니다. 예를 들어 하나의 문서에는 하나의 설명만 있지만 여러 개의 댓글이 있을 수 있습니다. 유형이 부울인 속성의 경우 true가 될 수 없습니다. false로 설정하면 값이 두 개 이상 포함된 속성에 해당 항목의 색인 생성 요청이 거부됩니다.

isSortable

boolean

속성을 정렬에 사용할 수 있음을 나타냅니다. 반복 가능한 속성의 경우 true가 될 수 없습니다. 유형이 객체인 속성의 경우 true가 될 수 없습니다. 이 옵션을 설정하려면 IsReturnable이 true여야 합니다. 부울, 날짜, 실수, 정수 및 타임스탬프 속성에만 지원됩니다.

isFacetable

boolean

패싯 생성에 속성을 사용할 수 있음을 나타냅니다. 유형이 객체인 속성의 경우 true가 될 수 없습니다. 이 옵션을 설정하려면 IsReturnable이 true여야 합니다. 불리언, 열거형, 정수, 텍스트 속성에만 지원됩니다.

isSuggestable

boolean

쿼리 추천을 생성하는 데 속성을 사용할 수 있음을 나타냅니다.

isWildcardSearchable

boolean

사용자가 이 속성에 대해 와일드 카드 검색을 수행할 수 있음을 나타냅니다. 텍스트 속성에만 지원됩니다. 이 옵션을 설정하려면 IsReturnable이 true여야 합니다. 지정된 데이터 소스에서 최대 5개의 속성을 isWildcardSearchable로 표시할 수 있습니다. 자세한 내용은 객체 속성 정의를 참조하세요.

displayOptions

object (PropertyDisplayOptions)

객체의 display options에 표시하도록 지정된 경우 Cloud Search 결과 페이지에 속성이 표시되는 방식을 결정하는 옵션입니다.

통합 필드 property_options. 속성의 색인이 생성되고 사용되는 방식을 결정하는 유형별 옵션입니다. 옵션이 유형의 기본 옵션이어야 하는 경우에도 이 필드는 유형 중 하나로 설정되어야 합니다. 이 필드를 설정하지 않으면 스키마 업데이트가 거부됩니다. property_options은 다음 중 하나여야 합니다.
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

정수 속성의 옵션입니다.

JSON 표현
{
  "orderedRanking": enum (IntegerPropertyOptions.OrderedRanking),
  "minimumValue": string,
  "maximumValue": string,
  "operatorOptions": {
    object (IntegerPropertyOptions.IntegerOperatorOptions)
  },
  "integerFacetingOptions": {
    object (IntegerFacetingOptions)
  }
}
필드
orderedRanking

enum (IntegerPropertyOptions.OrderedRanking)

정수의 순서 순위를 지정하는 데 사용됩니다. isRepeatable가 false인 경우에만 사용할 수 있습니다.

minimumValue

string (Int64Value format)

속성의 최솟값입니다. 속성의 최솟값과 최댓값은 ordered ranking에 따라 결과의 순위를 매기는 데 사용됩니다. 값이 최솟값보다 작은 색인 생성 요청은 허용되며 최솟값으로 색인이 생성된 항목과 동일한 가중치로 순위가 매겨집니다.

maximumValue

string (Int64Value format)

속성의 최댓값입니다. 속성의 최솟값과 최댓값은 ordered ranking에 따라 결과의 순위를 매기는 데 사용됩니다. 값이 최댓값보다 큰 색인 생성 요청은 허용되며 최댓값으로 색인이 생성된 항목과 동일한 가중치로 순위가 매겨집니다.

operatorOptions

object (IntegerPropertyOptions.IntegerOperatorOptions)

설정하는 경우 정수가 검색 연산자로 사용되는 방법을 설명합니다.

integerFacetingOptions

object (IntegerFacetingOptions)

설정하는 경우 지정된 정수 속성의 정수 패싯 생성 옵션을 설명합니다. 해당하는 정수 속성이 isFacetable로 표시되어야 합니다.

IntegerPropertyOptions.OrderedRanking

다른 값과 비교하여 정수 값의 순위를 지정하는 방법을 지정하는 데 사용됩니다. 순위가 높은 정수일수록 중요도가 더 높습니다. 예를 들어 일부 데이터 소스에서 우선순위가 낮을수록 중요도가 높다는 것을 의미하고, 다른 데이터 소스에서 우선순위가 높을수록 중요도가 더 있음을 나타냅니다.

열거형
NO_ORDER 속성에는 순위가 없습니다. 결과는 이 속성의 값으로 조정되지 않습니다.
ASCENDING 이 속성의 순위는 오름차순으로 매겨집니다. 값이 작을수록 순위가 낮습니다.
DESCENDING 이 숙박 시설의 순위는 내림차순으로 매겨집니다. 값이 작을수록 순위가 더 높습니다.

IntegerPropertyOptions.IntegerOperatorOptions

정수 속성에 대한 검색 연산자를 제공하는 데 사용됩니다. 이는 선택사항입니다. query.search 연산자를 사용하면 사용자가 검색되는 항목 유형과 관련된 특정 필드로 검색어를 제한할 수 있습니다.

JSON 표현
{
  "operatorName": string,
  "lessThanOperatorName": string,
  "greaterThanOperatorName": string
}
필드
operatorName

string

정수 속성을 분리하기 위해 쿼리에 필요한 연산자 이름을 나타냅니다. 예를 들어 연산자 이름이 priority이고 속성 이름이 priorityVal인 경우 priority:<value>와 같은 쿼리는 priorityVal이라는 속성 값이 <value>와 일치하는 경우에만 결과를 표시합니다. 반대로 연산자 없이 동일한 &lt;value&gt;를 사용하는 검색은 &lt;value&gt;가 항목의 콘텐츠 입력란에 있는 문자열 속성 또는 텍스트의 값과 일치하는 모든 항목을 반환합니다. 연산자 이름에는 소문자 (a~z)만 포함할 수 있습니다. 최대 길이는 32자(영문 기준)입니다.

lessThanOperatorName

string

보다 작음 연산자를 사용하여 정수 속성을 분리하기 위해 쿼리에 필요한 연산자 이름을 나타냅니다. 예를 들어 lessThanOperatorName이 priority below이고 속성 이름이 priorityVal인 경우 priority below:<value>와 같은 쿼리는 priorityVal이라는 속성 값이 <value>보다 작은 경우에만 결과를 표시합니다. 연산자 이름에는 소문자 (a~z)만 포함할 수 있습니다. 최대 길이는 32자(영문 기준)입니다.

greaterThanOperatorName

string

보다 큼 연산자를 사용하여 정수 속성을 분리하기 위해 쿼리에 필요한 연산자 이름을 나타냅니다. 예를 들어 largeThanOperatorName이 priority above이고 속성 이름이 priorityVal인 경우 priority above:<value>와 같은 쿼리는 priorityVal이라는 속성의 값이 <value>보다 큰 경우에만 결과를 표시합니다. 연산자 이름에는 소문자 (a~z)만 포함할 수 있습니다. 최대 길이는 32자(영문 기준)입니다.

DoublePropertyOptions

double 속성의 옵션입니다.

JSON 표현
{
  "operatorOptions": {
    object (DoublePropertyOptions.DoubleOperatorOptions)
  }
}
필드
operatorOptions

object (DoublePropertyOptions.DoubleOperatorOptions)

설정하는 경우 double이 검색 연산자로 사용되는 방법을 설명합니다.

DoublePropertyOptions.DoubleOperatorOptions

double 속성의 검색 연산자를 제공하는 데 사용됩니다. 이는 선택사항입니다. query.search 연산자를 사용하면 사용자가 검색되는 항목 유형과 관련된 특정 필드로 검색어를 제한할 수 있습니다.

JSON 표현
{
  "operatorName": string
}
필드
operatorName

string

정렬이나 패싯으로 double 속성을 사용하기 위해 쿼리에 필요한 연산자 이름을 나타냅니다. 연산자 이름에는 소문자 (a~z)만 포함할 수 있습니다. 최대 길이는 32자(영문 기준)입니다.

TimestampPropertyOptions

타임스탬프 속성의 옵션입니다.

JSON 표현
{
  "operatorOptions": {
    object (TimestampPropertyOptions.TimestampOperatorOptions)
  }
}
필드
operatorOptions

object (TimestampPropertyOptions.TimestampOperatorOptions)

설정하는 경우 타임스탬프가 검색 연산자로 사용되는 방식을 설명합니다.

TimestampPropertyOptions.TimestampOperatorOptions

타임스탬프 속성에 대한 검색 연산자를 제공하는 데 사용됩니다. 이는 선택사항입니다. query.search 연산자를 사용하면 사용자가 검색되는 항목 유형과 관련된 특정 필드로 검색어를 제한할 수 있습니다.

JSON 표현
{
  "operatorName": string,
  "lessThanOperatorName": string,
  "greaterThanOperatorName": string
}
필드
operatorName

string

타임스탬프 속성을 격리하기 위해 쿼리에 필요한 연산자 이름을 나타냅니다. 예를 들어 연산자 이름이 closedon이고 속성 이름이 closeDate인 경우 closedon:<value>와 같은 검색어는 closeDate라는 속성 값이 <value>와 일치하는 경우에만 결과를 표시합니다. 반대로 연산자 없이 동일한 &lt;value&gt;를 사용하는 검색은 &lt;value&gt;가 항목의 콘텐츠 입력란에 있는 문자열 속성 또는 텍스트의 값과 일치하는 모든 항목을 반환합니다. 연산자 이름에는 소문자 (a~z)만 포함할 수 있습니다. 최대 길이는 32자(영문 기준)입니다.

lessThanOperatorName

string

보다 작음 연산자를 사용하여 타임스탬프 속성을 격리하기 위해 쿼리에 필요한 연산자 이름을 나타냅니다. 예를 들어 lessThanOperatorName이 closedbefore이고 속성 이름이 closeDate인 경우 closedbefore:<value>와 같은 쿼리는 closeDate라는 속성 값이 <value>보다 이전인 경우에만 결과를 표시합니다. 연산자 이름에는 소문자 (a~z)만 포함할 수 있습니다. 최대 길이는 32자(영문 기준)입니다.

greaterThanOperatorName

string

보다 큼 연산자를 사용하여 타임스탬프 속성을 분리하기 위해 쿼리에 필요한 연산자 이름을 나타냅니다. 예를 들어 largeThanOperatorName이 closedafter이고 속성 이름이 closeDate인 경우 closedafter:<value>와 같은 쿼리는 이름이 closeDate인 속성의 값이 <value>보다 이후인 결과를 표시합니다. 연산자 이름에는 소문자 (a~z)만 포함할 수 있습니다. 최대 길이는 32자(영문 기준)입니다.

BooleanPropertyOptions

불리언 속성의 옵션입니다.

JSON 표현
{
  "operatorOptions": {
    object (BooleanPropertyOptions.BooleanOperatorOptions)
  }
}
필드
operatorOptions

object (BooleanPropertyOptions.BooleanOperatorOptions)

설정하는 경우 부울을 검색 연산자로 사용하는 방법을 설명합니다.

BooleanPropertyOptions.BooleanOperatorOptions

부울 속성에 대한 검색 연산자를 제공하는 데 사용됩니다. 이는 선택사항입니다. query.search 연산자를 사용하면 사용자가 검색되는 항목 유형과 관련된 특정 필드로 검색어를 제한할 수 있습니다.

JSON 표현
{
  "operatorName": string
}
필드
operatorName

string

부울 속성을 분리하기 위해 쿼리에 필요한 연산자 이름을 나타냅니다. 예를 들어 연산자 이름이 closed이고 속성 이름이 isClosed인 경우 closed:<value>와 같은 쿼리는 isClosed라는 속성의 값이 <value>과 일치하는 경우에만 결과를 표시합니다. 반대로 연산자 없이 동일한 &lt;value&gt;를 사용하는 검색은 &lt;value&gt;가 항목의 콘텐츠 입력란에 있는 문자열 속성 또는 텍스트의 값과 일치하는 모든 항목을 반환합니다. 연산자 이름에는 소문자 (a~z)만 포함할 수 있습니다. 최대 길이는 32자(영문 기준)입니다.

ObjectPropertyOptions

객체 속성의 옵션입니다.

JSON 표현
{
  "subobjectProperties": [
    {
      object (PropertyDefinition)
    }
  ]
}
필드
subobjectProperties[]

object (PropertyDefinition)

하위 객체의 속성입니다. 이러한 속성은 중첩된 객체를 나타냅니다. 예를 들어 이 속성이 우편 주소를 나타내는 경우 subobjectProperties의 이름은 street, citystate일 수 있습니다. 최대 요소 수는 1,000개입니다.

EnumPropertyOptions

enum 속성 옵션을 사용하면 사용자 쿼리와 일치하는 제한된 문자열 집합을 정의하고, 해당 문자열 값의 순위를 설정하고, 해당 문자열과 쌍을 이룰 연산자 이름을 정의하여 사용자가 특정 값을 가진 항목으로만 검색 결과를 좁힐 수 있습니다. 예를 들어 우선순위 정보가 있는 요청 추적 시스템의 항목의 경우 p0을 허용 가능한 enum 값으로 정의하고 이 enum을 연산자 이름 priority에 연결하여 검색 사용자가 priority:p0을 쿼리에 추가하여 결과 집합을 p0 값으로 색인이 생성된 항목으로만 제한할 수 있도록 할 수 있습니다.

JSON 표현
{
  "possibleValues": [
    {
      object (EnumPropertyOptions.EnumValuePair)
    }
  ],
  "orderedRanking": enum (EnumPropertyOptions.OrderedRanking),
  "operatorOptions": {
    object (EnumPropertyOptions.EnumOperatorOptions)
  }
}
필드
possibleValues[]

object (EnumPropertyOptions.EnumValuePair)

열거형 속성에 사용할 수 있는 값의 목록입니다. 모든 EnumValuePairs는 문자열 값을 제공해야 합니다. 하나의 EnumValuePair에 정수 값을 지정하는 경우, 가능한 모든 EnumValuePairs가 정수 값을 제공해야 합니다. 문자열 값과 정수 값은 가능한 모든 값에서 고유해야 합니다. 설정한 후에는 가능한 값을 삭제하거나 수정할 수 없습니다. 순서가 지정된 순위를 제공하고 향후 추가 enum 값을 삽입할 수도 있다고 생각되면 이전에 등록된 값 사이에 값을 추가할 수 있도록 초기 정수 값에 공백을 둡니다. 최대 요소 수는 100개입니다.

orderedRanking

enum (EnumPropertyOptions.OrderedRanking)

가능한 EnumValuePairs에서 제공되는 정수 값을 사용하여 결과의 순위를 지정하는 방법을 결정하는 열거형의 순서 순위를 지정하는 데 사용됩니다. 지정된 경우 이 속성에 지정된 가능한 모든 EnumValuePair 값에 정수 값을 제공해야 합니다. isRepeatable가 false인 경우에만 사용할 수 있습니다.

operatorOptions

object (EnumPropertyOptions.EnumOperatorOptions)

설정하는 경우 enum을 검색 연산자로 사용하는 방법을 설명합니다.

EnumPropertyOptions.EnumValuePair

열거형 값 쌍은 두 가지, 즉 필수 문자열 값과 선택적 정수 값을 정의합니다. 문자열 값은 해당 항목을 검색하는 데 필요한 검색어를 정의합니다(예: 우선순위 항목의 경우 p0). 정수 값은 동일한 속성의 다른 열거형 값과 비교한 해당 문자열 값의 순위를 결정합니다. 예를 들어 p00과 연결하고 다른 enum 쌍(예: p11)을 정의할 수 있습니다. 동일한 속성 이름에 대해 열거된 다른 값을 기준으로 특정 값의 순위를 설정하려면 정수 값을 ordered ranking와 함께 사용해야 합니다. 여기에서 priority 속성의 순위 순서가 DESCENDING이면 p1 값으로 색인이 생성된 항목에 비해 p0 값으로 색인이 생성된 항목의 순위가 상승합니다. 순위 지정 순서를 지정하지 않으면 정수 값은 항목 순위에 영향을 주지 않습니다.

JSON 표현
{
  "stringValue": string,
  "integerValue": integer
}
필드
stringValue

string

EnumValuePair의 문자열 값입니다. 최대 길이는 32자(영문 기준)입니다.

integerValue

integer

EnumValuePair의 정수 값으로, 음수가 아니어야 합니다. 선택사항입니다.

EnumPropertyOptions.OrderedRanking

다른 EnumValuePair 정수 값에 상대적인 EnumValuePair 정수의 순위 방향을 지정하는 데 사용됩니다. 일부 속성의 경우 정수 값이 작을수록 중요도가 높음을 나타내고, 다른 속성의 경우 정수 값이 클수록 중요도가 더 있음을 나타냅니다.

열거형
NO_ORDER 속성에는 순위가 없습니다. 결과는 이 속성의 값으로 조정되지 않습니다.
ASCENDING 이 속성의 순위는 오름차순으로 매겨집니다. 값이 작을수록 순위가 낮습니다.
DESCENDING 이 숙박 시설의 순위는 내림차순으로 매겨집니다. 값이 작을수록 순위가 더 높습니다.

EnumPropertyOptions.EnumOperatorOptions

enum 속성에 대한 검색 연산자를 제공하는 데 사용됩니다. 이는 선택사항입니다. query.search 연산자를 사용하면 사용자가 검색되는 항목 유형과 관련된 특정 필드로 검색어를 제한할 수 있습니다. 예를 들어 가능한 값이 p0p1Priority enum 속성에 연산자를 제공하지 않는 경우, 검색어 p0이 포함된 쿼리는 priority 속성의 값으로 p0을 포함하는 항목뿐 아니라 다른 필드에 문자열 p0이 포함된 모든 항목을 반환합니다. enum에 연산자 이름(예: priority)을 제공하는 경우 검색 사용자는 해당 연산자를 사용하여 이 속성의 값이 p0인 항목으로만 검색 결과를 세분화할 수 있습니다(검색어 priority:p0).

JSON 표현
{
  "operatorName": string
}
필드
operatorName

string

enum 속성을 격리하기 위해 쿼리에 필요한 연산자 이름을 나타냅니다. 예를 들어 연산자 이름이 priority이고 속성 이름이 priorityVal인 경우 priority:<value>와 같은 쿼리는 priorityVal이라는 속성 값이 <value>와 일치하는 경우에만 결과를 표시합니다. 반대로 연산자 없이 동일한 &lt;value&gt;를 사용하는 검색은 &lt;value&gt;가 항목의 콘텐츠 입력란에 있는 문자열 속성 또는 텍스트의 값과 일치하는 모든 항목을 반환합니다. 연산자 이름에는 소문자 (a~z)만 포함할 수 있습니다. 최대 길이는 32자(영문 기준)입니다.

DatePropertyOptions

날짜 속성의 옵션입니다.

JSON 표현
{
  "operatorOptions": {
    object (DatePropertyOptions.DateOperatorOptions)
  }
}
필드
operatorOptions

object (DatePropertyOptions.DateOperatorOptions)

설정하는 경우 날짜를 검색 연산자로 사용하는 방법을 설명합니다.

DatePropertyOptions.DateOperatorOptions

선택사항입니다. 날짜 속성에 대한 검색 연산자를 제공합니다. query.search 연산자를 사용하면 사용자가 검색되는 항목 유형과 관련된 특정 필드로 검색어를 제한할 수 있습니다.

JSON 표현
{
  "operatorName": string,
  "lessThanOperatorName": string,
  "greaterThanOperatorName": string
}
필드
operatorName

string

날짜 속성을 분리하기 위해 쿼리에 필요한 실제 문자열을 나타냅니다. 예를 들어 문제 추적 스키마 객체에 closeDate라는 속성이 있으며, 이 속성은 closedon의 workerName을 사용하여 연산자를 지정한다고 가정해 보겠습니다. 해당 데이터에 대한 검색에서 closedon:&lt;value&gt;과 같은 검색어를 사용하면 closedon:&lt;value&gt; 속성의 값이 closedon:&lt;value&gt;와 일치하는 결과만 표시됩니다. 반대로 연산자 없이 동일한 &lt;value&gt;를 사용하는 검색은 &lt;value&gt;가 색인이 생성된 데이터 소스의 콘텐츠 필드 내 문자열 속성 또는 텍스트 값과 일치하는 모든 항목을 반환합니다. 연산자 이름에는 소문자 (a~z)만 포함할 수 있습니다. 최대 길이는 32자(영문 기준)입니다.

lessThanOperatorName

string

보다 작음 연산자를 사용하여 날짜 속성을 격리하기 위해 쿼리에 필요한 연산자 이름을 나타냅니다. 예를 들어 lessThanOperatorName이 closedbefore이고 속성 이름이 closeDate인 경우 closedbefore:<value>와 같은 쿼리는 closeDate라는 속성 값이 <value>보다 이전인 경우에만 결과를 표시합니다. 연산자 이름에는 소문자 (a~z)만 포함할 수 있습니다. 최대 길이는 32자(영문 기준)입니다.

greaterThanOperatorName

string

보다 큼 연산자를 사용하여 날짜 속성을 분리하기 위해 쿼리에 필요한 연산자 이름을 나타냅니다. 예를 들어 largeThanOperatorName이 closedafter이고 속성 이름이 closeDate인 경우 closedafter:<value>와 같은 쿼리는 이름이 closeDate인 속성의 값이 <value>보다 이후인 결과를 표시합니다. 연산자 이름에는 소문자 (a~z)만 포함할 수 있습니다. 최대 길이는 32자(영문 기준)입니다.

TextPropertyOptions

텍스트 속성 옵션입니다.

JSON 표현
{
  "retrievalImportance": {
    object (RetrievalImportance)
  },
  "operatorOptions": {
    object (TextPropertyOptions.TextOperatorOptions)
  }
}
필드
retrievalImportance

object (RetrievalImportance)

검색에 사용되었을 때 필드 내 토큰의 검색 품질 중요도를 나타냅니다.

operatorOptions

object (TextPropertyOptions.TextOperatorOptions)

설정하는 경우 속성이 검색 연산자로 사용되는 방식을 설명합니다.

RetrievalImportance

JSON 표현
{
  "importance": enum (RetrievalImportance.Importance)
}
필드
importance

enum (RetrievalImportance.Importance)

검색 중에 속성이 일치될 때 속성에 부여되는 순위 중요도를 나타냅니다. 설정된 후에는 속성의 토큰 중요도를 변경할 수 없습니다.

RetrievalImportance.Importance

열거형
DEFAULT 본문 텍스트 일치처럼 일치를 처리합니다.
HIGHEST 항목의 타이틀과 일치하는 것으로 취급합니다.
HIGH 일치 항목을 본문 텍스트보다 더 높은 중요도로 처리합니다.
LOW 일치는 본문 텍스트보다 낮은 중요도로 처리합니다.
NONE 검색 시 이 필드와 일치하지 않습니다. 이 속성은 연산자 일치, 패싯 생성, 원하는 경우 제안에 계속 사용할 수 있습니다.

TextPropertyOptions.TextOperatorOptions

텍스트 속성에 대한 검색 연산자를 제공하는 데 사용됩니다. 이는 선택사항입니다. query.search 연산자를 사용하면 사용자가 검색되는 항목 유형과 관련된 특정 필드로 검색어를 제한할 수 있습니다.

JSON 표현
{
  "operatorName": string,
  "exactMatchWithOperator": boolean
}
필드
operatorName

string

텍스트 속성을 분리하기 위해 쿼리에 필요한 연산자 이름을 나타냅니다. 예를 들어 연산자 이름이 subject이고 속성 이름이 subjectLine인 경우 subject:<value>와 같은 쿼리는 subjectLine이라는 속성의 값이 <value>과 일치하는 경우에만 결과를 표시합니다. 반대로 연산자 없이 동일한 &lt;value&gt;를 사용하는 검색은 &lt;value&gt;가 항목의 콘텐츠 입력란에 있는 텍스트 속성 또는 텍스트의 값과 일치하는 모든 항목을 반환합니다. 연산자 이름에는 소문자 (a~z)만 포함할 수 있습니다. 최대 길이는 32자(영문 기준)입니다.

exactMatchWithOperator

boolean

true인 경우 텍스트 값은 연산자 검색 및 패싯 일치 항목에서 하나의 원자 값으로 토큰화됩니다. 예를 들어 연산자 이름이 'genre'인 경우 값은 'SF' 쿼리 제한 'genre:science' 및 'genre:physical' 아이템과 일치하지 않습니다. 'genre:science- 관리' 합니다. 텍스트 값 일치는 대소문자를 구분하며 특수문자를 삭제하지 않습니다. false인 경우 텍스트가 토큰화됩니다. 예를 들어 값이 'science- 부여'인 경우 'genre:science' 쿼리 및 'genre:physical' 일치하는 항목을 찾습니다.

HtmlPropertyOptions

HTML 속성의 옵션입니다.

JSON 표현
{
  "retrievalImportance": {
    object (RetrievalImportance)
  },
  "operatorOptions": {
    object (HtmlPropertyOptions.HtmlOperatorOptions)
  }
}
필드
retrievalImportance

object (RetrievalImportance)

검색에 사용되었을 때 필드 내 토큰의 검색 품질 중요도를 나타냅니다. DEFAULT 또는 NONE으로만 설정할 수 있습니다.

operatorOptions

object (HtmlPropertyOptions.HtmlOperatorOptions)

설정하는 경우 속성이 검색 연산자로 사용되는 방식을 설명합니다.

HtmlPropertyOptions.HtmlOperatorOptions

HTML 속성에 대한 검색 연산자를 제공하는 데 사용됩니다. 이는 선택사항입니다. query.search 연산자를 사용하면 사용자가 검색되는 항목 유형과 관련된 특정 필드로 검색어를 제한할 수 있습니다.

JSON 표현
{
  "operatorName": string
}
필드
operatorName

string

html 속성을 분리하기 위해 쿼리에 필요한 연산자 이름을 나타냅니다. 예를 들어 연산자 이름이 subject이고 속성 이름이 subjectLine인 경우 subject:<value>와 같은 쿼리는 subjectLine이라는 속성의 값이 <value>과 일치하는 경우에만 결과를 표시합니다. 반대로 연산자 없이 동일한 &lt;value&gt;를 사용하는 검색은 &lt;value&gt;가 항목의 콘텐츠 입력란 내에 있는 html 속성 또는 텍스트의 값과 일치하는 모든 항목을 반환합니다. 연산자 이름에는 소문자 (a~z)만 포함할 수 있습니다. 최대 길이는 32자(영문 기준)입니다.

PropertyDisplayOptions

속성의 표시 옵션입니다.

JSON 표현
{
  "displayLabel": string
}
필드
displayLabel

string

ObjectDisplayOptions에 표시되도록 속성이 지정된 경우 사용되는 속성의 사용자 친화적인 라벨입니다. 표시 라벨이 제공되는 경우 속성이 객체 표시 옵션의 일부인 경우 속성 값 앞에 표시됩니다. 예를 들어 속성 값이 '1'인 경우 값 자체는 사용자에게 유용한 컨텍스트가 아닐 수 있습니다. 지정된 표시 이름이 '우선순위'인 경우 사용자에게 '우선순위 : 1'이 표시됩니다. 검색결과는 사용자에게 명확한 맥락을 제공하는 데 도움이 됩니다. 선택사항입니다. 지정하지 않으면 속성 값만 표시됩니다. 최대 길이는 64자(영문 기준)입니다.