- Risorsa: SearchApplication
- DataSourceRestriction
- Fonte
- Source.PredefinedSource
- FilterOptions
- Filtro
- Filter.ValueFilter
- Conveniente
- Filter.CompositeFilter
- Filter.CompositeFilter.LogicOperator
- SourceConfig
- SourceScoringConfig
- SourceScoringConfig.SourceImportance
- SourceCrowdingConfig
- ScoringConfig
- SortOptions
- SortOptions.SortOrder
- FacetOptions
- IntegerFacetingOptions
- QueryInterpretationConfig
- Metodi
Risorsa: SearchApplication
SearchApplication
Rappresentazione JSON |
---|
{ "name": string, "displayName": string, "dataSourceRestrictions": [ { object ( |
Campi | |
---|---|
name |
Il nome dell'applicazione di ricerca. Formato: searchapplications/{applicationId}. |
displayName |
Nome visualizzato dell'applicazione di ricerca. La lunghezza massima è di 300 caratteri. |
dataSourceRestrictions[] |
Limitazioni applicate alle configurazioni. Il numero massimo di elementi è 10. |
sourceConfig[] |
Configurazione per un'origine specificata in dataSourceRestrictions. |
scoringConfig |
Configurazione per il ranking dei risultati. |
defaultSortOptions |
Opzioni predefinite per l'ordinamento dei risultati di ricerca |
defaultFacetOptions[] |
I campi predefiniti per la restituzione dei risultati dei facet. Le fonti specificate qui sono state incluse anche in |
returnResultThumbnailUrls |
Con ogni risultato dobbiamo restituire l'URI della relativa miniatura (se applicabile) |
operationIds[] |
Solo output. ID delle operazioni a lunga esecuzione (LRO) attualmente in esecuzione per questo schema. Campo di solo output. |
enableAuditLog |
Indica se l'audit logging è attivato/disattivato per le richieste effettuate per l'applicazione di ricerca nelle API delle query. |
queryInterpretationConfig |
Opzioni predefinite per l'interpretazione delle query |
DataSourceRestriction
Limitazione sull'origine dati.
Rappresentazione JSON |
---|
{ "source": { object ( |
Campi | |
---|---|
source |
L'origine della limitazione. |
filterOptions[] |
Opzioni di filtro che limitano i risultati. Se sono presenti più filtri, questi vengono raggruppati per tipo di oggetto prima dell'unione. I filtri con lo stesso tipo di oggetto sono unite congiuntamente, quindi le espressioni risultanti vengono unite in modo disgiuntivo. Il numero massimo di elementi è 20. NOTA: l'API Suggest al momento supporta solo pochi filtri: "objecttype", "type" e "mimetype". Al momento, non è possibile utilizzare filtri specifici dello schema per filtrare i suggerimenti. |
Origine
Definisce le origini delle API di suggerimento/ricerca.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo unione
|
|
name |
Nome dell'origine per i contenuti indicizzati da |
predefinedSource |
Origine di contenuto predefinita per Google Apps. |
Source.PredefinedSource
Origini predefinite:
Enum | |
---|---|
NONE |
|
QUERY_HISTORY |
Suggerisce le query eseguite dall'utente in passato. Valido solo se utilizzato con l'API Recommendations. Ignorato quando utilizzato nell'API Query. |
PERSON |
Suggerisce persone nell'organizzazione. Valido solo se utilizzato con l'API Recommendations. Genera un errore quando viene utilizzato nell'API Query. |
GOOGLE_DRIVE |
|
GOOGLE_GMAIL |
|
GOOGLE_SITES |
|
GOOGLE_GROUPS |
|
GOOGLE_CALENDAR |
|
GOOGLE_KEEP |
FilterOptions
Opzioni di filtro da applicare alla query.
Rappresentazione JSON |
---|
{
"objectType": string,
"filter": {
object ( |
Campi | |
---|---|
objectType |
Se subjectType è impostato, vengono restituiti solo oggetti di quel tipo. Dovrebbe corrispondere al nome dell'oggetto registrato all'interno della definizione dello schema. La lunghezza massima è di 256 caratteri. |
filter |
Filtro generico per limitare la ricerca, ad esempio |
Filtro
Un modo generico di esprimere i filtri in una query, che supporta due approcci:
1. Impostazione di un ValueFilter. Il nome deve corrispondere a un operatorName definito nello schema dell'origine dati.
2. Impostazione di un filtro composito. I filtri vengono valutati mediante l'operatore logico. Gli operatori di primo livello possono essere solo AND o NOT. AND può essere visualizzato solo nel livello più alto. OR può essere visualizzato solo in un operatore AND di primo livello.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo unione
|
|
valueFilter |
|
compositeFilter |
|
Filter.ValueFilter
Rappresentazione JSON |
---|
{
"operatorName": string,
"value": {
object ( |
Campi | |
---|---|
operatorName |
Il valore
|
value |
Il valore da confrontare. |
Valore
Definizione di un singolo valore con tipo generico.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo unione value . Il valore della proprietà denominata. value può essere solo uno dei seguenti: |
|
stringValue |
|
integerValue |
|
doubleValue |
|
timestampValue |
Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
booleanValue |
|
dateValue |
|
Filter.CompositeFilter
Rappresentazione JSON |
---|
{ "logicOperator": enum ( |
Campi | |
---|---|
logicOperator |
L'operatore logico del filtro secondario. |
subFilters[] |
Filtri secondari. |
Filter.CompositeFilter.LogicOperator
Enum | |
---|---|
AND |
Operatori logici, che possono essere applicati solo ai filtri secondari. |
OR |
|
NOT |
NON può essere applicato solo a un singolo filtro secondario. |
SourceConfig
Configurazioni per un'origine durante l'elaborazione di una richiesta query.search
o query.suggest
.
Rappresentazione JSON |
---|
{ "source": { object ( |
Campi | |
---|---|
source |
L'origine per cui deve essere utilizzata questa configurazione. |
scoringConfig |
La configurazione del punteggio per l'origine. |
crowdingConfig |
La configurazione di crowding per l'origine. |
SourceScoringConfig
Imposta la configurazione del punteggio. Ciò consente di modificare il ranking dei risultati per un'origine.
Rappresentazione JSON |
---|
{
"sourceImportance": enum ( |
Campi | |
---|---|
sourceImportance |
Importanza dell'origine. |
SourceScoringConfig.SourceImportance
L'importanza di una fonte che può essere utilizzata per indicare se a una fonte deve essere data maggiore priorità nel ranking rispetto a un'altra fonte.
Enum | |
---|---|
DEFAULT |
|
LOW |
|
HIGH |
SourceCrowdingConfig
Imposta limiti di crowding dei risultati di ricerca. Il crowding si verifica quando più risultati provenienti dalla stessa fonte o dallo stesso host si "incrociano" altri risultati, riducendo la qualità della ricerca per gli utenti. Per migliorare la qualità della ricerca e la diversità delle fonti nei risultati di ricerca, puoi impostare una condizione per ridurre i risultati ripetitivi in base alla fonte.
Rappresentazione JSON |
---|
{ "numResults": integer, "numSuggestions": integer } |
Campi | |
---|---|
numResults |
Numero massimo di risultati consentiti da un'origine dati in una pagina dei risultati, purché i risultati di altre origini non siano esauriti. il valore specificato non deve essere negativo. Se questo valore è uguale a 0, viene utilizzato un valore predefinito. Per disattivare il crowding, imposta un valore superiore a 100. |
numSuggestions |
Numero massimo di suggerimenti consentiti da una fonte. Non verranno impostati limiti sui risultati se questo valore è minore o uguale a 0. |
ScoringConfig
Configurazioni di punteggio per un'origine durante l'elaborazione di una richiesta query.search
o query.suggest
.
Rappresentazione JSON |
---|
{ "disableFreshness": boolean, "disablePersonalization": boolean } |
Campi | |
---|---|
disableFreshness |
Indica se utilizzare l'aggiornamento come indicatore di ranking. Per impostazione predefinita, l'aggiornamento viene utilizzato come indicatore di ranking. Tieni presente che questa impostazione non è disponibile nell'interfaccia utente amministratore. |
disablePersonalization |
Se personalizzare i risultati. Per impostazione predefinita, vengono utilizzati gli indicatori personali per migliorare i risultati. |
SortOptions
Rappresentazione JSON |
---|
{
"operatorName": string,
"sortOrder": enum ( |
Campi | |
---|---|
operatorName |
Il nome dell'operatore corrispondente al campo in base al quale eseguire l'ordinamento. La proprietà corrispondente deve essere contrassegnata come |
sortOrder |
L'ordinamento predefinito è crescente |
SortOptions.SortOrder
Enum | |
---|---|
ASCENDING |
|
DESCENDING |
FacetOptions
Specifica gli operatori per i quali restituire i risultati dei facet. Ci sarà un FacetResult per ogni combinazione sourceName/objectType/operatorName.
Rappresentazione JSON |
---|
{
"sourceName": string,
"objectType": string,
"operatorName": string,
"numFacetBuckets": integer,
"integerFacetingOptions": {
object ( |
Campi | |
---|---|
sourceName |
Nome dell'origine su cui eseguire il facet. Formato: datasources/{sourceId} Se vuoto, verranno utilizzate tutte le origini dati. |
objectType |
Se subjectType è impostato, solo gli oggetti di quel tipo verranno utilizzati per calcolare i facet. Se vuoto, tutti gli oggetti verranno utilizzati per calcolare i facet. |
operatorName |
Il nome dell'operatore scelto per il faceting. @vedi cloudsearch.SchemaPropertyOptions |
numFacetBuckets |
Numero massimo di bucket di facet che devono essere restituiti per questo facet. Il valore predefinito è 10. Il valore massimo è 100. |
integerFacetingOptions |
Se impostato, descrive le opzioni di faceting con numeri interi per la proprietà di numeri interi specificata. La proprietà del valore intero corrispondente nello schema deve essere contrassegnata come isFacetable. Il numero di bucket restituito è il minimo di questo e di numFacetBuckets. |
IntegerFacetingOptions
Utilizzato per specificare le opzioni di faceting con numeri interi.
Rappresentazione JSON |
---|
{ "integerBuckets": [ string ] } |
Campi | |
---|---|
integerBuckets[] |
I bucket per i valori interi specificati devono essere in ordine rigorosamente crescente. Ad esempio, se i valori forniti sono (1,5,10,100), i seguenti bucket di facet saranno formati {<1, [1,5), [5-10), [10-100), >=100}. |
QueryInterpretationConfig
Opzioni predefinite per l'interpretazione della query dell'utente.
Rappresentazione JSON |
---|
{ "forceVerbatimMode": boolean, "forceDisableSupplementalResults": boolean } |
Campi | |
---|---|
forceVerbatimMode |
Attiva questo flag per disattivare tutte le ottimizzazioni interne come l'interpretazione in linguaggio naturale (NL) delle query, il recupero di risultati supplementari e l'utilizzo di sinonimi, inclusi quelli personalizzati. Se il flag viene impostato su True, avrà la precedenza sull'opzione impostata a livello di query. Se il valore predefinito è False, il flag a livello di query imposterà l'interpretazione corretta per la modalità parola per parola. |
forceDisableSupplementalResults |
Imposta questo flag per disattivare il recupero dei risultati supplementari. L'impostazione di un flag qui non consentirà di recuperare risultati supplementari per le query associate a una determinata applicazione di ricerca. Se il flag viene impostato su True, avrà la precedenza sull'opzione impostata a livello di query. Se il valore predefinito è False, il flag a livello di query imposterà l'interpretazione corretta per i risultati supplementari. |
Metodi |
|
---|---|
|
Crea un'applicazione di ricerca. |
|
Elimina un'applicazione di ricerca. |
|
Ottiene l'applicazione di ricerca specificata. |
|
Elenca tutte le applicazioni di ricerca. |
|
Consente di aggiornare un'applicazione di ricerca. |
|
Reimposta le impostazioni predefinite di un'applicazione di ricerca. |
|
Consente di aggiornare un'applicazione di ricerca. |