Clases Facet

La clase Facet es una clase básica y abstracta que representa una faceta de un documento. No se debe crear directamente una instancia de esta clase.

Precaución: **Esta solución ya no se recomienda:** Las apps que usan esta API solo pueden ejecutarse en el entorno de ejecución de Python 2 y deberán actualizarse a una [solución recomendada](/appengine/docs/standard/python/migrate-to-python3/migrating-services#migration_paths_for_bundled_services) antes de migrar al entorno de ejecución de Python 3.

Facet se define en el módulo google.appengine.api.search.

Propiedades

Una instancia de la clase Facet tiene las siguientes propiedades:

name

El nombre de la faceta. Los nombres de las facetas deben tener una longitud máxima MAXIMUM_FIELD_NAME_LENGTH y un patrón que coincida "[A-Za-z][A-Za-z0-9_]*".

value

El valor de la faceta, que puede ser un str, un unicode o un número.

Subclases

La clase Facet tiene las siguientes subclases:

clase AtomFacet

Una faceta con contenido que debe tratarse como un token único para indexar.

El valor de la faceta es un objeto str o unicode que debe tratarse como un valor de texto indivisible. En el siguiente ejemplo, se muestra una faceta de Atom llamada wine_type:

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

Excepciones

TypeError

El valor proporcionado no es una string de texto.

ValueError

El valor excede la longitud máxima permitida.

clase NumberFacet

Una faceta que tiene un valor numérico.

En el siguiente ejemplo, se observa una faceta numérica llamada wine_vintage:

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

Excepciones

TypeError

El valor proporcionado no es numérico.

ValueError

El valor está fuera del rango.