Method: query.search

Cloud Search Query API, खोज करने का तरीका उपलब्ध कराता है. इससे उपयोगकर्ता की क्वेरी के हिसाब से सबसे काम के नतीजे मिलते हैं. नतीजे, Gmail या Google Drive जैसे Google Workspace ऐप्लिकेशन से मिल सकते हैं. इसके अलावा, ये ऐसे डेटा से भी मिल सकते हैं जिसे आपने तीसरे पक्ष से इंडेक्स किया है.

ध्यान दें: इस एपीआई को चलाने के लिए, स्टैंडर्ड एंड यूज़र खाते की ज़रूरत होती है. सेवा खाता, क्वेरी एपीआई के अनुरोध सीधे तौर पर नहीं कर सकता. क्वेरी करने के लिए सेवा खाते का इस्तेमाल करने के लिए, Google Workspace के डोमेन के अधिकार देने की सुविधा सेट अप करें.

एचटीटीपी अनुरोध

POST https://cloudsearch.googleapis.com/v1/query/search

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल होता है:

JSON के काेड में दिखाना
{
  "requestOptions": {
    object (RequestOptions)
  },
  "query": string,
  "pageSize": integer,
  "start": integer,
  "dataSourceRestrictions": [
    {
      object (DataSourceRestriction)
    }
  ],
  "facetOptions": [
    {
      object (FacetOptions)
    }
  ],
  "sortOptions": {
    object (SortOptions)
  },
  "queryInterpretationOptions": {
    object (QueryInterpretationOptions)
  },
  "contextAttributes": [
    {
      object (ContextAttribute)
    }
  ]
}
फ़ील्ड
requestOptions

object (RequestOptions)

अनुरोध के विकल्प, जैसे कि खोज ऐप्लिकेशन और उपयोगकर्ता का टाइमज़ोन.

query

string

रॉ क्वेरी स्ट्रिंग. ऑपरेटर की मदद से खोज के सटीक नतीजे पाना लेख में, खोज के लिए इस्तेमाल किए जा सकने वाले ऑपरेटर देखें

pageSize

integer

एक पेज पर खोज के ज़्यादा से ज़्यादा नतीजे दिखाने की संख्या. मान्य वैल्यू 1 से 100 के बीच होनी चाहिए. इसमें ये भी शामिल हैं. डिफ़ॉल्ट वैल्यू 10 है. अगर 2,000 से ज़्यादा नतीजे मांगे जाते हैं, तो कम से कम वैल्यू 50 होनी चाहिए.

start

integer

नतीजों का शुरुआती इंडेक्स.

dataSourceRestrictions[]

object (DataSourceRestriction)

क्वेरी के लिए इस्तेमाल किए जाने वाले सोर्स. अगर कोई डेटा सोर्स नहीं चुना जाता है, तो मौजूदा खोज ऐप्लिकेशन के सभी डेटा सोर्स का इस्तेमाल किया जाता है.

facetOptions[]

object (FacetOptions)

sortOptions

object (SortOptions)

खोज के नतीजों को क्रम से लगाने के विकल्प

queryInterpretationOptions

object (QueryInterpretationOptions)

उपयोगकर्ता की क्वेरी को समझने के विकल्प.

contextAttributes[]

object (ContextAttribute)

अनुरोध के लिए कॉन्टेक्स्ट एट्रिब्यूट. इनका इस्तेमाल, खोज के नतीजों की रैंकिंग को अडजस्ट करने के लिए किया जाएगा. ज़्यादा से ज़्यादा 10 एलिमेंट जोड़े जा सकते हैं.

जवाब का मुख्य भाग

Search API से मिला जवाब. NEXT id: 19

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

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.
}
फ़ील्ड
queryInterpretation

object (QueryInterpretation)

उपयोगकर्ता की क्वेरी के लिए, क्वेरी इंटरप्रिटेशन का नतीजा. क्वेरी इंटरप्रिटेशन की सुविधा बंद होने पर, यह फ़ील्ड खाली होता है.

results[]

object (SearchResult)

खोज क्वेरी के नतीजे.

structuredResults[]

object (StructuredResult)

उपयोगकर्ता की क्वेरी के लिए स्ट्रक्चर्ड नतीजे. इन नतीजों को pageSize में शामिल नहीं किया जाता.

spellResults[]

object (SpellResult)

क्वेरी के लिए सुझाई गई स्पेलिंग.

facetResults[]

object (FacetResult)

फ़ैसेट के नतीजों को दोहराया गया है.

hasMoreResults

boolean

क्वेरी से मिलते-जुलते खोज के और नतीजे मौजूद हैं या नहीं.

debugInfo

object (ResponseDebugInfo)

जवाब को डीबग करने से जुड़ी जानकारी.

errorInfo

object (ErrorInfo)

जवाब के बारे में गड़बड़ी की जानकारी.

resultCounts

object (ResultCounts)

नतीजों की संख्या की ज़्यादा जानकारी.

यूनियन फ़ील्ड result_count. अनुरोध किए गए सभी डेटा सोर्स के लिए, नतीजों की कुल संख्या. अगर क्वेरी किए गए डेटा सोर्स के सेट में पहले से तय किए गए सोर्स शामिल हैं, तो इसे शामिल नहीं किया जाता. इन स्थितियों में, नतीजों की संख्या सटीक तौर पर नहीं बताई जाती, बल्कि अनुमान के तौर पर बताई जाती है:

  • जब क्वेरी में किसी वाक्यांश में दो से ज़्यादा शब्द हों, जैसे कि कोटेशन मार्क में "नतीजों की सटीक संख्या".

  • जब खोज के नतीजों के लिए, आकलन करने के लिए यूनीक एसीएल की संख्या इतनी ज़्यादा हो कि उन्हें कम समय में प्रोसेस न किया जा सके.

अगर सिस्टम सभी दस्तावेज़ों में खोज नहीं कर पाता है, तो क्वेरी को फिर से चलाएं. result_count इनमें से सिर्फ़ एक हो सकता है:

resultCountEstimate

string (int64 format)

इस क्वेरी के लिए, अनुमानित नतीजों की संख्या.

resultCountExact

string (int64 format)

इस क्वेरी के लिए सटीक नतीजों की संख्या.

अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/cloud_search.query
  • https://www.googleapis.com/auth/cloud_search

ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.

QueryInterpretationOptions

उपयोगकर्ता की क्वेरी को समझने के विकल्प.

JSON के काेड में दिखाना
{
  "disableNlInterpretation": boolean,
  "enableVerbatimMode": boolean,
  "disableSupplementalResults": boolean
}
फ़ील्ड
disableNlInterpretation

boolean

क्वेरी को नैचुरल लैंग्वेज (एनएल) में समझने की सुविधा बंद करने का फ़्लैग. डिफ़ॉल्ट रूप से गलत पर सेट होती है. नैचुरल लैंग्वेज इंटरप्रिटेशन की सुविधा बंद करने के लिए, इसे सही पर सेट करें. नैचुरल लैंग्वेज इंटरप्रिटेशन की सुविधा, सिर्फ़ पहले से तय किए गए डेटा सोर्स पर लागू होती है.

enableVerbatimMode

boolean

इस फ़्लैग को चालू करने पर, क्वेरी की नैचुरल लैंग्वेज (एनएल) व्याख्या, अतिरिक्त नतीजे पाने की सुविधा, और कस्टम शब्दों के साथ-साथ समानार्थी शब्दों के इस्तेमाल जैसी सभी इंटरनल ऑप्टिमाइज़ेशन सुविधाएं बंद हो जाती हैं. अगर दोनों में से कोई भी फ़्लैग सही है, तो एनएल इंटरप्रिटेशन की सुविधा बंद हो जाएगी.

disableSupplementalResults

boolean

किसी क्वेरी के लिए, अतिरिक्त नतीजे दिखाने की सुविधा बंद करने के लिए इस फ़्लैग का इस्तेमाल करें. अगर SearchApplication लेवल पर पूरक नतीजे दिखाने की सेटिंग को 'सही है' पर सेट किया गया है, तो इसे प्राथमिकता दी जाएगी.

QueryInterpretation

JSON के काेड में दिखाना
{
  "interpretedQuery": string,
  "interpretationType": enum (QueryInterpretation.InterpretationType),
  "reason": enum (QueryInterpretation.Reason),
  "interpretedQueryActualResultCount": integer,
  "interpretedQueryEstimatedResultCount": string
}
फ़ील्ड
interpretedQuery

string

खोज में इस्तेमाल की गई क्वेरी का मतलब. उदाहरण के लिए, सामान्य भाषा में की गई क्वेरी, जैसे कि "जॉन का ईमेल" को "भेजने वाला:जॉन सोर्स:ईमेल" के तौर पर समझा जाएगा. अगर वजह NOT_ENOUGH_RESULTS_FOUND_FOR_USER_QUERY है, तो इस फ़ील्ड में जानकारी नहीं भरी जाएगी.

interpretationType

enum (QueryInterpretation.InterpretationType)

reason

enum (QueryInterpretation.Reason)

क्वेरी को समझने की वजह. अगर व्याख्या का टाइप NONE नहीं है, तो इस फ़ील्ड की वैल्यू UNSPECIFIED नहीं होगी.

interpretedQueryActualResultCount

integer

व्याख्या की गई क्वेरी से मिले नतीजों की असल संख्या.

interpretedQueryEstimatedResultCount

string (int64 format)

अनुवाद की गई क्वेरी से मिले नतीजों की अनुमानित संख्या.

QueryInterpretation.InterpretationType

Enums
NONE खोज के नतीजे पाने के लिए, न तो आम भाषा में की गई क्वेरी का इस्तेमाल किया जाता है और न ही क्वेरी के ज़्यादा शब्दों वाले वर्शन का इस्तेमाल किया जाता है.
BLEND ओरिजनल क्वेरी के नतीजों को अन्य नतीजों के साथ मिला दिया जाता है. इन अन्य नतीजों को ओरिजनल क्वेरी के नतीजों के साथ मिलाने की वजह, यहां 'वजह' फ़ील्ड में दी गई है.
REPLACE ओरिजनल क्वेरी के नतीजों को बदल दिया जाता है. ओरिजनल क्वेरी के नतीजों को बदलने की वजह, यहां दिए गए 'वजह' फ़ील्ड में दी गई है.

QueryInterpretation.Reason

Enums
UNSPECIFIED
QUERY_HAS_NATURAL_LANGUAGE_INTENT क्वेरी को आम भाषा में समझने की सुविधा का इस्तेमाल, खोज के नतीजे पाने के लिए किया जाता है.
NOT_ENOUGH_RESULTS_FOUND_FOR_USER_QUERY क्वेरी और दस्तावेज़ के शब्दों की समानता का इस्तेमाल, क्वेरी को चुनिंदा तौर पर बड़ा करने के लिए किया जाता है, ताकि खोज के ज़्यादा नतीजे मिल सकें. ऐसा इसलिए किया जाता है, क्योंकि उपयोगकर्ता की क्वेरी के लिए खोज के ज़्यादा नतीजे नहीं मिले थे. इस मामले में, क्वेरी का मतलब बताने वाला फ़ील्ड खाली होगा.

SearchResult

ऐसे नतीजे जिनमें किसी दस्तावेज़ के लिए इंडेक्स की गई जानकारी शामिल होती है. Next id: 16

JSON के काेड में दिखाना
{
  "title": string,
  "url": string,
  "snippet": {
    object (Snippet)
  },
  "metadata": {
    object (Metadata)
  },
  "clusteredResults": [
    {
      object (SearchResult)
    }
  ],
  "debugInfo": {
    object (ResultDebugInfo)
  }
}
फ़ील्ड
title

string

खोज के नतीजे का टाइटल.

url

string

खोज नतीजे का यूआरएल. यूआरएल में, Google का रीडायरेक्ट शामिल है, जो लोगों को असल आइटम पर ले जाता है. इस यूआरएल पर हस्ताक्षर किया गया है. इसलिए, इसे बदला नहीं जाना चाहिए.

snippet

object (Snippet)

इस नतीजे के लिए उपलब्ध सभी स्निपेट (खास जानकारी) को एक साथ जोड़कर बनाया गया टेक्स्ट.

metadata

object (Metadata)

खोज के नतीजे का मेटाडेटा.

clusteredResults[]

object (SearchResult)

अगर सोर्स को क्लस्टर किया गया है, तो क्लस्टर किए गए नतीजों की सूची दें. क्लस्टर किए गए नतीजों का सिर्फ़ एक लेवल होगा. अगर मौजूदा सोर्स के लिए क्लस्टरिंग की सुविधा चालू नहीं है, तो यह फ़ील्ड खाली होगा.

debugInfo

object (ResultDebugInfo)

खोज के इस नतीजे के बारे में डीबग करने की जानकारी.

स्निपेट

खोज के नतीजे का स्निपेट, जिसमें नतीजे के तौर पर मिले पेज के कॉन्टेंट के बारे में खास जानकारी दी गई होती है.

JSON के काेड में दिखाना
{
  "snippet": string,
  "matchRanges": [
    {
      object (MatchRange)
    }
  ]
}
फ़ील्ड
snippet

string

दस्तावेज़ का स्निपेट. इसमें एस्केप किया गया एचटीएमएल वर्ण शामिल हो सकता है. इसे रेंडर करने से पहले अनएस्केप किया जाना चाहिए.

matchRanges[]

object (MatchRange)

स्निपेट में मेल खाने वाली रेंज.

MatchRange

स्निपेट की मैच की गई रेंज [start, end).

JSON के काेड में दिखाना
{
  "start": integer,
  "end": integer
}
फ़ील्ड
start

integer

स्निपेट में मैच की शुरुआती पोज़िशन.

end

integer

स्निपेट में मैच के खत्म होने की जानकारी.

मेटाडेटा

खोज के मिलते-जुलते नतीजे का मेटाडेटा.

JSON के काेड में दिखाना
{
  "source": {
    object (Source)
  },
  "mimeType": string,
  "thumbnailUrl": string,
  "owner": {
    object (Person)
  },
  "createTime": string,
  "updateTime": string,
  "fields": [
    {
      object (NamedProperty)
    }
  ],
  "displayOptions": {
    object (ResultDisplayMetadata)
  },
  "objectType": string
}
फ़ील्ड
source

object (Source)

नतीजे के लिए सोर्स का नाम, जैसे कि Gmail.

mimeType

string

खोज के नतीजे का MIME टाइप.

thumbnailUrl

string

नतीजे के थंबनेल का यूआरएल.

owner

object (Person)

दस्तावेज़ या खोज के नतीजे के ऑब्जेक्ट का मालिक (आम तौर पर, क्रिएटर).

createTime

string (Timestamp format)

खोज के नतीजे में मौजूद इस दस्तावेज़ या ऑब्जेक्ट को बनाने का समय.

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

खोज के नतीजे में मौजूद ऑब्जेक्ट में पिछली बार बदलाव कब किया गया था. अगर इसे आइटम में सेट नहीं किया गया है, तो यहां दिखाई गई वैल्यू खाली होती है. अगर updateTime का इस्तेमाल, फ़ीड के अपडेट होने की फ़्रीक्वेंसी का हिसाब लगाने के लिए किया जाता है और इसे सेट नहीं किया जाता है, तो इसकी डिफ़ॉल्ट वैल्यू, मौजूदा समय से दो साल पहले की होती है.

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".

fields[]

object (NamedProperty)

स्ट्रक्चर्ड डेटा में इंडेक्स किए गए फ़ील्ड, जिन्हें नाम वाली सामान्य प्रॉपर्टी के तौर पर दिखाया जाता है.

displayOptions

object (ResultDisplayMetadata)

ऐसे विकल्प जो यह तय करते हैं कि स्ट्रक्चर्ड डेटा के खोज नतीजे को कैसे दिखाया जाए.

objectType

string

खोज के नतीजे का ऑब्जेक्ट टाइप.

ResultDisplayMetadata

JSON के काेड में दिखाना
{
  "objectTypeLabel": string,
  "metalines": [
    {
      object (ResultDisplayMetadata.ResultDisplayLine)
    }
  ]
}
फ़ील्ड
objectTypeLabel

string

ऑब्जेक्ट के लिए डिसप्ले लेबल.

metalines[]

object (ResultDisplayMetadata.ResultDisplayLine)

मेटालाइन का वह कॉन्टेंट जो नतीजे के साथ दिखाया जाना है.

ResultDisplayMetadata.ResultDisplayLine

फ़ील्ड का वह कलेक्शन जो दिखाई गई लाइन बनाता है

JSON के काेड में दिखाना
{
  "fields": [
    {
      object (ResultDisplayMetadata.ResultDisplayField)
    }
  ]
}
फ़ील्ड
fields[]

object (ResultDisplayMetadata.ResultDisplayField)

ResultDisplayMetadata.ResultDisplayField

क्वेरी.search के नतीजों के लिए डिसप्ले फ़ील्ड

JSON के काेड में दिखाना
{
  "label": string,
  "operatorName": string,
  "property": {
    object (NamedProperty)
  }
}
फ़ील्ड
label

string

प्रॉपर्टी के लिए डिसप्ले लेबल.

operatorName

string

प्रॉपर्टी के ऑपरेटर का नाम.

property

object (NamedProperty)

प्रॉपर्टी के लिए नाम-वैल्यू पेयर.

ResultDebugInfo

नतीजे को डीबग करने से जुड़ी जानकारी.

JSON के काेड में दिखाना
{
  "formattedDebugInfo": string
}
फ़ील्ड
formattedDebugInfo

string

डिसप्ले के लिए फ़ॉर्मैट की गई सामान्य डीबग जानकारी.

StructuredResult

खोज के अनुरोध के हिस्से के तौर पर दिखाए गए स्ट्रक्चर्ड नतीजे.

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.
}
फ़ील्ड

यूनियन फ़ील्ड structured_result.

structured_result इनमें से सिर्फ़ एक हो सकता है:

person

object (Person)

किसी व्यक्ति की इमेज

SpellResult

JSON के काेड में दिखाना
{
  "suggestedQuery": string,
  "suggestionType": enum (SpellResult.SuggestionType),
  "suggestedQueryHtml": {
    object (SafeHtmlProto)
  }
}
फ़ील्ड
suggestedQuery

string

क्वेरी की सुझाई गई स्पेलिंग.

suggestionType

enum (SpellResult.SuggestionType)

मौजूदा क्वेरी के लिए सुझाव ट्रिगर किया गया है.

suggestedQueryHtml

object (SafeHtmlProto)

स्पेलिंग ठीक करने के बाद, एचटीएमएल को सैनिटाइज़ किया जाता है. इस एचटीएमएल का इस्तेमाल यूज़र इंटरफ़ेस (यूआई) में किया जा सकता है. इसमें आम तौर पर, भाषा के हिसाब से टैग होते हैं. इनका इस्तेमाल क्वेरी के उन हिस्सों को मार्क अप करने के लिए किया जाता है जिनकी स्पेलिंग की जांच की गई है.

SpellResult.SuggestionType

क्वेरी के लिए ट्रिगर किए गए सुझाव का टाइप.

Enums
SUGGESTION_TYPE_UNSPECIFIED स्पेल चेक का डिफ़ॉल्ट टाइप
NON_EMPTY_RESULTS_SPELL_SUGGESTION स्पेलिंग के सुझावों में बदलाव किया गया है, लेकिन कोई नतीजा नहीं मिला. नतीजे अब भी मूल क्वेरी के लिए दिखाए जाते हैं. हालांकि, इसमें ऐसे नतीजे शामिल नहीं होते हैं जिनमें कोई वैल्यू नहीं होती. साथ ही, इसमें स्पेलिंग के लिए एक सुझाव दिया जाता है, ताकि नतीजे दिखाए जा सकें.
ZERO_RESULTS_FULL_PAGE_REPLACEMENT जब ओरिजनल क्वेरी से कोई नतीजा नहीं मिलता, तब स्पेलिंग के सुझाव ट्रिगर होते हैं. जब मूल क्वेरी के लिए कोई नतीजा नहीं मिलता है और स्पेलिंग के सुझाव के लिए नतीजे मिलते हैं, तो हम स्पेलिंग ठीक करके खोजी गई क्वेरी के लिए नतीजे दिखाते हैं.

SafeHtmlProto

अहम जानकारी: किसी गैर-भरोसेमंद सोर्स से मिले इस मैसेज को स्वीकार करना सुरक्षित नहीं है. ऐसा इसलिए, क्योंकि हैकर के लिए ऐसे सीरियल किए गए मैसेज बनाना आसान होता है जो टाइप के सुरक्षा समझौते को पूरा नहीं करते. उदाहरण के लिए, इसमें हैकर के कंट्रोल वाली स्क्रिप्ट शामिल हो सकती है. SafeHtmlProto पाने वाला सिस्टम, SafeHtmlProto बनाने वाले पर भरोसा करता है. इसलिए, इस मैसेज को आरपीसी के जवाबों में शामिल करना आम तौर पर सुरक्षित होता है. हालांकि, आरपीसी के अनुरोधों में इसे स्वीकार करना आम तौर पर सुरक्षित नहीं होता.

JSON के काेड में दिखाना
{
  "privateDoNotAccessOrElseSafeHtmlWrappedValue": string
}
फ़ील्ड
privateDoNotAccessOrElseSafeHtmlWrappedValue

string

अहम जानकारी: इस फ़ील्ड को कभी भी सेट या पढ़ा नहीं जाना चाहिए. भले ही, यह टेस्ट से जुड़ा हो. यह निजी होता है. इस मैसेज को बनाने या पढ़ने के लिए, प्रोग्रामिंग भाषा के पैकेज के बारे में जानने के लिए, .proto फ़ाइल में सबसे ऊपर मौजूद दस्तावेज़ देखें.

FacetResult

सोर्स के हिसाब से फ़ैसेट का जवाब

JSON के काेड में दिखाना
{
  "sourceName": string,
  "objectType": string,
  "operatorName": string,
  "buckets": [
    {
      object (FacetBucket)
    }
  ]
}
फ़ील्ड
sourceName

string

उस सोर्स का नाम जिसके लिए फ़ैसेट के नतीजे दिखाए गए हैं. यह खाली नहीं होगा.

objectType

string

यह उस ऑब्जेक्ट टाइप के बारे में बताता है जिसके लिए फ़ेसट के नतीजे दिखाए जाते हैं. इसे खाली छोड़ा जा सकता है.

operatorName

string

फ़ैसेटिंग के लिए चुने गए ऑपरेटर का नाम. @see cloudsearch.SchemaPropertyOptions

buckets[]

object (FacetBucket)

जवाब में मौजूद वैल्यू के लिए FacetBuckets. इनमें कम से कम एक ऐसा नतीजा होता है जिसमें फ़िल्टर लागू किया गया हो.

FacetBucket

किसी फ़ेसट में बकेट, ऑपरेशन की बुनियादी इकाई होती है. बकेट में, फ़ील्ड के टाइप के आधार पर, एक वैल्यू या वैल्यू की लगातार रेंज हो सकती है. फ़िलहाल, FacetBucket का इस्तेमाल सिर्फ़ जवाब ऑब्जेक्ट को वापस लाने के लिए किया जाता है.

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.
}
फ़ील्ड
count

integer

बकेट की वैल्यू से मेल खाने वाले नतीजों की संख्या. खोजों के लिए सिर्फ़ तब गिनती की जाती है, जब गिनती के सटीक होने की पुष्टि हो जाती है. Cloud Search, किसी भी क्वेरी के लिए फ़ैसेट की संख्या की गारंटी नहीं देता है. साथ ही, ऐसा हो सकता है कि फ़ैसेट की संख्या सिर्फ़ कुछ समय के लिए दिखे. ऐसा एक जैसी क्वेरी के लिए भी हो सकता है. फ़ेसट की संख्या के मौजूद होने पर निर्भरता न बनाएं. इसके बजाय, फ़ेसट की संख्या के प्रतिशत का इस्तेमाल करें, जो हमेशा दिखाए जाते हैं.

percentage

integer

बकेट की वैल्यू से मेल खाने वाले नतीजों का प्रतिशत. लौटाई गई वैल्यू, (0-100] के बीच होती है. अगर यह वैल्यू पूर्णांक नहीं है, तो इसे पूर्णांक में बदल दिया जाता है. अगर वैल्यू को साफ़ तौर पर नहीं दिखाया जाता है, तो यह एक प्रतिशत वैल्यू होती है, जिसे 0 पर राउंड किया जाता है. सभी खोजों के लिए प्रतिशत दिखाए जाते हैं. हालांकि, ये अनुमानित होते हैं. प्रतिशत हमेशा दिखाए जाते हैं. इसलिए, आपको गिनती के बजाय प्रतिशत दिखाने चाहिए.

filter

object (Filter)

अगर इससे जुड़ी बकेट को चुना जाता है, तो खोज के अनुरोध में फ़िल्टर पास किया जाएगा.

यूनियन फ़ील्ड bucket_value. फ़ेसट किए गए बकेट bucket_value की रेंज या वैल्यू इनमें से सिर्फ़ एक हो सकती है:
value

object (Value)

ResponseDebugInfo

जवाब को डीबग करने से जुड़ी जानकारी.

JSON के काेड में दिखाना
{
  "formattedDebugInfo": string
}
फ़ील्ड
formattedDebugInfo

string

डिसप्ले के लिए फ़ॉर्मैट की गई सामान्य डीबग जानकारी.

ErrorInfo

जवाब के बारे में गड़बड़ी की जानकारी.

JSON के काेड में दिखाना
{
  "errorMessages": [
    {
      object (ErrorMessage)
    }
  ]
}
फ़ील्ड
errorMessages[]

object (ErrorMessage)

ErrorMessage

हर सोर्स के जवाब के हिसाब से गड़बड़ी का मैसेज.

JSON के काेड में दिखाना
{
  "source": {
    object (Source)
  },
  "errorMessage": string
}
फ़ील्ड
source

object (Source)

errorMessage

string

ResultCounts

नतीजों की संख्या के बारे में जानकारी

JSON के काेड में दिखाना
{
  "sourceResultCounts": [
    {
      object (SourceResultCount)
    }
  ]
}
फ़ील्ड
sourceResultCounts[]

object (SourceResultCount)

नतीजे देने वाले हर सोर्स के लिए, नतीजों की संख्या की जानकारी.

SourceResultCount

हर सोर्स के हिसाब से, नतीजे की संख्या की जानकारी.

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.
}
फ़ील्ड
source

object (Source)

वह सोर्स जिससे नतीजों की संख्या की जानकारी जुड़ी है.

hasMoreResults

boolean

इस सोर्स के लिए, खोज के और नतीजे उपलब्ध हैं या नहीं.

यूनियन फ़ील्ड result_count.

result_count इनमें से सिर्फ़ एक हो सकता है:

resultCountEstimate

string (int64 format)

इस सोर्स के लिए, अनुमानित नतीजों की संख्या.

resultCountExact

string (int64 format)

इस सोर्स के लिए नतीजों की सटीक संख्या.