FacetRefinement 클래스는 상품 속성값을 기준으로 검색 결과 범위를 좁히는 데 사용됩니다.
속성 상세검색을 사용하는 데 권장되는 방법은 토큰 문자열을 사용하는 것입니다. 각 FacetResult는 이 클래스 대신 허용되는 토큰을 갖습니다. 이 클래스의 인스턴스를 SearchOptions에 전달하면 수동 FacetRefinement를 제공할 수 있습니다.
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이 잘못된 경우입니다.