O Python 2.7 atingiu o fim do suporte e vai ser descontinuado a 31 de janeiro de 2026. Após a descontinuação, não vai poder implementar aplicações Python 2.7, mesmo que a sua organização tenha usado anteriormente uma política organizacional para reativar as implementações de runtimes antigos. As suas aplicações Python 2.7 existentes vão continuar a ser executadas e a receber tráfego após a data de descontinuação. Recomendamos que migre para a versão suportada mais recente do Python.

Esta página foi traduzida pela API Cloud Translation.

Classes de atributos

A classe Facet é uma classe base abstrata que representa uma faceta de um documento. Esta classe não deve ser instanciada diretamente.

Facet está definido no módulo google.appengine.api.search.

Propriedades

Uma instância da classe Facet tem as seguintes propriedades:

name: O nome do aspeto. Os nomes dos aspetos têm de ter um comprimento máximo de MAXIMUM_FIELD_NAME_LENGTH e corresponder ao padrão "[A-Za-z][A-Za- z0-9_]*".
valor: O valor do aspeto, que pode ser uma string, um Unicode ou um número.

Subclasses

A classe Facet tem as seguintes subclasses:

class AtomFacet

Uma faceta que tem conteúdo a ser tratado como um único token para indexação.

O valor do aspeto é um objeto str ou unicode a ser tratado como um valor de texto indivisível. O exemplo seguinte mostra um aspeto atómico denominado wine_type:

AtomFacet(name='wine_type', value='Red')

Exceções

TypeError: O valor fornecido não é uma string de texto.
ValueError: O valor excede o comprimento máximo permitido.

class NumberFacet

Uma faceta com um valor numérico.

O exemplo seguinte mostra uma faceta numérica denominada wine_vintage:

NumberFacet(name='wine_vintage', value=2000)

Exceções

TypeError: O valor fornecido não é numérico.
ValueError: O valor está fora do intervalo.