La classe FacetRefinement

La classe FacetRefinement viene utilizzata per restringere i risultati di ricerca in base a un valore facet.

Il modo consigliato per utilizzare il perfezionamento dei facet è utilizzare la relativa stringa di token. Ogni FacetResult avrà un token accettabile al posto di questa classe. Per fornire FacetRefinement manuale, un'istanza di questa classe può essere passata a SearchOptions.

FacetRefinement è definito nel modulo google.appengine.api.search.

Costruttore

Il costruttore della classe FacetRefinement è definito come segue:

class FacetRefinement(name, value=None, facet_range=None)

Costruisci un'istanza della classe FacetRefinement.

NOTA: deve essere impostato il valore o l'intervallo_sfaccettatura, ma non entrambi.

Argomenti

name

Imposta la proprietà name

valore

Imposta la proprietà del valore

facet_range

Imposta la proprietà facet_range

Valore del risultato

Una nuova istanza della classe FacetRefinement.

Eccezioni

TypeError

Se uno dei parametri ha tipi non validi o viene passato un attributo sconosciuto.

ValueError

Se uno dei parametri ha valori non validi.

Proprietà

Un'istanza della classe FacetRefinement ha le seguenti proprietà:

name

nome del perfezionamento della sfaccettatura.

valore

valore stringa del perfezionamento del facet.

range

intervallo numerico del perfezionamento del facet.

Metodi dell'istanza

Le istanze della classe FacetRefinement hanno i seguenti metodi:

ToTokenString()

Converte questo perfezionamento in una stringa di token sicura da utilizzare in HTML. Il formato di questa stringa potrebbe cambiare.

Valore del risultato

Una stringa di token sicura da utilizzare in HTML per questo perfezionamento della sfaccettatura.

FromTokenString()

Questo metodo statico converte una stringa di token in un oggetto FacetRefinement. Non memorizzare stringhe di token tra versioni diverse dell'API, in quanto la chiave potrebbe essere incompatibile.

Argomenti

token_string

Una stringa di token creata dal metodo ToTokenString o restituita da un risultato di ricerca.

Valore del risultato

Un oggetto FacetRefinement.

Eccezioni

ValueError

Se token_string non è valido.