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

值超出範圍。