Method: query.search

Cloud Search Query API มีเมธอดการค้นหาซึ่งจะแสดงผลลัพธ์ที่เกี่ยวข้องมากที่สุดจากคำค้นหาของผู้ใช้ ผลการค้นหาอาจมาจากแอป Google Workspace เช่น Gmail หรือ Google ไดรฟ์ หรืออาจมาจากข้อมูลที่คุณจัดทำดัชนีจากบุคคลที่สาม

หมายเหตุ: API นี้ต้องใช้บัญชีผู้ใช้ปลายทางมาตรฐานในการดำเนินการ บัญชีบริการไม่สามารถส่งคำขอ API ของการค้นหาได้โดยตรง หากต้องการใช้บัญชีบริการเพื่อทำการค้นหา ให้ตั้งค่าการมอบสิทธิ์ทั้งโดเมนของ Google Workspace

คำขอ HTTP

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

URL ใช้ไวยากรณ์การแปลงรหัส 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 ค่าต่ำสุดคือ 50 เมื่อมีการขอผลลัพธ์เกิน 2,000 รายการ
start

integer

ดัชนีเริ่มต้นของผลลัพธ์
dataSourceRestrictions[]

object (DataSourceRestriction)

แหล่งข้อมูลที่จะใช้สำหรับการค้นหา หากไม่ได้ระบุ ระบบจะใช้แหล่งข้อมูลทั้งหมดจากแอปพลิเคชันการค้นหาปัจจุบัน
facetOptions[]

object (FacetOptions)
sortOptions

object (SortOptions)

ตัวเลือกสำหรับการจัดเรียงผลการค้นหา
queryInterpretationOptions

object (QueryInterpretationOptions)

ตัวเลือกในการตีความคําค้นหาของผู้ใช้
contextAttributes[]

object (ContextAttribute)

แอตทริบิวต์บริบทสำหรับคำขอซึ่งจะใช้เพื่อปรับการจัดอันดับของผลการค้นหา จำนวนองค์ประกอบสูงสุดคือ 10 รายการ

เนื้อหาการตอบกลับ

การตอบกลับจาก Search API รหัส NEXT: 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)

ข้อมูลจำนวนผลการค้นหาที่ขยาย

ฟิลด์ Union result_count จํานวนผลลัพธ์ทั้งหมดในแหล่งข้อมูลที่ขอทั้งหมด ละเว้นหากรวมแหล่งที่มาที่กําหนดไว้ล่วงหน้าไว้ในชุดแหล่งข้อมูลที่ค้นหา ระบบอาจแสดงจำนวนผลลัพธ์เป็นค่าประมาณแทนค่าที่แน่นอนในกรณีต่อไปนี้

  • เมื่อคำค้นหามีคำมากกว่า 2 คำในวลี เช่น "จำนวนผลลัพธ์ที่แน่นอน" ในเครื่องหมายคำพูด

  • เมื่อจำนวน ACL ของผลการค้นหาที่ไม่ซ้ำกันที่ต้องประเมินมีมากเกินกว่าที่จะคำนวณภายในเวลาในการตอบสนองที่สมเหตุสมผล

ในกรณีที่พบได้ยากซึ่งระบบค้นหาเอกสารทั้งหมดไม่ได้ ให้เรียกใช้คำค้นหาอีกครั้ง 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

Flag เพื่อปิดใช้การตีความการค้นหาด้วยภาษาธรรมชาติ (NL) ค่าเริ่มต้นคือ False ตั้งค่าเป็น True เพื่อปิดใช้การตีความภาษาธรรมชาติ การตีความ NL ใช้ได้กับแหล่งข้อมูลที่กำหนดไว้ล่วงหน้าเท่านั้น
enableVerbatimMode

boolean

เปิดใช้ฟีเจอร์นี้เพื่อปิดการเพิ่มประสิทธิภาพภายในทั้งหมด เช่น การตีความคำค้นหาด้วยภาษาธรรมชาติ (NL) การดึงผลการค้นหาเพิ่มเติม และการใช้คำพ้องความหมาย รวมถึงคำพ้องความหมายที่กำหนดเอง ระบบจะปิดใช้การตีความ NL หากตั้งค่าสถานะใดสถานะหนึ่งเป็นจริง
disableSupplementalResults

boolean

ใช้ Flag นี้เพื่อปิดใช้ผลการค้นหาเสริมสำหรับการค้นหา การตั้งค่าผลการค้นหาเสริมที่เลือกในระดับ SearchApplication จะมีลำดับความสำคัญเหนือกว่าหากตั้งค่าเป็น True

QueryInterpretation

การแสดง JSON 
{
  "interpretedQuery": string,
  "interpretationType": enum (QueryInterpretation.InterpretationType),
  "reason": enum (QueryInterpretation.Reason),
  "interpretedQueryActualResultCount": integer,
  "interpretedQueryEstimatedResultCount": string
}
ช่อง
interpretedQuery

string

การตีความคำค้นหาที่ใช้ในการค้นหา เช่น ระบบจะตีความคำค้นหาที่มีเจตนาเป็นภาษาธรรมชาติ เช่น "อีเมลจากสมชาย" เป็น "from:john source:mail" ระบบจะไม่กรอกข้อมูลในช่องนี้เมื่อเหตุผลคือ NOT_ENOUGH_RESULTS_FOUND_FOR_USER_QUERY
interpretationType

enum (QueryInterpretation.InterpretationType)
reason

enum (QueryInterpretation.Reason)

เหตุผลในการตีความคำค้นหา ฟิลด์นี้จะไม่เป็น UNSPECIFIED หากประเภทการตีความไม่ใช่ NONE
interpretedQueryActualResultCount

integer

จำนวนผลลัพธ์จริงที่ส่งคืนโดยคำค้นหาที่ตีความ
interpretedQueryEstimatedResultCount

string (int64 format)

จำนวนผลลัพธ์โดยประมาณที่ส่งคืนโดยคำค้นหาที่ตีความ

QueryInterpretation.InterpretationType

Enum
NONE ระบบจะไม่ใช้ทั้งการตีความภาษาธรรมชาติและคำค้นหาเวอร์ชันที่กว้างขึ้นเพื่อดึงผลการค้นหา
BLEND ระบบจะรวมผลลัพธ์จากการค้นหาเดิมเข้ากับผลลัพธ์อื่นๆ เหตุผลในการผสมผลการค้นหาอื่นๆ เหล่านี้กับผลการค้นหาจากคำค้นหาเดิมจะแสดงในช่อง "เหตุผล" ด้านล่าง
REPLACE ระบบจะแทนที่ผลลัพธ์จากการค้นหาเดิม เหตุผลในการแทนที่ผลลัพธ์จากการค้นหาเดิมจะแสดงในช่อง "เหตุผล" ด้านล่าง

QueryInterpretation.Reason

Enum
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

URL ของผลการค้นหา URL มีการเปลี่ยนเส้นทางของ Google ไปยังสินค้าจริง URL นี้มีการลงนามและไม่ควรเปลี่ยนแปลง
snippet

object (Snippet)

การต่อกันของข้อมูลโค้ด (ข้อมูลสรุป) ทั้งหมดที่พร้อมใช้งานสำหรับผลการค้นหานี้
metadata

object (Metadata)

ข้อมูลเมตาของผลการค้นหา
clusteredResults[]

object (SearchResult)

หากแหล่งที่มาเป็นคลัสเตอร์ ให้ระบุรายการผลลัพธ์ที่จัดกลุ่ม โดยจะมีผลการค้นหาที่จัดกลุ่มเพียงระดับเดียว หากไม่ได้เปิดใช้แหล่งที่มาปัจจุบันสำหรับการจัดกลุ่ม ช่องนี้จะว่างเปล่า
debugInfo

object (ResultDebugInfo)

ข้อมูลการแก้ไขข้อบกพร่องเกี่ยวกับผลการค้นหานี้

ตัวอย่างข้อมูล

ตัวอย่างข้อมูลของผลการค้นหา ซึ่งสรุปเนื้อหาของหน้าเว็บที่ได้

การแสดง JSON 
{
  "snippet": string,
  "matchRanges": [
    {
      object (MatchRange)
    }
  ]
}
ช่อง
snippet

string

ตัวอย่างของเอกสาร อาจมีอักขระ HTML ที่กำหนดไว้เป็นอักขระหลีกซึ่งควรยกเลิกการกำหนดเป็นอักขระหลีกก่อนการแสดงผล
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

URL ของภาพขนาดย่อของผลการค้นหา
owner

object (Person)

เจ้าของ (โดยปกติคือผู้สร้าง) เอกสารหรือออบเจ็กต์ของผลการค้นหา
createTime

string (Timestamp format)

เวลาที่สร้างเอกสารหรือออบเจ็กต์นี้ในผลการค้นหา

ใช้ RFC 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 ในการคำนวณความใหม่และไม่ได้ตั้งค่าไว้ ค่านี้จะตั้งค่าเริ่มต้นเป็น 2 ปีนับจากเวลาปัจจุบัน

ใช้ RFC 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)

ตัวเลือกที่ระบุวิธีแสดงผลการค้นหา Structured Data
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

ฟิลด์ที่แสดงสำหรับผลลัพธ์ของ query.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.
}
ช่อง

ฟิลด์ Union 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)

HTML ที่ผ่านการล้างข้อมูลซึ่งแสดงคำค้นหาที่แก้ไขการสะกดคำแล้วซึ่งใช้ใน UI ได้ โดยปกติแล้วจะมีแท็กเฉพาะภาษาเพื่อมาร์กอัปส่วนของคำค้นหาที่ผ่านการตรวจตัวสะกด

SpellResult.SuggestionType

ประเภทคำแนะนำที่ทริกเกอร์สำหรับคำค้นหา

Enum
SUGGESTION_TYPE_UNSPECIFIED ประเภทการตรวจตัวสะกดเริ่มต้น
NON_EMPTY_RESULTS_SPELL_SUGGESTION เปลี่ยนคำแนะนำการสะกดโดยไม่มีผลลัพธ์ ระบบจะยังแสดงผลลัพธ์สำหรับคำค้นหาเดิม (ซึ่งมีผลลัพธ์ที่ไม่ใช่ 0) พร้อมคำแนะนำสำหรับการสะกดคำที่จะมีผลลัพธ์
ZERO_RESULTS_FULL_PAGE_REPLACEMENT คำแนะนำการสะกดคำจะแสดงเมื่อคำค้นหาเดิมไม่มีผลการค้นหา เมื่อคำค้นหาเดิมไม่มีผลลัพธ์ และคำแนะนำการสะกดมีผลลัพธ์ เราจะแสดงผลลัพธ์สำหรับคำค้นหาที่แก้ไขการสะกด

SafeHtmlProto

สำคัญ: การยอมรับข้อความนี้จากแหล่งที่มาที่ไม่น่าเชื่อถือไม่ปลอดภัย เนื่องจากผู้โจมตีสามารถปลอมแปลงข้อความที่ทำให้เป็นอนุกรมซึ่งไม่เป็นไปตามสัญญาด้านความปลอดภัยของประเภทได้ง่าย เช่น อาจมีสคริปต์ที่ผู้โจมตีควบคุม ระบบที่รับ SafeHtmlProto จะเชื่อถือผู้ผลิต SafeHtmlProto โดยนัย ดังนั้น โดยทั่วไปจึงปลอดภัยที่จะส่งข้อความนี้ในการตอบกลับ RPC แต่โดยทั่วไปจะไม่ปลอดภัยที่จะยอมรับข้อความนี้ในคำขอ RPC

การแสดง JSON 
{
  "privateDoNotAccessOrElseSafeHtmlWrappedValue": string
}
ช่อง
privateDoNotAccessOrElseSafeHtmlWrappedValue

string

สำคัญ: อย่าตั้งค่าหรืออ่านฟิลด์นี้ แม้ว่าจะเป็นการทดสอบก็ตาม เนื่องจากเป็นฟิลด์ส่วนตัว ดูเอกสารประกอบที่ด้านบนของไฟล์ .proto สำหรับแพ็กเกจภาษาโปรแกรมที่จะใช้สร้างหรืออ่านข้อความนี้

FacetResult

การตอบกลับของแง่มุมที่เฉพาะเจาะจงของแหล่งที่มา

การแสดง JSON 
{
  "sourceName": string,
  "objectType": string,
  "operatorName": string,
  "buckets": [
    {
      object (FacetBucket)
    }
  ]
}
ช่อง
sourceName

string

ชื่อแหล่งที่มาที่จะแสดงผลลัพธ์ของแง่มุม ต้องระบุ
objectType

string

ประเภทออบเจ็กต์ที่จะแสดงผลลัพธ์ของแง่มุม เว้นว่างไว้ได้
operatorName

string

ชื่อของตัวดำเนินการที่เลือกสำหรับการแบ่งกลุ่ม @ดู cloudsearch.SchemaPropertyOptions
buckets[]

object (FacetBucket)

FacetBuckets สำหรับค่าในการตอบกลับที่มีผลลัพธ์อย่างน้อย 1 รายการพร้อมตัวกรองที่เกี่ยวข้อง

FacetBucket

ที่เก็บข้อมูลใน Facet คือหน่วยการทำงานพื้นฐาน ที่เก็บข้อมูลอาจประกอบด้วยค่าเดียวหรือช่วงค่าที่ต่อเนื่องกันก็ได้ ขึ้นอยู่กับประเภทของฟิลด์ที่จัดกลุ่ม ปัจจุบัน 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)

ตัวกรองที่จะส่งในคำขอค้นหาหากเลือกที่เก็บข้อมูลที่เกี่ยวข้อง
ฟิลด์ Union 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

มีผลการค้นหาเพิ่มเติมสำหรับแหล่งที่มานี้หรือไม่

ฟิลด์ Union result_count

result_count ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
resultCountEstimate

string (int64 format)

จำนวนผลลัพธ์โดยประมาณสำหรับแหล่งที่มานี้
resultCountExact

string (int64 format)

จํานวนผลลัพธ์ที่แน่นอนสําหรับแหล่งที่มานี้