Facet 类

Facet 类是一个表示文档 Facet 的抽象基类。该类不应直接进行实例化。

注意:**我们不再推荐此解决方案:** 使用此 API 的应用只能在 Python 2 运行时环境中运行,并且必须升级到 [推荐解决方案](/appengine/docs/standard/python/migrate-to-python3/migrating-services#migration_paths_for_bundled_services),然后再迁移到 Python 3 运行时。

Facet 在模块 google.appengine.api.search 中定义。

属性

Facet 类的实例具有以下属性:

name

Facet 的名称。Facet 名称的最大长度必须为 MAXIMUM_FIELD_NAME_LENGTH 且符合格式 [A-Za-z][A-Za-z0-9_]*。

value

Facet 的值可以是字符串、unicode 或数字。

子类

Facet 类具有以下子类:

AtomFacet

一个 Facet,其内容可被视为用于索引的单个令牌。

此 Facet 的值可以是字符串或 unicode 对象,且被视为不可分割的文本值。以下示例显示了名为 wine_type 的 atom facet:

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

异常

TypeError

提供的值不是文本字符串。

ValueError

值超过最大允许长度。

NumberFacet

一个 Facet,具有数值。

以下示例显示了名为 wine_vintage 的数字 facet:

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

异常

TypeError

提供的值不是数字。

ValueError

值超出范围。