A classe SearchResults
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
A classe SearchResults representa o resultado da execução de uma solicitação de pesquisa que usa Index.search().
SearchResults é definido no módulo google.appengine.api.search.
Construtor
O construtor da classe SearchResults é definido da seguinte maneira:
-
class SearchResults(number_found, results=None, cursor=None)
Solicite ao serviço de pesquisa para consultar um índice, especificando parâmetros para essa consulta.
Argumentos
- number_found
O número de documentos encontrados para a consulta.
- results
A lista de objetos ScoredDocument retornados da execução de uma solicitação de pesquisa.
- cursor
Um objeto Cursor que permite continuar a pesquisa a partir do final dos resultados da pesquisa atuais.
Valor do resultado
Uma nova instância da classe SearchRequest que representa os resultados da execução de Index.search().
Exceções
- TypeError
Se algum dos parâmetros tiver um tipo inválido ou um atributo desconhecido for passado.
- ValueError
Se algum parâmetro tiver um valor inválido.
Propriedades
Uma instância da classe SearchResults tem as seguintes propriedades:
- results
Retorna a lista de objetos ScoredDocument que correspondem à consulta.
- number_found
Retorna um número aproximado de documentos correspondentes à consulta. QueryOptions definindo o pós-processamento dos resultados da pesquisa. Se o parâmetro QueryOptions.number_found_accuracy tiver sido definido como 100, então number_found <= 100 é preciso.
- cursor
- Para que esse campo seja preenchido, você precisa transmitir um cursor em QueryOptions
da pesquisa. Do contrário, ele será 'None". Retorna um Cursor de resultado que pode ser usado para continuar a pesquisa a partir do último resultado. Se
não houver mais resultados depois do resultado atual, retornará "None".
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-31 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-31 UTC."],[[["\u003cp\u003e\u003ccode\u003eSearchResults\u003c/code\u003e represents the outcome of a search request made using \u003ccode\u003eIndex.search()\u003c/code\u003e and is found within the \u003ccode\u003egoogle.appengine.api.search\u003c/code\u003e module.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eSearchResults\u003c/code\u003e constructor takes parameters such as \u003ccode\u003enumber_found\u003c/code\u003e, \u003ccode\u003eresults\u003c/code\u003e (a list of \u003ccode\u003eScoredDocument\u003c/code\u003e objects), and \u003ccode\u003ecursor\u003c/code\u003e to manage search results and pagination.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eresults\u003c/code\u003e property of \u003ccode\u003eSearchResults\u003c/code\u003e provides a list of \u003ccode\u003eScoredDocument\u003c/code\u003e objects that match the search query.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003enumber_found\u003c/code\u003e property offers an approximate count of documents that match the query, with accuracy influenced by the \u003ccode\u003eQueryOptions.number_found_accuracy\u003c/code\u003e parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ecursor\u003c/code\u003e property can be used to continue a search from where the last result left off if a cursor is included in the search's \u003ccode\u003eQueryOptions\u003c/code\u003e, otherwise it will be None.\u003c/p\u003e\n"]]],[],null,["# The SearchResults Class\n\nClass `SearchResults` represents the result of executing a search request using [Index.search()](/appengine/docs/legacy/standard/python/search/indexclass).\n| This API is supported for first-generation runtimes and can be used when [upgrading to corresponding second-generation runtimes](/appengine/docs/standard/\n| python3\n|\n| /services/access). If you are updating to the App Engine Python 3 runtime, refer to the [migration guide](/appengine/migration-center/standard/migrate-to-second-gen/python-differences) to learn about your migration options for legacy bundled services.\n\n`SearchResults` is defined in the `google.appengine.api.search` module.\n\nConstructor\n-----------\n\nThe constructor for class `SearchResults` is defined as follows:\n\n\nclass SearchResults(number_found, results=None, cursor=None)\n\n:\n\n Request the search service to query an index, specifying parameters for that query..\n\n \u003cbr /\u003e\n\n:\n\n Arguments\n\n number_found\n\n : The number of documents found for the query.\n\n results\n\n : The list of [ScoredDocument](/appengine/docs/legacy/standard/python/search/scoreddocumentclass) objects returned from executing a search request.\n\n cursor\n\n : A [Cursor](/appengine/docs/legacy/standard/python/search/cursorclass) object allowing you to continue the search from the end of the current search results.\n\n Result value\n\n : A new instance of class `SearchRequest` representing the results of executing [Index.search()](/appengine/docs/legacy/standard/python/search/indexclass).\n\n Exceptions\n\n TypeError\n\n : If any of the parameters have an invalid type, or an unknown attribute is passed.\n\n ValueError\n\n : If any parameter has an invalid value.\n\n \u003cbr /\u003e\n\nProperties\n----------\n\nAn instance of class `SearchResults` has the following properties:\n\nresults\n\n: Returns the list of [ScoredDocument](/appengine/docs/legacy/standard/python/search/scoreddocumentclass) objects matching the query.\n\nnumber_found\n\n: Returns an approximate number of documents matching the query. [QueryOptions](/appengine/docs/legacy/standard/python/search/queryoptionsclass) defining post-processing of the search results. If the `QueryOptions.number_found_accuracy` parameter were set to 100, then `number_found` \\\u003c= 100 is accurate.\n\ncursor\n: For this field to be populated, you must pass a cursor in the search's [QueryOptions](/appengine/docs/legacy/standard/python/search/queryoptionsclass),\n otherwise this will be None. Returns a results [Cursor](/appengine/docs/legacy/standard/python/search/cursorclass) that can be used to continue the search from the last result. If\n there are no more results after the current result, returns None."]]
