SearchResponse

Search API yanıtı. NEXT kimliği: 17

JSON gösterimi 
{
  "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.
}
Alanlar
queryInterpretation

object (QueryInterpretation)

Kullanıcı sorgusu için sorgu yorumlama sonucu. Sorgu yorumlama devre dışıysa boştur.
results[]

object (SearchResult)

Bir arama sorgusunun sonuçları.
structuredResults[]

object (StructuredResult)

Kullanıcı sorgusu için yapılandırılmış sonuçlar. Bu sonuçlar pageSize'e dahil edilmez.
spellResults[]

object (SpellResult)

Sorgu için önerilen yazım.
facetResults[]

object (FacetResult)

Tekrarlanan yön sonuçları.
hasMoreResults

boolean

Sorguyla eşleşen başka arama sonucu olup olmadığı.
debugInfo

object (ResponseDebugInfo)

Yanıtla ilgili hata ayıklama bilgileri.
errorInfo

object (ErrorInfo)

Yanıtla ilgili hata bilgileri.
resultCounts

object (ResultCounts)

Genişletilmiş sonuç sayısı bilgileri.

Birlik alanı result_count. İstenen tüm veri kaynaklarındaki toplam sonuç sayısı. Sorgulanan veri kaynakları grubuna önceden tanımlanmış kaynaklar dahil edilmişse atlanır. Sonuç sayıları aşağıdaki durumlarda tam sayı yerine tahmin olarak döndürülebilir:

  • Sorgu, bir kelime öbeğinde 2'den fazla terim içeriyorsa (ör. tırnak içinde "sonuç sayısı tam").

  • Değerlendirilecek benzersiz arama sonucu ACL'si sayısı, makul bir gecikme süresi içinde hesaplanmayacak kadar büyük olduğunda.

Sistemin tüm dokümanları arayamamasının nadir bir durumda olması halinde sorguyu yeniden çalıştırın. result_count yalnızca aşağıdakilerden biri olabilir:
resultCountEstimate

string (int64 format)

Bu sorgu için tahmini sonuç sayısı.
resultCountExact

string (int64 format)

Bu sorgunun tam sonuç sayısı.

QueryInterpretation

JSON gösterimi 
{
  "interpretedQuery": string,
  "interpretationType": enum (QueryInterpretation.InterpretationType),
  "reason": enum (QueryInterpretation.Reason),
  "interpretedQueryActualResultCount": integer,
  "interpretedQueryEstimatedResultCount": string
}
Alanlar
interpretedQuery

string

Aramada kullanılan sorgunun yorumu. Örneğin, "mehmet'in e-postası" gibi doğal dil amaçlı sorgular "from:mehmet source:mail" olarak yorumlanır. Neden NOT_ENOUGH_RESULTS_FOUND_FOR_USER_QUERY olduğunda bu alan doldurulmaz.
interpretationType

enum (QueryInterpretation.InterpretationType)
reason

enum (QueryInterpretation.Reason)

Sorgunun yorumlanma nedeni. Yorumlama türü NONE değilse bu alan UNSPECIFIED olmaz.
interpretedQueryActualResultCount

integer

Yorumlanmış sorgu tarafından döndürülen gerçek sonuç sayısı.
interpretedQueryEstimatedResultCount

string (int64 format)

Yorumlanmış sorgu tarafından döndürülen tahmini sonuç sayısı.

QueryInterpretation.InterpretationType

Sıralamalar
NONE Arama sonuçlarını almak için doğal dil yorumu veya sorgunun daha geniş bir sürümü kullanılmaz.
BLEND Orijinal sorgudan elde edilen sonuçlar diğer sonuçlarla harmanlanır. Bu diğer sonuçların orijinal sorgudaki sonuçlarla birleştirilmesinin nedeni, aşağıdaki "neden" alanına doldurulur.
REPLACE Orijinal sorgunun sonuçları değiştirilir. Orijinal sorgudan alınan sonuçların değiştirilme nedeni aşağıdaki "neden" alanına doldurulur.

QueryInterpretation.Reason

Sıralamalar
UNSPECIFIED
QUERY_HAS_NATURAL_LANGUAGE_INTENT Arama sonuçlarını almak için sorgunun doğal dil yorumu kullanılır.
NOT_ENOUGH_RESULTS_FOUND_FOR_USER_QUERY Sorgu ve doküman terimleri benzerliği, kullanıcı sorgusu için yeterli sonuç bulunamadığından sorguyu seçici bir şekilde genişleterek ek arama sonuçları almak için kullanılır. Yorumlanmış sorgu bu durumda boş olur.

SearchResult

Bir dokümanla ilgili dizine eklenen bilgileri içeren sonuçlar.

JSON gösterimi 
{
  "title": string,
  "url": string,
  "snippet": {
    object (Snippet)
  },
  "metadata": {
    object (Metadata)
  },
  "clusteredResults": [
    {
      object (SearchResult)
    }
  ],
  "debugInfo": {
    object (ResultDebugInfo)
  }
}
Alanlar
title

string

Arama sonucunun başlığı.
url

string

Arama sonucunun URL'si. URL, gerçek öğeye yönlendiren bir Google yönlendirmesi içeriyor. Bu URL imzalıdır ve değiştirilmemelidir.
snippet

object (Snippet)

Bu sonuç için kullanılabilen tüm snippet'lerin (özetlerin) birleştirilmesi.
metadata

object (Metadata)

arama sonucunun meta verileri.
clusteredResults[]

object (SearchResult)

Kaynak kümelenmişse kümelenmiş sonuçların listesini sağlayın. Yalnızca bir düzeyde kümelenmiş sonuçlar olur. Mevcut kaynak küme oluşturma için etkinleştirilmemişse bu alan boş olur.
debugInfo

object (ResultDebugInfo)

Bu arama sonucuyla ilgili hata ayıklama bilgileri.

Snippet

Arama sonucunun, sonuçlanan sayfanın içeriğini özetleyen snippet'i.

JSON gösterimi 
{
  "snippet": string,
  "matchRanges": [
    {
      object (MatchRange)
    }
  ]
}
Alanlar
snippet

string

Belgenin snippet'i. Oluşturmadan önce kod dışı bırakılması gereken kod dışı bırakılmış HTML karakterleri içerebilir.
matchRanges[]

object (MatchRange)

Snippet'te eşleşen aralıklar.

MatchRange

Bir snippet'in eşleşen aralığı [başlangıç, bitiş].

JSON gösterimi 
{
  "start": integer,
  "end": integer
}
Alanlar
start

integer

Eşleşmenin snippet'teki başlangıç konumu.
end

integer

Snippet'te maçın sonu.

Meta veri

eşleşen bir arama sonucunun meta verileri.

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

object (Source)

Gmail gibi sonucun adlandırılmış kaynağı.
mimeType

string

Arama sonucunun MIME türü.
thumbnailUrl

string

Sonucun küçük resim URL'si.
owner

object (Person)

arama sonucunun sahibi (genellikle dosyayı veya nesneyi oluşturan kişi)
createTime

string (Timestamp format)

Arama sonucundaki bu dokümanın veya nesnenin oluşturulma zamanı.

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Arama sonucundaki nesnenin son değiştirilme tarihi. Öğede ayarlanmamışsa burada döndürülen değer boş olur. Güncelliği hesaplamak için updateTime kullanılırsa ve ayarlanmazsa bu değer varsayılan olarak geçerli zamandan itibaren 2 yıl olarak belirlenir.

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
fields[]

object (NamedProperty)

Yapılandırılmış verilerdeki dizine eklenen alanlar, genel bir adlandırılmış mülk olarak döndürülür.
displayOptions

object (ResultDisplayMetadata)

seçenekleri, yapılandırılmış veri arama sonucunun nasıl gösterileceğini belirtir.
objectType

string

Arama sonucunun nesne türü.

ResultDisplayMetadata

JSON gösterimi 
{
  "objectTypeLabel": string,
  "metalines": [
    {
      object (ResultDisplayMetadata.ResultDisplayLine)
    }
  ]
}
Alanlar
objectTypeLabel

string

Nesnenin görüntüleme etiketi.
metalines[]

object (ResultDisplayMetadata.ResultDisplayLine)

Sonuçla birlikte gösterilecek meta satır içeriği.

ResultDisplayMetadata.ResultDisplayLine

Gösterilen bir satırı oluşturan alan koleksiyonu

JSON gösterimi 
{
  "fields": [
    {
      object (ResultDisplayMetadata.ResultDisplayField)
    }
  ]
}
Alanlar
fields[]

object (ResultDisplayMetadata.ResultDisplayField)

ResultDisplayMetadata.ResultDisplayField

Arama Sonuçları İçin Görüntüleme Alanları

JSON gösterimi 
{
  "label": string,
  "operatorName": string,
  "property": {
    object (NamedProperty)
  }
}
Alanlar
label

string

Tesisin görünen etiketi.
operatorName

string

Tesisin işletmeci adı.
property

object (NamedProperty)

Mülkün ad değeri çifti.

ResultDebugInfo

Sonuçla ilgili hata ayıklama bilgileri.

JSON gösterimi 
{
  "formattedDebugInfo": string
}
Alanlar
formattedDebugInfo

string

Gösterilmek üzere biçimlendirilmiş genel hata ayıklama bilgileri.

StructuredResult

Arama isteği kapsamında döndürülen yapılandırılmış sonuçlar.

JSON gösterimi 
{

  // 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.
}
Alanlar

Birlik alanı structured_result.

structured_result yalnızca aşağıdakilerden biri olabilir:
person

object (Person)

Bir kişinin temsili

SpellResult

JSON gösterimi 
{
  "suggestedQuery": string,
  "suggestionType": enum (SpellResult.SuggestionType),
  "suggestedQueryHtml": {
    object (SafeHtmlProto)
  }
}
Alanlar
suggestedQuery

string

Sorgunun önerilen yazımı.
suggestionType

enum (SpellResult.SuggestionType)

önerisi tetiklenir.
suggestedQueryHtml

object (SafeHtmlProto)

Kullanıcı arayüzünde kullanılabilen, yazımı düzeltilmiş sorguyu temsil eden temizlenmiş HTML. Bu, genellikle sorgunun yazım denetimi yapılan bölümlerini işaretlemek için dile özgü etiketler içerir.

SpellResult.SuggestionType

Sorgu için tetiklenen öneri türü.

Sıralamalar
SUGGESTION_TYPE_UNSPECIFIED Varsayılan yazım denetimi türü
NON_EMPTY_RESULTS_SPELL_SUGGESTION Değişen sonuç olmadan yazım önerisi. Sonuçlar, orijinal sorgu için (sonuç sayısı sıfırdan farklı) sonuçlara sahip bir yazım önerisiyle birlikte gösterilmeye devam eder.
ZERO_RESULTS_FULL_PAGE_REPLACEMENT Orijinal sorgu sonuç vermediğinde yazım önerisi tetiklenir. Orijinal sorgunun sonucu yoksa ve yazım önerisinin sonucu varsa yazım hatası düzeltilmiş sorgunun sonuçlarını tetikleriz.

SafeHtmlProto

ÖNEMLİ: Bir saldırganın, türün güvenlik sözleşmesini karşılamayan serileştirilmiş mesajlar oluşturması çok kolay olduğundan, bu iletiyi güvenilmeyen bir kaynaktan kabul etmek güvenli değildir. Örneğin, saldırgan tarafından kontrol edilen komut dosyası içerebilir. SafeHtmlProto alan bir sistem, SafeHtmlProto'nun üreticisine dolaylı olarak güvenir. Bu nedenle, bu mesajı RPC yanıtlarında döndürmek genellikle güvenlidir ancak RPC isteklerinde kabul etmek genellikle güvenli değildir.

JSON gösterimi 
{
  "privateDoNotAccessOrElseSafeHtmlWrappedValue": string
}
Alanlar
privateDoNotAccessOrElseSafeHtmlWrappedValue

string

ÖNEMLİ: Testlerden bile olsa bu alanı hiçbir zaman ayarlamayın veya okumayın. Bu alan gizlidir. Bu mesajı oluşturmak veya okumak için kullanabileceğiniz programlama dili paketleri için .proto dosyasının üst kısmındaki dokümanları inceleyin.

FacetResult

Kaynağa özgü yön yanıtı

JSON gösterimi 
{
  "sourceName": string,
  "objectType": string,
  "operatorName": string,
  "buckets": [
    {
      object (FacetBucket)
    }
  ]
}
Alanlar
sourceName

string

Yön bölümünün sonuçlarının döndürüldüğü kaynak adı. Boş olmaz.
objectType

string

Yön bölümünün sonuçlarının döndürüldüğü nesne türü. Boş bırakılabilir.
operatorName

string

Kelime öbeğine ayırma için seçilen operatörün adı. @see cloudsearch.SchemaPropertyOptions
buckets[]

object (FacetBucket)

Yanıtta, ilgili filtreyle en az bir sonuç içeren değerler için FacetBuckets.

FacetBucket

Bir kesite ait grup, temel işlem birimidir. Gruplandırılan alanın türüne bağlı olarak grup, tek bir değer VEYA bitişik bir değer aralığı içerebilir. FacetBucket şu anda yalnızca yanıt nesnesini döndürmek için kullanılır.

JSON gösterimi 
{
  "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.
}
Alanlar
count

integer

Grup değeriyle eşleşen sonuç sayısı. Sayılar yalnızca sayı doğruluğu sağlandığında aramalar için döndürülür. Cloud Search, herhangi bir sorgu için yön sayısı garanti etmez ve yön sayıları, aynı sorgular için bile yalnızca ara sıra gösterilebilir. Yüz sayısı varlığına bağlı bağımlılıklar oluşturmayın. Bunun yerine her zaman döndürülen yüz sayısı yüzdelerini kullanın.
percentage

integer

Paket değeriyle eşleşen sonuçların yüzdesi. Döndürülen değer [0-100] aralığındadır ve kesirli ise tam sayıya yuvarlanır. Değer açıkça döndürülmezse 0'a yuvarlanan bir yüzde değerini temsil eder. Yüzdeler tüm aramalar için döndürülür ancak tahminidir. Yüzdeler her zaman döndürüldüğünden, sayılar yerine yüzdeleri oluşturmanız gerekir.
filter

object (Filter)

İlgili paket seçilirse arama isteğine iletilecek filtre.
Birlik alanı bucket_value. bucket_value boyutlandırılmış paketin aralığı veya değeri aşağıdakilerden yalnızca biri olabilir:
value

object (Value)

ResponseDebugInfo

Yanıtla ilgili hata ayıklama bilgileri.

JSON gösterimi 
{
  "formattedDebugInfo": string
}
Alanlar
formattedDebugInfo

string

Gösterilmek üzere biçimlendirilmiş genel hata ayıklama bilgileri.

ErrorInfo

Yanıtla ilgili hata bilgileri.

JSON gösterimi 
{
  "errorMessages": [
    {
      object (ErrorMessage)
    }
  ]
}
Alanlar
errorMessages[]

object (ErrorMessage)

ErrorMessage

Kaynak yanıtı başına hata mesajı.

JSON gösterimi 
{
  "source": {
    object (Source)
  },
  "errorMessage": string
}
Alanlar
source

object (Source)
errorMessage

string

ResultCounts

Sonuç sayısı bilgileri

JSON gösterimi 
{
  "sourceResultCounts": [
    {
      object (SourceResultCount)
    }
  ]
}
Alanlar
sourceResultCounts[]

object (SourceResultCount)

Sonuç içeren her kaynak için sonuç sayısı bilgileri.

SourceResultCount

Kaynak başına sonuç sayısı bilgileri.

JSON gösterimi 
{
  "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.
}
Alanlar
source

object (Source)

Sonuç sayısı bilgilerinin ilişkili olduğu kaynak.
hasMoreResults

boolean

Bu kaynak için daha fazla arama sonucu olup olmadığı.

Birlik alanı result_count.

result_count yalnızca aşağıdakilerden biri olabilir:
resultCountEstimate

string (int64 format)

Bu kaynak için tahmini sonuç sayısı.
resultCountExact

string (int64 format)

Bu kaynak için tam sonuç sayısı.