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

• คำขอ ภาพรวม
• คำค้นหา
• พารามิเตอร์คำขอ
• ตัวอย่างคำค้นหาของ WebSearch
• ข้อความค้นหาใน 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

    <!DOCTYPE GSP SYSTEM "google.dtd">

การค้นหาขั้นสูง

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

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

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

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

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

ตัวอย่างด้านล่างแสดงคำขอ 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

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

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

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

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

บริการ 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 กรองการค้นหาได้หลายวิธี ผลลัพธ์:

• อัตโนมัติ การกรองผลการค้นหา
• การกรองภาษาและประเทศ
• การกรองเนื้อหาสำหรับผู้ใหญ่ด้วย SafeSearch

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

เพื่อแสดงผลการค้นหาที่ดีที่สุดเท่าที่จะเป็นไปได้ 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

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

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

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

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

ผลลัพธ์ 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 สำหรับคำค้นหารูปภาพ

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