การอ้างอิง XML API

หน้านี้อ้างถึงเวอร์ชัน XML ของ Custom Search JSON API ซึ่งพร้อมให้บริการสำหรับลูกค้า Google Site Search เท่านั้น

  1. ภาพรวม
  2. รูปแบบคำขอ Programmable Search Engine
    1. ภาพรวมคำขอ
    2. คำค้นหา
    3. พารามิเตอร์คำขอ
      1. ตัวอย่างคำค้นหา WebSearch
      2. คำจำกัดความของพารามิเตอร์การค้นหา WebSearch
      3. การค้นหาขั้นสูง
      4. พารามิเตอร์คำค้นหาขั้นสูง
      5. คำค้นหาพิเศษ
      6. การค้นหารูปภาพตัวอย่าง
      7. พารามิเตอร์คำค้นหารูปภาพ
      8. ขีดจำกัดคำขอ
    4. การทำให้คำค้นหาและการนำเสนอผลลัพธ์เป็นสากล
      1. การเข้ารหัสอักขระ
      2. ภาษาของอินเทอร์เฟซ
      3. การค้นหาภาษาจีนตัวย่อและตัวเต็ม
    5. การกรองผลลัพธ์
      1. การกรองผลการค้นหาโดยอัตโนมัติ
      2. การกรองภาษาและประเทศ
      3. การกรองเนื้อหาสำหรับผู้ใหญ่ด้วยฟีเจอร์ค้นหาปลอดภัย
  3. ผลลัพธ์ XML
    1. ผลลัพธ์ที่เป็น XML ของ Google
    2. เกี่ยวกับการตอบกลับ XML
    3. ผลลัพธ์ XML สำหรับคำค้นหาปกติ รูปภาพ และขั้นสูง
      1. การค้นหาทั่วไป/ขั้นสูง: ตัวอย่างข้อความค้นหาและผลลัพธ์ XML
      2. การค้นหาทั่วไป/ขั้นสูง: แท็ก XML
      3. ผลลัพธ์ XML สำหรับคำค้นหารูปภาพ
      4. การค้นหารูปภาพ: การค้นหาตัวอย่างและผลลัพธ์ XML
      5. การค้นหารูปภาพ: แท็ก XML

ภาพรวม

บริการ Google WebSearch ทำให้ลูกค้า Google Site Search แสดงผลการค้นหาโดย Google ในเว็บไซต์ของตนเองได้ บริการ WebSearch ใช้โปรโตคอลแบบ HTTP แบบง่ายเพื่อแสดงผลการค้นหา ผู้ดูแลระบบการค้นหาสามารถควบคุมวิธีขอผลการค้นหาและวิธีแสดงผลการค้นหาต่อผู้ใช้ปลายทางได้อย่างเต็มที่ เอกสารนี้อธิบายรายละเอียดทางเทคนิคของรูปแบบคำขอและผลการค้นหาของ Google

หากต้องการเรียกผลการค้นหาของ Google WebSearch แอปพลิเคชันจะส่งคำขอ HTTP แบบง่ายไปยัง Google จากนั้น Google จะแสดงผลการค้นหาในรูปแบบ XML ผลการค้นหาในรูปแบบ XML จะช่วยให้คุณปรับแต่งวิธีการแสดงผลการค้นหาได้

รูปแบบคำขอ WebSearch

ภาพรวมคำขอ

คำขอ Google Search เป็นคำสั่ง HTTP GET มาตรฐาน โดยมีชุดพารามิเตอร์ที่เกี่ยวข้องกับคำค้นหาของคุณ พารามิเตอร์เหล่านี้จะรวมอยู่ใน URL คำขอเป็นคู่ name=value โดยคั่นด้วยอักขระเครื่องหมายแอมเพอร์แซนด์ (&) พารามิเตอร์ประกอบด้วยข้อมูล เช่น คำค้นหาและรหัสเครื่องมือที่ไม่ซ้ำกัน (cx) ซึ่งระบุเครื่องมือที่สร้างคำขอ HTTP บริการ WebSearch หรือ Image Search แสดงผลผลลัพธ์ XML เพื่อตอบสนองคำขอ HTTP ของคุณ

คำค้นหา

คำขอการค้นหาส่วนใหญ่จะมีคำค้นหาอย่างน้อย 1 รายการ ข้อความค้นหาจะปรากฏเป็นค่าของพารามิเตอร์ในคำขอการค้นหา

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

  • คำหรือวลีที่จะรวมหรือยกเว้น
    • ทุกคำในคำค้นหา (ค่าเริ่มต้น)
    • วลีที่ตรงกันในคำค้นหา
    • คำหรือวลีในคำค้นหา
  • ตำแหน่งในเอกสารสำหรับค้นหาข้อความค้นหา
    • ทุกที่ในเอกสาร (ค่าเริ่มต้น)
    • เฉพาะในเนื้อความของเอกสารเท่านั้น
    • ในชื่อเอกสารเท่านั้น
    • เฉพาะใน URL เอกสาร
    • เฉพาะในลิงก์ในเอกสาร
  • ข้อจำกัดเกี่ยวกับเอกสาร
    • การรวมหรือยกเว้นเอกสารในไฟล์บางประเภท (เช่น ไฟล์ PDF หรือเอกสาร Word)
  • การค้นหา URL พิเศษที่แสดงข้อมูลเกี่ยวกับ URL หนึ่งๆ แทนการทำการค้นหา
    • คำค้นหาที่แสดงข้อมูลทั่วไปเกี่ยวกับ URL เช่น หมวดหมู่ Open Directory, ตัวอย่างข้อมูล หรือภาษา
    • คำค้นหาที่แสดงผลชุดหน้าเว็บที่ลิงก์ไปยัง URL
    • ข้อความค้นหาที่แสดงผลชุดหน้าเว็บที่คล้ายกับ URL ที่ระบุ

การค้นหาเริ่มต้น

ค่าพารามิเตอร์คำค้นหาต้องเป็นอักขระหลีกกับ URL โปรดทราบว่าคุณจะต้องแทนที่เครื่องหมายบวก ("+") สำหรับลำดับช่องว่างในคำค้นหา ซึ่งจะมีการอธิบายเพิ่มเติมในส่วนการใช้อักขระหลีก URL ของเอกสารนี้

ระบบจะส่งข้อความค้นหาไปยังบริการ WebSearch โดยใช้พารามิเตอร์ q ตัวอย่างของข้อความค้นหา ได้แก่

q=horses+cows+pigs

โดยค่าเริ่มต้น บริการ Google WebSearch จะแสดงเฉพาะเอกสารที่มีคำทุกคำในคำค้นหาเท่านั้น

พารามิเตอร์คำขอ

ส่วนนี้จะแสดงพารามิเตอร์ที่คุณใช้เมื่อส่งคำขอค้นหาได้ พารามิเตอร์จะแบ่งออกเป็น 2 รายการ รายการแรกมีพารามิเตอร์ที่เกี่ยวข้องกับคำขอการค้นหาทั้งหมด รายการที่ 2 จะมีพารามิเตอร์ที่เกี่ยวข้องกับคำขอการค้นหาขั้นสูงเท่านั้น

ต้องมีพารามิเตอร์คำขอ 3 แบบ ดังนี้

  • ต้องตั้งค่าพารามิเตอร์ client เป็น google-csbe
  • พารามิเตอร์ output ระบุรูปแบบของผลลัพธ์ XML ที่แสดงผล โดยสามารถส่งกลับผลลัพธ์โดยมี (xml) หรือไม่มี (xml_no_dtd) การอ้างอิงไปยัง DTD ของ Google เราขอแนะนำให้ตั้งค่านี้เป็น xml_no_dtd หมายเหตุ: หากคุณไม่ระบุพารามิเตอร์นี้ ระบบจะแสดงผลผลลัพธ์เป็น HTML แทน XML
  • พารามิเตอร์ cx ที่แสดงรหัสที่ไม่ซ้ำกันของเครื่องมือ

พารามิเตอร์คำขอที่ใช้บ่อยที่สุดนอกเหนือจากที่กล่าวไว้ข้างต้น ได้แก่

  • num - จำนวนผลการค้นหาที่ขอ
  • q - ข้อความค้นหา
  • start - ดัชนีเริ่มต้นสำหรับผลการค้นหา

ตัวอย่างการค้นหา WebSearch

ตัวอย่างด้านล่างแสดงคำขอ HTTP ของ WebSearch 2 รายการเพื่อแสดงวิธีการใช้พารามิเตอร์การค้นหาที่แตกต่างกัน คำจำกัดความของพารามิเตอร์การค้นหาต่างๆ มีอยู่ในคำจำกัดความพารามิเตอร์การค้นหาของ WebSearch และพารามิเตอร์คำค้นหาขั้นสูงของเอกสารนี้

คำขอนี้ขอผลลัพธ์ 10 รายการแรก (start=0&num=10) สำหรับคำค้นหา "red sox" (q=red+sox) คำค้นหายัง ระบุว่าผลลัพธ์ควรมาจากเว็บไซต์ของแคนาดา (cr=countryCA) และควรเขียนเป็นภาษาฝรั่งเศส (lr=lang_fr) สุดท้าย คำค้นหา ระบุค่าสำหรับพารามิเตอร์ client, เอาต์พุต และ cx ซึ่งจำเป็นต้องมีทั้ง 3 รายการ

http://www.google.com/search?
  start=0
  &num=10
  &q=red+sox
  &cr=countryCA
  &lr=lang_fr
  &client=google-csbe
  &output=xml_no_dtd
  &cx=00255077836266642015:u-scht7a-8i

ตัวอย่างนี้ใช้พารามิเตอร์การค้นหาขั้นสูงบางรายการเพื่อปรับแต่งคำค้นหาเพิ่มเติม คำขอนี้ใช้พารามิเตอร์ as_q (as_q=red+sox) แทนพารามิเตอร์ q และยังใช้พารามิเตอร์ as_eq เพื่อยกเว้นเอกสารที่มีคำว่า "Yankees" ในผลการค้นหา (as_eq=yankees) อีกด้วย

http://www.google.com/search?
  start=0
  &num=10
  &as_q=red+sox
  &as_eq=Yankees
  &client=google-csbe
  &output=xml_no_dtd
  &cx=00255077836266642015:u-scht7a-8i

คำจำกัดความของพารามิเตอร์การค้นหา WebSearch

c2coff
คำอธิบาย

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

ค่าเริ่มต้นของพารามิเตอร์นี้คือ 0 (ศูนย์) ซึ่งหมายความว่าฟีเจอร์นี้เปิดใช้อยู่ ค่าสำหรับพารามิเตอร์ c2coff มีดังนี้

ค่า การดำเนินการ
1 ปิดใช้
0 เปิดใช้อยู่
ตัวอย่าง q=google&c2coff=1

ลูกค้า
คำอธิบาย

ต้องระบุ ต้องตั้งค่าพารามิเตอร์ client เป็น google-csbe
ตัวอย่าง q=google&client=google-csbe

cr
คำอธิบาย

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

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

  • โดเมนระดับบนสุด (TLD) ของ URL ของเอกสาร
  • สถานที่ตั้งทางภูมิศาสตร์ของที่อยู่ IP ของเว็บเซิร์ฟเวอร์

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

cx
คำอธิบาย

ต้องระบุ พารามิเตอร์ cx ระบุโค้ดที่ไม่ซ้ำกันซึ่งระบุเครื่องมือค้นหาที่กำหนดเอง คุณต้องระบุ Programmable Search Engine โดยใช้พารามิเตอร์ cx เพื่อดึงผลการค้นหาจากเครื่องมือนั้น

หากต้องการค้นหาค่าของพารามิเตอร์ cx ให้ไปที่แผงควบคุม > แท็บโค้ดของเครื่องมือ แล้วคุณจะเห็นพารามิเตอร์นี้ในพื้นที่ข้อความใต้ "วางโค้ดนี้ในหน้าเว็บที่ต้องการให้ช่องค้นหาปรากฏ ผลการค้นหาจะแสดงบนหน้าที่โฮสต์โดย Google
ตัวอย่าง q=Frodo&cx=00255077836266642015:u-scht7a-8i

ฟิลเตอร์
คำอธิบาย

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

ค่าเริ่มต้นสำหรับพารามิเตอร์ filter คือ 1 ซึ่งบ่งบอกว่าฟีเจอร์นี้เปิดใช้อยู่ ค่าที่ถูกต้องสำหรับพารามิเตอร์นี้คือ

ค่า การดำเนินการ
1 ปิดใช้
0 เปิดใช้อยู่

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

gl
คำอธิบาย

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

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

คำขอนี้ช่วยกระตุ้นให้เอกสารที่เขียนในสหราชอาณาจักรปรากฏในผลการค้นหาของ WebSearch:
q=pizza&gl=uk

hl
คำอธิบาย

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

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

คำขอนี้กำหนดเป้าหมายโฆษณาสำหรับไวน์ในภาษาฝรั่งเศส (Vin คือคำศัพท์ภาษาฝรั่งเศสสำหรับไวน์)

q=vin&ip=10.10.10.10&ad=w5&hl=fr

คุณภาพสูง
คำอธิบาย

Optional พารามิเตอร์ hq จะเพิ่มข้อความค้นหาที่ระบุต่อท้ายการค้นหา เสมือนว่าถูกรวมเข้ากับโอเปอเรเตอร์ตรรกะ AND

ตัวอย่าง

คำขอนี้ค้นหา "พิซซ่า" และ "ชีส" และนิพจน์จะเหมือนกับ q=pizza+cheese

q=pizza&hq=cheese

ie
คำอธิบาย

Optional พารามิเตอร์ ie จะกำหนดรูปแบบการเข้ารหัสอักขระที่ควรใช้เพื่อตีความสตริงคำค้นหา ค่า ie เริ่มต้นคือ latin1

ดูส่วนการเข้ารหัสอักขระ สำหรับการสนทนาเกี่ยวกับเวลาที่คุณอาจต้องใช้พารามิเตอร์นี้

ดูส่วนรูปแบบการเข้ารหัสอักขระสำหรับรายการค่า ie ที่เป็นไปได้
ตัวอย่าง q=google&ie=utf8&oe=utf8
lr
คำอธิบาย

Optional พารามิเตอร์ lr (จำกัดภาษา) จะจำกัดผลการค้นหาไว้เฉพาะเอกสารที่เขียนในภาษาหนึ่งๆ เท่านั้น

Google WebSearch ระบุภาษาของเอกสารโดยวิเคราะห์สิ่งต่อไปนี้

  • โดเมนระดับบนสุด (TLD) ของ URL ของเอกสาร
  • เมตาแท็กภาษาภายในเอกสาร
  • ภาษาหลักที่ใช้ในข้อความเนื้อหาของเอกสาร
  • ภาษารอง (หากมี) ในเนื้อหาของเอกสาร

ดูส่วนค่าคอลเล็กชันภาษา (lr) สำหรับรายการค่าที่ถูกต้องสำหรับพารามิเตอร์นี้
ตัวอย่าง q=Frodo&lr=lang_en

num
คำอธิบาย

Optional พารามิเตอร์ num จะระบุจำนวนผลการค้นหาที่จะแสดงผล

ค่า num เริ่มต้นคือ 10 และค่าสูงสุดคือ 20 หากคุณขอผลการค้นหามากกว่า 20 รายการ ระบบจะแสดงผลการค้นหาเพียง 20 รายการ

หมายเหตุ: หากจำนวนผลการค้นหาทั้งหมดน้อยกว่าจำนวนผลการค้นหาที่ขอ ระบบจะแสดงผลการค้นหาทั้งหมดที่มี
ตัวอย่าง q=google&num=10

oe
คำอธิบาย

Optional พารามิเตอร์ oe จะกำหนดรูปแบบการเข้ารหัสอักขระที่ควรใช้เพื่อถอดรหัสผลลัพธ์ XML ค่า oe เริ่มต้นคือ latin1

ดูส่วนการเข้ารหัสอักขระ สำหรับการสนทนาเกี่ยวกับเวลาที่คุณอาจต้องใช้พารามิเตอร์นี้

ดูส่วนรูปแบบการเข้ารหัสอักขระสำหรับรายการค่า oe ที่เป็นไปได้
ตัวอย่าง q=google&ie=utf8&oe=utf8

เอาต์พุต
คำอธิบาย

ต้องระบุ พารามิเตอร์ output ระบุรูปแบบของผลลัพธ์ XML ค่าที่ถูกต้องสำหรับพารามิเตอร์นี้คือ xml และ xml_no_dtd แผนภูมิด้านล่างอธิบายว่าค่าพารามิเตอร์เหล่านี้แตกต่างกันอย่างไร

ค่า รูปแบบเอาต์พุต
xml_no_dtd ผลลัพธ์ที่เป็น XML จะไม่มีคำสั่ง !DOCTYPE (แนะนำ)
xml ผลลัพธ์ XML จะมีการอ้างอิง Google DTD บรรทัดที่ 2 ของผลการค้นหาจะระบุประเภทคำจำกัดความเอกสาร (DTD) ที่ผลลัพธ์ใช้ ดังนี้ 
    <!DOCTYPE GSP SYSTEM "google.dtd">
ตัวอย่าง output=xml_no_dtd
output=xml

q
คำอธิบาย

Optional พารามิเตอร์ q จะระบุคำค้นหาที่ผู้ใช้ป้อน แม้ว่าพารามิเตอร์นี้จะไม่บังคับ แต่คุณต้องระบุค่าสำหรับพารามิเตอร์การค้นหาอย่างน้อย 1 รายการ (as_epq, as_lq, as_oq, as_q เพื่อรับผลการค้นหา

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

แผงควบคุม Google Search จะมีรายงานคำค้นหายอดนิยมที่ส่งโดยใช้พารามิเตอร์ q

หมายเหตุ: ค่าที่ระบุสำหรับพารามิเตอร์ q ต้องเป็นค่า Escape จาก URL
ตัวอย่าง q=vacation&as_oq=london+paris

ปลอดภัย
คำอธิบาย

Optional พารามิเตอร์ safe จะระบุวิธีการกรองผลการค้นหาสำหรับเนื้อหาสำหรับผู้ใหญ่และเนื้อหาลามกอนาจาร ค่าเริ่มต้นสำหรับพารามิเตอร์ safe คือ off ค่าพารามิเตอร์ที่ถูกต้องมีดังนี้

ค่า การดำเนินการ
off ปิดใช้งานฟีเจอร์ค้นหาปลอดภัย
medium เปิดใช้งานฟีเจอร์ค้นหาปลอดภัย
high เปิดใช้เวอร์ชันที่เข้มงวดยิ่งขึ้นของฟีเจอร์ค้นหาปลอดภัย

ดูส่วนการกรองเนื้อหาสำหรับผู้ใหญ่ด้วยฟีเจอร์ค้นหาปลอดภัยสำหรับรายละเอียดเพิ่มเติมเกี่ยวกับฟีเจอร์นี้
ตัวอย่าง q=adult&safe=high

เริ่มต้น
คำอธิบาย

Optional พารามิเตอร์ start ระบุผลลัพธ์ที่ตรงกันรายการแรกที่ควรรวมอยู่ในผลการค้นหา พารามิเตอร์ start ใช้ดัชนีฐาน 0 ซึ่งหมายความว่าผลลัพธ์แรกคือ 0 ผลลัพธ์ที่สองคือ 1 เป็นต้นไป

พารามิเตอร์ start จะทำงานร่วมกับพารามิเตอร์ num เพื่อกำหนดผลการค้นหาที่จะแสดงผล โปรดทราบว่าจะไม่มีผลลัพธ์มากกว่า 1000 รายการสำหรับข้อความค้นหาใดๆ แม้ว่าจะมีเอกสารมากกว่า 1, 000 รายการที่ตรงกับข้อความค้นหา ดังนั้นการตั้งค่าที่เริ่มต้นด้วย 1, 000 หรือสูงกว่าจะทำให้ไม่มีผลลัพธ์
ตัวอย่าง start=10

จัดเรียง
คำอธิบาย

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

sort=date

อ.
คำอธิบาย

Optional พารามิเตอร์ ud จะระบุว่าการตอบกลับ XML ควรมี URL ที่เข้ารหัส IDN สำหรับผลการค้นหาหรือไม่ การเข้ารหัส IDN (ชื่อโดเมนสากล) ช่วยให้โดเมนแสดงโดยใช้ภาษาท้องถิ่นได้ เช่น

http://www.花井鮨.com

ค่าที่ถูกต้องสำหรับพารามิเตอร์นี้คือ 1 (ค่าเริ่มต้น) ซึ่งหมายความว่าผลลัพธ์ XML ควรมี URL ที่เข้ารหัส IDN และ 0 ซึ่งหมายความว่าผลลัพธ์ XML ไม่ควรมี URL ที่เข้ารหัส IDN หากตั้งค่าพารามิเตอร์ ud เป็น 1 URL ที่เข้ารหัส IDN จะปรากฏในแท็ก UD ในผลลัพธ์ XML ของคุณ

หากตั้งค่าพารามิเตอร์ ud เป็น 0 URL ในตัวอย่างด้านบนจะแสดงเป็น

http://www.xn--elq438j.com.

หมายเหตุ: ฟีเจอร์นี้อยู่ในเวอร์ชันเบต้า
ตัวอย่าง q=google&ud=1

พารามิเตอร์การค้นหาเพิ่มเติมที่แสดงอยู่ด้านล่างรูปภาพเกี่ยวข้องกับคำค้นหาขั้นสูง เมื่อส่งการค้นหาขั้นสูง ระบบจะพิจารณาค่าของพารามิเตอร์หลายรายการ (เช่น as_eq, as_epq, as_oq ฯลฯ) ในคำค้นหาสำหรับการค้นหานั้น รูปภาพแสดงหน้าการค้นหาขั้นสูงของ Google ในรูปภาพ ชื่อของพารามิเตอร์การค้นหาขั้นสูงแต่ละรายการจะเขียนด้วยข้อความredด้านในหรือข้างช่องในหน้าที่สอดคล้องกับพารามิเตอร์นั้นๆ



พารามิเตอร์การค้นหาขั้นสูง

as_dt
คำอธิบาย

Optional พารามิเตอร์ as_dt จะควบคุมว่าจะรวมหรือยกเว้นผลการค้นหาจากเว็บไซต์ที่มีชื่อในพารามิเตอร์ as_sitesearch หรือไม่ ค่า i และ e แสดงถึงการรวมและการยกเว้นตามลำดับ
ตัวอย่าง as_dt=i,as_dt=e

as_epq
คำอธิบาย

Optional พารามิเตอร์ as_epq จะระบุวลีที่เอกสารทั้งหมดในผลการค้นหาต้องมี นอกจากนี้ คุณยังใช้คำค้นหาที่ค้นหาวลีเพื่อค้นหาวลีได้ด้วย
ตัวอย่าง as_epq=abraham+lincoln

as_eq
คำอธิบาย

Optional พารามิเตอร์ as_eq จะระบุคำหรือวลีที่ไม่ควรปรากฏในเอกสารในผลการค้นหา คุณยังใช้คำค้นหายกเว้นเพื่อให้แน่ใจว่าคำหรือวลีนั้นจะไม่ปรากฏในเอกสารในชุดผลการค้นหา
ตัวอย่าง

q=bass&as_eq=music.

as_lq
คำอธิบาย

Optional พารามิเตอร์ as_lq ระบุว่าผลการค้นหาทั้งหมดควรมีลิงก์ไปยัง URL หนึ่งๆ นอกจากนี้คุณยังใช้คำค้นหา link: สำหรับคำค้นหาประเภทนี้ได้อีกด้วย

ตัวอย่าง

as_lq=www.google.com

as_nlo
คำอธิบาย

Optional พารามิเตอร์ as_nlo ระบุค่าเริ่มต้นสำหรับช่วงการค้นหา ใช้ as_nlo และ as_nhi เพื่อเพิ่มช่วงการค้นหาที่ครอบคลุมของ as_nlo...as_nhi ลงในการค้นหา

ตัวอย่าง

การตั้งค่าต่อไปนี้กำหนดช่วงการค้นหาเป็น 5 ถึง 10

as_nlo=5&as_nhi=10
as_nhi
คำอธิบาย

Optional พารามิเตอร์ as_nhi ระบุค่าสิ้นสุดสำหรับช่วงการค้นหา ใช้ as_nlo และ as_nhi เพื่อเพิ่มช่วงการค้นหาที่ครอบคลุม as_nlo...as_nhi ลงในการค้นหา
ตัวอย่าง

การตั้งค่าต่อไปนี้กำหนดช่วงการค้นหาเป็น 5 ถึง 10

as_nlo=5&as_nhi=10
as_oq
คำอธิบาย

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

q=vacation&as_oq=London+Paris

as_q
คำอธิบาย

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

q=president&as_q=John+Adams

as_qdr
คำอธิบาย

Optional พารามิเตอร์ as_qdr จะขอผลการค้นหาจากระยะเวลาที่ระบุ (ช่วงวันที่ด่วน) ค่าที่รองรับมีดังนี้

d[number] ขอผลลัพธ์จากจำนวนวันที่ผ่านมาที่ระบุ
w[number] ขอผลลัพธ์จากจำนวนสัปดาห์ที่ผ่านมาที่ระบุ
m[number] ขอผลลัพธ์จากจำนวนเดือนที่ผ่านมาที่ระบุ
y[number] ขอผลลัพธ์จากจำนวนปีที่ผ่านมาที่ระบุ
ตัวอย่าง

ตัวอย่างนี้ขอผลลัพธ์จากปีที่ผ่านมา:

as_qdr=y

ตัวอย่างนี้ขอผลลัพธ์จาก 10 วันที่ผ่านมา

as_qdr=d10
as_sitesearch
คำอธิบาย

Optional พารามิเตอร์ as_sitesearch ช่วยให้คุณสามารถระบุว่าผลการค้นหาทั้งหมดควรเป็นหน้าเว็บจากเว็บไซต์หนึ่งๆ การตั้งค่าพารามิเตอร์ as_dt จะช่วยให้คุณสามารถใช้พารามิเตอร์ดังกล่าวเพื่อยกเว้นหน้าเว็บจากเว็บไซต์หนึ่งๆ จากการค้นหาด้วย
ตัวอย่าง

q=vacation&as_sitesearch=www.google.com

คำค้นหาพิเศษ

Google WebSearch อนุญาตให้ใช้ข้อความค้นหาพิเศษต่างๆ มากมายที่เข้าถึงความสามารถเพิ่มเติมของเครื่องมือค้นหาของ Google คำค้นหาพิเศษเหล่านี้ควรรวมอยู่ในค่าของพารามิเตอร์คำขอ q คำค้นหาพิเศษต้องเป็น URL ที่ใช้ Escape เช่นเดียวกับคำค้นหาอื่นๆ ข้อความค้นหาพิเศษจำนวนมากมีโคลอน (:) อักขระนี้ต้องกำหนดเป็นอักขระหลีกกับ URL ด้วย ค่าที่กำหนดเป็นอักขระหลีกของ URL คือ %3A

ลิงก์ย้อนกลับ [link:]
คำอธิบาย

ข้อความค้นหา link: จะเรียกชุดของหน้าเว็บที่ลิงก์กับ URL ที่เฉพาะเจาะจง คำค้นหาควรอยู่ในรูปแบบ link:URL โดยไม่มีช่องว่างระหว่างคำค้นหา link: กับ URL

link: เวอร์ชันที่ใช้อักขระหลีกกับ URL คือ link%3A

คุณใช้พารามิเตอร์คำขอ as_lq เพื่อส่งคำขอ link: ได้ด้วย

หมายเหตุ: คุณไม่สามารถระบุคำค้นหาอื่นๆ เมื่อใช้ link:
ตัวอย่าง

http://www.google.com/search?q=link%3Awww.example.com

บูลีน OR การค้นหา [ OR ]
คำอธิบาย

คำค้นหา OR จะเรียกเอกสารที่มีชุดคำค้นหา (2 คำขึ้นไป) 1 ชุด หากต้องการใช้ข้อความค้นหา OR คุณจะต้องแทรกข้อความค้นหา OR เป็นตัวอักษรพิมพ์ใหญ่คั่นระหว่างแต่ละคำในชุด

คุณยังใช้พารามิเตอร์คำขอ as_oq เพื่อส่งการค้นหาคำใดๆ ในชุดคำได้อีกด้วย

หมายเหตุ: หากคำขอการค้นหาระบุคำค้นหา "London+OR+Paris" ผลการค้นหาจะรวมเอกสารที่มีคำเหล่านั้นอย่างน้อย 1 คำจาก 2 คำดังกล่าว ในบางกรณี เอกสารในผลการค้นหาอาจมีทั้ง 2 คำ
ตัวอย่าง

ค้นหาลอนดอนหรือปารีส:

ข้อมูลจากผู้ใช้:london OR paris ข้อความค้นหา:q=london+OR+paris

ค้นหาวันหยุดพักผ่อนและลอนดอนหรือปารีส:

ข้อความค้นหา:q=vacation+london+OR+paris

ค้นหาวันหยุดพักผ่อนและวันหยุดลอนดอน ปารีส หรือช็อกโกแลต:

ข้อความค้นหา:  q=vacation+london+OR+paris+OR+chocolates

ค้นหา "วันหยุดพักผ่อน" และ "ช็อกโกแลต" หรือ "ลอนดอน" หรือ "ปารีส" โดยให้น้ำหนักน้อยที่สุดดังนี้

ข้อความค้นหา:  q=vacation+london+OR+paris+chocolates

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

ข้อความค้นหา:  q=vacation+london+OR+paris+chocolates+flowers

ค้นหา "วันหยุดพักผ่อน" และ "ลอนดอน" หรือ "ปารีส" และค้นหา "ช็อกโกแลตหรือดอกไม้" โดยทำดังนี้

ข้อความค้นหา:  q=vacation+london+OR+paris+chocolates+OR+flowers

ยกเว้นข้อความค้นหา [-]
คำอธิบาย

คำค้นหา "ยกเว้น" (-) จะจำกัดผลลัพธ์ของคำขอการค้นหาบางรายการไว้เฉพาะเอกสารที่ไม่มีคำหรือวลีที่เจาะจง หากต้องการใช้คำค้นหายกเว้น คุณจะต้องนำหน้าคำหรือวลีที่จะยกเว้นจากเอกสารที่ตรงกันด้วย "-" (เครื่องหมายลบ)

- เวอร์ชันที่ใช้อักขระหลีกกับ URL คือ %2D

ข้อความค้นหา "ยกเว้น" จะมีประโยชน์เมื่อข้อความค้นหามีความหมายมากกว่า 1 ความหมาย ตัวอย่างเช่น คำว่า "bass" อาจแสดงผลการค้นหาเกี่ยวกับปลาหรือเพลงก็ได้ หากคุณต้องการเอกสารเกี่ยวกับปลา คุณสามารถยกเว้นเอกสารเกี่ยวกับเพลงในผลการค้นหาได้โดยใช้ข้อความค้นหายกเว้น

คุณยังใช้พารามิเตอร์คำขอ as_eq เพื่อยกเว้นเอกสารที่ตรงกับคำหรือวลีหนึ่งๆ ในผลการค้นหาได้อีกด้วย
ตัวอย่าง ข้อมูลจากผู้ใช้: bass -music
ข้อความค้นหา: q=bass+%2Dmusic

การยกเว้นประเภทไฟล์ [ -filetype: ]
คำอธิบาย

คำค้นหา -filetype: จะไม่รวมเอกสารที่มีนามสกุลไฟล์เฉพาะ เช่น ".pdf" หรือ ".doc" จากผลการค้นหา คำค้นหาควรจัดรูปแบบเป็น -filetype:EXTENSION โดยไม่มีช่องว่างระหว่างคำค้นหา -filetype: และส่วนขยายที่ระบุ

-filetype: เวอร์ชันที่ใช้อักขระหลีกกับ URL คือ %2Dfiletype%3A

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

ประเภทไฟล์ที่ 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 (เอกสาร)
  • Microsoft Works (สัปดาห์, WPS, WDB)
  • Microsoft Write (wri)
  • รูปแบบ Rich Text (RTF)
  • ShockWave Flash (SWF)
  • ข้อความ (ans, txt)

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

ตัวอย่างนี้แสดงเอกสารที่พูดถึง "Google" แต่ไม่ใช่เอกสาร PDF
q=Google+%2Dfiletype%3Apdf

ตัวอย่างนี้แสดงเอกสารที่พูดถึง "Google" แต่ยกเว้นทั้งเอกสาร PDF และ Word:
q=Google+%2Dfiletype%3Apdf+%2Dfiletype%3Adoc

การกรองประเภทไฟล์ [ filetype: ]
คำอธิบาย

ข้อความค้นหา filetype: จะจำกัดผลการค้นหาไว้เฉพาะเอกสารที่มีนามสกุลไฟล์หนึ่งๆ เช่น ".pdf" หรือ ".doc" คำค้นหาควรอยู่ในรูปแบบ filetype:EXTENSION โดยไม่มีช่องว่างระหว่างคำค้นหา filetype: และส่วนขยายที่ระบุ

filetype: เวอร์ชันที่ใช้อักขระหลีกกับ URL คือ filetype%3A

คุณจะจำกัดผลการค้นหาให้แสดงเฉพาะเอกสารที่ตรงกับนามสกุลไฟล์ไฟล์ใดไฟล์หนึ่งได้โดยการเพิ่มข้อความค้นหา filetype: ลงในคำค้นหา คุณควรมีคำค้นหา filetype: 1 คำในคำค้นหาสำหรับนามสกุลไฟล์แต่ละรายการที่ควรรวมอยู่ในผลการค้นหา คำค้นหา filetype: หลายคำต้องคั่นด้วยคำค้นหา OR

โดยค่าเริ่มต้น ผลการค้นหาจะรวมเอกสารที่มีนามสกุลไฟล์ใดก็ได้

ประเภทไฟล์ที่ 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 (เอกสาร)
  • Microsoft Works (สัปดาห์, WPS, WDB)
  • Microsoft Write (wri)
  • รูปแบบ Rich Text (RTF)
  • ShockWave Flash (SWF)
  • ข้อความ (ans, txt)

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

ตัวอย่างนี้แสดงเอกสาร PDF ที่ระบุ "Google":
q=Google+filetype%3Apdf

ตัวอย่างนี้แสดงเอกสาร PDF และ Word ที่พูดถึง "Google"
q=Google+filetype%3Apdf+OR+filetype%3Adoc

รวมข้อความค้นหา [+]
คำอธิบาย

คำค้นหา "รวม (+)" จะระบุว่าคำหรือวลีหนึ่งๆ ต้องปรากฏในเอกสารทั้งหมดที่อยู่ในผลการค้นหา หากต้องการใช้ข้อความค้นหา "รวม" คุณจะต้องหน้าคำหรือวลีที่ต้องรวมอยู่ในผลการค้นหาทั้งหมดด้วย "+" (เครื่องหมายบวก)

+ เวอร์ชันที่ใช้อักขระหลีกกับ URL (เครื่องหมายบวก) คือ %2B

คุณควรใช้ + ก่อนคำทั่วไปที่ปกติแล้ว Google จะทิ้งก่อนที่จะระบุผลการค้นหา
ตัวอย่าง ข้อมูลจากผู้ใช้: Star Wars Episode +I
ข้อความค้นหา: q=Star+Wars+Episode+%2BI

การค้นหาเฉพาะลิงก์ คำทั้งหมด [ allinlinks: ]
คำอธิบาย

ข้อความค้นหา allinlinks: กำหนดให้เอกสารในผลการค้นหาต้องมีคำทั้งหมดของคำค้นหาในลิงก์ URL คำค้นหาควรอยู่ในรูปแบบ allinlinks: ตามด้วยคำในคำค้นหา

หากคำค้นหามีคำค้นหา allinlinks: Google จะตรวจสอบเฉพาะลิงก์ URL ในเอกสารสำหรับคำในคำค้นหา โดยจะไม่สนใจข้อความอื่นๆ ในเอกสาร ชื่อเอกสาร และ URL ของเอกสารแต่ละรายการ โปรดทราบว่า URL ของเอกสารจะแตกต่างจากลิงก์ URL ที่อยู่ในเอกสาร

allinlinks: เวอร์ชันที่ใช้อักขระหลีกกับ URL คือ allinlinks%3A
ตัวอย่าง ข้อมูลจากผู้ใช้:allinlinks: Google search
ข้อความค้นหา:q=allinlinks%3A+Google+search

การค้นหาวลี
คำอธิบาย

คำค้นหาวลี (") ช่วยให้คุณค้นหาวลีที่สมบูรณ์ด้วยการใส่เครื่องหมายคำพูดล้อมรอบวลี หรือเชื่อมต่อวลีเหล่านั้นกับขีดกลาง

" เวอร์ชันที่ใช้อักขระหลีกกับ URL (เครื่องหมายคำพูด) คือ %22

การค้นหาวลีจะมีประโยชน์เป็นพิเศษหากคุณค้นหาคำพูดที่มีชื่อเสียงหรือชื่อเฉพาะ

คุณยังใช้พารามิเตอร์คำขอ as_epq เพื่อส่งการค้นหาวลีได้อีกด้วย
ตัวอย่าง ข้อมูลจากผู้ใช้:"Abraham Lincoln"
ข้อความค้นหา: q=%22Abraham+Lincoln%22

การค้นหาข้อความเท่านั้น คำทั้งหมด [allintext:]
คำอธิบาย

ข้อความค้นหา allintext: กำหนดให้เอกสารแต่ละรายการในผลการค้นหาต้องมีคำทั้งหมดของคำค้นหาในเนื้อความของเอกสาร คำค้นหาควรอยู่ในรูปแบบ allintext: ตามด้วยคำในคำค้นหา

หากคำค้นหามีคำค้นหา allintext: Google จะตรวจสอบเฉพาะเนื้อความของเอกสารสำหรับคำในคำค้นหา โดยจะไม่สนใจลิงก์ในเอกสาร ชื่อเอกสาร และ URL เอกสารเหล่านั้น

allintext: เวอร์ชันที่ใช้อักขระหลีกกับ URL คือ allintext%3A
ตัวอย่าง ตัวอย่างนี้ระบุว่าคำว่า "Google" และ "search" ต้องปรากฏในส่วนเนื้อหาของเอกสารทั้งหมดที่อยู่ในผลการค้นหา ดังนี้
ข้อมูลจากผู้ใช้:allintext:Google search
ข้อความค้นหา:q=allintext%3AGoogle+search

การค้นหาชื่อ, คำเดียว [intitle:]
คำอธิบาย

คำค้นหา intitle: จะจำกัดผลการค้นหาไว้เฉพาะเอกสารที่มีคำที่กำหนดในชื่อเอกสาร คำค้นหาควรมีรูปแบบเป็น intitle:WORD โดยไม่มีช่องว่างระหว่างคำค้นหา intitle: กับคำต่อไปนี้

หมายเหตุ: คุณระบุคำมากกว่า 1 คำที่จะรวมไว้ในชื่อเอกสารได้โดยใส่คำค้นหา intitle: ไว้หน้าคำดังกล่าวแต่ละคำ นอกจากนี้คุณยังใช้คำค้นหา allintitle: เพื่อระบุว่าต้องมีคำค้นหาทั้งหมดอยู่ในชื่อเอกสารที่แสดงในผลการค้นหาได้

intitle: เวอร์ชันที่ใช้อักขระหลีกกับ URL คือ intitle%3A
ตัวอย่าง

ตัวอย่างนี้ระบุว่าคำว่า "Google" ต้องปรากฏในชื่อเอกสารใดก็ตามในผลการค้นหา และคำว่า "ค้นหา" ต้องปรากฏในชื่อ, URL, ลิงก์ หรือเนื้อหาของเอกสารเหล่านั้น ดังนี้
ข้อมูลจากผู้ใช้:intitle:Google search
ข้อความค้นหา:q=intitle%3AGoogle+search

การค้นหาชื่อ คำทั้งหมด [allintitle:]
คำอธิบาย

ข้อความค้นหา allintitle: จำกัดผลการค้นหาไว้เฉพาะเอกสารที่มีคำค้นหาทั้งหมดในชื่อเอกสาร หากต้องการใช้ข้อความค้นหา allintitle: ให้ใส่ "allintitle:" ที่ด้านหน้าของคำค้นหา

หมายเหตุ: การป้อน allintitle: ไว้หน้าคำค้นหาจะเทียบเท่ากับการป้อน intitle: ข้างหน้าแต่ละคำในคำค้นหา

allintitle: เวอร์ชันที่ใช้อักขระหลีกกับ URL คือ allintitle%3A
ตัวอย่าง

ตัวอย่างนี้ระบุว่าคำว่า "Google" และ "ค้นหา" ต้องปรากฏในชื่อเอกสารในผลการค้นหา
ข้อมูลจากผู้ใช้: allintitle: Google search
ข้อความค้นหา: q=allintitle%3A+Google+search

การค้นหา URL, คำเดียว [inurl:]
คำอธิบาย

ข้อความค้นหา inurl: จำกัดผลการค้นหาไว้เฉพาะเอกสารที่มีคำที่กำหนดใน URL เอกสาร คำค้นหาควรจัดรูปแบบเป็น inurl:WORD โดยไม่มีช่องว่างระหว่างคำค้นหา inurl: กับคำต่อไปนี้

คำค้นหา inurl: จะไม่สนใจเครื่องหมายวรรคตอนและใช้เฉพาะคำแรกที่ตามหลังโอเปอเรเตอร์ inurl: คุณจะระบุคำที่ต้องรวมอยู่ใน URL เอกสารได้มากกว่า 1 คำโดยใส่คำค้นหา inurl: ไว้หน้าคำดังกล่าวแต่ละคำ คุณยังใช้ข้อความค้นหา allinurl: เพื่อระบุว่าจะต้องรวมคำค้นหาทั้งหมดไว้ใน URL ของเอกสารที่แสดงในผลการค้นหาได้

inurl: เวอร์ชันที่ใช้อักขระหลีกกับ URL คือ inurl%3A
ตัวอย่าง

ตัวอย่างนี้ระบุว่าคำว่า "Google" ต้องปรากฏใน URL ของเอกสารในผลการค้นหา และคำว่า "ค้นหา" ต้องปรากฏในชื่อ, URL, ลิงก์ หรือเนื้อหาของเอกสารเหล่านั้น ดังนี้
ข้อมูลจากผู้ใช้: inurl:Google search
ข้อความค้นหา: q=inurl%3AGoogle+search

การค้นหา URL, คำทั้งหมด [allinurl:]
คำอธิบาย

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

คำค้นหา allinurl: ไม่สนใจเครื่องหมายวรรคตอน จึงทำงานกับคำเท่านั้น ไม่ใช่ในคอมโพเนนต์ของ URL เช่น allinurl: uk/scotland จะจำกัดผลลัพธ์ไว้เฉพาะเอกสารที่มีคำว่า "uk" และ "scotland" ใน URL แต่จะไม่กำหนดให้ 2 คำนี้ปรากฏในลำดับที่เจาะจงหรือให้มีเครื่องหมายทับคั่น

allinurl: เวอร์ชันที่ใช้อักขระหลีกกับ URL คือ allinurl%3A
ตัวอย่าง

ตัวอย่างนี้ระบุว่าคำว่า "Google" และ "search" ต้องปรากฏใน URL ของเอกสารในผลการค้นหา
ข้อมูลจากผู้ใช้: allinurl: Google search
ข้อความค้นหา: q=allinurl%3A+Google+search


ข้อมูลเอกสารในเว็บ [info:]
คำอธิบาย

ข้อความค้นหา info: จะเรียกข้อมูลทั่วไปเกี่ยวกับ URL ตราบใดที่ URL นั้นรวมอยู่ในดัชนีการค้นหาของ Google คำค้นหาควรจัดรูปแบบเป็น info:URL โดยไม่มีช่องว่างระหว่างคำค้นหา info: กับ URL

info: เวอร์ชันที่ใช้อักขระหลีกกับ URL คือ info%3A

หมายเหตุ: คุณไม่สามารถระบุคำค้นหาอื่นๆ เมื่อใช้ info:
ตัวอย่าง ข้อมูลจากผู้ใช้: info:www.google.com
ข้อความค้นหา: q=info%3Awww.google.com

การค้นหารูปภาพตัวอย่าง

ตัวอย่างด้านล่างแสดงคำขอ HTTP รูปภาพ 2 รายการเพื่อแสดงวิธีใช้พารามิเตอร์การค้นหาที่แตกต่างกัน คำนิยามสำหรับพารามิเตอร์การค้นหาต่างๆ มีอยู่ในส่วนคำจำกัดความพารามิเตอร์การค้นหารูปภาพของเอกสารนี้

คำขอนี้ขอให้แสดงผลลัพธ์ 5 รายการแรก (start=0&num=5) สำหรับคำค้นหา "monkey" (q=monkey) ของประเภทไฟล์ .png สุดท้าย การค้นหาจะระบุค่าสำหรับพารามิเตอร์ client, output และ cx โดยที่ทั้ง 3 ค่าเป็นพารามิเตอร์ที่ต้องระบุ

http://www.google.com/cse?
  searchtype=image
  start=0
  &num=5
  &q=monkey
  &as_filetype=png
  &client=google-csbe
  &output=xml_no_dtd
  &cx=00255077836266642015:u-scht7a-8i

พารามิเตอร์คำค้นหารูปภาพ

as_filetype
คำอธิบาย

Optional แสดงรูปภาพในประเภทที่ระบุ ค่าที่อนุญาตคือ bmp, gif, png, jpg และ svg
ตัวอย่าง q=google&as_filetype=png

imgsz
คำอธิบาย

Optional แสดงรูปภาพที่มีขนาดตามที่ระบุ โดยขนาดอาจเป็นค่าใดค่าหนึ่งต่อไปนี้

  • icon (เล็ก)
  • small|medium|large|xlarge (ปานกลาง)
  • xxlarge (ใหญ่)
  • huge (ใหญ่พิเศษ)

ตัวอย่าง q=google&as_filetype=png&imgsz=icon

ประเภทภาพ
คำอธิบาย

Optional แสดงรูปภาพประเภทหนึ่ง ซึ่งอาจเป็นอย่างใดอย่างหนึ่งต่อไปนี้

  • clipart (คลิป)
  • face (ใบหน้า)
  • lineart (เชิงเส้น)
  • news (ข่าว)
  • photo (รูปภาพ)
ตัวอย่าง q=google&as_filetype=png&imgtype=photo

imgc
คำอธิบาย

Optional แสดงรูปภาพขาวดำ โทนสีเทา หรือรูปภาพสี ดังนี้

  • mono (ขาวดำ)
  • gray (โทนสีเทา)
  • color (สี)
ตัวอย่าง q=google&as_filetype=png&imgc=gray

สี imgcolor
คำอธิบาย

Optional แสดงรูปภาพที่มีสีเด่นที่เฉพาะเจาะจง:

  • yellow
  • green
  • teal
  • blue
  • purple
  • pink
  • white
  • gray
  • black
  • brown
ตัวอย่าง q=google&as_filetype=png&imgcolor=yellow

as_rights
คำอธิบาย

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

  • cc_publicdomain
  • cc_attribute
  • cc_sharealike
  • cc_noncommercial
  • cc_nonderived
ตัวอย่าง q=cats&as_filetype=png&as_rights=cc_attribute

ขีดจำกัดคำขอ

แผนภูมิด้านล่างนี้แสดงข้อจำกัดของคำขอค้นหาที่คุณส่งไปยัง Google

ส่วนประกอบ ขีดจำกัด ความคิดเห็น
ความยาวของคำขอการค้นหา 2048 ไบต์  
จำนวนข้อความค้นหา 10 รวมคำในพารามิเตอร์ต่อไปนี้ q, as_epq, as_eq, as_lq, as_oq, as_q
จำนวนผลลัพธ์ 20 หากคุณตั้งค่าพารามิเตอร์ num เป็นตัวเลขที่มากกว่า 20 ระบบจะแสดงผลลัพธ์เพียง 20 รายการ หากต้องการผลลัพธ์เพิ่มเติม คุณจะต้องส่งคำขอหลายรายการและเพิ่มค่าของพารามิเตอร์ start ด้วยคำขอแต่ละรายการ

การทำให้การค้นหาและการนำเสนอผลลัพธ์เป็นสากล

บริการ Google WebSearch ช่วยให้คุณค้นหาเอกสารในหลายภาษาได้ คุณระบุการเข้ารหัสอักขระที่ควรใช้เพื่อตีความคำขอ HTTP และเพื่อเข้ารหัสการตอบกลับ XML ได้ (โดยใช้พารามิเตอร์การค้นหา ie และ oe) คุณยังกรองผลลัพธ์ให้รวมเฉพาะเอกสารที่เขียนในภาษาที่ต้องการได้

ส่วนต่อไปนี้จะอธิบายปัญหาเกี่ยวกับการค้นหาในภาษาต่างๆ

การเข้ารหัสอักขระ

เซิร์ฟเวอร์จะส่งข้อมูลไปยัง User Agent เช่น เบราว์เซอร์ เป็นลำดับไบต์ที่เข้ารหัส จากนั้น User Agent จะถอดรหัสไบต์เป็นลำดับอักขระ เมื่อส่งคำขอไปยังบริการ WebSearch คุณสามารถระบุรูปแบบการเข้ารหัสสำหรับทั้งคำค้นหาและการตอบกลับ XML ที่คุณได้รับ

คุณใช้พารามิเตอร์คำขอ ie เพื่อระบุกลไกการเข้ารหัสสำหรับอักขระในคำขอ HTTP ได้ นอกจากนี้ คุณยังใช้พารามิเตอร์ oe เพื่อระบุรูปแบบการเข้ารหัสที่ Google ควรใช้เพื่อเข้ารหัสการตอบกลับ XML ของคุณได้ หากคุณใช้รูปแบบการเข้ารหัสอื่นที่ไม่ใช่ ISO-8859-1 (หรือ latin1) โปรดตรวจสอบว่าคุณได้ระบุค่าที่ถูกต้องสำหรับพารามิเตอร์ ie และ oe

หมายเหตุ: หากคุณให้บริการฟังก์ชันการค้นหาในหลายภาษา เราขอแนะนำให้ใช้ค่าการเข้ารหัส utf8 (UTF-8) สำหรับทั้งพารามิเตอร์ ie และ oe

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

สำหรับข้อมูลทั่วไปเพิ่มเติมเกี่ยวกับการเข้ารหัสอักขระ โปรดดู http://www.w3.org/TR/REC-html40/charset.html

ภาษาของอินเทอร์เฟซ

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

เราขอแนะนําให้คุณตั้งค่าพารามิเตอร์ hl ในผลการค้นหาให้ชัดเจนเพื่อให้ Google เลือกผลการค้นหาที่มีคุณภาพสูงสุดสําหรับคําค้นหาแต่ละรายการ

โปรดดูส่วนภาษาของอินเทอร์เฟซที่รองรับสำหรับรายการค่าที่ถูกต้องทั้งหมดสำหรับพารามิเตอร์ hl

การค้นหาเอกสารที่เขียนในภาษาที่เฉพาะเจาะจง

คุณใช้พารามิเตอร์คำขอ lr เพื่อจำกัดผลการค้นหาไว้เฉพาะเอกสารที่เขียนในภาษาใดภาษาหนึ่งหรือกลุ่มภาษาได้

พารามิเตอร์ lr รองรับโอเปอเรเตอร์บูลีนเพื่อให้คุณระบุหลายภาษาที่ควรจะรวม (หรือยกเว้น) จากผลการค้นหาได้

ตัวอย่างต่อไปนี้แสดงวิธีการใช้โอเปอเรเตอร์บูลีนเพื่อขอเอกสารในภาษาต่างๆ

สำหรับเอกสารที่เขียนเป็นภาษาญี่ปุ่น

lr=lang_jp

สำหรับเอกสารที่เขียนเป็นภาษาอิตาลีหรือเยอรมัน

lr=lang_it|lang_de

สำหรับเอกสารที่ไม่ได้เขียนเป็นภาษาฮังการีหรือเช็ก:

lr=(-lang_hu).(-lang_cs)

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

ภาษาจีนตัวย่อและจีนตัวเต็มเป็น 2 รูปแบบการเขียนของภาษาจีน แนวคิดเดียวกันอาจเขียนแตกต่างกันในตัวแปรแต่ละรายการ เนื่องจากมีคำค้นหาหนึ่งในตัวแปร บริการ Google WebSearch สามารถแสดงผลการค้นหาที่มีหน้าในทั้ง 2 รูปแบบ

วิธีใช้คุณลักษณะนี้

  1. ตั้งค่าพารามิเตอร์คำขอ c2coff เป็น 0
    และ
  2. ทำตามข้อใดข้อหนึ่งต่อไปนี้
    • อย่าตั้งค่าพารามิเตอร์คำขอ lr
      หรือ
    • ตั้งค่าพารามิเตอร์คำขอ lr เป็น lr=lang_zh-TW|lang_zh-CN

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

search?hl=zh-CN
    &lr=lang_zh-TW|lang_zh-CN
    &c2coff=0

การกรองผลลัพธ์

Google WebSearch มีวิธีกรองผลการค้นหาหลายวิธี ดังนี้

การกรองผลการค้นหาโดยอัตโนมัติ

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

  • เนื้อหาที่ซ้ำกัน หากเอกสารหลายฉบับมีข้อมูลเหมือนกัน ระบบจะรวมเฉพาะเอกสารที่เกี่ยวข้องที่สุดของชุดนั้นไว้ในผลการค้นหา

  • Host Crowding - หากมีผลการค้นหาจํานวนมากจากเว็บไซต์เดียวกัน Google อาจไม่แสดงผลการค้นหาทั้งหมดจากเว็บไซต์นั้น หรืออาจแสดงผลลัพธ์ใน
    อันดับที่ต่ำกว่าที่ควรจะเป็น

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

การกรองภาษาและประเทศ

บริการ Google WebSearch แสดงผลการค้นหาจากดัชนีหลักของเอกสารในเว็บทั้งหมด ดัชนีหลักมีเอกสารคอลเล็กชันย่อยที่จัดกลุ่มตามแอตทริบิวต์หนึ่งๆ ซึ่งรวมถึงภาษาและประเทศต้นทาง

คุณสามารถใช้พารามิเตอร์คำขอ lr และ cr เพื่อจำกัดผลการค้นหาไว้เฉพาะเอกสารคอลเล็กชันย่อยที่เขียนในภาษาหนึ่งๆ หรือมาจากประเทศหนึ่งๆ ตามลำดับ

Google WebSearch ระบุภาษาของเอกสารโดยวิเคราะห์สิ่งต่อไปนี้

  • โดเมนระดับบนสุด (TLD) ของ URL ของเอกสาร
  • เมตาแท็กภาษาภายในเอกสาร
  • ภาษาหลักที่ใช้ในข้อความเนื้อหาของเอกสาร


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

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

  • โดเมนระดับบนสุด (TLD) ของ URL ของเอกสาร
  • สถานที่ตั้งทางภูมิศาสตร์ของที่อยู่ IP ของเว็บเซิร์ฟเวอร์

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

หมายเหตุ: คุณรวมค่าภาษาและค่าประเทศเพื่อปรับแต่งผลการค้นหาได้ เช่น อาจขอเอกสารที่เขียนเป็นภาษาฝรั่งเศสและมาจากฝรั่งเศสหรือแคนาดา หรือขอเอกสารที่มาจากฮอลแลนด์แต่ไม่ได้เขียนเป็นภาษาอังกฤษก็ได้ ทั้งพารามิเตอร์ lr และ cr รองรับโอเปอเรเตอร์บูลีน

การกรองเนื้อหาสำหรับผู้ใหญ่ด้วยฟีเจอร์ค้นหาปลอดภัย

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

Google มุ่งมั่นที่จะทำให้ฟีเจอร์ค้นหาปลอดภัยเป็นปัจจุบันและครอบคลุมมากที่สุดด้วยการรวบรวมข้อมูลเว็บอย่างต่อเนื่องและรวบรวมการอัปเดตจากคำแนะนำของผู้ใช้

ฟีเจอร์ค้นหาปลอดภัยมีให้บริการในภาษาต่อไปนี้

ดัตช์
อังกฤษ
ฝรั่งเศส
เยอรมัน 		อิตาลี
โปรตุเกส (บราซิล)
สเปน
จีนตัวเต็ม

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

ระดับฟีเจอร์ค้นหาปลอดภัย คำอธิบาย
สูง เปิดใช้งานฟีเจอร์ค้นหาปลอดภัยเวอร์ชันเข้มงวดยิ่งขึ้น
medium บล็อกหน้าเว็บที่มีภาพอนาจารและเนื้อหาเกี่ยวกับเรื่องเพศที่โจ่งแจ้งอื่นๆ
ปิด ไม่กรองเนื้อหาสำหรับผู้ใหญ่ออกจากผลการค้นหา

* ระบบจะปิดการตั้งค่าฟีเจอร์ค้นหาปลอดภัยเริ่มต้นไว้

หากเปิดใช้งานฟีเจอร์ค้นหาปลอดภัยแล้ว แต่พบเว็บไซต์ที่มีเนื้อหาไม่เหมาะสมในผลการค้นหา โปรดส่งอีเมล URL ของเว็บไซต์ไปยัง safesearch@google.com แล้วเราจะตรวจสอบเว็บไซต์นั้น

ผลลัพธ์ XML

ผลลัพธ์ XML ของ Google DTD

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

เอกสารนี้อธิบายแง่มุมต่างๆ ของ DTD ที่เกี่ยวข้องกับ WebSearch ในกรณีที่ใช้ WebSearch เมื่อดูที่ DTD คุณจะละเว้นแท็กและแอตทริบิวต์ที่ไม่ได้ระบุไว้ที่นี่ได้ หากคำจำกัดความแตกต่างกันระหว่าง DTD และเอกสาร เราจะระบุข้อเท็จจริงไว้ในเอกสารนี้

Google แสดงผลลัพธ์ XML ได้ทั้งแบบที่มีหรือไม่มีการอ้างอิงถึง DTD ล่าสุด DTD คือคำแนะนำที่จะช่วยให้ผู้ดูแลระบบการค้นหาและโปรแกรมแยกวิเคราะห์ XML เข้าใจผลลัพธ์ XML ของ Google เนื่องจากไวยากรณ์ XML ของ Google อาจเปลี่ยนแปลงเป็นครั้งคราว คุณจึงไม่ควรกำหนดค่าโปรแกรมแยกวิเคราะห์ให้ใช้ DTD เพื่อตรวจสอบผลลัพธ์ XML แต่ละรายการ

นอกจากนี้ คุณไม่ควรกำหนดค่าโปรแกรมแยกวิเคราะห์ XML ให้ดึงข้อมูล DTD ทุกครั้งที่ส่งคำขอการค้นหา Google จะอัปเดต DTD ไม่บ่อยนักและคำขอเหล่านี้จะสร้างข้อกำหนดด้านแบนด์วิดท์และความล่าช้าที่ไม่จำเป็น

Google ขอแนะนำให้คุณใช้รูปแบบเอาต์พุต xml_no_dtd เพื่อรับผลลัพธ์แบบ XML หากคุณระบุรูปแบบ xml เอาต์พุต ในคำขอค้นหา ความแตกต่างเพียงอย่างเดียวคือการรวมบรรทัดต่อไปนี้ในผลลัพธ์ XML

<!DOCTYPE GSP SYSTEM "google.dtd">

คุณเข้าถึง DTD ล่าสุดได้ที่ http://www.google.com/google.dtd

โปรดทราบว่าฟีเจอร์บางรายการใน DTD อาจไม่พร้อมใช้งานหรือรองรับในขณะนี้

เกี่ยวกับการตอบกลับ XML

  • ค่าองค์ประกอบทั้งหมดเป็น HTML ที่ถูกต้องที่เหมาะสำหรับการแสดง เว้นแต่จะระบุไว้เป็นอย่างอื่นในคำจำกัดความแท็ก XML
  • ค่าองค์ประกอบบางค่าเป็น URL ที่ต้องเข้ารหัส HTML ก่อนที่จะแสดง
  • โปรแกรมแยกวิเคราะห์ XML ควรละเว้นแอตทริบิวต์และแท็กที่ไม่ได้ระบุไว้ ซึ่งจะช่วยให้แอปพลิเคชันทำงานต่อได้โดยไม่ต้องแก้ไขหาก Google เพิ่มฟีเจอร์เพิ่มเติมในเอาต์พุต XML
  • อักขระบางตัวต้องกำหนดเป็นอักขระหลีกเมื่อใส่เป็นค่าในแท็ก XML ตัวประมวลผล XML ควรแปลงเอนทิตีเหล่านี้กลับไปเป็นอักขระที่เหมาะสม หากไม่แปลงเอนทิตีอย่างถูกต้อง เบราว์เซอร์อาจแสดงผลอักขระ & เป็น "&amp;" เป็นต้น มาตรฐาน XML ได้บันทึกอักขระเหล่านี้ไว้ โดยอักขระเหล่านี้จะมีการทำซ้ำในตารางด้านล่าง

    อักขระ ฟอร์มที่ใช้ Escape เอนทิตี รหัสอักขระ
    สัญลักษณ์แทนคำว่า "และ" & &amp; &#38;
    เครื่องหมายคำพูดเดี่ยว ' &apos; &#39;
    เครื่องหมายคำพูดคู่ " &quot; &#34;
    เครื่องหมายมากกว่า > &gt; &#62;
    เครื่องหมายน้อยกว่า < &lt; &#60;

ผลลัพธ์ XML สำหรับคำค้นหาทั่วไปและขั้นสูง

การค้นหาทั่วไป/ขั้นสูง: ข้อความค้นหาตัวอย่างและผลลัพธ์ XML

ตัวอย่างคำขอ WebSearch นี้ขอผลลัพธ์ 10 รายการ (num=10) เกี่ยวกับข้อความค้นหา "socer" (q=socer) ซึ่งเป็นคำว่า "ฟุตบอล" ที่จงใจสะกดไม่ถูกต้องในตัวอย่างนี้)

http://www.google.com/search?
    q=socer
    &hl=en
    &start=10
    &num=10
    &output=xml
    &client=google-csbe
    &cx=00255077836266642015:u-scht7a-8i

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

<?xml version="1.0" encoding="ISO-8859-1" standalone="no" ?>

<GSP VER="3.2">
   <TM>0.452923</TM>
   <Q>socer</Q>

<PARAM name="cx" value="00255077836266642015:u-scht7a-8i" original_value="00255077836266642015%3Au-scht7a-8i"/>
   <PARAM name="hl" value="en" original_value="en"/>
   <PARAM name="q" value="socer" original_value="socer"/>
   <PARAM name="output" value="xml" original_value="xml"/>
   <PARAM name="client" value="google-csbe" original_value="google-csbe"/>
   <PARAM name="num" value="10" original_value="10"/>
   <Spelling>
      <Suggestion q="soccer"><b><i>soccer</i></b></Suggestion>
   </Spelling>
   <Context>

<title>Sample Vacation CSE</title>
    <Facet>
      <FacetItem>
        <label>restaurants</label>
        <anchor_text>restaurants</anchor_text>
      </FacetItem>
      <FacetItem>
        <label>wineries</label>
        <anchor_text>wineries</anchor_text>
      </FacetItem>
    </Facet>
    <Facet>
      <FacetItem>
        <label>golf_courses</label>
        <anchor_text>golf courses</anchor_text>
      </FacetItem>
    </Facet>
    <Facet>
     <FacetItem>
        <label>hotels</label>
        <anchor_text>hotels</anchor_text>
      </FacetItem>
    </Facet>
    <Facet>
      <FacetItem>
        <label>nightlife</label>
        <anchor_text>nightlife</anchor_text>
      </FacetItem>
    </Facet>
    <Facet>
      <FacetItem>
        <label>soccer_sites</label>
        <anchor_text>soccer sites</anchor_text>
      </FacetItem>
    </Facet>
   </Context>
   <RES SN="1" EN="10">
      <M>6080</M>
      /*
       * The FI tag after the comment indicates that the result
       * set has been filtered. If the number of results were exact, the
       * FI tag would be replaced by an XT tag in the same format.
       */
      <FI />
      <NB>
         /*
          * Since the request is for the first page of results, the PU tag,
          * which contains a link to the previous page of search results,
          * is not included in this XML result. If the sample result did include
          * a previous page of results, it would be listed here, in the same format
          * as the NU tag on the following line
          */
         <NU>/search?q=socer&hl=en&lr=&ie=UTF-8&output=xml&client=test&start=10&sa=N</NU>
      </NB>
      <R N="1">
         <U>http://www.soccerconnection.net/</U>
         <UE>http://www.soccerconnection.net/</UE>
         <T>SoccerConnection.net</T>
              <CRAWLDATE>May 21, 2007</CRAWLDATE>
         <S><b>soccer</b>; players; coaches; ball; world cup;<b>...</b></S>
  <Label>transcodable_pages</Label>
    <Label>accessible</Label>
         <Label>soccer_sites</Label>
         <LANG>en</LANG>
         <HAS>
            <DI>
               <DT>SoccerConnection.net</DT>
               <DS>Post your <b>soccer</b> resume directly on the Internet.</DS>
            </DI>
            <L/>
            <C SZ="8k" CID="kWAPoYw1xIUJ"/>
            <RT/>
         </HAS>
      </R>
      /*
       * The result includes nine more results, each enclosed by an R tag.
       */
   </RES>
</GSP>

การค้นหาทั่วไป/ขั้นสูง: แท็ก XML

การตอบกลับด้วย XML สำหรับคำขอการค้นหาทั่วไปและคำขอการค้นหาขั้นสูงจะใช้แท็ก XML ชุดเดียวกัน แท็ก XML เหล่านี้จะแสดงในตัวอย่าง XML ด้านบนและอธิบายไว้ในตารางด้านล่าง

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

สัญลักษณ์บางอย่างอาจแสดงถัดจากแท็กย่อยบางรายการในคำจำกัดความด้านล่าง สัญลักษณ์และความหมายของสัญลักษณ์มีดังนี้

? = แท็กย่อยที่ไม่บังคับ
* = อินสแตนซ์ของแท็กย่อยเป็นศูนย์หรือมากกว่า
+ = อินสแตนซ์ของแท็กย่อยอย่างน้อย 1 อินสแตนซ์
B C ง เ ผู้ประกอบวิชาชีพ ล้าน คำถาม R T ใช้ X

anchor_text
คำจำกัดความ

แท็ก <anchor_text> ระบุข้อความที่คุณควรแสดงต่อผู้ใช้เพื่อระบุป้ายกำกับการปรับแต่งที่เชื่อมโยงกับชุดผลการค้นหา เนื่องจากป้ายกำกับการปรับเกณฑ์การค้นหาจะใช้ขีดล่างแทนอักขระที่ไม่ใช่ตัวเลขหรือตัวอักษร คุณจึงไม่ควรแสดงค่าของแท็ก <label> ในอินเทอร์เฟซผู้ใช้ คุณควรแสดงค่าของแท็ก <anchor_text> แทน

ตัวอย่าง <anchor_text>สนามกอล์ฟ</anchor_text>
แท็กย่อยของ FacetItem
รูปแบบเนื้อหา ข้อความ

บล็อก
คำจำกัดความ

แท็กนี้สรุปเนื้อหาของบล็อกในบรรทัดเนื้อหาของผลลัพธ์การสนับสนุน แต่ละบล็อกจะมีแท็กย่อย T, U และ L แท็ก T ที่ไม่ว่างเปล่าหมายความว่าบล็อกมีข้อความ แท็ก U และ L ที่ไม่ว่างเปล่าหมายความว่าบล็อกนั้นมีลิงก์ (โดยมี URL ที่ระบุในแท็กย่อย U และ anchor text ในแท็กย่อย L)
แท็กย่อย T, U, L
แท็กย่อยของ BODY_LINE
รูปแบบเนื้อหา ว่าง

BODY_LINE
คำจำกัดความ

แท็กนี้สรุปเนื้อหาของบรรทัดในเนื้อหาผลลัพธ์ที่โปรโมต บรรทัดเนื้อหาแต่ละบรรทัดประกอบด้วยแท็ก BLOCK หลายแท็ก ซึ่งมีข้อความหรือลิงก์ที่มี URL และ anchor text
แท็กย่อย บล็อก*
แท็กย่อยของ SL_MAIN
รูปแบบเนื้อหา ว่าง

C
คำจำกัดความ

แท็ก <C> ระบุว่าบริการ WebSearch เรียก URL ผลการค้นหาเวอร์ชันที่แคชไว้ได้ คุณเรียกข้อมูลหน้าที่แคชไว้ผ่าน XML API ไม่ได้ แต่เปลี่ยนเส้นทางผู้ใช้ไปยัง www.google.com สำหรับเนื้อหานี้ได้
แอตทริบิวต์
ชื่อ รูปแบบ คำอธิบาย
SZ ข้อความ (จำนวนเต็ม + "k") ระบุขนาดของผลการค้นหาเวอร์ชันที่แคชไว้เป็นกิโลไบต์ ("k")
CID ข้อความ ระบุเอกสารในแคชของ Google หากต้องการดึงข้อมูลเอกสารจากแคช ให้ส่งข้อความค้นหาที่สร้างขึ้นดังนี้
cache:CIDtext:escapedURL

URL ที่ใช้ Escape จะอยู่ในแท็ก UE
ตัวอย่าง <C SZ="6k" CID="kvOXK_cYSSgJ" />
แท็กย่อยของ HAS
รูปแบบเนื้อหา ว่าง

C2C
คำจำกัดความ แท็ก <C2C> บ่งบอกว่าผลการค้นหาหมายถึงหน้าภาษาจีนตัวเต็ม แท็กนี้จะปรากฏเฉพาะเมื่อเปิดใช้การค้นหาภาษาจีนตัวย่อและตัวเต็มเท่านั้น ดูคำจำกัดความของพารามิเตอร์การค้นหา c2coff สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการเปิดและปิดใช้ฟีเจอร์นี้
รูปแบบเนื้อหา ข้อความ

บริบท
คำจำกัดความ

แท็ก <Context> สรุปรายการป้ายกำกับปรับเกณฑ์การค้นหาที่เชื่อมโยงกับชุดผลการค้นหา
ตัวอย่าง <Context>
แท็กย่อย title, Facet+
รูปแบบเนื้อหา คอนเทนเนอร์

วันที่รวบรวมข้อมูล
คำจำกัดความ

แท็ก <CRAWLDATE> ระบุวันที่ที่มีการ Crawl หน้าเว็บครั้งล่าสุด CRAWLDATE ไม่แสดงผลสำหรับหน้าผลการค้นหาทุกหน้า
ตัวอย่าง <CRAWLDATE>21 พฤษภาคม 2005</CRAWLDATE>
แท็กย่อยของ R
รูปแบบเนื้อหา ข้อความ

DI
คำจำกัดความ

แท็ก <DI> สรุปข้อมูลหมวดหมู่ Open Directory Project (ODP) สำหรับผลการค้นหารายการเดียว
ตัวอย่าง <DI>
แท็กย่อย DT, DS ใช่ไหม
แท็กย่อยของ HAS
รูปแบบเนื้อหา ว่าง

DS
คำจำกัดความ

แท็ก <DS> มีข้อมูลสรุปที่แสดงสำหรับหมวดหมู่เดียวในไดเรกทอรี ODP
ตัวอย่าง <DS>โพสต์ &lt;b&gt;ฟุตบอล&lt;/b&gt; อ่านต่อ ใน อินเทอร์เน็ตโดยตรง</DS>
แท็กย่อยของ DI
รูปแบบเนื้อหา ข้อความ (อาจมี HTML)

DT
คำจำกัดความ

แท็ก <DT> ระบุชื่อหมวดหมู่เดียวที่แสดงในไดเรกทอรี ODP
ตัวอย่าง <DT>SoccerConnection.net</DT>
แท็กย่อยของ DI
รูปแบบเนื้อหา ข้อความ (อาจมี HTML)

ข้อมูลประกอบ
คำจำกัดความ

แท็ก <Facet> มีการจัดกลุ่มแท็ก <FacetItem> ตามตรรกะ คุณสร้างการจัดกลุ่มเหล่านี้ได้โดยใช้รูปแบบข้อกำหนด XML ของ Programmable Search Engine หากคุณไม่สร้างกลุ่มเหล่านี้ แท็ก results_xml_tag_Context><Context> จะมีแท็ก <Facet> สูงสุด 4 รายการ ระบบจะจัดกลุ่มรายการภายในแท็ก <Facet> แต่ละรายการเพื่อวัตถุประสงค์ในการแสดงผล แต่อาจไม่มีความสัมพันธ์เชิงตรรกะ
ตัวอย่าง <Facet>
แท็กย่อย FacetItem+, ชื่อ+
แท็กย่อยของ Context
รูปแบบเนื้อหา คอนเทนเนอร์

FacetItem
คำจำกัดความ

แท็ก <FacetItem> สรุปข้อมูลเกี่ยวกับป้ายกำกับการปรับเกณฑ์การค้นหาที่เชื่อมโยงกับชุดผลการค้นหา
ตัวอย่าง <FacetItem>
แท็กย่อย label, anchor_text+
แท็กย่อยของ ข้อมูลประกอบ
รูปแบบเนื้อหา FacetItem

FI
คำจำกัดความ แท็ก <FI> ทำหน้าที่เป็นแฟล็กที่ระบุว่ามีการกรองเอกสารสำหรับการค้นหาหรือไม่ ดูข้อมูลเพิ่มเติมเกี่ยวกับตัวกรองผลการค้นหาของ Google ในส่วนการกรองอัตโนมัติของเอกสารนี้
ตัวอย่าง <FI />
แท็กย่อยของ RES
รูปแบบเนื้อหา ว่าง

GSP
คำจำกัดความ

แท็ก <GSP> สรุปข้อมูลทั้งหมดที่แสดงผลในผลการค้นหา XML ของ Google "GSP" เป็นตัวย่อของ "Google Search Protocol"
แอตทริบิวต์
ชื่อ รูปแบบ คำอธิบาย
ความหมาย ข้อความ (จำนวนเต็ม) แอตทริบิวต์ VER ระบุเวอร์ชันของผลลัพธ์การค้นหา เอาต์พุตเวอร์ชันปัจจุบันคือ "3.2"
ตัวอย่าง <GSP VER="3.2">
แท็กย่อย PARAM+, Q, RES, หน่วยความจำคำแปล
รูปแบบเนื้อหา ว่าง

HAS
คำจำกัดความ แท็ก <HAS> สรุปข้อมูลเกี่ยวกับพารามิเตอร์คำขอการค้นหาพิเศษที่รองรับสำหรับ URL หนึ่งๆ

หมายเหตุ: คำจำกัดความของ <HAS> สำหรับ WebSearch มีข้อจำกัดมากกว่าใน DTD

แท็กย่อย DI, ?, C?, RT?
แท็กย่อยของ R

ISURL
คำจำกัดความ Google จะแสดงแท็ก <ISURL> หากคําค้นหาที่เกี่ยวข้องเป็น URL
แท็กย่อยของ GSP
รูปแบบเนื้อหา ว่าง

L
คำจำกัดความ การมีแท็ก <L> บ่งบอกว่าบริการ WebSearch จะหาเว็บไซต์อื่นๆ ที่ลิงก์ไปยัง URL ของผลการค้นหานี้ได้ หากต้องการค้นหาเว็บไซต์เช่นนี้ ให้ใช้คำค้นหาพิเศษ link:
แท็กย่อยของ HAS
รูปแบบเนื้อหา ว่าง

ป้ายกำกับ
คำจำกัดความ

แท็ก <label> ระบุป้ายกำกับการปรับเกณฑ์การค้นหา ที่คุณสามารถใช้เพื่อกรองผลการค้นหาที่คุณได้รับ หากต้องการใช้ป้ายกำกับการปรับแต่ง ให้เพิ่มสตริง more:[[label tag value]] ลงในค่าของพารามิเตอร์ q ในคำขอ HTTP ที่ส่งไปยัง Google ตามที่แสดงในตัวอย่างต่อไปนี้ โปรดทราบว่าค่านี้ต้องกำหนดเป็นอักขระหลีกกับ URL ก่อนที่จะส่งคำค้นหาไปยัง Google

This example uses the refinement label golf_courses to
filter search results about Palm Springs:
    q=Palm+Springs+more:golf_courses

The URL-escaped version of this query is:
    q=Palm+Springs+more%3Agolf_courses

หมายเหตุ: แท็ก <label> ไม่เหมือนกับแท็ก <Label> ซึ่งใช้ระบุป้ายกำกับการปรับแต่งที่เชื่อมโยงกับ URL หนึ่งๆ ในผลการค้นหา
ตัวอย่าง <label>golf_courses</label>
แท็กย่อยของ FacetItem
รูปแบบเนื้อหา ข้อความ

ภาษา
คำจำกัดความ

แท็ก <LANG> มีการคาดเดาที่ดีที่สุดของ Google เกี่ยวกับภาษาของผลการค้นหา
ตัวอย่าง <LANG>en</LANG>
แท็กย่อยของ R
รูปแบบเนื้อหา ข้อความ

M
คำจำกัดความ

แท็ก <M> จะระบุจำนวนผลการค้นหาทั้งหมดโดยประมาณ

หมายเหตุ: ค่าประมาณนี้อาจไม่ถูกต้อง

ตัวอย่าง <M>16200000</M>
แท็กย่อยของ RES
รูปแบบเนื้อหา ข้อความ

แรกเกิด
คำจำกัดความ

แท็ก <NB> สรุปข้อมูลการนำทาง (ลิงก์ไปยังหน้าผลการค้นหาถัดไปหรือหน้าก่อนหน้าของผลการค้นหา) สำหรับชุดผลการค้นหา

หมายเหตุ: แท็กนี้จะปรากฏก็ต่อเมื่อมีผลลัพธ์เพิ่มเติมเท่านั้น
ตัวอย่าง <NB>
แท็กย่อย NU PU
แท็กย่อยของ RES
รูปแบบเนื้อหา ว่าง

ไม่มีข้อมูล
คำจำกัดความ

แท็ก <NU> มีลิงก์ที่เกี่ยวข้องเพื่อไปยังหน้าถัดไปของผลการค้นหา
ตัวอย่าง <NU>/search?q=flowers&num=10&hl=th&ie=UTF-8
&output=xml&client=test&start=10</NU>
แท็กย่อยของ NB
รูปแบบเนื้อหา ข้อความ (URL สัมพัทธ์)

พารามิเตอร์
คำจำกัดความ

แท็ก <PARAM> ระบุพารามิเตอร์อินพุตที่ส่งในคำขอ HTTP ที่เชื่อมโยงกับผลลัพธ์ XML ข้อมูลเกี่ยวกับพารามิเตอร์นี้อยู่ในแอตทริบิวต์แท็ก ได้แก่ ชื่อ ค่า ค่าต้นฉบับ และจะมีแท็ก PARAM 1 รายการสำหรับแต่ละพารามิเตอร์ที่ส่งในคำขอ HTTP
แอตทริบิวต์
ชื่อ รูปแบบ คำอธิบาย
name ข้อความ ชื่อพารามิเตอร์อินพุต
value HTML ค่าพารามิเตอร์อินพุตเวอร์ชันรูปแบบ HTML
original_value ข้อความ ค่าพารามิเตอร์อินพุตเวอร์ชัน URL ที่ใช้อักขระหลีกดั้งเดิม
ตัวอย่าง <PARAM name="cr" value="countryNZ" original_value="countryNZ" />
แท็กย่อยของ GSP
รูปแบบเนื้อหา ซับซ้อน

หนังเทียม
คำจำกัดความ

แท็ก <PU> มีลิงก์ที่เกี่ยวข้องกับหน้าผลการค้นหาก่อนหน้า
ตัวอย่าง <PU>/search?q=flowers&num=10&hl=th&output=xml
&client=test&start=10</PU>
แท็กย่อยของ NB
รูปแบบเนื้อหา ข้อความ (URL สัมพัทธ์)

Q
คำจำกัดความ

แท็ก <Q> ระบุคำค้นหาที่ส่งในคำขอ HTTP ที่เชื่อมโยงกับผลลัพธ์ XML
ตัวอย่าง

<Q>pizza</Q>
แท็กย่อยของ GSP
รูปแบบเนื้อหา ข้อความ

R
คำจำกัดความ

แท็ก <R> สรุปรายละเอียดของผลการค้นหาแต่ละรายการ

หมายเหตุ: คำจำกัดความของแท็ก <R> สำหรับ WebSearch มีการจำกัดมากกว่าใน DTD

แอตทริบิวต์
ชื่อ รูปแบบ คำอธิบาย
N ข้อความ (จำนวนเต็ม) ระบุดัชนี (แบบ 1) ของผลการค้นหานี้
MIME ข้อความ ระบุประเภท MIME ของผลการค้นหา
แท็กย่อย U, UE, T, CRAWLDATE, S?, LANG, HAS
แท็กย่อยของ RES

RES
คำจำกัดความ

แท็ก <RES> สรุปชุดผลการค้นหาแต่ละรายการและรายละเอียดเกี่ยวกับผลการค้นหาเหล่านั้น
แอตทริบิวต์
ชื่อ รูปแบบ คำอธิบาย
SN ข้อความ (จำนวนเต็ม) ระบุดัชนี (แบบ 1) ของผลการค้นหาแรกที่แสดงผลในชุดผลการค้นหานี้
TH ข้อความ (จำนวนเต็ม) ระบุดัชนี (แบบ 1) ของผลการค้นหาล่าสุดที่แสดงผลในชุดผลการค้นหานี้
ตัวอย่าง <RES SN="1" EN="10">
แท็กย่อย , FI, XT แล้ว NB R*
แท็กย่อยของ GSP
รูปแบบเนื้อหา ว่าง

S
คำจำกัดความ

แท็ก <S> มีข้อความที่ตัดตอนมาสำหรับผลการค้นหาที่แสดงข้อความค้นหาที่ไฮไลต์เป็นตัวหนา ตัวแบ่งบรรทัดจะรวมอยู่ในข้อความที่ตัดตอนมาเพื่อให้ตัดข้อความได้อย่างถูกต้อง
ตัวอย่าง <S>วอชิงตัน (CNN) -- ราคาเสนอเพื่อยุติการยืนหยัดของวุฒิสภาเหนือประธานาธิบดี บุช บุช ตัดสิน ช่วยให้ผู้ได้รับการเสนอชื่อเข้าชิงตำแหน่ง 5 คนสามารถโหวตขั้นสุดท้ายได้ในขณะที่ยังรักษา&<&gt;...&gt;<&gt;
แท็กย่อยของ R
รูปแบบเนื้อหา ข้อความ (HTML)

SL_MAIN
คำจำกัดความ

แท็กนี้สรุปเนื้อหาของผลลัพธ์โปรโมชัน ใช้เพื่อแยกวิเคราะห์โปรโมชัน ข้อความ Anchor และ URL ของลิงก์ชื่อจะอยู่ในแท็กย่อย T และ U ตามลำดับ บรรทัดของข้อความและลิงก์ของเนื้อหาจะอยู่ในแท็กย่อย BODY_LINE
แท็กย่อย BODY_LINE*, T, U
แท็กย่อยของ SL_RESULTS
รูปแบบเนื้อหา ว่าง

SL_RESULTS
คำจำกัดความ

คอนเทนเนอร์แท็กสำหรับผลการค้นหาที่โปรโมต โฆษณาประเภทใดประเภทหนึ่งจะปรากฏเมื่อใดก็ตามที่คุณมีโปรโมชันในผลการค้นหา แท็กย่อย SL_MAIN มีข้อมูลผลการค้นหาหลัก
แท็กย่อย SL_MAIN*
แท็กย่อยของ R
รูปแบบเนื้อหา ว่าง

การสะกด
คำจำกัดความ

แท็ก <Spelling> สรุปคำแนะนำการสะกดคำแบบอื่นสำหรับคำค้นหาที่ส่ง แท็กนี้จะปรากฏเฉพาะในหน้าแรกของผลการค้นหา คำแนะนำการสะกดมีให้บริการในภาษาอังกฤษ จีน ญี่ปุ่น และเกาหลี

หมายเหตุ: Google จะแสดงเฉพาะคำแนะนำการสะกดสำหรับคำค้นหาที่ค่าพารามิเตอร์ gl เป็นอักษรตัวพิมพ์เล็กเท่านั้น
ตัวอย่าง <Spelling>
แท็กย่อย คำแนะนำ
แท็กย่อยของ GSP
รูปแบบเนื้อหา ว่าง

คำแนะนำ
คำจำกัดความ แท็ก <Suggestion> มีคำแนะนำการสะกดแบบอื่นสำหรับคำค้นหาที่ส่ง คุณใช้เนื้อหาของแท็กเพื่อแนะนำการสะกดแบบอื่นแก่ผู้ใช้การค้นหาได้ ค่าของแอตทริบิวต์ q คือคำแนะนำการสะกดคำที่ใช้อักขระหลีกกับ URL ซึ่งคุณใช้เป็นข้อความค้นหาได้
แอตทริบิวต์
ชื่อ รูปแบบ คำอธิบาย
q ข้อความ แอตทริบิวต์ q ระบุคำแนะนำการสะกดเวอร์ชัน URL ที่ใช้อักขระหลีก
ตัวอย่าง <Suggestion q="soccer">&lt;b&gt;&lt;i&gt;ฟุตบอล&lt;/i&gt;&lt;/b&gt;</Suggestion>
แท็กย่อยของ การสะกด
รูปแบบเนื้อหา ข้อความ (HTML)

T
คำจำกัดความ แท็ก <T> มีชื่อของผลลัพธ์
ตัวอย่าง <T>ร้านพิซซ่าอะมิซีส์ อีสต์โคสต์</T>
แท็กย่อยของ R
รูปแบบเนื้อหา ข้อความ (HTML)

title
คำจำกัดความ

ในฐานะลูกของ <Context> แท็ก <title> จะมีชื่อของ Programmable Search Engine

ในฐานะย่อยของ <Facet> แท็ก <title> จะให้ชื่อของชุด Facet
ตัวอย่าง

ในฐานะลูกของ <Context>: <title>เครื่องมือค้นหาของฉัน</title>

เป็นบุตรหลานของ <Facet>: <title>facet title</title>
แท็กย่อยของ บริบท, ข้อมูลประกอบ
รูปแบบเนื้อหา ข้อความ

TM
คำจำกัดความ

แท็ก <TM> ระบุเวลารวมของเซิร์ฟเวอร์ที่ต้องใช้ในการแสดงผลการค้นหา โดยวัดเป็นวินาที
ตัวอย่าง <TM>0.100445</TM>
แท็กย่อยของ GSP
รูปแบบเนื้อหา ข้อความ (หมายเลขจุดลอย)

TT
คำจำกัดความ แท็ก <TT> มีเคล็ดลับ ในการค้นหา
ตัวอย่าง <TT>&gt;เคล็ดลับ: สำหรับเบราว์เซอร์ส่วนใหญ่ การกดแป้น Return จะให้ผลลัพธ์เดียวกับการคลิกปุ่มค้นหา&lt;/i&gt;</TT>
แท็กย่อยของ GSP

U
คำจำกัดความ แท็ก <U> ระบุ URL ของผลการค้นหา
ตัวอย่าง <U>http://www.dominos.com/</U>
แท็กย่อยของ R
รูปแบบเนื้อหา ข้อความ (URL ที่สมบูรณ์)

UDID
คำจำกัดความ

แท็ก <UD> ระบุ URL ที่เข้ารหัส IDN (ชื่อโดเมนสากล) สำหรับผลการค้นหา ค่านี้ช่วยให้โดเมนแสดงโดยใช้ภาษาท้องถิ่นได้ เช่น ระบบอาจถอดรหัส http://www.%E8%8A%B1%E4%BA%95.com URL ที่เข้ารหัส IDN และแสดงเป็น http://www.花\r鮨.com. แท็ก <UD> นี้จะรวมอยู่ในผลการค้นหาของคําขอที่มีพารามิเตอร์ ud เท่านั้น

หมายเหตุ: ฟีเจอร์นี้อยู่ในเวอร์ชันเบต้า
ตัวอย่าง <UD>http://www.%E8%8A%B1%E4%BA%95.com/</UD>
แท็กย่อยของ R
รูปแบบเนื้อหา ข้อความ (URL ที่เข้ารหัส IDN)

UE
คำจำกัดความ แท็ก <UE> ระบุ URL ของผลการค้นหา ค่านี้ใช้ Escape กับ URL เพื่อให้เหมาะสำหรับการส่งเป็นพารามิเตอร์การค้นหาใน URL
ตัวอย่าง <UE>http://www.dominos.com/</UE>
แท็กย่อยของ R
รูปแบบเนื้อหา ข้อความ (URL ที่ใช้อักขระหลีกกับ URL)

XT
คำจำกัดความ แท็ก <XT> บ่งบอกว่าจำนวนผลลัพธ์ทั้งหมดโดยประมาณ ตามที่ระบุโดยแท็ก M แต่ที่จริงแล้วแสดงจำนวนผลลัพธ์ทั้งหมด ดูรายละเอียดเพิ่มเติมได้ที่ส่วนการกรองอัตโนมัติของเอกสารนี้
ตัวอย่าง <XT/
แท็กย่อยของ RES
รูปแบบเนื้อหา ว่าง


ผลลัพธ์ XML สำหรับคำค้นหารูปภาพ

คำขอรูปภาพตัวอย่างนี้ขอผลลัพธ์ 5 รายการ (ตัวเลข=5) เกี่ยวกับข้อความค้นหา "monkey" (q=monkey) 

http://www.google.com/cse?
  searchtype=image
  &num=2
  &q=monkey
  &client=google-csbe
  &output=xml_no_dtd
  &cx=00255077836266642015:u-scht7a-8i

คำขอนี้แสดงผลลัพธ์ XML ด้านล่าง 


<GSP VER="3.2">
  <TM>0.395037</TM>
  <Q>monkeys</Q>

  <PARAM name="cx" value="011737558837375720776:mbfrjmyam1g" original_value="011737558837375720776:mbfrjmyam1g" url_<escaped_value="011737558837375720776%3Ambfrjmyam1g" js_escaped_value="011737558837375720776:mbfrjmyam1g"/>
  <PARAM name="client" value="google-csbe" original_value="google-csbe" url_escaped_value="google-csbe" js_escaped_value="google-csbe"/>
  <PARAM name="q" value="monkeys" original_value="monkeys" url_escaped_value="monkeys" js_escaped_value="monkeys"/>
  <PARAM name="num" value="2" original_value="2" url_escaped_value="2" js_escaped_value="2"/>
  <PARAM name="output" value="xml_no_dtd" original_value="xml_no_dtd" url_escaped_value="xml_no_dtd" js_escaped_value="xml_no_dtd"/>
  <PARAM name="adkw" value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" original_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" url_escaped_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" js_escaped_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A"/>
  <PARAM name="hl" value="en" original_value="en" url_escaped_value="en" js_escaped_value="en"/>
  <PARAM name="oe" value="UTF-8" original_value="UTF-8" url_escaped_value="UTF-8" js_escaped_value="UTF-8"/>
  <PARAM name="ie" value="UTF-8" original_value="UTF-8" url_escaped_value="UTF-8" js_escaped_value="UTF-8"/>
  <PARAM name="boostcse" value="0" original_value="0" url_escaped_value="0" js_escaped_value="0"/>

  <Context>
    <title>domestigeek</title>
  </Context>

  <ARES/>
  <RES SN="1" EN="2">
    <M>2500000</M>
    <NB>
      <NU>/images?q=monkeys&num=2&hl=en&client=google-csbe&cx=011737558837375720776:mbfrjmyam1g&boostcse=0&output=xml_no_dtd
        &ie=UTF-8&oe=UTF-8&tbm=isch&ei=786oTsLiJaaFiALKrPChBg&start=2&sa=N
      </NU>
    </NB>
    <RG START="1" SIZE="2"/>
      <R N="1" MIME="image/jpeg">
        <RU>http://www.flickr.com/photos/fncll/135465558/</RU>
        <U>
          http://farm1.static.flickr.com/46/135465558_123402af8c.jpg
        </U>
        <UE>
          http://farm1.static.flickr.com/46/135465558_123402af8c.jpg
        </UE>
        <T>Computer <b>Monkeys</b> | Flickr - Photo Sharing!</T>
        <RK>0</RK>
        <BYLINEDATE>1146034800</BYLINEDATE>
        <S>Computer <b>Monkeys</b> | Flickr</S>
        <LANG>en</LANG>
        <IMG WH="500" HT="305" IID="ANd9GcQARKLwzi-t4lpWi2AERV3kJb4ansaQzTn3MNDZR9fD_JDiktPKByKUBLs">
          <SZ>88386</SZ>
          <IN/>
        </IMG>
        <TBN TYPE="0" WH="130" HT="79" URL="http://t0.gstatic.com/images?q=tbn:ANd9GcQARKLwzi-
t4lpWi2AERV3kJb4ansaQzTn3MNDZR9fD_JDiktPKByKUBLs"/>
      </R>
      <R N="2" MIME="image/jpeg">
        <RU>
          http://www.flickr.com/photos/flickerbulb/187044366/
        </RU>
        <U>
          http://farm1.static.flickr.com/73/187044366_506a1933f4.jpg
        </U>
        <UE>
          http://farm1.static.flickr.com/73/187044366_506a1933f4.jpg
        </UE>
        <T>
          one. ugly. <b>monkey</b>. | Flickr - Photo Sharing!
        </T>
        <RK>0</RK>
        <BYLINEDATE>1152514800</BYLINEDATE>
        <S>one. ugly. <b>monkey</b>.</S>
        <LANG>en</LANG>
        <IMG WH="400" HT="481" IID="ANd9GcQ3Qom0bYbee4fThCQVi96jMEwMU6IvVf2b8K5vERKVw-
           EF4tQQnDDKOq0"><SZ>58339</SZ>
          <IN/>
        </IMG>
        <TBN TYPE="0" WH="107" HT="129" URL="http://t1.gstatic.com/images?q=tbn:ANd9GcQ3Qom0bYbee4fThCQ
          Vi96jMEwMU6IvVf2b8K5vERKVw-EF4tQQnDDKOq0"/>
      </R>
  </RES>
</GSP>

ค้นหารูปภาพ: แท็ก XML

ตารางด้านล่างแสดงแท็ก XML เพิ่มเติมที่ใช้ในการตอบสนอง XML สำหรับคำค้นหารูปภาพ

สัญลักษณ์บางอย่างอาจแสดงถัดจากแท็กย่อยบางรายการในคำจำกัดความด้านล่าง สัญลักษณ์และความหมายของสัญลักษณ์มีดังนี้

? = แท็กย่อยที่ไม่บังคับ
* = อินสแตนซ์ของแท็กย่อยเป็นศูนย์หรือมากกว่า
+ = อินสแตนซ์ของแท็กย่อยอย่างน้อย 1 อินสแตนซ์

สาย RG
คำจำกัดความ

แท็ก <RG> ระบุรายละเอียดของผลการค้นหารูปภาพแต่ละรายการ
แอตทริบิวต์
ชื่อ รูปแบบ คำอธิบาย
N ข้อความ (จำนวนเต็ม) ระบุดัชนี (แบบ 1) ของผลการค้นหานี้
MIME ข้อความ ระบุประเภท MIME ของผลการค้นหา
แท็กย่อยของ RES
RU
คำจำกัดความ

แท็ก <RU tag> ระบุรายละเอียดผลการค้นหารูปภาพแต่ละรายการ
แท็กย่อยของ R