참고: Python 2.7은 2024년 1월 31일 지원 종료됩니다. 기존 Python 2.7 애플리케이션을 계속 실행하고 트래픽을 받을 수 있습니다. 그러나 지원 종료 날짜 이후에는 해당 런타임을 사용하는 애플리케이션의 재배포를 App Engine에서 차단할 수 있습니다. 지원되는 최신 Python 버전으로 마이그레이션하는 것이 좋습니다.

SearchResults 클래스

SearchResults 클래스는 Index.search()를 사용하여 검색 요청 실행 결과를 제공합니다.

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

생성자

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

class SearchResults(number_found, results=None, cursor=None)

해당 쿼리의 매개변수를 지정하여 검색 서비스가 색인을 쿼리하도록 요청합니다.

인수

number_found: 쿼리로 찾은 문서 수입니다.
결과: 검색 요청을 실행하여 반환된 ScoredDocument 객체 목록입니다.
cursor: 현재 검색 결과의 끝에서 계속 검색을 수행할 수 있게 해주는 Cursor 객체입니다.

결과 값

Index.search() 실행 결과를 나타내는 SearchRequest 클래스의 새 인스턴스입니다.

예외

TypeError: 매개변수에 잘못된 유형이 있거나 알 수 없는 속성이 전달된 경우 발생합니다.
ValueError: 매개변수에 잘못된 값이 있는 경우 발생합니다.

속성

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

결과: 쿼리와 일치하는 ScoredDocument 객체 목록을 반환합니다.
number_found: 쿼리와 일치하는 대략적인 문서 개수를 반환합니다. QueryOptions는 검색 결과의 후처리를 정의합니다. QueryOptions.number_found_accuracy 매개변수가 100으로 설정된 경우 100보다 작거나 같은 number_found가 정확합니다.
cursor: 이 필드를 채우려면 검색의 QueryOptions에 커서를 전달해야 합니다. 그렇지 않으면 None이 됩니다. 마지막 결과에서 검색을 계속하기 위해 사용할 수 있는 결과 Cursor를 반환합니다. 현재 결과 이후 추가 결과가 없으면 None이 반환됩니다.