FacetRefinement 클래스

FacetRefinement 클래스는 상품 속성값을 기준으로 검색 결과 범위를 좁히는 데 사용됩니다.

속성 상세검색을 사용하는 데 권장되는 방법은 토큰 문자열을 사용하는 것입니다. 각 FacetResult는 이 클래스 대신 허용되는 토큰을 갖습니다. 이 클래스의 인스턴스를 SearchOptions에 전달하면 수동 FacetRefinement를 제공할 수 있습니다.

주의: **이 솔루션은 더 이상 권장되지 않습니다.** 이 API를 사용하는 앱은 Python 2 런타임에서만 실행되며 Python 3 런타임으로 마이그레이션하기 전에 [권장 솔루션](/appengine/docs/standard/python/migrate-to-python3/migrating-services#migration_paths_for_bundled_services)으로 업그레이드해야 합니다.

FacetRefinement은 모듈 google.appengine.api.search에 정의됩니다.

생성자

FacetRefinement 클래스의 생성자는 다음과 같이 정의됩니다.

class FacetRefinement(name, value=None, facet_range=None)

FacetRefinement 클래스의 인스턴스를 생성합니다.

참고: value 또는 facet_range 중 하나만 설정해야 합니다.

인수

name

name 속성을 설정합니다.

value

value 속성을 설정합니다.

facet_range

facet_range 속성을 설정합니다.

결과 값

FacetRefinement 클래스의 새 인스턴스입니다.

예외

TypeError

유형이 잘못된 매개변수가 하나라도 있거나 알 수 없는 속성이 전달된 경우에 발생합니다.

ValueError

값이 잘못된 매개변수가 하나라도 있는 경우에 발생합니다.

속성

FacetRefinement 클래스의 인스턴스에는 다음 속성이 있습니다.

name

속성 상세검색의 이름입니다.

value

속성 상세검색의 문자열 값입니다.

range

속성 상세검색의 숫자 범위입니다.

인스턴스 메서드

FacetRefinement 클래스의 인스턴스에는 다음과 같은 메서드가 있습니다.

ToTokenString()

이 상세검색을 HTML에서 안전하게 사용할 수 있는 토큰 문자열로 변환합니다. 이 문자열의 형식을 변경할 수 있습니다.

결과 값

HTML에서 안전하게 사용할 수 있는 이 속성 상세검색의 토큰 문자열입니다.

FromTokenString()

토큰 문자열을 FacetRefinement 객체로 변환하는 정적 메소드입니다. 서로 다른 API 버전 간에 토큰 문자열을 저장하지 마세요. 키가 호환되지 않을 수 있습니다.

인수

token_string

ToTokenString 메소드가 생성했거나 검색결과로 반환된 토큰 문자열입니다.

결과 값

FacetRefinement 객체입니다.

예외

ValueError

token_string이 잘못된 경우입니다.