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)
    }
  ]
}
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 Gesamtanzahl ü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. Wird dieses Feld weggelassen, gibt es keine nachfolgenden Seiten.
correctedQuery

string

Enthält die rechtschreibkorrigierte Anfrage, sofern gefunden. 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

Steuerungen, 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.

Facette

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 aus 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 Attributen 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, mit dem die Ergebnisse eingegrenzt werden. Beispiel: "drama".

GeoSearchDebugInfo

Debugging-Informationen speziell zu Problemen mit dem Forward Geocoding, die durch die Geolocation-Suche entstehen.

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

string

Die Adresse, bei der beim Forward Geocoding Probleme aufgetreten sind.
errorMessage

string

Der aufgetretene Fehler.

QueryExpansionInfo

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

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

boolean

Boolescher Wert, der angibt, ob eine Suchanfragenerweiterung erfolgt ist
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 in natürlicher Sprache 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 String-, numerische oder geografische Einschränkung angibt, oder um einen zusammengesetzten Ausdruck, der eine Kombination aus mehreren Ausdrücken ist, die mit logischen Operatoren (OR und AND) verbunden sind.

Ausdruck

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)

Numerischer Einschränkungsausdruck.
geolocationConstraint

object (GeolocationConstraint)

Ausdruck für die Einschränkung der geografischen Position.
andExpr

object (AndExpression)

Logischer zusammengesetzter „And“-Operator, der mehrere Ausdrücke verbindet.
orExpr

object (OrExpression)

Logischer „Or“-Operator, der mehrere Ausdrücke verbindet.

StringConstraint

Einschränkungsausdruck 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 Keywords in der Suchanfrage an, die mit einem Filter übereinstimmen.

NumberConstraint

Einschränkungsausdruck eines Zahlenfelds. Beispiel: Preis < 100.

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

string

Name des numerischen Felds, 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 Keywords in der Suchanfrage an, die mit einem Filter übereinstimmen.

Vergleich

Der durchgeführte Vergleichsvorgang.

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

GeolocationConstraint

Einschränkung eines Felds „Standort“. Name des Standorts, 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 Eingabeabfrage abgeleitet wurde. Die Nähe der Referenzadresse zum Geolocation-Feld 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 der Standort des Geolocation-Felds 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 automatische Sitzungsmodus 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 mehrere 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 wir in der Benutzeroberfläche unterschiedlich darstellen möchten.

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

enum (OneBoxType)

Der Typ des OneBox-Ergebnisses.
searchResults[]

object (SearchResult)

Die Suchergebnisse für dieses OneBox-Ergebnis.

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.