Python 2.7 已达到支持终止期限，并将于 2026 年 1 月 31 日弃用。弃用后，您将无法部署 Python 2.7 应用，即使您的组织之前曾使用组织政策重新启用旧版运行时的部署也是如此。现有的 Python 2.7 应用在弃用日期之后将继续运行并接收流量。我们建议您迁移到最新支持的 Python 版本。

Facet 类

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

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: 值超出范围。