การอ้างอิง 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. 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

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

รูปแบบคำขอ WebSearch

ภาพรวมคำขอ

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

คำค้นหา

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

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

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

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

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

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

q=horses+cows+pigs

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

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

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

ไม่บังคับ พารามิเตอร์ 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 ระบุ จำนวนผลการค้นหาที่จะแสดง

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

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

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

oe
คำอธิบาย

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

q
คำอธิบาย

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

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



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

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 ซึ่งรวมถึง 5 และ 10 ด้วย

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

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

โดยคำสั่งต่อไปนี้จะกำหนดช่วงการค้นหาเป็น 5 ถึง 10 ซึ่งรวมถึง 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 ด้วย โดยค่าที่กำหนดเป็นอักขระหลีกใน URL คือ %3A

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

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

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

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

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

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

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

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

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

หมายเหตุ: หากคำขอค้นหาระบุคำค้นหา "London+OR+Paris" ผลการค้นหาจะมีเอกสารที่มีคำใดคำหนึ่งใน 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 อย่าง เช่น คำว่า "เบส" อาจแสดงผลลัพธ์ เกี่ยวกับปลาหรือดนตรี หากคุณกำลังมองหาเอกสารเกี่ยวกับ ปลา คุณสามารถยกเว้นเอกสารเกี่ยวกับเพลงจากผลการค้นหา ได้โดยใช้คำค้นหาที่ยกเว้น

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

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

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

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

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

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 (mw)
  • Microsoft Excel (xls)
  • Microsoft PowerPoint (ppt)
  • Microsoft Word (doc)
  • Microsoft Works (wks, wps, wdb)
  • Microsoft Write (wri)
  • Rich Text Format (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: กับนามสกุลที่ระบุ

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

คุณจำกัดผลการค้นหา ให้แสดงเฉพาะเอกสารที่ตรงกับนามสกุลไฟล์ใดไฟล์หนึ่งได้โดยการเพิ่ม filetype:ข้อความค้นหาเพิ่มเติมลงในคำค้นหา คุณควรมีfiletype:คำค้นหาในคำค้นหาสำหรับนามสกุลไฟล์แต่ละรายการที่ควรจะรวมอยู่ในผลการค้นหา ต้องคั่นคำค้นหา 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 (mw)
  • Microsoft Excel (xls)
  • Microsoft PowerPoint (ppt)
  • Microsoft Word (doc)
  • Microsoft Works (wks, wps, wdb)
  • Microsoft Write (wri)
  • Rich Text Format (rtf)
  • Shockwave Flash (swf)
  • ข้อความ (ans, txt)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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


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

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

เวอร์ชันที่ใช้อักขระหลีกของ URL ของ info: คือ 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
คำอธิบาย

ไม่บังคับ แสดงรูปภาพประเภทที่ระบุ ค่าที่อนุญาตคือ 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

imgtype
คำอธิบาย

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

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

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

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

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

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

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

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

ผลลัพธ์ XML

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

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

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

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

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

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

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

ผลลัพธ์ XML สำหรับคำค้นหาในการค้นหาปกติและการค้นหาขั้นสูง

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

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

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

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

? = แท็กย่อยที่ไม่บังคับ
* = แท็กย่อย 0 รายการขึ้นไป
+ = แท็กย่อย 1 รายการขึ้นไป
A B C D G H I L M ทิศเหนือ Q 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 ที่หลีกเลี่ยงแล้วจะอยู่ในแท็ก UE
ตัวอย่าง <C SZ="6k" CID="kvOXK_cYSSgJ" />
แท็กย่อยของ HAS
รูปแบบเนื้อหา ว่าง

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

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

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

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

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

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

แท็ก <DI> จะห่อหุ้มข้อมูลหมวดหมู่ของโปรเจ็กต์ไดเรกทอรีเปิด (ODP) สำหรับผลการค้นหาเดียว
ตัวอย่าง <DI>
แท็กย่อย DT?, DS
แท็กย่อยของ HAS
รูปแบบเนื้อหา ว่าง

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

แท็ก <DS> จะแสดงข้อมูลสรุปของหมวดหมู่เดียวในไดเรกทอรี ODP
ตัวอย่าง <DS>โพสต์เรซูเม่<0x0A> &lt;b&gt;ฟุตบอล&lt;/b&gt;ของคุณบนอินเทอร์เน็ตโดยตรง<0x0A> </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+, title+
แท็กย่อยของ Context
รูปแบบเนื้อหา คอนเทนเนอร์

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

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

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

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

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

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

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

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

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

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

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

แท็ก <label> ระบุป้ายกำกับการปรับแต่ง ที่คุณใช้กรองผลการค้นหาที่ได้รับได้ หากต้องการใช้ ป้ายกำกับการปรับแต่ง ให้เพิ่มสตริง more:[[ค่าแท็กป้ายกำกับ]] ลงใน ค่าของพารามิเตอร์ 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
คำจำกัดความ

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

แท็กนี้จะห่อหุ้มเนื้อหาของผลลัพธ์โปรโมชัน ใช้สำหรับการแยกวิเคราะห์โปรโมชัน Anchor Text และ URL ของลิงก์ Title จะอยู่ในแท็กย่อย 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>Amici's East Coast Pizzeria</T>
แท็กย่อยของ R
รูปแบบเนื้อหา ข้อความ (HTML)

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

แท็ก <title> เป็นแท็กย่อยของ <Context> และมีชื่อของ Programmable Search Engine

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

เป็นแท็กย่อยของ <Context>: <title>เครื่องมือ ค้นหาของฉัน</title>

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

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

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

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

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

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

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

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

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

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


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

คำขอรูปภาพตัวอย่างนี้ขอผลการค้นหา 5 รายการ (num=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 สำหรับคำค้นหารูปภาพ

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

? = แท็กย่อยที่ไม่บังคับ
* = แท็กย่อย 0 รายการขึ้นไป
+ = แท็กย่อย 1 รายการขึ้นไป

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

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

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