Python 2.7 已終止支援，並將於 2026 年 1 月 31 日淘汰。淘汰後，您將無法部署 Python 2.7 應用程式，即使貴機構先前曾使用機構政策重新啟用舊版執行階段的部署作業，也無法部署。現有的 Python 2.7 應用程式在淘汰日期過後，仍會繼續執行並接收流量。建議您改用系統支援的最新 Python 版本。

本頁面由 Cloud Translation API 翻譯而成。

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 的值，可為 Str、Unicode 或數字。

子類別

Facet 類別具有下列子類別：

class AtomFacet

所含內容要當做單一符記編入索引的 Facet。

Facet 的值為要當做不可分割文字值的 Str 或 Unicode 物件。以下是名為 wine_type 的完整 Facet 範例：

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

例外狀況

TypeError: 提供的值並非文字字串。
ValueError: 值超過允許長度上限。

class NumberFacet

包含數字值的 Facet。

以下是名為 wine_vintage 的數字 Facet 範例：

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

例外狀況

TypeError: 提供的值並非數字。
ValueError: 值超出範圍。