Facettenklassen

Die Klasse Facet ist eine abstrakte Basisklasse, die ein Attribut eines Dokuments darstellt. Diese Klasse sollte nicht direkt instanziiert werden.

Achtung: **Diese Lösung wird nicht mehr empfohlen:** Anwendungen, die diese API verwenden, können nur in der Python 2-Laufzeit ausgeführt werden und müssen vor der Migration zur Python 3-Laufzeit auf eine [empfohlene Lösung](/appengine/docs/standard/python/migrate-to-python3/migrating-services#migration_paths_for_bundled_services) aktualisiert werden.

Facet ist im Modul google.appengine.api.search definiert.

Attribute

Eine Instanz der Klasse Facet hat die folgenden Attribute:

name

Der Name des Attributs. Attributnamen müssen die maximale Länge MAXIMUM_FIELD_NAME_LENGTH und das Übereinstimmungsmuster "[A-Za-z] [A-Za-z0-9_]*" haben.

Wert

Der Attributwert; kann ein String, Unicode oder eine Zahl sein.

Abgeleitete Klassen

Die Klasse Facet hat die folgenden abgeleiteten Klassen:

Klasse AtomFacet

Ein Attribut, dessen Inhalt für Indexierungszwecke als einzelner Token behandelt werden soll.

Der Attributwert ist ein String- oder Unicode-Objekt, das als nicht teilbarer Textwert behandelt wird. Das folgende Beispiel zeigt ein Atomattribut mit dem Namen wine_type:

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

Ausnahmen

TypeError

Der angegebene Wert ist kein Textstring.

ValueError

Der Wert überschreitet die maximal zulässige Länge.

Klasse NumberFacet

Ein Attribut, das einen numerischen Wert enthält.

Das folgende Beispiel zeigt ein Zahlenattribut namens wine_vintage:

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

Ausnahmen

TypeError

Der angegebene Wert ist nicht numerisch.

ValueError

Der Wert liegt außerhalb des zulässigen Bereichs.