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

หน้านี้อ้างถึง Custom Search JSON API เวอร์ชัน XML ซึ่งใช้ได้เฉพาะสำหรับ 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. DTD ผลการค้นหา 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 WebSearch แอปพลิเคชันของคุณจะส่ง คำขอ HTTP ง่ายๆ แก่ Google จากนั้น Google จะแสดงผลการค้นหาในรูปแบบ XML ผลลัพธ์ในรูปแบบ XML ช่วยให้คุณสามารถกำหนดค่า วิธีการแสดงผลการค้นหา

รูปแบบคำขอ WebSearch

ภาพรวมคำขอ

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

คำค้นหา

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

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

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

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

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

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

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

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

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

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

ตัวอย่าง q=google&client=google-csbe

cr
คำอธิบาย

ไม่บังคับ พารามิเตอร์ 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

ตัวกรอง
คำอธิบาย

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

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

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

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

ตัวอย่าง q=google&filter=0

gl
คำอธิบาย

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

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

ตัวอย่าง

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


hl
คำอธิบาย

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

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

ตัวอย่าง

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

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

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

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

ตัวอย่าง

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

q=pizza&hq=cheese


ie
คำอธิบาย

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

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

ดูการเข้ารหัสอักขระ ส่วนรูปแบบสำหรับรายการค่า ie ที่เป็นไปได้

ตัวอย่าง q=google&ie=utf8&oe=utf8
lr
คำอธิบาย

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

Google WebSearch ระบุภาษาของเอกสารตาม ที่กำลังวิเคราะห์:

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

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

ตัวอย่าง q=Frodo&lr=lang_en

จำนวน
คำอธิบาย

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

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

หมายเหตุ: ถ้าจำนวนผลการค้นหาทั้งหมดน้อยกว่า มากกว่าจำนวนผลลัพธ์ที่ขอ ผลการค้นหาที่มีอยู่ทั้งหมดจะ

ตัวอย่าง q=google&num=10

O
คำอธิบาย

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

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

ดูการเข้ารหัสอักขระ ส่วนรูปแบบสำหรับรายการค่า oe ที่เป็นไปได้

ตัวอย่าง q=google&ie=utf8&oe=utf8

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

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

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

q
คำอธิบาย

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

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

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

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

ตัวอย่าง q=vacation&as_oq=london+paris

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

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

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

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

ตัวอย่าง q=adult&safe=high

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

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

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

ตัวอย่าง start=10

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

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

ตัวอย่าง

sort=date


ud
คำอธิบาย

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

http://www.花井鮨.com

ค่าที่ถูกต้องสำหรับพารามิเตอร์นี้คือ 1 (ค่าเริ่มต้น) ซึ่งหมายความว่าผลลัพธ์ XML ควร มี URL ที่เข้ารหัสด้วย IDN และ 0 ซึ่งหมายความว่าผลการค้นหา XML ไม่ควรมีการเข้ารหัส IDN URL หากตั้งค่าพารามิเตอร์ 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 ในภาพ ชื่อของแต่ละรายการ พารามิเตอร์การค้นหาขั้นสูงเขียนด้วยข้อความสีแดงภายในหรือถัดจาก ฟิลด์ในหน้าที่พารามิเตอร์ดังกล่าวสอดคล้องกัน



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

as_dt
คำอธิบาย

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

ตัวอย่าง as_dt=i,as_dt=e

as_epq
คำอธิบาย

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

ตัวอย่าง as_epq=abraham+lincoln

as_eq
คำอธิบาย

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

ตัวอย่าง

q=bass&as_eq=music


as_lq
คำอธิบาย

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

ตัวอย่าง

as_lq=www.google.com


as_nlo
คำอธิบาย

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

ตัวอย่าง

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

as_nlo=5&as_nhi=10

as_nhi
คำอธิบาย

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

ตัวอย่าง

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

as_nlo=5&as_nhi=10

as_oq
คำอธิบาย

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

ตัวอย่าง

q=vacation&as_oq=London+Paris


as_q
คำอธิบาย

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

ตัวอย่าง

q=president&as_q=John+Adams


as_qdr
คำอธิบาย

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

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

ตัวอย่าง

ตัวอย่างนี้ขอผลการค้นหาจากปีที่ผ่านมา

as_qdr=y

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

as_qdr=d10

as_sitesearch
คำอธิบาย

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

ตัวอย่าง

q=vacation&as_sitesearch=www.google.com


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

Google WebSearch อนุญาตให้ใช้ข้อความค้นหาพิเศษหลายๆ คำที่ เข้าถึงความสามารถเพิ่มเติมของเครื่องมือค้นหาของ Google เหล่านี้ ควรระบุข้อความค้นหาพิเศษไว้ในค่าพารามิเตอร์คำขอ q เช่นเดียวกับข้อความค้นหาอื่นๆ แอตทริบิวต์ ข้อความค้นหาพิเศษต้องใช้อักขระหลีกกับ URL ต ข้อความค้นหาพิเศษมีเครื่องหมายโคลอน (:) ตัวละครนี้ ต้องกำหนดเป็นอักขระหลีกกับ URL ด้วย ค่าที่ Escape 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 จะเรียกเอกสารที่มี ของชุดข้อความค้นหา (ตั้งแต่ 2 ข้อความขึ้นไป) วิธีใช้การค้นหา OR คำ คุณจะแทรกข้อความค้นหา OR เป็นตัวพิมพ์ใหญ่ ระหว่างแต่ละพจน์ในชุด

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

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

ตัวอย่าง

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

ข้อมูลจากผู้ใช้: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

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

คุณยังใช้คำขอ 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)
  • Lotus 1-2-3 (wk1, wk2, wk3, wk4, wk5, wki, wks, wku)
  • Lotus WordPro (LWP)
  • Macwrite (เมกะวัตต์)
  • Microsoft Excel (xls)
  • Microsoft PowerPoint (PPT)
  • Microsoft Word (เอกสาร)
  • Microsoft Works (สัปดาห์, wps, wdb)
  • Microsoft เขียน (เขียน)
  • รูปแบบ 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)
  • Lotus 1-2-3 (wk1, wk2, wk3, wk4, wk5, wki, wks, wku)
  • Lotus WordPro (LWP)
  • Macwrite (เมกะวัตต์)
  • Microsoft Excel (xls)
  • Microsoft PowerPoint (PPT)
  • Microsoft Word (เอกสาร)
  • Microsoft Works (สัปดาห์, wps, wdb)
  • Microsoft เขียน (เขียน)
  • รูปแบบ 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" และ "ค้นหา" ต้องปรากฏในส่วนเนื้อหาของเอกสารทั้งหมดที่รวมอยู่ ในผลการค้นหา:
ข้อมูลจากผู้ใช้: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: คุณสามารถระบุคำที่จะรวมไว้ในไฟล์ได้มากกว่า 1 คำ URL ของเอกสารโดยใส่คำค้นหา 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" และ "สกอตแลนด์" ใน URL แต่จะไม่กำหนดให้คำสองคำนี้ปรากฏ หรือให้คั่นด้วยเครื่องหมายทับ

allinurl: เวอร์ชันที่ออกจาก URL คือ allinurl%3A

ตัวอย่าง

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



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

คำค้นหา 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) จากคำค้นหา "ลิง" (q=monkey) จาก filetype .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
คำอธิบาย

ไม่บังคับ แสดงรูปภาพตามประเภทที่ระบุ ค่าที่อนุญาตคือ bmp, gif, png, jpg และ svg

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

imgsz
คำอธิบาย

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

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

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

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

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

  • clipart (เนื้อหา)
  • face (ใบหน้า)
  • lineart (เชิงเส้น)
  • news (ข่าว)
  • photo (รูปภาพ)

ตัวอย่าง q=google&as_filetype=png&imgtype=photo

imgc
คำอธิบาย

ไม่บังคับ แสดงผลรูปภาพขาวดำ โทนสีเทา หรือสี

  • mono (ขาวดำ)
  • gray (โทนสีเทา)
  • color (สี)

ตัวอย่าง q=google&as_filetype=png&imgc=gray

imgcolor
คำอธิบาย

ไม่บังคับ แสดงรูปภาพที่มีสีเฉพาะที่โดดเด่น ดังนี้

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

as_rights
คำอธิบาย

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

  • 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 จะถอดรหัส ไบต์ให้เป็นลำดับอักขระ เมื่อส่งคำขอไปยัง คุณสามารถระบุรูปแบบการเข้ารหัสสำหรับทั้ง คำค้นหาและการตอบกลับ 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 สามารถแสดงผลลัพธ์ที่มีหน้าเว็บใน รายละเอียดปลีกย่อย

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

  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 อาจไม่แสดงผลลัพธ์ทั้งหมดจากเว็บไซต์ หรืออาจ แสดงผลการค้นหาในลำดับที่ต่ำกว่าใน
    ได้รับอันดับที่ดีขึ้นกว่าที่เคย

เราขอแนะนำให้เปิดตัวกรองเหล่านี้ไว้สำหรับคำขอการค้นหาโดยทั่วไป เนื่องจากตัวกรองจะช่วยปรับปรุงคุณภาพของการค้นหาส่วนใหญ่ได้อย่างมาก ผลลัพธ์ แต่คุณสามารถข้ามตัวกรองอัตโนมัติเหล่านี้ได้โดยตั้งค่าพารามิเตอร์การค้นหาของตัวกรองเป็น 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 มุ่งมั่นที่จะทำให้ฟีเจอร์ค้นหาปลอดภัยเป็นปัจจุบันและครอบคลุม ที่เป็นไปได้ด้วยการ Crawl เว็บอย่างต่อเนื่องและรวมการอัปเดต จากคำแนะนำของผู้ใช้

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

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

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

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

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

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

ผลลัพธ์ XML

DTD ผลการค้นหา XML ของ Google

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

เอกสารฉบับนี้อธิบายแง่มุมต่างๆ ของ DTD ที่เกี่ยวข้อง สำหรับ 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
  • อักขระบางตัวต้องใช้ Escape เมื่อรวมเป็นค่าใน แท็ก XML ตัวประมวลผล XML ควรแปลงเอนทิตีเหล่านี้กลับไปเป็น ตัวละครที่เหมาะสม ถ้าคุณไม่แปลงเอนทิตีอย่างถูกต้อง เช่น เบราว์เซอร์อาจแสดงผล เป็น "&amp;" XML มาตรฐานจะบันทึกอักขระเหล่านี้ อักขระเหล่านี้คือ เกิดซ้ำในตารางด้านล่าง:

    อักขระ ฟอร์มที่กำหนดเป็นอักขระหลีก เอนทิตี รหัสอักขระ
    สัญลักษณ์แทนคำว่า "และ" & &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 รายการ
พันล้าน C ผู้ประกอบวิชาชีพ ล้าน ทิศเหนือ คำถาม ทิศใต้ ใช้ X

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

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

ตัวอย่าง <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
คำจำกัดความ

แท็ก &lt;C&gt; ระบุว่าบริการ WebSearch สามารถเรียก URL ของผลการค้นหานี้ในเวอร์ชันแคชได้ คุณไม่สามารถ เรียกหน้าที่แคชไว้ผ่านทาง XML API แต่คุณสามารถเปลี่ยนเส้นทางผู้ใช้ได้ ไปที่ www.google.com เพื่อดำเนินการนี้ เนื้อหา

แอตทริบิวต์
ชื่อ รูปแบบ คำอธิบาย
เซาท์แคโรไลนา ข้อความ (จำนวนเต็ม + "k") ระบุขนาดของเวอร์ชันที่แคชไว้ ของผลการค้นหาเป็นกิโลไบต์ ("k")
CID ข้อความ ระบุเอกสารในแคชของ Google หากต้องการดึงข้อมูลเอกสารจากแคช ให้ส่งข้อความค้นหาที่สร้างเป็น ติดตาม:
cache:CIDtext:escapedURL

URL ที่กำหนดเป็นอักขระหลีกจะอยู่ในแท็ก UE

ตัวอย่าง <C SZ="6K" CID=&quot;kvOXK_cYSSgJ&quot; />
แท็กย่อยของ มี
รูปแบบเนื้อหา ว่าง

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

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

แท็ก &lt;Context&gt; สรุปรายการ ป้ายกำกับการปรับแต่งที่เชื่อมโยงกับชุดผลการค้นหา

ตัวอย่าง &lt;Context&gt;
แท็กย่อย title, Facet ขึ้นไป
รูปแบบเนื้อหา คอนเทนเนอร์

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

แท็ก &lt;CRAWLDATE&gt; ระบุวันที่ มีการ Crawl หน้าเว็บครั้งล่าสุด ระบบจะไม่แสดงผล CRAWLDATE สำหรับหน้าผลการค้นหาทุกหน้า

ตัวอย่าง <CRAWLDATE>21 พฤษภาคม 2005</CRAWLDATE>
แท็กย่อยของ
รูปแบบเนื้อหา ข้อความ

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

แท็ก &lt;DI&gt; สรุปโครงการ Open Directory (ODP) สำหรับผลการค้นหารายการเดียว

ตัวอย่าง &lt;DI&gt;
แท็กย่อย DT, DS
แท็กย่อยของ มี
รูปแบบเนื้อหา ว่าง

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

แท็ก &lt;DS&gt; ให้สรุปที่ระบุไว้สำหรับ หมวดหมู่เดียวในไดเรกทอรี ODP

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

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

แท็ก &lt;DT&gt; ระบุชื่อของแท็ก หมวดหมู่ที่แสดงในไดเรกทอรี ODP

ตัวอย่าง &lt;DT&gt;SoccerConnection.net&lt;/DT&gt;
แท็กย่อยของ DI
รูปแบบเนื้อหา ข้อความ (อาจมี HTML)

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

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

ตัวอย่าง <Facet>
แท็กย่อย FacetItem+, ชื่อ+
แท็กย่อยของ Context
รูปแบบเนื้อหา คอนเทนเนอร์

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

แท็ก &lt;FacetItem&gt; สรุปข้อมูล เกี่ยวกับป้ายกำกับการปรับแต่งที่เชื่อมโยงกับชุดผลการค้นหา

ตัวอย่าง &lt;FacetItem&gt;
แท็กย่อย ป้ายกำกับ, anchor_text+
แท็กย่อยของ ข้อมูลประกอบ
รูปแบบเนื้อหา FacetItem

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

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

แท็ก &lt;GSP&gt; สรุปข้อมูลทั้งหมดที่แสดงในผลการค้นหา XML ของ Google "GSP" เท่ากับ ตัวย่อของ "Google Search Protocol"

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

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

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

แท็กย่อย DI, L, C, RT หรือไม่
แท็กย่อยของ

ISURL
คำจำกัดความ Google แสดงผลแท็ก &lt;ISURL&gt; หากคำค้นหาที่เกี่ยวข้องเป็น URL
แท็กย่อยของ GSP
รูปแบบเนื้อหา ว่าง

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

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

แท็ก <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> ไม่เหมือนกับ แท็ก &lt;Label&gt; ซึ่งจะระบุป้ายกำกับการปรับแต่ง ที่เชื่อมโยงกับ URL หนึ่งๆ ในผลการค้นหา

ตัวอย่าง &lt;label&gt;golf_courses&lt;/label&gt;
แท็กย่อยของ FacetItem
รูปแบบเนื้อหา ข้อความ

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

แท็ก &lt;LANG&gt; มีการคาดเดาที่ดีที่สุดของ Google ภาษาของผลการค้นหา

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

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

แท็ก &lt;M&gt; ระบุยอดรวมโดยประมาณ จำนวนผลลัพธ์สำหรับการค้นหา

หมายเหตุ: ค่าประมาณนี้อาจไม่แม่นยำ

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

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

แท็ก &lt;NB&gt; สรุปข้อมูลการนำทาง โดยลิงก์ไปยังหน้าถัดไปของผลการค้นหาหรือหน้าก่อนหน้าของ ผลการค้นหา—สำหรับชุดผลลัพธ์

หมายเหตุ: แท็กนี้จะปรากฏเท่านั้น หากมีผลลัพธ์เพิ่มเติม

ตัวอย่าง &lt;NB&gt;
แท็กย่อย NU, PU ไหม
แท็กย่อยของ ความละเอียด
รูปแบบเนื้อหา ว่าง

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

แท็ก &lt;NU&gt; มีลิงก์ที่เกี่ยวข้องกับแท็ก หน้าถัดไปของผลการค้นหา

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

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

แท็ก &lt;PARAM&gt; ระบุพารามิเตอร์อินพุตที่ส่งในคำขอ HTTP ที่เชื่อมโยง ด้วยผลลัพธ์ XML ข้อมูลเกี่ยวกับพารามิเตอร์มีอยู่ใน แอตทริบิวต์ของแท็ก เช่น ชื่อ ค่า ค่าต้นฉบับ แท็ก PARAM 1 รายการสำหรับแต่ละพารามิเตอร์ที่ส่งในคำขอ HTTP

แอตทริบิวต์
ชื่อ รูปแบบ คำอธิบาย
name ข้อความ ชื่อพารามิเตอร์ที่ป้อน
value HTML ข้อมูลในรูปแบบ HTML พารามิเตอร์
original_value ข้อความ ค่าพารามิเตอร์อินพุตเวอร์ชัน URL ที่ใช้อักขระหลีกดั้งเดิม
ตัวอย่าง <PARAM name="cr" value=&quot;countryNZ&quot; Original_value = "countryNZ" />
แท็กย่อยของ GSP
รูปแบบเนื้อหา ซับซ้อน

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

แท็ก &lt;PU&gt; จะให้ลิงก์สัมพัทธ์กับ หน้าก่อนหน้าของผลการค้นหา

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

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

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

ตัวอย่าง

<Q>พิซซ่า</Q>

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

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

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

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

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

ความละเอียด
คำจำกัดความ

แท็ก &lt;RES&gt; สรุปชุดข้อมูลของ ผลการค้นหาและรายละเอียดเกี่ยวกับผลการค้นหาเหล่านั้น

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

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

แท็ก &lt;S&gt; มีข้อความที่ตัดตอนมาจากการค้นหา ผลลัพธ์ที่แสดงข้อความค้นหาที่ไฮไลต์เป็นตัวหนา ตัวแบ่งบรรทัดคือ รวมอยู่ในข้อความที่ตัดตอนมาสำหรับการตัดข้อความอย่างเหมาะสม

ตัวอย่าง <S>วอชิงตัน (CNN) -- การเสนอราคาเพื่อสิ้นสุด การเลือกตั้งวุฒิสภาสหรัฐฯ เหนือกว่าประธานาธิบดี &lt;b&gt;บุช&#39;s&lt;/b&gt; การพิจารณาคดีของศาล ให้ผู้ได้รับการเสนอชื่อ 5 คนผ่านไปสู่การลงคะแนนเสียงเลือกตั้งขั้นสุดท้าย ขณะที่ยังคงรักษา &lt;b&gt;...&lt;b&gt;...&lt;/b&gt;<S>
แท็กย่อยของ
รูปแบบเนื้อหา ข้อความ (HTML)

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

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

แท็กย่อย BODY_LINE*, T, U
แท็กย่อยของ SL_RESULTS
รูปแบบเนื้อหา ว่าง

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

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

แท็กย่อย SL_MAIN*
แท็กย่อยของ
รูปแบบเนื้อหา ว่าง

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

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

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

ตัวอย่าง <การสะกดคำ>
แท็กย่อย คำแนะนำ
แท็กย่อยของ GSP
รูปแบบเนื้อหา ว่าง

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

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

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

ในฐานะหน่วยย่อยของ &lt;Context&gt; แท็ก &lt;Context&gt; จะมีชื่อของ Programmable Search Engine

ในฐานะรายการย่อยของ <Facet> แท็ก <title> จะตั้งชื่อชุดของข้อมูลประกอบ

ตัวอย่าง

ในฐานะบุตรหลานของ <Context>: <title>My Search Engine&lt;/title&gt;

ในฐานะบุตรหลานของ <Facet>: <title>facet ชื่อ</title>

แท็กย่อยของ บริบท, Facet
รูปแบบเนื้อหา ข้อความ

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

แท็ก &lt;TM&gt; ระบุเวลาทั้งหมดของเซิร์ฟเวอร์ ที่จำเป็นต่อการแสดงผลการค้นหาซึ่งวัดในหน่วยวินาที

ตัวอย่าง <TM>0.100445</TM>
แท็กย่อยของ GSP
รูปแบบเนื้อหา ข้อความ (ตัวเลขทศนิยม)

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

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

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

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

หมายเหตุ: ฟีเจอร์นี้อยู่ในเวอร์ชันเบต้า

ตัวอย่าง &lt;UD&gt;http://www.%E8%8A%B1%E4%BA%95.com/&lt;/UD&gt;
แท็กย่อยของ
รูปแบบเนื้อหา ข้อความ (URL ที่เข้ารหัส IDN)

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

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


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

คำขอรูปภาพตัวอย่างนี้ขอผลลัพธ์ 5 รายการ (จำนวน=5) เกี่ยวกับข้อความค้นหา "ลิง" (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
คำจำกัดความ

แท็ก &lt;RG&gt; จะล้อมรอบรายละเอียดของผลการค้นหารูปภาพแต่ละภาพ

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

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

แท็กย่อยของ