SearchResponse

Antwortnachricht für die Methode SearchService.Search.

JSON-Darstellung 
{
  "results": [
    {
      object (SearchResult)
    }
  ],
  "facets": [
    {
      object (Facet)
    }
  ],
  "guidedSearchResult": {
    object (GuidedSearchResult)
  },
  "totalSize": integer,
  "attributionToken": string,
  "redirectUri": string,
  "nextPageToken": string,
  "correctedQuery": string,
  "suggestedQuery": string,
  "summary": {
    object (Summary)
  },
  "appliedControls": [
    string
  ],
  "geoSearchDebugInfo": [
    {
      object (GeoSearchDebugInfo)
    }
  ],
  "queryExpansionInfo": {
    object (QueryExpansionInfo)
  },
  "naturalLanguageQueryUnderstandingInfo": {
    object (NaturalLanguageQueryUnderstandingInfo)
  },
  "sessionInfo": {
    object (SessionInfo)
  },
  "oneBoxResults": [
    {
      object (OneBoxResult)
    }
  ],
  "searchLinkPromotions": [
    {
      object (SearchLinkPromotion)
    }
  ],
  "semanticState": enum (SemanticState)
}
Felder
results[]

object (SearchResult)

Eine Liste der übereinstimmenden Dokumente. Die Reihenfolge entspricht dem Ranking.
facets[]

object (Facet)

Ergebnisse der vom Nutzer angeforderten Facetten.
guidedSearchResult

object (GuidedSearchResult)

Ergebnis der geführten Suche.
totalSize

integer

Die geschätzte Gesamtzahl übereinstimmender Elemente unabhängig von der Paginierung. Die Anzahl der von der Paginierung zurückgegebenen results kann geringer sein als die totalSize der Übereinstimmungen.
attributionToken

string

Ein eindeutiges Suchtoken. Es sollte in den UserEvent-Logs enthalten sein, die für diese Suche generiert werden. Damit lässt sich die Leistung des Suchmodells genau zuordnen. Außerdem kann eine Anfrage so leichter identifiziert werden, wenn Kunden Support benötigen.
redirectUri

string

Der URI einer vom Kunden definierten Weiterleitungsseite. Wenn eine Weiterleitungsaktion ausgelöst wird, wird keine Suche durchgeführt, und in der Antwort werden nur redirectUri und attributionToken festgelegt.
nextPageToken

string

Ein Token, das als SearchRequest.page_token gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.
correctedQuery

string

Enthält die Anfrage mit korrigierter Rechtschreibung, sofern Fehler gefunden wurden. Wenn der Typ der Rechtschreibkorrektur AUTOMATIC lautet, basieren die Suchergebnisse auf der „correctedQuery“. Andernfalls wird die ursprüngliche Anfrage für die Suche verwendet.
suggestedQuery

string

Korrigierte Anfrage mit niedrigem Konfidenzwert, auch „Meinten Sie“-Anfrage genannt. Im Vergleich zu „correctedQuery“ wird dieses Feld festgelegt, wenn SpellCorrector eine Antwort zurückgegeben hat, FPR (full page replacement, vollständiger Seitenersatz) jedoch nicht ausgelöst wird, weil die Korrektur eine geringe Wahrscheinlichkeit hat (z. B. umgekehrt, weil es Übereinstimmungen der ursprünglichen Anfrage im Dokumentkorpus gibt).
summary

object (Summary)

Eine Zusammenfassung als Teil der Suchergebnisse. Dieses Feld wird nur zurückgegeben, wenn SearchRequest.ContentSearchSpec.summary_spec festgelegt ist.
appliedControls[]

string

Kontrollen, die im Rahmen des Control-Dienstes angewendet werden.
geoSearchDebugInfo[]

object (GeoSearchDebugInfo)
queryExpansionInfo

object (QueryExpansionInfo)

Informationen zur Suchanfragenerweiterung für die zurückgegebenen Ergebnisse.
naturalLanguageQueryUnderstandingInfo

object (NaturalLanguageQueryUnderstandingInfo)

Informationen zur Interpretation von Anfragen in natürlicher Sprache für die zurückgegebenen Ergebnisse.
sessionInfo

object (SessionInfo)

Informationen zur Sitzung.

Wird nur festgelegt, wenn SearchRequest.session angegeben ist. Weitere Informationen finden Sie in der Beschreibung.
oneBoxResults[]

object (OneBoxResult)

Eine Liste mit One-Box-Ergebnissen. Es kann mehrere One-Box-Ergebnisse unterschiedlicher Typen geben.
semanticState

enum (SemanticState)

Nur Ausgabe. Gibt den semantischen Status der Suchantwort an.

Facet

Ein Facettenergebnis.

JSON-Darstellung 
{
  "key": string,
  "values": [
    {
      object (FacetValue)
    }
  ],
  "dynamicFacet": boolean
}
Felder
key

string

Der Schlüssel für diese Facette. Beispiel: "colors" oder "price". Entspricht SearchRequest.FacetSpec.FacetKey.key.
values[]

object (FacetValue)

Die Facettenwerte für dieses Feld.
dynamicFacet

boolean

Gibt an, ob die Facette dynamisch generiert wird.

FacetValue

Ein Facettenwert, der Wertnamen und deren Anzahl enthält.

JSON-Darstellung 
{
  "count": string,

  // Union field facet_value can be only one of the following:
  "value": string,
  "interval": {
    object (Interval)
  }
  // End of list of possible types for union field facet_value.
}
Felder
count

string (int64 format)

Anzahl der Elemente mit diesem Facettenwert.
Union-Feld facet_value. Ein Facettenwert, der Werte enthält. Für facet_value ist nur einer der folgenden Werte zulässig:
value

string

Textwert einer Facette, z. B. „black“ für die Facette „colors“
interval

object (Interval)

Intervallwert für eine Facette, z. B. [10, 20] für die Facette „price“. Entspricht SearchRequest.FacetSpec.FacetKey.intervals.

GuidedSearchResult

Ergebnis der geführten Suche. Die geführte Suche hilft Nutzern, die Suchergebnisse einzugrenzen und in einer breiten Auswahl an Suchergebnissen die für sie relevanten zu finden.

JSON-Darstellung 
{
  "refinementAttributes": [
    {
      object (RefinementAttribute)
    }
  ],
  "followUpQuestions": [
    string
  ]
}
Felder
refinementAttributes[]

object (RefinementAttribute)

Eine Liste der nach Rang geordneten Attribute für die Verfeinerung.
followUpQuestions[]

string

Vorgeschlagene weiterführende Fragen.

RefinementAttribute

Nützliches Attribut für die Verfeinerung von Suchergebnissen.

JSON-Darstellung 
{
  "attributeKey": string,
  "attributeValue": string
}
Felder
attributeKey

string

Attributschlüssel, der zum Eingrenzen der Ergebnisse verwendet wird. Beispiel: "movie_type".
attributeValue

string

Attributwert, der zum Eingrenzen der Ergebnisse verwendet wird. Beispiel: "drama".

GeoSearchDebugInfo

Spezielle Debugging-Informationen für Probleme beim Forward Geocoding, die bei der Standortsuche entstehen.

JSON-Darstellung 
{
  "originalAddressQuery": string,
  "errorMessage": string
}
Felder
originalAddressQuery

string

Die Adresse, für die beim Forward Geocoding Probleme aufgetreten sind.
errorMessage

string

Der aufgetretene Fehler.

QueryExpansionInfo

Informationen zur Suchanfragenerweiterung, einschließlich der Angabe, ob eine Erweiterung erfolgt ist

JSON-Darstellung 
{
  "expandedQuery": boolean,
  "pinnedResultCount": string
}
Felder
expandedQuery

boolean

Boolescher Wert, der angibt, ob eine Anfrage erweitert wurde.
pinnedResultCount

string (int64 format)

Anzahl der angepinnten Ergebnisse. Dieses Feld wird nur festgelegt, wenn eine Erweiterung erfolgt und SearchRequest.QueryExpansionSpec.pin_unexpanded_results auf „true“ gesetzt ist.

NaturalLanguageQueryUnderstandingInfo

Informationen dazu, wie die Eingabeabfrage durch Natural Language Understanding interpretiert wurde.

JSON-Darstellung 
{
  "extractedFilters": string,
  "rewrittenQuery": string,
  "classifiedIntents": [
    string
  ],
  "structuredExtractedFilter": {
    object (StructuredExtractedFilter)
  }
}
Felder
extractedFilters

string

Die Filter, die aus der Eingabeabfrage extrahiert wurden.
rewrittenQuery

string

Umformulierte Eingabeabfrage ohne die extrahierten Filter.
classifiedIntents[]

string

Die klassifizierten Intentionen aus der Eingabeanfrage.
structuredExtractedFilter

object (StructuredExtractedFilter)

Die Filter, die aus der Eingabeabfrage extrahiert wurden, in strukturierter Form.

StructuredExtractedFilter

Die Filter, die aus der Eingabeabfrage extrahiert wurden, in strukturierter Form.

JSON-Darstellung 
{
  "expression": {
    object (Expression)
  }
}
Felder
expression

object (Expression)

Der Ausdruck, der den Filter angibt, der in strukturierter Form aus der Eingabeabfrage extrahiert wurde. Es kann sich um einen einfachen Ausdruck handeln, der eine einzelne Einschränkung (String, Zahl oder Standortbestimmung) angibt, oder um einen zusammengesetzten Ausdruck, der mehrere Ausdrücke kombiniert, die durch logische Operatoren (OR und AND) verknüpft sind.

Expression

Der Ausdruck, der den aus der Eingabeabfrage extrahierten Filter angibt.

JSON-Darstellung 
{

  // Union field expr can be only one of the following:
  "stringConstraint": {
    object (StringConstraint)
  },
  "numberConstraint": {
    object (NumberConstraint)
  },
  "geolocationConstraint": {
    object (GeolocationConstraint)
  },
  "andExpr": {
    object (AndExpression)
  },
  "orExpr": {
    object (OrExpression)
  }
  // End of list of possible types for union field expr.
}
Felder
Union-Feld expr. Der Ausdruckstyp. Für expr ist nur einer der folgenden Werte zulässig:
stringConstraint

object (StringConstraint)

Ausdruck für die String-Einschränkung.
numberConstraint

object (NumberConstraint)

Ausdruck für die numerische Einschränkung.
geolocationConstraint

object (GeolocationConstraint)

Ausdruck für die Einschränkung der Standortbestimmung.
andExpr

object (AndExpression)

Logischer verknüpfter Operator „And“, der mehrere Ausdrücke verbindet.
orExpr

object (OrExpression)

Logische verknüpfter Opearator „Or“, der mehrere Ausdrücke verbindet.

StringConstraint

Ausdruck für die Einschränkung eines Stringfelds.

JSON-Darstellung 
{
  "fieldName": string,
  "values": [
    string
  ],
  "querySegment": string
}
Felder
fieldName

string

Name des Stringfelds, wie im Schema definiert.
values[]

string

Werte des Stringfelds. Der Datensatz wird nur zurückgegeben, wenn der Feldwert mit einem der hier angegebenen Werte übereinstimmt.
querySegment

string

Gibt die Suchbegriffe in der Suchanfrage an, die mit einem Filter übereinstimmen.

NumberConstraint

Ausdruck für die Einschränkung eines Zahlenfelds. Beispiel: Preis < 100.

JSON-Darstellung 
{
  "fieldName": string,
  "comparison": enum (Comparison),
  "value": number,
  "querySegment": string
}
Felder
fieldName

string

Name des Zahlenfelds, wie im Schema definiert.
comparison

enum (Comparison)

Der Vergleichsvorgang, der zwischen dem Feldwert und dem in der Einschränkung angegebenen Wert ausgeführt wird.
value

number

Der in der numerischen Einschränkung angegebene Wert.
querySegment

string

Gibt die Suchbegriffe in der Suchanfrage an, die mit einem Filter übereinstimmen.

Comparison

Der durchgeführte Vergleichsvorgang.

Enums
COMPARISON_UNSPECIFIED Vergleichsoperator nicht definiert.
EQUALS Gibt den Gleichheitsoperator (=) an.
LESS_THAN_EQUALS Gibt den Operator „kleiner oder gleich“ (<=) an.
LESS_THAN Gibt den Operator „kleiner als“ (<) an.
GREATER_THAN_EQUALS Gibt den Operator „größer oder gleich“ (>=) an.
GREATER_THAN Gibt den Operator „größer als“ (>) an.

GeolocationConstraint

Einschränkung eines Standortfelds. Der Nam des Standortfelds, wie im Schema definiert.

JSON-Darstellung 
{
  "fieldName": string,
  "address": string,
  "latitude": number,
  "longitude": number,
  "radiusInMeters": number
}
Felder
fieldName

string

Der Name des Standortfelds, wie im Schema definiert.
address

string

Die Referenzadresse, die aus der Eingabeanfrage abgeleitet wurde. Die Nähe der Referenzadresse zum Standortfeld wird verwendet, um die Ergebnisse zu filtern.
latitude

number

Der Breitengrad des Standorts, der aus der Eingabeabfrage abgeleitet wurde.
longitude

number

Der Längengrad des Standorts, der aus der Eingabeabfrage abgeleitet wurde.
radiusInMeters

number

Der Radius in Metern um die Adresse. Der Datensatz wird zurückgegeben, wenn sich die Position des Standortfelds innerhalb des Radius befindet.

AndExpression

Logischer Operator And.

JSON-Darstellung 
{
  "expressions": [
    {
      object (Expression)
    }
  ]
}
Felder
expressions[]

object (Expression)

Die Ausdrücke, die mit AND verknüpft wurden.

OrExpression

Logischer Operator Or.

JSON-Darstellung 
{
  "expressions": [
    {
      object (Expression)
    }
  ]
}
Felder
expressions[]

object (Expression)

Die Ausdrücke, die mit OR verknüpft wurden.

SessionInfo

Informationen zur Sitzung

JSON-Darstellung 
{
  "name": string,
  "queryId": string
}
Felder
name

string

Name der Sitzung. Wenn der Modus für automatische Sitzungen verwendet wird (wenn SearchRequest.session auf „-“ endet), enthält dieses Feld den neu generierten Sitzungsnamen.
queryId

string

Die Abfrage-ID für diesen Search API-Aufruf. Eine Sitzung kann aus mehreren Runden mit jeweils einer eindeutigen Abfrage-ID bestehen.

Wenn Sie den Sitzungsnamen und diese Abfrage-ID im Answer API-Aufruf angeben, erfolgt die Antwortgenerierung im Kontext der Suchergebnisse für diesen Suchaufruf.

OneBoxResult

OneBoxResult ist ein Container für alle Ergebnisse eines bestimmten Typs, die in der Benutzeroberfläche unterschiedlich dargestellt werden sollen.

JSON-Darstellung 
{
  "oneBoxType": enum (OneBoxType),
  "searchResults": [
    {
      object (SearchResult)
    }
  ]
}
Felder
oneBoxType

enum (OneBoxType)

Der Typ des OneBox-Ergebnisses.
searchResults[]

object (SearchResult)

Die Suchergebnisse für diese OneBox.

OneBoxType

Der Typ des OneBox-Ergebnisses.

Enums
ONE_BOX_TYPE_UNSPECIFIED Standardwert. Sollte nicht verwendet werden.
PEOPLE OneBox-Ergebnis enthält Ergebnisse zu Personen.
ORGANIZATION OneBox-Ergebnis enthält Ergebnisse zu Organisationen.
SLACK OneBox-Ergebnis enthält Slack-Ergebnisse.
KNOWLEDGE_GRAPH OneBox-Ergebnis enthält Antworten aus der Knowledge Graph-Suche.

SemanticState

Semantischer Status der Suchantwort.

Enums
SEMANTIC_STATE_UNSPECIFIED Standardwert. Sollte nicht verwendet werden.
DISABLED Die semantische Suche wurde für diese Suchantwort deaktiviert.
ENABLED Die semantische Suche wurde für diese Suchantwort aktiviert.