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)

  • แฟลชเวฟ (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)

  • แฟลชเวฟ (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)

  • แฟลชเวฟ (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)

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

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

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