Search

ตอบกลับคำขอการค้นหาที่กำหนดเอง

การแสดง JSON
{
  "kind": string,
  "url": {
    "type": string,
    "template": string
  },
  "queries": {
    "previousPage": [
      {
        "title": string,
        "totalResults": string,
        "searchTerms": string,
        "count": integer,
        "startIndex": integer,
        "startPage": integer,
        "language": string,
        "inputEncoding": string,
        "outputEncoding": string,
        "safe": string,
        "cx": string,
        "sort": string,
        "filter": string,
        "gl": string,
        "cr": string,
        "googleHost": string,
        "disableCnTwTranslation": string,
        "hq": string,
        "hl": string,
        "siteSearch": string,
        "siteSearchFilter": string,
        "exactTerms": string,
        "excludeTerms": string,
        "linkSite": string,
        "orTerms": string,
        "relatedSite": string,
        "dateRestrict": string,
        "lowRange": string,
        "highRange": string,
        "fileType": string,
        "rights": string,
        "searchType": string,
        "imgSize": string,
        "imgType": string,
        "imgColorType": string,
        "imgDominantColor": string
      }
    ],
    "request": [
      {
        "title": string,
        "totalResults": string,
        "searchTerms": string,
        "count": integer,
        "startIndex": integer,
        "startPage": integer,
        "language": string,
        "inputEncoding": string,
        "outputEncoding": string,
        "safe": string,
        "cx": string,
        "sort": string,
        "filter": string,
        "gl": string,
        "cr": string,
        "googleHost": string,
        "disableCnTwTranslation": string,
        "hq": string,
        "hl": string,
        "siteSearch": string,
        "siteSearchFilter": string,
        "exactTerms": string,
        "excludeTerms": string,
        "linkSite": string,
        "orTerms": string,
        "relatedSite": string,
        "dateRestrict": string,
        "lowRange": string,
        "highRange": string,
        "fileType": string,
        "rights": string,
        "searchType": string,
        "imgSize": string,
        "imgType": string,
        "imgColorType": string,
        "imgDominantColor": string
      }
    ],
    "nextPage": [
      {
        "title": string,
        "totalResults": string,
        "searchTerms": string,
        "count": integer,
        "startIndex": integer,
        "startPage": integer,
        "language": string,
        "inputEncoding": string,
        "outputEncoding": string,
        "safe": string,
        "cx": string,
        "sort": string,
        "filter": string,
        "gl": string,
        "cr": string,
        "googleHost": string,
        "disableCnTwTranslation": string,
        "hq": string,
        "hl": string,
        "siteSearch": string,
        "siteSearchFilter": string,
        "exactTerms": string,
        "excludeTerms": string,
        "linkSite": string,
        "orTerms": string,
        "relatedSite": string,
        "dateRestrict": string,
        "lowRange": string,
        "highRange": string,
        "fileType": string,
        "rights": string,
        "searchType": string,
        "imgSize": string,
        "imgType": string,
        "imgColorType": string,
        "imgDominantColor": string
      }
    ]
  },
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "context": {
    object
  },
  "searchInformation": {
    "searchTime": number,
    "formattedSearchTime": string,
    "totalResults": string,
    "formattedTotalResults": string
  },
  "spelling": {
    "correctedQuery": string,
    "htmlCorrectedQuery": string
  },
  "items": [
    {
      object (Result)
    }
  ]
}
ช่อง
kind

string

ตัวระบุที่ไม่ซ้ำกันสำหรับประเภทออบเจ็กต์ปัจจุบัน สำหรับ API นี้จะเป็น customsearch#search

url

object

องค์ประกอบ URL ของ OpenSearch ที่กำหนดเทมเพลตสำหรับ API นี้

url.type

string

ประเภท MIME ของเทมเพลต URL ของ OpenSearch สำหรับ Custom Search JSON API

url.template

string

เทมเพลต OpenSearch จริงสำหรับ API นี้

queries

object

ประกอบด้วยข้อมูลเมตาของการค้นหาอย่างน้อย 1 ชุดโดยคีย์ตามชื่อบทบาท ชื่อบทบาทที่เป็นไปได้ประกอบด้วย request ที่กำหนดโดยบทบาทในคำค้นหา OpenSearch และบทบาทที่กำหนดเอง 2 บทบาท ได้แก่ nextPage และ previousPage

queries.previousPage[]

object

ข้อมูลเมตาที่แสดงหน้าผลลัพธ์ก่อนหน้า หากมี

queries.previousPage[].title

string

คำอธิบายของการค้นหา

queries.previousPage[].totalResults

string (int64 format)

จำนวนผลการค้นหาทั้งหมดโดยประมาณ อาจไม่ถูกต้อง

queries.previousPage[].searchTerms

string

ข้อความค้นหาที่ผู้ใช้ป้อน

queries.previousPage[].count

integer

จำนวนผลการค้นหาที่แสดงในชุดนี้

queries.previousPage[].startIndex

integer

ดัชนีของชุดผลการค้นหาปัจจุบันในชุดผลการค้นหาทั้งหมด โดยที่ดัชนีของผลลัพธ์แรกคือ 1

queries.previousPage[].startPage

integer

หมายเลขหน้าของผลการค้นหาชุดนี้ ซึ่งกำหนดความยาวของหน้าโดยพร็อพเพอร์ตี้ count

queries.previousPage[].language

string

ภาษาของผลการค้นหา

queries.previousPage[].inputEncoding

string

การเข้ารหัสอักขระที่รองรับสำหรับคำขอการค้นหา

queries.previousPage[].outputEncoding

string

การเข้ารหัสอักขระที่สนับสนุนสำหรับผลการค้นหา

queries.previousPage[].safe

string

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

  • "off": ปิดใช้ฟีเจอร์ค้นหาปลอดภัย

  • "active": เปิดใช้ฟีเจอร์ค้นหาปลอดภัย

queries.previousPage[].cx

string

ตัวระบุของเครื่องมือค้นหาที่สร้างขึ้นโดยใช้แผงควบคุมของ Programmable Search Engine พร็อพเพอร์ตี้นี้เป็นพร็อพเพอร์ตี้ที่กำหนดเองซึ่งไม่ได้ระบุไว้ในข้อกำหนดของ OpenSearch ต้องระบุพารามิเตอร์นี้

queries.previousPage[].sort

string

ระบุว่าผลลัพธ์ควรจัดเรียงตามนิพจน์ที่ระบุ เช่น จัดเรียงตามวันที่

queries.previousPage[].filter

string

เปิดหรือปิดใช้งานการกรองอัตโนมัติสำหรับผลการค้นหาของ Google ดูการกรองอัตโนมัติสำหรับข้อมูลเพิ่มเติมเกี่ยวกับตัวกรองผลการค้นหาของ Google ค่าที่ถูกต้องสำหรับพารามิเตอร์นี้คือ

  • 0: ปิดใช้

  • 1: เปิดใช้ (ค่าเริ่มต้น)

หมายเหตุ: โดยค่าเริ่มต้น Google จะใช้การกรองกับผลการค้นหาทั้งหมดเพื่อปรับปรุงคุณภาพของผลการค้นหาเหล่านั้น

queries.previousPage[].gl

string

บูสต์ผลการค้นหาที่ประเทศต้นทางตรงกับค่าพารามิเตอร์ โปรดดูรายการค่าที่ถูกต้องในรหัสประเทศ

การระบุค่าพารามิเตอร์ gl ในคำขอ WebSearch ควรปรับปรุงความเกี่ยวข้องของผลการค้นหา โดยเฉพาะลูกค้าในประเทศต่างๆ และโดยเฉพาะอย่างยิ่ง ลูกค้าในประเทศที่พูดภาษาอังกฤษนอกเหนือจากสหรัฐอเมริกา

queries.previousPage[].cr

string

จำกัดผลการค้นหาเฉพาะเอกสารที่มาจากประเทศที่กำหนด คุณจะใช้โอเปอเรเตอร์บูลีนในค่าพารามิเตอร์ cr ได้

Google WebSearch ระบุประเทศของเอกสารด้วยการวิเคราะห์ข้อมูลต่อไปนี้

  • โดเมนระดับบนสุด (TLD) ของ URL ของเอกสาร

  • สถานที่ตั้งทางภูมิศาสตร์ของที่อยู่ IP ของเว็บเซิร์ฟเวอร์

โปรดดูค่าพารามิเตอร์ประเทศ (cr) สำหรับรายการค่าที่ถูกต้องสำหรับพารามิเตอร์นี้

queries.previousPage[].googleHost

string

ระบุโดเมน Google (เช่น google.com, google.de หรือ google.fr) ที่ควรจำกัดการค้นหา

queries.previousPage[].disableCnTwTranslation

string

เปิดหรือปิดใช้ฟีเจอร์การค้นหาภาษาจีนตัวย่อและตัวเต็ม

ค่าที่รองรับมีดังนี้

  • 0: เปิดใช้ (ค่าเริ่มต้น)

  • 1: ปิดใช้งานแล้ว

queries.previousPage[].hq

string

นำคำค้นหาที่ระบุต่อท้ายคำค้นหา ราวกับว่ามีการรวมกับโอเปอเรเตอร์ AND เชิงตรรกะ

queries.previousPage[].hl

string

ระบุภาษาอินเทอร์เฟซ (ภาษาโฮสต์) ของอินเทอร์เฟซผู้ใช้ การตั้งค่าพารามิเตอร์นี้อย่างชัดแจ้งจะช่วยปรับปรุงประสิทธิภาพและคุณภาพของผลการค้นหา

ดูข้อมูลเพิ่มเติมได้ที่ส่วนภาษาอินเทอร์เฟซของการค้นหาเป็นสากลและการนำเสนอผลลัพธ์ และดูภาษาของอินเทอร์เฟซที่รองรับเพื่อดูรายการภาษาที่รองรับ

queries.previousPage[].siteSearch

string

จำกัดผลการค้นหาเฉพาะ URL จากเว็บไซต์ที่ระบุ

queries.previousPage[].siteSearchFilter

string

ระบุว่าจะรวมหรือยกเว้นผลการค้นหาจากเว็บไซต์ที่มีชื่อในพารามิเตอร์ sitesearch ค่าที่รองรับมีดังนี้

  • i: รวมเนื้อหาจากเว็บไซต์

  • e: ยกเว้นเนื้อหาจากเว็บไซต์

queries.previousPage[].exactTerms

string

ระบุวลีที่เอกสารทั้งหมดในผลการค้นหาต้องมี

queries.previousPage[].excludeTerms

string

ระบุคำหรือวลีที่ไม่ควรปรากฏในเอกสารใดๆ ในผลการค้นหา

queries.previousPage[].linkSite

string

ระบุว่าผลลัพธ์ทั้งหมดควรมีลิงก์ไปยัง URL ที่ระบุ

queries.previousPage[].orTerms

string

ระบุข้อความค้นหาเพิ่มเติมที่ต้องตรวจสอบในเอกสาร โดยเอกสารแต่ละรายการในผลการค้นหาต้องมีคำค้นหาเพิ่มเติมอย่างน้อย 1 รายการ คุณยังสามารถใช้คำค้นหาบูลีน OR สำหรับคำค้นหาประเภทนี้ได้ด้วย

queries.previousPage[].relatedSite

string

ระบุว่าผลการค้นหาทั้งหมดควรเป็นหน้าที่เกี่ยวข้องกับ URL ที่ระบุ ค่าพารามิเตอร์ควรเป็น URL

queries.previousPage[].dateRestrict

string

จำกัดผลการค้นหาให้แสดงเฉพาะ URL ตามวันที่ ค่าที่รองรับมีดังนี้

  • d[number]: ขอผลการค้นหาจากจำนวนวันที่ผ่านมาที่ระบุ

  • w[number]: ขอผลลัพธ์จากจำนวนสัปดาห์ที่ผ่านมาที่ระบุ

  • m[number]: ขอผลลัพธ์จากจำนวนเดือนที่ผ่านมาตามที่ระบุ

  • y[number]: คำขอผลลัพธ์จากจำนวนปีที่ผ่านมาที่ระบุ

queries.previousPage[].lowRange

string

ระบุค่าเริ่มต้นสำหรับช่วงการค้นหา ใช้ cse:lowRange และ cse:highrange เพื่อเพิ่มช่วงการค้นหาที่ครอบคลุมของ lowRange...highRange ในคำค้นหา

queries.previousPage[].highRange

string

ระบุค่าสิ้นสุดสำหรับช่วงการค้นหา ใช้ cse:lowRange และ cse:highrange เพื่อเพิ่มช่วงการค้นหาที่ครอบคลุมของ lowRange...highRange ในคำค้นหา

queries.previousPage[].fileType

string

จำกัดผลการค้นหาเฉพาะไฟล์ที่มีนามสกุลที่ระบุ ประเภทไฟล์ที่ Google รองรับมีดังนี้

  • Adobe Portable Document Format (pdf)

  • Adobe PostScript (ps)

  • ดอกบัว 1-2-3 (wk1, wk2, wk3, wk4, wk5, wki, wks, wku)

  • Lotus WordPro (lwp)

  • Macwrite (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft เขียน (wri)

  • รูปแบบ Rich Text (rtf)

  • Shockwave Flash (swf)

  • ข้อความ (ans, txt)

อาจมีการเพิ่มประเภทไฟล์อื่นๆ ในอนาคต คุณดูรายการที่อัปเดตได้ทุกเมื่อในคำถามที่พบบ่อยเกี่ยวกับประเภทไฟล์ของ Google

queries.previousPage[].rights

string

ตัวกรองตามการอนุญาตให้ใช้สิทธิ ค่าที่รองรับมีดังนี้

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived

queries.previousPage[].searchType

string

ค่าที่อนุญาตคือ web หรือ image หากไม่ระบุ ผลลัพธ์จะจำกัดให้แสดงเฉพาะหน้าเว็บเท่านั้น

queries.previousPage[].imgSize

string

จำกัดผลการค้นหาเฉพาะภาพที่มีขนาดที่ระบุ ค่าที่รองรับมีดังนี้

  • icon (เล็ก)

  • small | medium | large | xlarge (ปานกลาง)

  • xxlarge (ใหญ่)

  • huge (ใหญ่พิเศษ)

queries.previousPage[].imgType

string

จำกัดผลการค้นหาเฉพาะภาพประเภทที่ระบุ ค่าที่รองรับมีดังนี้

  • clipart (คลิปอาร์ต)

  • face (ใบหน้า)

  • lineart (ภาพวาดลายเส้น)

  • photo (รูปภาพ)

  • animated (ภาพเคลื่อนไหว)

  • stock (สต็อก)

queries.previousPage[].imgColorType

string

จำกัดผลการค้นหาเฉพาะภาพประเภทสีที่ระบุ ค่าที่รองรับมีดังนี้

  • mono (ขาวดำ)

  • gray (โทนสีเทา)

  • color (สี)

queries.previousPage[].imgDominantColor

string

จำกัดผลลัพธ์สำหรับรูปภาพที่มีสีเฉพาะที่โดดเด่นเท่านั้น ค่าที่รองรับมีดังนี้

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown

queries.request[]

object

ข้อมูลเมตาที่แสดงถึงคำขอปัจจุบัน

queries.request[].title

string

คำอธิบายของการค้นหา

queries.request[].totalResults

string (int64 format)

จำนวนผลการค้นหาทั้งหมดโดยประมาณ อาจไม่ถูกต้อง

queries.request[].searchTerms

string

ข้อความค้นหาที่ผู้ใช้ป้อน

queries.request[].count

integer

จำนวนผลการค้นหาที่แสดงในชุดนี้

queries.request[].startIndex

integer

ดัชนีของชุดผลการค้นหาปัจจุบันในชุดผลการค้นหาทั้งหมด โดยที่ดัชนีของผลลัพธ์แรกคือ 1

queries.request[].startPage

integer

หมายเลขหน้าของผลการค้นหาชุดนี้ ซึ่งกำหนดความยาวของหน้าโดยพร็อพเพอร์ตี้ count

queries.request[].language

string

ภาษาของผลการค้นหา

queries.request[].inputEncoding

string

การเข้ารหัสอักขระที่รองรับสำหรับคำขอการค้นหา

queries.request[].outputEncoding

string

การเข้ารหัสอักขระที่สนับสนุนสำหรับผลการค้นหา

queries.request[].safe

string

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

  • "off": ปิดใช้ฟีเจอร์ค้นหาปลอดภัย

  • "active": เปิดใช้ฟีเจอร์ค้นหาปลอดภัย

queries.request[].cx

string

ตัวระบุของเครื่องมือค้นหาที่สร้างขึ้นโดยใช้แผงควบคุมของ Programmable Search Engine พร็อพเพอร์ตี้นี้เป็นพร็อพเพอร์ตี้ที่กำหนดเองซึ่งไม่ได้ระบุไว้ในข้อกำหนดของ OpenSearch ต้องระบุพารามิเตอร์นี้

queries.request[].sort

string

ระบุว่าผลลัพธ์ควรจัดเรียงตามนิพจน์ที่ระบุ เช่น จัดเรียงตามวันที่

queries.request[].filter

string

เปิดหรือปิดใช้งานการกรองอัตโนมัติสำหรับผลการค้นหาของ Google ดูการกรองอัตโนมัติสำหรับข้อมูลเพิ่มเติมเกี่ยวกับตัวกรองผลการค้นหาของ Google ค่าที่ถูกต้องสำหรับพารามิเตอร์นี้คือ

  • 0: ปิดใช้

  • 1: เปิดใช้ (ค่าเริ่มต้น)

หมายเหตุ: โดยค่าเริ่มต้น Google จะใช้การกรองกับผลการค้นหาทั้งหมดเพื่อปรับปรุงคุณภาพของผลการค้นหาเหล่านั้น

queries.request[].gl

string

บูสต์ผลการค้นหาที่ประเทศต้นทางตรงกับค่าพารามิเตอร์ โปรดดูรายการค่าที่ถูกต้องในรหัสประเทศ

การระบุค่าพารามิเตอร์ gl ในคำขอ WebSearch ควรปรับปรุงความเกี่ยวข้องของผลการค้นหา โดยเฉพาะลูกค้าในประเทศต่างๆ และโดยเฉพาะอย่างยิ่ง ลูกค้าในประเทศที่พูดภาษาอังกฤษนอกเหนือจากสหรัฐอเมริกา

queries.request[].cr

string

จำกัดผลการค้นหาเฉพาะเอกสารที่มาจากประเทศที่กำหนด คุณจะใช้โอเปอเรเตอร์บูลีนในค่าพารามิเตอร์ cr ได้

Google WebSearch ระบุประเทศของเอกสารด้วยการวิเคราะห์ข้อมูลต่อไปนี้

  • โดเมนระดับบนสุด (TLD) ของ URL ของเอกสาร

  • สถานที่ตั้งทางภูมิศาสตร์ของที่อยู่ IP ของเว็บเซิร์ฟเวอร์

โปรดดูค่าพารามิเตอร์ประเทศ (cr) สำหรับรายการค่าที่ถูกต้องสำหรับพารามิเตอร์นี้

queries.request[].googleHost

string

ระบุโดเมน Google (เช่น google.com, google.de หรือ google.fr) ที่ควรจำกัดการค้นหา

queries.request[].disableCnTwTranslation

string

เปิดหรือปิดใช้ฟีเจอร์การค้นหาภาษาจีนตัวย่อและตัวเต็ม

ค่าที่รองรับมีดังนี้

  • 0: เปิดใช้ (ค่าเริ่มต้น)

  • 1: ปิดใช้งานแล้ว

queries.request[].hq

string

นำคำค้นหาที่ระบุต่อท้ายคำค้นหา ราวกับว่ามีการรวมกับโอเปอเรเตอร์ AND เชิงตรรกะ

queries.request[].hl

string

ระบุภาษาอินเทอร์เฟซ (ภาษาโฮสต์) ของอินเทอร์เฟซผู้ใช้ การตั้งค่าพารามิเตอร์นี้อย่างชัดแจ้งจะช่วยปรับปรุงประสิทธิภาพและคุณภาพของผลการค้นหา

ดูข้อมูลเพิ่มเติมได้ที่ส่วนภาษาอินเทอร์เฟซของการค้นหาเป็นสากลและการนำเสนอผลลัพธ์ และดูภาษาของอินเทอร์เฟซที่รองรับเพื่อดูรายการภาษาที่รองรับ

queries.request[].siteSearch

string

จำกัดผลการค้นหาเฉพาะ URL จากเว็บไซต์ที่ระบุ

queries.request[].siteSearchFilter

string

ระบุว่าจะรวมหรือยกเว้นผลการค้นหาจากเว็บไซต์ที่มีชื่อในพารามิเตอร์ sitesearch ค่าที่รองรับมีดังนี้

  • i: รวมเนื้อหาจากเว็บไซต์

  • e: ยกเว้นเนื้อหาจากเว็บไซต์

queries.request[].exactTerms

string

ระบุวลีที่เอกสารทั้งหมดในผลการค้นหาต้องมี

queries.request[].excludeTerms

string

ระบุคำหรือวลีที่ไม่ควรปรากฏในเอกสารใดๆ ในผลการค้นหา

queries.request[].linkSite

string

ระบุว่าผลลัพธ์ทั้งหมดควรมีลิงก์ไปยัง URL ที่ระบุ

queries.request[].orTerms

string

ระบุข้อความค้นหาเพิ่มเติมที่ต้องตรวจสอบในเอกสาร โดยเอกสารแต่ละรายการในผลการค้นหาต้องมีคำค้นหาเพิ่มเติมอย่างน้อย 1 รายการ คุณยังสามารถใช้คำค้นหาบูลีน OR สำหรับคำค้นหาประเภทนี้ได้ด้วย

queries.request[].relatedSite

string

ระบุว่าผลการค้นหาทั้งหมดควรเป็นหน้าที่เกี่ยวข้องกับ URL ที่ระบุ ค่าพารามิเตอร์ควรเป็น URL

queries.request[].dateRestrict

string

จำกัดผลการค้นหาให้แสดงเฉพาะ URL ตามวันที่ ค่าที่รองรับมีดังนี้

  • d[number]: ขอผลการค้นหาจากจำนวนวันที่ผ่านมาที่ระบุ

  • w[number]: ขอผลลัพธ์จากจำนวนสัปดาห์ที่ผ่านมาที่ระบุ

  • m[number]: ขอผลลัพธ์จากจำนวนเดือนที่ผ่านมาตามที่ระบุ

  • y[number]: คำขอผลลัพธ์จากจำนวนปีที่ผ่านมาที่ระบุ

queries.request[].lowRange

string

ระบุค่าเริ่มต้นสำหรับช่วงการค้นหา ใช้ cse:lowRange และ cse:highrange เพื่อเพิ่มช่วงการค้นหาที่ครอบคลุมของ lowRange...highRange ในคำค้นหา

queries.request[].highRange

string

ระบุค่าสิ้นสุดสำหรับช่วงการค้นหา ใช้ cse:lowRange และ cse:highrange เพื่อเพิ่มช่วงการค้นหาที่ครอบคลุมของ lowRange...highRange ในคำค้นหา

queries.request[].fileType

string

จำกัดผลการค้นหาเฉพาะไฟล์ที่มีนามสกุลที่ระบุ ประเภทไฟล์ที่ Google รองรับมีดังนี้

  • Adobe Portable Document Format (pdf)

  • Adobe PostScript (ps)

  • ดอกบัว 1-2-3 (wk1, wk2, wk3, wk4, wk5, wki, wks, wku)

  • Lotus WordPro (lwp)

  • Macwrite (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft เขียน (wri)

  • รูปแบบ Rich Text (rtf)

  • Shockwave Flash (swf)

  • ข้อความ (ans, txt)

อาจมีการเพิ่มประเภทไฟล์อื่นๆ ในอนาคต คุณดูรายการที่อัปเดตได้ทุกเมื่อในคำถามที่พบบ่อยเกี่ยวกับประเภทไฟล์ของ Google

queries.request[].rights

string

ตัวกรองตามการอนุญาตให้ใช้สิทธิ ค่าที่รองรับมีดังนี้

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived

queries.request[].searchType

string

ค่าที่อนุญาตคือ web หรือ image หากไม่ระบุ ผลลัพธ์จะจำกัดให้แสดงเฉพาะหน้าเว็บเท่านั้น

queries.request[].imgSize

string

จำกัดผลการค้นหาเฉพาะภาพที่มีขนาดที่ระบุ ค่าที่รองรับมีดังนี้

  • icon (เล็ก)

  • small | medium | large | xlarge (ปานกลาง)

  • xxlarge (ใหญ่)

  • huge (ใหญ่พิเศษ)

queries.request[].imgType

string

จำกัดผลการค้นหาเฉพาะภาพประเภทที่ระบุ ค่าที่รองรับมีดังนี้

  • clipart (คลิปอาร์ต)

  • face (ใบหน้า)

  • lineart (ภาพวาดลายเส้น)

  • photo (รูปภาพ)

  • animated (ภาพเคลื่อนไหว)

  • stock (สต็อก)

queries.request[].imgColorType

string

จำกัดผลการค้นหาเฉพาะภาพประเภทสีที่ระบุ ค่าที่รองรับมีดังนี้

  • mono (ขาวดำ)

  • gray (โทนสีเทา)

  • color (สี)

queries.request[].imgDominantColor

string

จำกัดผลลัพธ์สำหรับรูปภาพที่มีสีเฉพาะที่โดดเด่นเท่านั้น ค่าที่รองรับมีดังนี้

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown

queries.nextPage[]

object

ข้อมูลเมตาที่แทนผลลัพธ์หน้าถัดไป (หากมี)

queries.nextPage[].title

string

คำอธิบายของการค้นหา

queries.nextPage[].totalResults

string (int64 format)

จำนวนผลการค้นหาทั้งหมดโดยประมาณ อาจไม่ถูกต้อง

queries.nextPage[].searchTerms

string

ข้อความค้นหาที่ผู้ใช้ป้อน

queries.nextPage[].count

integer

จำนวนผลการค้นหาที่แสดงในชุดนี้

queries.nextPage[].startIndex

integer

ดัชนีของชุดผลการค้นหาปัจจุบันในชุดผลการค้นหาทั้งหมด โดยที่ดัชนีของผลลัพธ์แรกคือ 1

queries.nextPage[].startPage

integer

หมายเลขหน้าของผลการค้นหาชุดนี้ ซึ่งกำหนดความยาวของหน้าโดยพร็อพเพอร์ตี้ count

queries.nextPage[].language

string

ภาษาของผลการค้นหา

queries.nextPage[].inputEncoding

string

การเข้ารหัสอักขระที่รองรับสำหรับคำขอการค้นหา

queries.nextPage[].outputEncoding

string

การเข้ารหัสอักขระที่สนับสนุนสำหรับผลการค้นหา

queries.nextPage[].safe

string

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

  • "off": ปิดใช้ฟีเจอร์ค้นหาปลอดภัย

  • "active": เปิดใช้ฟีเจอร์ค้นหาปลอดภัย

queries.nextPage[].cx

string

ตัวระบุของเครื่องมือค้นหาที่สร้างขึ้นโดยใช้แผงควบคุมของ Programmable Search Engine พร็อพเพอร์ตี้นี้เป็นพร็อพเพอร์ตี้ที่กำหนดเองซึ่งไม่ได้ระบุไว้ในข้อกำหนดของ OpenSearch ต้องระบุพารามิเตอร์นี้

queries.nextPage[].sort

string

ระบุว่าผลลัพธ์ควรจัดเรียงตามนิพจน์ที่ระบุ เช่น จัดเรียงตามวันที่

queries.nextPage[].filter

string

เปิดหรือปิดใช้งานการกรองอัตโนมัติสำหรับผลการค้นหาของ Google ดูการกรองอัตโนมัติสำหรับข้อมูลเพิ่มเติมเกี่ยวกับตัวกรองผลการค้นหาของ Google ค่าที่ถูกต้องสำหรับพารามิเตอร์นี้คือ

  • 0: ปิดใช้

  • 1: เปิดใช้ (ค่าเริ่มต้น)

หมายเหตุ: โดยค่าเริ่มต้น Google จะใช้การกรองกับผลการค้นหาทั้งหมดเพื่อปรับปรุงคุณภาพของผลการค้นหาเหล่านั้น

queries.nextPage[].gl

string

บูสต์ผลการค้นหาที่ประเทศต้นทางตรงกับค่าพารามิเตอร์ โปรดดูรายการค่าที่ถูกต้องในรหัสประเทศ

การระบุค่าพารามิเตอร์ gl ในคำขอ WebSearch ควรปรับปรุงความเกี่ยวข้องของผลการค้นหา โดยเฉพาะลูกค้าในประเทศต่างๆ และโดยเฉพาะอย่างยิ่ง ลูกค้าในประเทศที่พูดภาษาอังกฤษนอกเหนือจากสหรัฐอเมริกา

queries.nextPage[].cr

string

จำกัดผลการค้นหาเฉพาะเอกสารที่มาจากประเทศที่กำหนด คุณจะใช้โอเปอเรเตอร์บูลีนในค่าพารามิเตอร์ cr ได้

Google WebSearch ระบุประเทศของเอกสารด้วยการวิเคราะห์ข้อมูลต่อไปนี้

  • โดเมนระดับบนสุด (TLD) ของ URL ของเอกสาร

  • สถานที่ตั้งทางภูมิศาสตร์ของที่อยู่ IP ของเว็บเซิร์ฟเวอร์

โปรดดูค่าพารามิเตอร์ประเทศ (cr) สำหรับรายการค่าที่ถูกต้องสำหรับพารามิเตอร์นี้

queries.nextPage[].googleHost

string

ระบุโดเมน Google (เช่น google.com, google.de หรือ google.fr) ที่ควรจำกัดการค้นหา

queries.nextPage[].disableCnTwTranslation

string

เปิดหรือปิดใช้ฟีเจอร์การค้นหาภาษาจีนตัวย่อและตัวเต็ม

ค่าที่รองรับมีดังนี้

  • 0: เปิดใช้ (ค่าเริ่มต้น)

  • 1: ปิดใช้งานแล้ว

queries.nextPage[].hq

string

นำคำค้นหาที่ระบุต่อท้ายคำค้นหา ราวกับว่ามีการรวมกับโอเปอเรเตอร์ AND เชิงตรรกะ

queries.nextPage[].hl

string

ระบุภาษาอินเทอร์เฟซ (ภาษาโฮสต์) ของอินเทอร์เฟซผู้ใช้ การตั้งค่าพารามิเตอร์นี้อย่างชัดแจ้งจะช่วยปรับปรุงประสิทธิภาพและคุณภาพของผลการค้นหา

ดูข้อมูลเพิ่มเติมได้ที่ส่วนภาษาอินเทอร์เฟซของการค้นหาเป็นสากลและการนำเสนอผลลัพธ์ และดูภาษาของอินเทอร์เฟซที่รองรับเพื่อดูรายการภาษาที่รองรับ

queries.nextPage[].siteSearch

string

จำกัดผลการค้นหาเฉพาะ URL จากเว็บไซต์ที่ระบุ

queries.nextPage[].siteSearchFilter

string

ระบุว่าจะรวมหรือยกเว้นผลการค้นหาจากเว็บไซต์ที่มีชื่อในพารามิเตอร์ sitesearch ค่าที่รองรับมีดังนี้

  • i: รวมเนื้อหาจากเว็บไซต์

  • e: ยกเว้นเนื้อหาจากเว็บไซต์

queries.nextPage[].exactTerms

string

ระบุวลีที่เอกสารทั้งหมดในผลการค้นหาต้องมี

queries.nextPage[].excludeTerms

string

ระบุคำหรือวลีที่ไม่ควรปรากฏในเอกสารใดๆ ในผลการค้นหา

queries.nextPage[].linkSite

string

ระบุว่าผลลัพธ์ทั้งหมดควรมีลิงก์ไปยัง URL ที่ระบุ

queries.nextPage[].orTerms

string

ระบุข้อความค้นหาเพิ่มเติมที่ต้องตรวจสอบในเอกสาร โดยเอกสารแต่ละรายการในผลการค้นหาต้องมีคำค้นหาเพิ่มเติมอย่างน้อย 1 รายการ คุณยังสามารถใช้คำค้นหาบูลีน OR สำหรับคำค้นหาประเภทนี้ได้ด้วย

queries.nextPage[].relatedSite

string

ระบุว่าผลการค้นหาทั้งหมดควรเป็นหน้าที่เกี่ยวข้องกับ URL ที่ระบุ ค่าพารามิเตอร์ควรเป็น URL

queries.nextPage[].dateRestrict

string

จำกัดผลการค้นหาให้แสดงเฉพาะ URL ตามวันที่ ค่าที่รองรับมีดังนี้

  • d[number]: ขอผลการค้นหาจากจำนวนวันที่ผ่านมาที่ระบุ

  • w[number]: ขอผลลัพธ์จากจำนวนสัปดาห์ที่ผ่านมาที่ระบุ

  • m[number]: ขอผลลัพธ์จากจำนวนเดือนที่ผ่านมาตามที่ระบุ

  • y[number]: คำขอผลลัพธ์จากจำนวนปีที่ผ่านมาที่ระบุ

queries.nextPage[].lowRange

string

ระบุค่าเริ่มต้นสำหรับช่วงการค้นหา ใช้ cse:lowRange และ cse:highrange เพื่อเพิ่มช่วงการค้นหาที่ครอบคลุมของ lowRange...highRange ในคำค้นหา

queries.nextPage[].highRange

string

ระบุค่าสิ้นสุดสำหรับช่วงการค้นหา ใช้ cse:lowRange และ cse:highrange เพื่อเพิ่มช่วงการค้นหาที่ครอบคลุมของ lowRange...highRange ในคำค้นหา

queries.nextPage[].fileType

string

จำกัดผลการค้นหาเฉพาะไฟล์ที่มีนามสกุลที่ระบุ ประเภทไฟล์ที่ Google รองรับมีดังนี้

  • Adobe Portable Document Format (pdf)

  • Adobe PostScript (ps)

  • ดอกบัว 1-2-3 (wk1, wk2, wk3, wk4, wk5, wki, wks, wku)

  • Lotus WordPro (lwp)

  • Macwrite (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks, wps, wdb)

  • Microsoft เขียน (wri)

  • รูปแบบ Rich Text (rtf)

  • Shockwave Flash (swf)

  • ข้อความ (ans, txt)

อาจมีการเพิ่มประเภทไฟล์อื่นๆ ในอนาคต คุณดูรายการที่อัปเดตได้ทุกเมื่อในคำถามที่พบบ่อยเกี่ยวกับประเภทไฟล์ของ Google

queries.nextPage[].rights

string

ตัวกรองตามการอนุญาตให้ใช้สิทธิ ค่าที่รองรับมีดังนี้

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived

queries.nextPage[].searchType

string

ค่าที่อนุญาตคือ web หรือ image หากไม่ระบุ ผลลัพธ์จะจำกัดให้แสดงเฉพาะหน้าเว็บเท่านั้น

queries.nextPage[].imgSize

string

จำกัดผลการค้นหาเฉพาะภาพที่มีขนาดที่ระบุ ค่าที่รองรับมีดังนี้

  • icon (เล็ก)

  • small | medium | large | xlarge (ปานกลาง)

  • xxlarge (ใหญ่)

  • huge (ใหญ่พิเศษ)

queries.nextPage[].imgType

string

จำกัดผลการค้นหาเฉพาะภาพประเภทที่ระบุ ค่าที่รองรับมีดังนี้

  • clipart (คลิปอาร์ต)

  • face (ใบหน้า)

  • lineart (ภาพวาดลายเส้น)

  • photo (รูปภาพ)

  • animated (ภาพเคลื่อนไหว)

  • stock (สต็อก)

queries.nextPage[].imgColorType

string

จำกัดผลการค้นหาเฉพาะภาพประเภทสีที่ระบุ ค่าที่รองรับมีดังนี้

  • mono (ขาวดำ)

  • gray (โทนสีเทา)

  • color (สี)

queries.nextPage[].imgDominantColor

string

จำกัดผลลัพธ์สำหรับรูปภาพที่มีสีเฉพาะที่โดดเด่นเท่านั้น ค่าที่รองรับมีดังนี้

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown

promotions[]

object (Promotion)

ชุดของโปรโมชัน นำเสนอต่อเมื่อไฟล์การกำหนดค่าของ Custom Search Engine ระบุผลการค้นหาที่ได้รับการสนับสนุนสำหรับคำค้นหาดังกล่าวเท่านั้น

context

object (Struct format)

ข้อมูลเมตาและการปรับแต่งที่เกี่ยวข้องกับเครื่องมือค้นหาที่ระบุ ซึ่งรวมถึง:

  • ชื่อของเครื่องมือค้นหาที่ใช้สำหรับข้อความค้นหา

  • ชุดออบเจ็กต์ประกอบ (การปรับแต่ง) ที่คุณใช้ปรับแต่งการค้นหาได้

searchInformation

object

ข้อมูลเมตาเกี่ยวกับการค้นหานี้ รวมถึงเวลาที่ค้นหาและผลการค้นหาทั้งหมด

searchInformation.searchTime

number

เวลาที่เซิร์ฟเวอร์ใช้ในการแสดงผลการค้นหา

searchInformation.formattedSearchTime

string

เวลาที่เซิร์ฟเวอร์ใช้ในการแสดงผลการค้นหา ซึ่งอยู่ในรูปแบบตามสไตล์ภาษา

searchInformation.totalResults

string

จำนวนผลการค้นหาทั้งหมดที่แสดงจากข้อความค้นหา

searchInformation.formattedTotalResults

string

จำนวนผลการค้นหาทั้งหมด ซึ่งจัดรูปแบบตามสไตล์ภาษา

spelling

object

สรุปการค้นหาที่แก้ไขแล้ว

spelling.correctedQuery

string

คำค้นหาที่แก้ไขแล้ว

spelling.htmlCorrectedQuery

string

คำค้นหาที่แก้ไขแล้วซึ่งอยู่ในรูปแบบ HTML

items[]

object (Result)

ผลการค้นหาที่กำหนดเองชุดปัจจุบัน

โปรโมชัน

ผลการโปรโมต

การแสดง JSON
{
  "title": string,
  "htmlTitle": string,
  "link": string,
  "displayLink": string,
  "bodyLines": [
    {
      "title": string,
      "htmlTitle": string,
      "url": string,
      "link": string
    }
  ],
  "image": {
    "source": string,
    "width": integer,
    "height": integer
  }
}
ช่อง
title

string

ชื่อของโปรโมชัน

htmlTitle

string

ชื่อของโปรโมชันในรูปแบบ HTML

bodyLines[]

object

อาร์เรย์ของออบเจ็กต์บล็อกสำหรับโปรโมชันนี้

bodyLines[].title

string

ข้อความของออบเจ็กต์บล็อก หากมีข้อความ

bodyLines[].htmlTitle

string

ข้อความของออบเจ็กต์บล็อกใน HTML หากมีข้อความ

bodyLines[].url

string

URL ลิงก์ของออบเจ็กต์บล็อก (หากมี)

bodyLines[].link

string

Anchor Text ของลิงก์ของออบเจ็กต์บล็อก หากมีลิงก์

image

object

รูปภาพที่เชื่อมโยงกับการโปรโมตนี้ หากมี

image.source

string

URL ของรูปภาพสำหรับลิงก์โปรโมชันนี้

image.width

integer

ความกว้างของรูปภาพเป็นพิกเซล

image.height

integer

ความสูงของรูปภาพเป็นพิกเซล

ผลลัพธ์

ผลการค้นหาที่กำหนดเอง

การแสดง JSON
{
  "kind": string,
  "title": string,
  "htmlTitle": string,
  "link": string,
  "displayLink": string,
  "snippet": string,
  "htmlSnippet": string,
  "cacheId": string,
  "formattedUrl": string,
  "htmlFormattedUrl": string,
  "pagemap": {
    object
  },
  "mime": string,
  "fileFormat": string,
  "image": {
    "contextLink": string,
    "height": integer,
    "width": integer,
    "byteSize": integer,
    "thumbnailLink": string,
    "thumbnailHeight": integer,
    "thumbnailWidth": integer
  },
  "labels": [
    {
      "name": string,
      "displayName": string,
      "label_with_op": string
    }
  ]
}
ช่อง
kind

string

ตัวระบุที่ไม่ซ้ำกันสำหรับประเภทออบเจ็กต์ปัจจุบัน สำหรับ API นี้จะเป็น customsearch#result.

title

string

ชื่อของผลการค้นหาเป็นข้อความธรรมดา

htmlTitle

string

ชื่อของผลการค้นหาในรูปแบบ HTML

snippet

string

ตัวอย่างข้อมูลของผลการค้นหาในข้อความธรรมดา

htmlSnippet

string

ตัวอย่างข้อมูลของผลการค้นหา ใน HTML

cacheId

string

ระบุรหัสของผลการค้นหาเวอร์ชันที่แคชไว้ของ Google

formattedUrl

string

URL ที่แสดงหลังตัวอย่างข้อมูลของผลการค้นหาแต่ละรายการ

htmlFormattedUrl

string

URL รูปแบบ HTML ที่แสดงหลังตัวอย่างข้อมูลของผลการค้นหาแต่ละรายการ

pagemap

object (Struct format)

มีข้อมูล PageMap สำหรับผลการค้นหานี้

mime

string

ประเภท MIME ของผลการค้นหา

fileFormat

string

รูปแบบไฟล์ของผลการค้นหา

image

object

สรุปข้อมูลทั้งหมดเกี่ยวกับรูปภาพที่ปรากฏในผลการค้นหา

image.contextLink

string

URL ที่ชี้ไปยังหน้าเว็บที่โฮสต์รูปภาพ

image.height

integer

ความสูงของรูปภาพเป็นพิกเซล

image.width

integer

ความกว้างของรูปภาพในหน่วยพิกเซล

image.byteSize

integer

ขนาดของรูปภาพในหน่วยไบต์

image.thumbnailLink

string

URL ไปยังภาพขนาดย่อ

image.thumbnailHeight

integer

ความสูงของภาพขนาดย่อในหน่วยพิกเซล

image.thumbnailWidth

integer

ความกว้างของรูปภาพขนาดย่อในหน่วยพิกเซล

labels[]

object

สรุปข้อมูลทั้งหมดเกี่ยวกับป้ายกำกับการปรับแต่ง

labels[].name

string

ชื่อของป้ายกำกับการปรับเกณฑ์การค้นหาที่คุณสามารถใช้เพื่อปรับแต่งการค้นหา ไม่แสดงข้อมูลนี้ในอินเทอร์เฟซผู้ใช้ของคุณ ให้ใช้ displayName แทน

labels[].displayName

string

ชื่อที่แสดงของป้ายกำกับการปรับแต่ง นี่คือชื่อที่คุณควรแสดงในอินเทอร์เฟซผู้ใช้ของคุณ

labels[].label_with_op

string

ป้ายกำกับการปรับแต่งและการดำเนินการปรับเกณฑ์การค้นหาที่เกี่ยวข้อง