REST Resource: settings.searchapplications

Risorsa: SearchApplication

SearchApplication

Rappresentazione JSON
{
  "name": string,
  "displayName": string,
  "dataSourceRestrictions": [
    {
      object (DataSourceRestriction)
    }
  ],
  "sourceConfig": [
    {
      object (SourceConfig)
    }
  ],
  "scoringConfig": {
    object (ScoringConfig)
  },
  "defaultSortOptions": {
    object (SortOptions)
  },
  "defaultFacetOptions": [
    {
      object (FacetOptions)
    }
  ],
  "returnResultThumbnailUrls": boolean,
  "operationIds": [
    string
  ],
  "enableAuditLog": boolean,
  "queryInterpretationConfig": {
    object (QueryInterpretationConfig)
  }
}
Campi
name

string

Il nome dell'applicazione di ricerca.

Formato: searchapplications/{applicationId}.

displayName

string

Nome visualizzato dell'applicazione di ricerca. La lunghezza massima è di 300 caratteri.

dataSourceRestrictions[]

object (DataSourceRestriction)

Limitazioni applicate alle configurazioni. Il numero massimo di elementi è 10.

sourceConfig[]

object (SourceConfig)

Configurazione per un'origine specificata in dataSourceRestrictions.

scoringConfig

object (ScoringConfig)

Configurazione per il ranking dei risultati.

defaultSortOptions

object (SortOptions)

Opzioni predefinite per l'ordinamento dei risultati di ricerca

defaultFacetOptions[]

object (FacetOptions)

I campi predefiniti per la restituzione dei risultati dei facet. Le fonti specificate qui sono state incluse anche in dataSourceRestrictions sopra.

returnResultThumbnailUrls

boolean

Con ogni risultato dobbiamo restituire l'URI della relativa miniatura (se applicabile)

operationIds[]

string

Solo output. ID delle operazioni a lunga esecuzione (LRO) attualmente in esecuzione per questo schema. Campo di solo output.

enableAuditLog

boolean

Indica se l'audit logging è attivato/disattivato per le richieste effettuate per l'applicazione di ricerca nelle API delle query.

queryInterpretationConfig

object (QueryInterpretationConfig)

Opzioni predefinite per l'interpretazione delle query

DataSourceRestriction

Limitazione sull'origine dati.

Rappresentazione JSON
{
  "source": {
    object (Source)
  },
  "filterOptions": [
    {
      object (FilterOptions)
    }
  ]
}
Campi
source

object (Source)

L'origine della limitazione.

filterOptions[]

object (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 source can be only one of the following:
  "name": string,
  "predefinedSource": enum (Source.PredefinedSource)
  // End of list of possible types for union field source.
}
Campi

Campo unione source.

source può essere solo uno dei seguenti:

name

string

Nome dell'origine per i contenuti indicizzati da Indexing API.

predefinedSource

enum (Source.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 (Filter)
  }
}
Campi
objectType

string

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

object (Filter)

Filtro generico per limitare la ricerca, ad esempio lang:en, site:xyz.

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 filter can be only one of the following:
  "valueFilter": {
    object (Filter.ValueFilter)
  },
  "compositeFilter": {
    object (Filter.CompositeFilter)
  }
  // End of list of possible types for union field filter.
}
Campi

Campo unione filter.

filter può essere solo uno dei seguenti:

valueFilter

object (Filter.ValueFilter)

compositeFilter

object (Filter.CompositeFilter)

Filter.ValueFilter

Rappresentazione JSON
{
  "operatorName": string,
  "value": {
    object (Value)
  }
}
Campi
operatorName

string

Il valore operatorName applicato alla query, ad esempio price_greater_than. Il filtro può funzionare con entrambi i tipi di filtri definiti nello schema dell'origine dati:

  1. operatorName, in cui la query filtra i risultati in base alla proprietà corrispondente al valore.

  2. greaterThanOperatorName o lessThanOperatorName nel tuo schema. La query filtra i risultati per i valori della proprietà maggiori o minori di quello specificato nella query.

value

object (Value)

Il valore da confrontare.

Valore

Definizione di un singolo valore con tipo generico.

Rappresentazione JSON
{

  // Union field value can be only one of the following:
  "stringValue": string,
  "integerValue": string,
  "doubleValue": number,
  "timestampValue": string,
  "booleanValue": boolean,
  "dateValue": {
    object (Date)
  }
  // End of list of possible types for union field value.
}
Campi
Campo unione value. Il valore della proprietà denominata. value può essere solo uno dei seguenti:
stringValue

string

integerValue

string (int64 format)

doubleValue

number

timestampValue

string (Timestamp format)

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

booleanValue

boolean

dateValue

object (Date)

Filter.CompositeFilter

Rappresentazione JSON
{
  "logicOperator": enum (Filter.CompositeFilter.LogicOperator),
  "subFilters": [
    {
      object (Filter)
    }
  ]
}
Campi
logicOperator

enum (Filter.CompositeFilter.LogicOperator)

L'operatore logico del filtro secondario.

subFilters[]

object (Filter)

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 (Source)
  },
  "scoringConfig": {
    object (SourceScoringConfig)
  },
  "crowdingConfig": {
    object (SourceCrowdingConfig)
  }
}
Campi
source

object (Source)

L'origine per cui deve essere utilizzata questa configurazione.

scoringConfig

object (SourceScoringConfig)

La configurazione del punteggio per l'origine.

crowdingConfig

object (SourceCrowdingConfig)

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 (SourceScoringConfig.SourceImportance)
}
Campi
sourceImportance

enum (SourceScoringConfig.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

integer

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

integer

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

boolean

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

boolean

Se personalizzare i risultati. Per impostazione predefinita, vengono utilizzati gli indicatori personali per migliorare i risultati.

SortOptions

Rappresentazione JSON
{
  "operatorName": string,
  "sortOrder": enum (SortOptions.SortOrder)
}
Campi
operatorName

string

Il nome dell'operatore corrispondente al campo in base al quale eseguire l'ordinamento. La proprietà corrispondente deve essere contrassegnata come sortable.

sortOrder

enum (SortOptions.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 (IntegerFacetingOptions)
  }
}
Campi
sourceName

string

Nome dell'origine su cui eseguire il facet. Formato: datasources/{sourceId} Se vuoto, verranno utilizzate tutte le origini dati.

objectType

string

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

string

Il nome dell'operatore scelto per il faceting. @vedi cloudsearch.SchemaPropertyOptions

numFacetBuckets

integer

Numero massimo di bucket di facet che devono essere restituiti per questo facet. Il valore predefinito è 10. Il valore massimo è 100.

integerFacetingOptions

object (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[]

string (Int64Value format)

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

boolean

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

boolean

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

create

Crea un'applicazione di ricerca.

delete

Elimina un'applicazione di ricerca.

get

Ottiene l'applicazione di ricerca specificata.

list

Elenca tutte le applicazioni di ricerca.

patch

Consente di aggiornare un'applicazione di ricerca.

reset

Reimposta le impostazioni predefinite di un'applicazione di ricerca.

update

Consente di aggiornare un'applicazione di ricerca.