SearchResponse

La risposta dell'API di ricerca. ID NEXT: 17

Rappresentazione JSON 
{
  "queryInterpretation": {
    object (QueryInterpretation)
  },
  "results": [
    {
      object (SearchResult)
    }
  ],
  "structuredResults": [
    {
      object (StructuredResult)
    }
  ],
  "spellResults": [
    {
      object (SpellResult)
    }
  ],
  "facetResults": [
    {
      object (FacetResult)
    }
  ],
  "hasMoreResults": boolean,
  "debugInfo": {
    object (ResponseDebugInfo)
  },
  "errorInfo": {
    object (ErrorInfo)
  },
  "resultCounts": {
    object (ResultCounts)
  },

  // Union field result_count can be only one of the following:
  "resultCountEstimate": string,
  "resultCountExact": string
  // End of list of possible types for union field result_count.
}
Campi
queryInterpretation

object (QueryInterpretation)

Risultato dell'interpretazione della query per la query dell'utente. Vuoto se l'interpretazione delle query è disattivata.
results[]

object (SearchResult)

Risultati di una query di ricerca.
structuredResults[]

object (StructuredResult)

Risultati strutturati per la query dell'utente. Questi risultati non vengono conteggiati per pageSize.
spellResults[]

object (SpellResult)

Ortografia suggerita per la query.
facetResults[]

object (FacetResult)

Risultati delle sfaccettature ripetuti.
hasMoreResults

boolean

Se sono presenti altri risultati di ricerca corrispondenti alla query.
debugInfo

object (ResponseDebugInfo)

Informazioni di debug sulla risposta.
errorInfo

object (ErrorInfo)

Informazioni sull'errore relativo alla risposta.
resultCounts

object (ResultCounts)

Informazioni espanse sul conteggio dei risultati.

Campo unione result_count. Il conteggio totale dei risultati in tutte le origini dati richieste. Omesso se nel set di origini dati sottoposte a query sono incluse origini predefinite. I conteggi dei risultati potrebbero essere restituiti come stima, anziché esatti, nelle seguenti circostanze:

  • Quando la query contiene più di due termini in una frase, ad esempio "conteggio risultati esatto" tra virgolette.

  • Quando il numero di ACL dei risultati di ricerca univoci da valutare è troppo elevato per essere calcolato in una latenza ragionevole.

Nei rari casi in cui il sistema non è in grado di eseguire ricerche in tutti i documenti, esegui di nuovo la query. result_count può essere solo uno dei seguenti:
resultCountEstimate

string (int64 format)

Il numero stimato di risultati per questa query.
resultCountExact

string (int64 format)

Il conteggio esatto dei risultati per questa query.

QueryInterpretation

Rappresentazione JSON 
{
  "interpretedQuery": string,
  "interpretationType": enum (QueryInterpretation.InterpretationType),
  "reason": enum (QueryInterpretation.Reason),
  "interpretedQueryActualResultCount": integer,
  "interpretedQueryEstimatedResultCount": string
}
Campi
interpretedQuery

string

L'interpretazione della query utilizzata nella ricerca. Ad esempio, le query con intent di linguaggio naturale come "email da Giovanni" verranno interpretate come "da:Giovanni origine:email". Questo campo non verrà compilato se il motivo è NOT_ENOUGH_RESULTS_FOUND_FOR_USER_QUERY.
interpretationType

enum (QueryInterpretation.InterpretationType)
reason

enum (QueryInterpretation.Reason)

Il motivo dell'interpretazione della query. Questo campo non sarà UNSPECIFIED se il tipo di interpretazione non è NONE.
interpretedQueryActualResultCount

integer

Il numero effettivo di risultati restituiti dalla query interpretata.
interpretedQueryEstimatedResultCount

string (int64 format)

Il numero stimato di risultati restituiti dalla query interpretata.

QueryInterpretation.InterpretationType

Enum
NONE Per recuperare i risultati di ricerca non viene utilizzata né l'interpretazione in linguaggio naturale né una versione più ampia della query.
BLEND I risultati della query originale vengono combinati con altri risultati. Il motivo per cui questi altri risultati vengono combinati con i risultati della query originale viene inserito nel campo "reason" di seguito.
REPLACE I risultati della query originale vengono sostituiti. Il motivo della sostituzione dei risultati della query originale viene inserito nel campo "reason" di seguito.

QueryInterpretation.Reason

Enum
UNSPECIFIED
QUERY_HAS_NATURAL_LANGUAGE_INTENT Per recuperare i risultati di ricerca viene utilizzata l'interpretazione della query in linguaggio naturale.
NOT_ENOUGH_RESULTS_FOUND_FOR_USER_QUERY La somiglianza dei termini delle query e dei documenti viene utilizzata per ampliare in modo selettivo la query in modo da recuperare ulteriori risultati di ricerca, poiché non sono stati trovati risultati sufficienti per la query dell'utente. La query interpretata sarà vuota per questa richiesta.

SearchResult

Risultati contenenti informazioni indicizzate per un documento.

Rappresentazione JSON 
{
  "title": string,
  "url": string,
  "snippet": {
    object (Snippet)
  },
  "metadata": {
    object (Metadata)
  },
  "clusteredResults": [
    {
      object (SearchResult)
    }
  ],
  "debugInfo": {
    object (ResultDebugInfo)
  }
}
Campi
title

string

Titolo del risultato di ricerca.
url

string

L'URL del risultato di ricerca. L'URL contiene un reindirizzamento di Google all'articolo effettivo. Questo URL è firmato e non deve essere modificato.
snippet

object (Snippet)

La concatenazione di tutti gli snippet (riepiloghi) disponibili per questo risultato.
metadata

object (Metadata)

dei metadati del risultato di ricerca.
clusteredResults[]

object (SearchResult)

Se l'origine è raggruppata, fornisci un elenco dei risultati raggruppati. Verrà utilizzato un solo livello di risultati raggruppati. Se l'origine corrente non è abilitata per il clustering, questo campo sarà vuoto.
debugInfo

object (ResultDebugInfo)

Informazioni di debug su questo risultato di ricerca.

Snippet

Snippet del risultato di ricerca, che riassume i contenuti della pagina risultante.

Rappresentazione JSON 
{
  "snippet": string,
  "matchRanges": [
    {
      object (MatchRange)
    }
  ]
}
Campi
snippet

string

Lo snippet del documento. Potrebbe contenere un carattere HTML con codice di escape che deve essere rimosso prima del rendering.
matchRanges[]

object (MatchRange)

Gli intervalli corrispondenti nello snippet.

MatchRange

Intervallo corrispondente di uno snippet [start, end].

Rappresentazione JSON 
{
  "start": integer,
  "end": integer
}
Campi
start

integer

Posizione iniziale della corrispondenza nello snippet.
end

integer

Fine della corrispondenza nello snippet.

Metadati

metadati di un risultato di ricerca corrispondente.

Rappresentazione JSON 
{
  "source": {
    object (Source)
  },
  "mimeType": string,
  "thumbnailUrl": string,
  "owner": {
    object (Person)
  },
  "createTime": string,
  "updateTime": string,
  "fields": [
    {
      object (NamedProperty)
    }
  ],
  "displayOptions": {
    object (ResultDisplayMetadata)
  },
  "objectType": string
}
Campi
source

object (Source)

L'origine denominata del risultato, ad esempio Gmail.
mimeType

string

Tipo MIME del risultato di ricerca.
thumbnailUrl

string

L'URL della miniatura del risultato.
owner

object (Person)

proprietario (di solito autore) del documento o dell'oggetto del risultato di ricerca.
createTime

string (Timestamp format)

La data e l'ora di creazione di questo documento o oggetto nel risultato di ricerca.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

La data dell'ultima modifica dell'oggetto nel risultato di ricerca. Se non viene impostato nell'elemento, il valore restituito qui è vuoto. Quando updateTime viene utilizzato per il calcolo dell'aggiornamento e non è impostato, il valore predefinito è 2 anni a partire dall'ora corrente.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
fields[]

object (NamedProperty)

Campi indicizzati nei dati strutturati, restituiti come proprietà denominate generiche.
displayOptions

object (ResultDisplayMetadata)

Opzioni che specificano come visualizzare un risultato di ricerca con dati strutturati.
objectType

string

Tipo di oggetto del risultato di ricerca.

ResultDisplayMetadata

Rappresentazione JSON 
{
  "objectTypeLabel": string,
  "metalines": [
    {
      object (ResultDisplayMetadata.ResultDisplayLine)
    }
  ]
}
Campi
objectTypeLabel

string

L'etichetta di visualizzazione dell'oggetto.
metalines[]

object (ResultDisplayMetadata.ResultDisplayLine)

I contenuti delle metaline da visualizzare con il risultato.

ResultDisplayMetadata.ResultDisplayLine

La raccolta di campi che compongono una riga visualizzata

Rappresentazione JSON 
{
  "fields": [
    {
      object (ResultDisplayMetadata.ResultDisplayField)
    }
  ]
}
Campi
fields[]

object (ResultDisplayMetadata.ResultDisplayField)

ResultDisplayMetadata.ResultDisplayField

Campi di visualizzazione per i risultati di ricerca

Rappresentazione JSON 
{
  "label": string,
  "operatorName": string,
  "property": {
    object (NamedProperty)
  }
}
Campi
label

string

L'etichetta visualizzata per la proprietà.
operatorName

string

Il nome dell'operatore della struttura.
property

object (NamedProperty)

La coppia di nome e valore per la proprietà.

ResultDebugInfo

Informazioni di debug sul risultato.

Rappresentazione JSON 
{
  "formattedDebugInfo": string
}
Campi
formattedDebugInfo

string

Informazioni di debug generali formattate per la visualizzazione.

StructuredResult

Risultati strutturati restituiti nell'ambito della richiesta di ricerca.

Rappresentazione JSON 
{

  // Union field structured_result can be only one of the following:
  "person": {
    object (Person)
  }
  // End of list of possible types for union field structured_result.
}
Campi

Campo unione structured_result.

structured_result può essere solo uno dei seguenti:
person

object (Person)

Rappresentazione di una persona

SpellResult

Rappresentazione JSON 
{
  "suggestedQuery": string,
  "suggestionType": enum (SpellResult.SuggestionType),
  "suggestedQueryHtml": {
    object (SafeHtmlProto)
  }
}
Campi
suggestedQuery

string

L'ortografia suggerita della query.
suggestionType

enum (SpellResult.SuggestionType)

suggerimento attivato per la query corrente.
suggestedQueryHtml

object (SafeHtmlProto)

Il codice HTML sanificato che rappresenta la query corretta ortograficamente che può essere utilizzata nell'interfaccia utente. In genere, sono presenti tag specifici per la lingua per contrassegnare le parti della query sottoposte a controllo ortografico.

SpellResult.SuggestionType

Il tipo di suggerimento attivato per la query.

Enum
SUGGESTION_TYPE_UNSPECIFIED Tipo di controllo ortografico predefinito
NON_EMPTY_RESULTS_SPELL_SUGGESTION Suggerimento ortografico senza risultati modificati. I risultati vengono comunque mostrati per la query originale (che ha risultati diversi da zero) con un suggerimento ortografico che avrebbe risultati.
ZERO_RESULTS_FULL_PAGE_REPLACEMENT Suggerimento ortografico attivato quando la query originale non ha risultati. Quando la query originale non ha risultati, ma il suggerimento ortografico ne ha, attiviamo i risultati per la query corretta.

SafeHtmlProto

IMPORTANTE: non è sicuro accettare questo messaggio da un'origine non attendibile, poiché è facile per un malintenzionato creare messaggi serializzati che non rispettano il contratto di sicurezza del tipo, ad esempio potrebbe contenere script controllati dall'utente malintenzionato. Un sistema che riceve un SafeHtmlProto si fida implicitamente del produttore del SafeHtmlProto. Pertanto, è generalmente sicuro restituire questo messaggio nelle risposte RPC, ma non è generalmente sicuro accettarlo nelle richieste RPC.

Rappresentazione JSON 
{
  "privateDoNotAccessOrElseSafeHtmlWrappedValue": string
}
Campi
privateDoNotAccessOrElseSafeHtmlWrappedValue

string

IMPORTANTE: non impostare o leggere mai questo campo, nemmeno dai test, perché è privato. Consulta la documentazione nella parte superiore del file .proto per i pacchetti di linguaggi di programmazione con cui creare o leggere questo messaggio.

FacetResult

Risposta ai componenti specifici dell'origine

Rappresentazione JSON 
{
  "sourceName": string,
  "objectType": string,
  "operatorName": string,
  "buckets": [
    {
      object (FacetBucket)
    }
  ]
}
Campi
sourceName

string

Nome dell'origine per cui vengono restituiti i risultati del livello. Non sarà vuoto.
objectType

string

Tipo di oggetto per cui vengono restituiti i risultati delle sfaccettature. Può essere vuoto.
operatorName

string

Il nome dell'operatore scelto per la suddivisione in livelli. @see cloudsearch.SchemaPropertyOptions
buckets[]

object (FacetBucket)

FacetBuckets per i valori nella risposta contenenti almeno un risultato con il filtro corrispondente.

FacetBucket

Un bucket in una frazione è l'unità di base di operazione. Un bucket può comprendere un singolo valore OPPURE un intervallo contiguo di valori, a seconda del tipo di campo raggruppato. Al momento FacetBucket viene utilizzato solo per restituire l'oggetto di risposta.

Rappresentazione JSON 
{
  "count": integer,
  "percentage": integer,
  "filter": {
    object (Filter)
  },

  // Union field bucket_value can be only one of the following:
  "value": {
    object (Value)
  }
  // End of list of possible types for union field bucket_value.
}
Campi
count

integer

Numero di risultati corrispondenti al valore del bucket. I conteggi vengono restituiti per le ricerche solo quando è garantita la loro accuratezza. Cloud Search non garantisce il conteggio dei componenti per nessuna query e i conteggi dei componenti potrebbero essere presenti solo a intermittenza, anche per query identiche. Non creare dipendenze sull'esistenza del conteggio delle sfaccettature; utilizza invece le percentuali del conteggio delle sfaccettature che vengono sempre restituite.
percentage

integer

Percentuale di risultati che corrispondono al valore del bucket. Il valore restituito è compreso tra [0-100] e viene arrotondato per difetto a un numero intero se frazionario. Se il valore non viene restituito esplicitamente, rappresenta un valore percentuale arrotondato a 0. Le percentuali vengono restituite per tutte le ricerche, ma si tratta di una stima. Poiché vengono sempre restituite le percentuali, devi visualizzare le percentuali anziché i conteggi.
filter

object (Filter)

Filtro da passare nella richiesta di ricerca se è selezionato il bucket corrispondente.
Campo unione bucket_value. L'intervallo o il valore del bucket con i vari aspetti bucket_value può essere solo uno dei seguenti:
value

object (Value)

ResponseDebugInfo

Informazioni di debug sulla risposta.

Rappresentazione JSON 
{
  "formattedDebugInfo": string
}
Campi
formattedDebugInfo

string

Informazioni di debug generali formattate per la visualizzazione.

ErrorInfo

Informazioni sull'errore relativo alla risposta.

Rappresentazione JSON 
{
  "errorMessages": [
    {
      object (ErrorMessage)
    }
  ]
}
Campi
errorMessages[]

object (ErrorMessage)

ErrorMessage

Messaggio di errore per risposta dell'origine.

Rappresentazione JSON 
{
  "source": {
    object (Source)
  },
  "errorMessage": string
}
Campi
source

object (Source)
errorMessage

string

ResultCounts

Informazioni sul conteggio dei risultati

Rappresentazione JSON 
{
  "sourceResultCounts": [
    {
      object (SourceResultCount)
    }
  ]
}
Campi
sourceResultCounts[]

object (SourceResultCount)

Informazioni sul conteggio dei risultati per ogni origine con risultati.

SourceResultCount

Informazioni sul conteggio dei risultati per origine.

Rappresentazione JSON 
{
  "source": {
    object (Source)
  },
  "hasMoreResults": boolean,

  // Union field result_count can be only one of the following:
  "resultCountEstimate": string,
  "resultCountExact": string
  // End of list of possible types for union field result_count.
}
Campi
source

object (Source)

L'origine a cui sono associate le informazioni sul conteggio dei risultati.
hasMoreResults

boolean

Indica se sono presenti altri risultati di ricerca per questa origine.

Campo unione result_count.

result_count può essere solo uno dei seguenti:
resultCountEstimate

string (int64 format)

Il conteggio stimato dei risultati per questa origine.
resultCountExact

string (int64 format)

Il conteggio esatto dei risultati per questa origine.