SearchResult

Represents the search results.

JSON representation
{"id":string,"document":{object (Document)},"chunk":{object (Chunk)},"modelScores":{string:{object (DoubleList)},...},"rankSignals":{object (RankSignals)}}
Fields
id

string

Document.id of the searchedDocument.

document

object (Document)

The document data snippet in the search response. Only fields that are marked asretrievable are populated.

chunk

object (Chunk)

The chunk data in the search response if theSearchRequest.ContentSearchSpec.search_result_mode is set toCHUNKS.

modelScores

map (key: string, value: object (DoubleList))

Output only. Google provided available scores.

rankSignals

object (RankSignals)

Optional. A set of ranking signals associated with the result.

Chunk

Chunk captures all raw metadata information of items to be recommended or searched in the chunk mode.

JSON representation
{"name":string,"id":string,"content":string,"documentMetadata":{object (DocumentMetadata)},"derivedStructData":{object},"pageSpan":{object (PageSpan)},"chunkMetadata":{object (ChunkMetadata)},"dataUrls":[string],"annotationContents":[string],"annotationMetadata":[{object (AnnotationMetadata)}],"relevanceScore":number}
Fields
name

string

The full resource name of the chunk. Format:projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}/branches/{branch}/documents/{documentId}/chunks/{chunk_id}.

This field must be a UTF-8 encoded string with a length limit of 1024 characters.

id

string

Unique chunk ID of the current chunk.

content

string

Content is a string from a document (parsed content).

documentMetadata

object (DocumentMetadata)

Metadata of the document from the current chunk.

derivedStructData

object (Struct format)

Output only. This field is OUTPUT_ONLY. It contains derived data that are not in the original input document.

pageSpan

object (PageSpan)

Page span of the chunk.

chunkMetadata

object (ChunkMetadata)

Output only. Metadata of the current chunk.

dataUrls[]

string

Output only. Image Data URLs if the current chunk contains images. Data URLs are composed of four parts: a prefix (data:), a MIME type indicating the type of data, an optional base64 token if non-textual, and the data itself: data:[][;base64],

annotationContents[]

string

Output only. Annotation contents if the current chunk contains annotations.

annotationMetadata[]

object (AnnotationMetadata)

Output only. The annotation metadata includes structured content in the current chunk.

relevanceScore

number

Output only. Represents the relevance score based on similarity. Higher score indicates higher chunk relevance. The score is in range [-1.0, 1.0]. Only populated onSearchResponse.

DocumentMetadata

Document metadata contains the information of the document of the current chunk.

JSON representation
{"uri":string,"title":string,"mimeType":string,"structData":{object}}
Fields
uri

string

Uri of the document.

title

string

Title of the document.

mimeType

string

The mime type of the document.https://www.iana.org/assignments/media-types/media-types.xhtml.

structData

object (Struct format)

Data representation. The structured JSON data for the document. It should conform to the registeredSchema or anINVALID_ARGUMENT error is thrown.

PageSpan

Page span of the chunk.

JSON representation
{"pageStart":integer,"pageEnd":integer}
Fields
pageStart

integer

The start page of the chunk.

pageEnd

integer

The end page of the chunk.

ChunkMetadata

Metadata of the current chunk. This field is only populated onSearchService.Search API.

JSON representation
{"previousChunks":[{object (Chunk)}],"nextChunks":[{object (Chunk)}]}
Fields
previousChunks[]

object (Chunk)

The previous chunks of the current chunk. The number is controlled bySearchRequest.ContentSearchSpec.ChunkSpec.num_previous_chunks. This field is only populated onSearchService.Search API.

nextChunks[]

object (Chunk)

The next chunks of the current chunk. The number is controlled bySearchRequest.ContentSearchSpec.ChunkSpec.num_next_chunks. This field is only populated onSearchService.Search API.

AnnotationMetadata

The annotation metadata includes structured content in the current chunk.

JSON representation
{"structuredContent":{object (StructuredContent)},"imageId":string}
Fields
structuredContent

object (StructuredContent)

Output only. The structured content information.

imageId

string

Output only. Image id is provided if the structured content is based on an image.

StructuredContent

The structured content information.

JSON representation
{"structureType":enum (StructureType),"content":string}
Fields
structureType

enum (StructureType)

Output only. The structure type of the structured content.

content

string

Output only. The content of the structured content.

StructureType

Defines the types of the structured content that can be extracted.

Enums
STRUCTURE_TYPE_UNSPECIFIEDDefault value.
SHAREHOLDER_STRUCTUREShareholder structure.
SIGNATURE_STRUCTUREsignature structure.
CHECKBOX_STRUCTURECheckbox structure.

DoubleList

Double list.

JSON representation
{"values":[number]}
Fields
values[]

number

Double values.

RankSignals

A set of ranking signals.

JSON representation
{"defaultRank":number,"customSignals":[{object (CustomSignal)}],"keywordSimilarityScore":number,"relevanceScore":number,"semanticSimilarityScore":number,"pctrRank":number,"topicalityRank":number,"documentAge":number,"boostingFactor":number}
Fields
defaultRank

number

Optional. The default rank of the result.

customSignals[]

object (CustomSignal)

Optional. A list of custom clearbox signals.

keywordSimilarityScore

number

Optional. Keyword matching adjustment.

relevanceScore

number

Optional. Semantic relevance adjustment.

semanticSimilarityScore

number

Optional. Semantic similarity adjustment.

pctrRank

number

Optional. Predicted conversion rate adjustment as a rank.

topicalityRank

number

Optional. Topicality adjustment as a rank.

documentAge

number

Optional. Age of the document in hours.

boostingFactor

number

Optional. Combined custom boosts for a doc.

CustomSignal

Custom clearbox signal represented by name and value pair.

JSON representation
{"name":string,"value":number}
Fields
name

string

Optional. name of the signal.

value

number

Optional. Float value representing the ranking signal (e.g. 1.25 for BM25).

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-11-12 UTC.