หน้านี้อ้างถึงเวอร์ชัน XML ของ Custom Search JSON API ซึ่งพร้อมให้บริการสำหรับลูกค้า Google Site Search เท่านั้น
- ภาพรวม
- รูปแบบคำขอ Programmable Search Engine
- ผลลัพธ์ XML
ภาพรวม
บริการ Google WebSearch ทำให้ลูกค้า Google Site Search แสดงผลการค้นหาโดย Google ในเว็บไซต์ของตนเองได้ บริการ WebSearch ใช้โปรโตคอลแบบ HTTP แบบง่ายเพื่อแสดงผลการค้นหา ผู้ดูแลระบบการค้นหาสามารถควบคุมวิธีขอผลการค้นหาและวิธีแสดงผลการค้นหาต่อผู้ใช้ปลายทางได้อย่างเต็มที่ เอกสารนี้อธิบายรายละเอียดทางเทคนิคของรูปแบบคำขอและผลการค้นหาของ Google
หากต้องการเรียกผลการค้นหาของ Google WebSearch แอปพลิเคชันจะส่งคำขอ HTTP แบบง่ายไปยัง Google จากนั้น Google จะแสดงผลการค้นหาในรูปแบบ XML ผลการค้นหาในรูปแบบ XML จะช่วยให้คุณปรับแต่งวิธีการแสดงผลการค้นหาได้
รูปแบบคำขอ WebSearch
- ภาพรวมของคำขอ
- คำค้นหา
- พารามิเตอร์คำขอ
- ตัวอย่างคำค้นหา WebSearch
- คำจำกัดความของพารามิเตอร์การค้นหา WebSearch
- การค้นหารูปภาพตัวอย่าง
- คำจำกัดความของพารามิเตอร์การค้นหารูปภาพ
- การค้นหาขั้นสูง
- พารามิเตอร์คำค้นหาขั้นสูง
- คำค้นหาพิเศษ
- ขีดจำกัดคำขอ
ภาพรวมคำขอ
คำขอ Google Search เป็นคำสั่ง HTTP GET
มาตรฐาน โดยมีชุดพารามิเตอร์ที่เกี่ยวข้องกับคำค้นหาของคุณ พารามิเตอร์เหล่านี้จะรวมอยู่ใน URL คำขอเป็นคู่ name=value
โดยคั่นด้วยอักขระเครื่องหมายแอมเพอร์แซนด์ (&) พารามิเตอร์ประกอบด้วยข้อมูล เช่น คำค้นหาและรหัสเครื่องมือที่ไม่ซ้ำกัน (cx
) ซึ่งระบุเครื่องมือที่สร้างคำขอ HTTP บริการ WebSearch หรือ Image Search แสดงผลผลลัพธ์ XML เพื่อตอบสนองคำขอ HTTP ของคุณ
คำค้นหา
คำขอการค้นหาส่วนใหญ่จะมีคำค้นหาอย่างน้อย 1 รายการ ข้อความค้นหาจะปรากฏเป็นค่าของพารามิเตอร์ในคำขอการค้นหา
ข้อความค้นหาอาจระบุข้อมูลหลายประเภทเพื่อกรองและจัดระเบียบผลการค้นหาที่ Google แสดง คำค้นหาสามารถระบุสิ่งต่อไปนี้
- คำหรือวลีที่จะรวมหรือยกเว้น
- ทุกคำในคำค้นหา (ค่าเริ่มต้น)
- วลีที่ตรงกันในคำค้นหา
- คำหรือวลีในคำค้นหา
- ตำแหน่งในเอกสารสำหรับค้นหาข้อความค้นหา
- ทุกที่ในเอกสาร (ค่าเริ่มต้น)
- เฉพาะในเนื้อความของเอกสารเท่านั้น
- ในชื่อเอกสารเท่านั้น
- เฉพาะใน URL เอกสาร
- เฉพาะในลิงก์ในเอกสาร
- ข้อจำกัดเกี่ยวกับเอกสาร
- การรวมหรือยกเว้นเอกสารในไฟล์บางประเภท (เช่น ไฟล์ PDF หรือเอกสาร Word)
- การค้นหา URL พิเศษที่แสดงข้อมูลเกี่ยวกับ URL หนึ่งๆ แทนการทำการค้นหา
- คำค้นหาที่แสดงข้อมูลทั่วไปเกี่ยวกับ URL เช่น หมวดหมู่ Open Directory, ตัวอย่างข้อมูล หรือภาษา
- คำค้นหาที่แสดงผลชุดหน้าเว็บที่ลิงก์ไปยัง URL
- ข้อความค้นหาที่แสดงผลชุดหน้าเว็บที่คล้ายกับ URL ที่ระบุ
การค้นหาเริ่มต้น
ค่าพารามิเตอร์คำค้นหาต้องเป็นอักขระหลีกกับ URL โปรดทราบว่าคุณจะต้องแทนที่เครื่องหมายบวก ("+") สำหรับลำดับช่องว่างในคำค้นหา ซึ่งจะมีการอธิบายเพิ่มเติมในส่วนการใช้อักขระหลีก URL ของเอกสารนี้
ระบบจะส่งข้อความค้นหาไปยังบริการ WebSearch โดยใช้พารามิเตอร์ q ตัวอย่างของข้อความค้นหา ได้แก่
q=horses+cows+pigs
โดยค่าเริ่มต้น บริการ Google WebSearch จะแสดงเฉพาะเอกสารที่มีคำทุกคำในคำค้นหาเท่านั้น
พารามิเตอร์คำขอ
ส่วนนี้จะแสดงพารามิเตอร์ที่คุณใช้เมื่อส่งคำขอค้นหาได้ พารามิเตอร์จะแบ่งออกเป็น 2 รายการ รายการแรกมีพารามิเตอร์ที่เกี่ยวข้องกับคำขอการค้นหาทั้งหมด รายการที่ 2 จะมีพารามิเตอร์ที่เกี่ยวข้องกับคำขอการค้นหาขั้นสูงเท่านั้น
ต้องมีพารามิเตอร์คำขอ 3 แบบ ดังนี้
- ต้องตั้งค่าพารามิเตอร์ client เป็น
google-csbe
- พารามิเตอร์ output ระบุรูปแบบของผลลัพธ์ XML ที่แสดงผล โดยสามารถส่งกลับผลลัพธ์โดยมี (xml) หรือไม่มี (
xml_no_dtd
) การอ้างอิงไปยัง DTD ของ Google เราขอแนะนำให้ตั้งค่านี้เป็นxml_no_dtd
หมายเหตุ: หากคุณไม่ระบุพารามิเตอร์นี้ ระบบจะแสดงผลผลลัพธ์เป็น HTML แทน XML
- พารามิเตอร์ cx ที่แสดงรหัสที่ไม่ซ้ำกันของเครื่องมือ
พารามิเตอร์คำขอที่ใช้บ่อยที่สุดนอกเหนือจากที่กล่าวไว้ข้างต้น ได้แก่
ตัวอย่างการค้นหา WebSearch
ตัวอย่างด้านล่างแสดงคำขอ HTTP ของ WebSearch 2 รายการเพื่อแสดงวิธีการใช้พารามิเตอร์การค้นหาที่แตกต่างกัน คำจำกัดความของพารามิเตอร์การค้นหาต่างๆ มีอยู่ในคำจำกัดความพารามิเตอร์การค้นหาของ WebSearch และพารามิเตอร์คำค้นหาขั้นสูงของเอกสารนี้
คำขอนี้ขอผลลัพธ์ 10 รายการแรก (start=0&num=10
)
สำหรับคำค้นหา "red sox" (q=red+sox
) คำค้นหายัง
ระบุว่าผลลัพธ์ควรมาจากเว็บไซต์ของแคนาดา (cr=countryCA
)
และควรเขียนเป็นภาษาฝรั่งเศส (lr=lang_fr
) สุดท้าย คำค้นหา
ระบุค่าสำหรับพารามิเตอร์ client, เอาต์พุต
และ cx ซึ่งจำเป็นต้องมีทั้ง 3 รายการ
http://www.google.com/search?
start=0
&num=10
&q=red+sox
&cr=countryCA
&lr=lang_fr
&client=google-csbe
&output=xml_no_dtd
&cx=00255077836266642015:u-scht7a-8i
ตัวอย่างนี้ใช้พารามิเตอร์การค้นหาขั้นสูงบางรายการเพื่อปรับแต่งคำค้นหาเพิ่มเติม คำขอนี้ใช้พารามิเตอร์ as_q (as_q=red+sox
) แทนพารามิเตอร์ q และยังใช้พารามิเตอร์ as_eq เพื่อยกเว้นเอกสารที่มีคำว่า "Yankees" ในผลการค้นหา (as_eq=yankees
) อีกด้วย
http://www.google.com/search?
start=0
&num=10
&as_q=red+sox
&as_eq=Yankees
&client=google-csbe
&output=xml_no_dtd
&cx=00255077836266642015:u-scht7a-8i
คำจำกัดความของพารามิเตอร์การค้นหา WebSearch
c2coff | |||||||
---|---|---|---|---|---|---|---|
คำอธิบาย | Optional พารามิเตอร์ c2coff จะเปิดหรือปิดใช้ฟีเจอร์การค้นหาภาษาจีนตัวย่อและตัวเต็ม ค่าเริ่มต้นของพารามิเตอร์นี้คือ
|
||||||
ตัวอย่าง | q=google&c2coff=1 |
ลูกค้า | |
---|---|
คำอธิบาย | ต้องระบุ ต้องตั้งค่าพารามิเตอร์ |
ตัวอย่าง | q=google&client=google-csbe |
cr | |
---|---|
คำอธิบาย | Optional พารามิเตอร์ Google WebSearch ระบุประเทศของเอกสารด้วยการวิเคราะห์สิ่งต่อไปนี้
ดูส่วนค่าพารามิเตอร์ประเทศ (cr) สำหรับรายการค่าที่ถูกต้องสำหรับพารามิเตอร์นี้ |
ตัวอย่าง | q=Frodo&cr=countryNZ |
cx | |
---|---|
คำอธิบาย | ต้องระบุ พารามิเตอร์ |
ตัวอย่าง | q=Frodo&cx=00255077836266642015:u-scht7a-8i |
ฟิลเตอร์ | |||||||
---|---|---|---|---|---|---|---|
คำอธิบาย | Optional พารามิเตอร์ตัวกรองจะเปิดหรือปิดใช้งานการกรองอัตโนมัติของผลการค้นหาของ Google ดูข้อมูลเพิ่มเติมเกี่ยวกับตัวกรองผลการค้นหาของ Google ได้ในส่วนการกรองอัตโนมัติของเอกสารนี้ ค่าเริ่มต้นสำหรับพารามิเตอร์
หมายเหตุ: โดยค่าเริ่มต้น Google จะใช้การกรองกับผลการค้นหาทั้งหมดเพื่อปรับปรุงคุณภาพของผลการค้นหาเหล่านั้น |
||||||
ตัวอย่าง | q=google&filter=0 |
gl | |
---|---|
คำอธิบาย | Optional ค่าพารามิเตอร์ การระบุค่าพารามิเตอร์ |
ตัวอย่าง | คำขอนี้ช่วยกระตุ้นให้เอกสารที่เขียนในสหราชอาณาจักรปรากฏในผลการค้นหาของ WebSearch: |
hl | |
---|---|
คำอธิบาย | Optional พารามิเตอร์ ดูข้อมูลเพิ่มเติมได้ที่ส่วน ภาษาของอินเทอร์เฟซ ของ Internationalizing คำค้นหาและการนำเสนอผลลัพธ์ และ ภาษาของอินเทอร์เฟซที่รองรับเพื่อดูรายการภาษาที่รองรับ |
ตัวอย่าง | คำขอนี้กำหนดเป้าหมายโฆษณาสำหรับไวน์ในภาษาฝรั่งเศส (Vin คือคำศัพท์ภาษาฝรั่งเศสสำหรับไวน์) q=vin&ip=10.10.10.10&ad=w5&hl=fr |
คุณภาพสูง | |
---|---|
คำอธิบาย | Optional พารามิเตอร์ |
ตัวอย่าง | คำขอนี้ค้นหา "พิซซ่า" และ "ชีส" และนิพจน์จะเหมือนกับ
|
ie | |
---|---|
คำอธิบาย | Optional พารามิเตอร์ ดูส่วนการเข้ารหัสอักขระ สำหรับการสนทนาเกี่ยวกับเวลาที่คุณอาจต้องใช้พารามิเตอร์นี้ ดูส่วนรูปแบบการเข้ารหัสอักขระสำหรับรายการค่า |
ตัวอย่าง | q=google&ie=utf8&oe=utf8 |
lr | |
---|---|
คำอธิบาย | Optional พารามิเตอร์ Google WebSearch ระบุภาษาของเอกสารโดยวิเคราะห์สิ่งต่อไปนี้
ดูส่วนค่าคอลเล็กชันภาษา ( |
ตัวอย่าง | q=Frodo&lr=lang_en |
num | |
---|---|
คำอธิบาย | Optional พารามิเตอร์ ค่า หมายเหตุ: หากจำนวนผลการค้นหาทั้งหมดน้อยกว่าจำนวนผลการค้นหาที่ขอ ระบบจะแสดงผลการค้นหาทั้งหมดที่มี |
ตัวอย่าง | q=google&num=10 |
oe | |
---|---|
คำอธิบาย | Optional พารามิเตอร์ ดูส่วนการเข้ารหัสอักขระ สำหรับการสนทนาเกี่ยวกับเวลาที่คุณอาจต้องใช้พารามิเตอร์นี้ ดูส่วนรูปแบบการเข้ารหัสอักขระสำหรับรายการค่า |
ตัวอย่าง | q=google&ie=utf8&oe=utf8 |
เอาต์พุต | |||||||
---|---|---|---|---|---|---|---|
คำอธิบาย | ต้องระบุ พารามิเตอร์
|
||||||
ตัวอย่าง | output=xml_no_dtd |
q | |
---|---|
คำอธิบาย | Optional พารามิเตอร์ นอกจากนี้ยังมีข้อความค้นหาพิเศษอีกมากมายที่ใช้เป็นส่วนหนึ่งของค่าของพารามิเตอร์ แผงควบคุม Google Search จะมีรายงานคำค้นหายอดนิยมที่ส่งโดยใช้พารามิเตอร์ หมายเหตุ: ค่าที่ระบุสำหรับพารามิเตอร์ q ต้องเป็นค่า Escape จาก URL |
ตัวอย่าง | q=vacation&as_oq=london+paris |
ปลอดภัย | |||||||||
---|---|---|---|---|---|---|---|---|---|
คำอธิบาย | Optional พารามิเตอร์
ดูส่วนการกรองเนื้อหาสำหรับผู้ใหญ่ด้วยฟีเจอร์ค้นหาปลอดภัยสำหรับรายละเอียดเพิ่มเติมเกี่ยวกับฟีเจอร์นี้ |
||||||||
ตัวอย่าง | q=adult&safe=high |
เริ่มต้น | |
---|---|
คำอธิบาย | Optional พารามิเตอร์ พารามิเตอร์ |
ตัวอย่าง | start=10 |
จัดเรียง | |
---|---|
คำอธิบาย | Optional พารามิเตอร์ |
ตัวอย่าง |
|
อ. | |
---|---|
คำอธิบาย | Optional พารามิเตอร์ http://www.花井鮨.com ค่าที่ถูกต้องสำหรับพารามิเตอร์นี้คือ หากตั้งค่าพารามิเตอร์ http://www.xn--elq438j.com. หมายเหตุ: ฟีเจอร์นี้อยู่ในเวอร์ชันเบต้า |
ตัวอย่าง | q=google&ud=1 |
การค้นหาขั้นสูง
พารามิเตอร์การค้นหาเพิ่มเติมที่แสดงอยู่ด้านล่างรูปภาพเกี่ยวข้องกับคำค้นหาขั้นสูง เมื่อส่งการค้นหาขั้นสูง ระบบจะพิจารณาค่าของพารามิเตอร์หลายรายการ (เช่น as_eq, as_epq, as_oq ฯลฯ) ในคำค้นหาสำหรับการค้นหานั้น รูปภาพแสดงหน้าการค้นหาขั้นสูงของ Google ในรูปภาพ ชื่อของพารามิเตอร์การค้นหาขั้นสูงแต่ละรายการจะเขียนด้วยข้อความredด้านในหรือข้างช่องในหน้าที่สอดคล้องกับพารามิเตอร์นั้นๆ
พารามิเตอร์การค้นหาขั้นสูง
as_dt | |
---|---|
คำอธิบาย | Optional พารามิเตอร์ |
ตัวอย่าง | as_dt=i,as_dt=e |
as_epq | |
---|---|
คำอธิบาย | Optional พารามิเตอร์ |
ตัวอย่าง | as_epq=abraham+lincoln |
as_eq | |
---|---|
คำอธิบาย | Optional พารามิเตอร์ |
ตัวอย่าง |
|
as_lq | |
---|---|
คำอธิบาย | Optional พารามิเตอร์ |
ตัวอย่าง |
|
as_nlo | |
---|---|
คำอธิบาย | Optional พารามิเตอร์ |
ตัวอย่าง | การตั้งค่าต่อไปนี้กำหนดช่วงการค้นหาเป็น 5 ถึง 10
|
as_nhi | |
---|---|
คำอธิบาย | Optional พารามิเตอร์ |
ตัวอย่าง | การตั้งค่าต่อไปนี้กำหนดช่วงการค้นหาเป็น 5 ถึง 10
|
as_oq | |
---|---|
คำอธิบาย | Optional พารามิเตอร์ |
ตัวอย่าง |
|
as_q | |
---|---|
คำอธิบาย | Optional พารามิเตอร์ |
ตัวอย่าง |
|
as_qdr | |
---|---|
คำอธิบาย | Optional พารามิเตอร์
|
ตัวอย่าง |
ตัวอย่างนี้ขอผลลัพธ์จากปีที่ผ่านมา:
ตัวอย่างนี้ขอผลลัพธ์จาก 10 วันที่ผ่านมา
|
as_sitesearch | |
---|---|
คำอธิบาย | Optional พารามิเตอร์ |
ตัวอย่าง |
|
คำค้นหาพิเศษ
Google WebSearch อนุญาตให้ใช้ข้อความค้นหาพิเศษต่างๆ มากมายที่เข้าถึงความสามารถเพิ่มเติมของเครื่องมือค้นหาของ Google คำค้นหาพิเศษเหล่านี้ควรรวมอยู่ในค่าของพารามิเตอร์คำขอ q คำค้นหาพิเศษต้องเป็น URL ที่ใช้ Escape เช่นเดียวกับคำค้นหาอื่นๆ ข้อความค้นหาพิเศษจำนวนมากมีโคลอน (:) อักขระนี้ต้องกำหนดเป็นอักขระหลีกกับ URL ด้วย ค่าที่กำหนดเป็นอักขระหลีกของ URL คือ %3A
ลิงก์ย้อนกลับ [link:] | |
---|---|
คำอธิบาย | ข้อความค้นหา
คุณใช้พารามิเตอร์คำขอ as_lq เพื่อส่งคำขอ หมายเหตุ: คุณไม่สามารถระบุคำค้นหาอื่นๆ เมื่อใช้ |
ตัวอย่าง |
|
บูลีน OR การค้นหา [ OR ] | |
---|---|
คำอธิบาย | คำค้นหา คุณยังใช้พารามิเตอร์คำขอ as_oq เพื่อส่งการค้นหาคำใดๆ ในชุดคำได้อีกด้วย หมายเหตุ: หากคำขอการค้นหาระบุคำค้นหา "London+OR+Paris" ผลการค้นหาจะรวมเอกสารที่มีคำเหล่านั้นอย่างน้อย 1 คำจาก 2 คำดังกล่าว ในบางกรณี เอกสารในผลการค้นหาอาจมีทั้ง 2 คำ |
ตัวอย่าง | ค้นหาลอนดอนหรือปารีส: ข้อมูลจากผู้ใช้:
london OR
paris ข้อความค้นหา:q=london+OR+paris ค้นหาวันหยุดพักผ่อนและลอนดอนหรือปารีส: ข้อความค้นหา:
q=vacation+london+OR+paris ค้นหาวันหยุดพักผ่อนและวันหยุดลอนดอน ปารีส หรือช็อกโกแลต: ข้อความค้นหา:
q=vacation+london+OR+paris+OR+chocolates ค้นหา "วันหยุดพักผ่อน" และ "ช็อกโกแลต" หรือ "ลอนดอน" หรือ "ปารีส" โดยให้น้ำหนักน้อยที่สุดดังนี้ ข้อความค้นหา:
q=vacation+london+OR+paris+chocolates ค้นหาวันหยุดพักผ่อน ช็อกโกแลต และดอกไม้ในเอกสารที่มีคำว่าลอนดอนหรือปารีสด้วย ข้อความค้นหา:
q=vacation+london+OR+paris+chocolates+flowers ค้นหา "วันหยุดพักผ่อน" และ "ลอนดอน" หรือ "ปารีส" และค้นหา "ช็อกโกแลตหรือดอกไม้" โดยทำดังนี้ ข้อความค้นหา: q=vacation+london+OR+paris+chocolates+OR+flowers |
ยกเว้นข้อความค้นหา [-] | |
---|---|
คำอธิบาย | คำค้นหา "ยกเว้น" (
ข้อความค้นหา "ยกเว้น" จะมีประโยชน์เมื่อข้อความค้นหามีความหมายมากกว่า 1 ความหมาย ตัวอย่างเช่น คำว่า "bass" อาจแสดงผลการค้นหาเกี่ยวกับปลาหรือเพลงก็ได้ หากคุณต้องการเอกสารเกี่ยวกับปลา คุณสามารถยกเว้นเอกสารเกี่ยวกับเพลงในผลการค้นหาได้โดยใช้ข้อความค้นหายกเว้น คุณยังใช้พารามิเตอร์คำขอ as_eq เพื่อยกเว้นเอกสารที่ตรงกับคำหรือวลีหนึ่งๆ ในผลการค้นหาได้อีกด้วย |
ตัวอย่าง | ข้อมูลจากผู้ใช้: bass -music ข้อความค้นหา: q=bass+%2Dmusic |
การยกเว้นประเภทไฟล์ [ -filetype: ] | |
---|---|
คำอธิบาย | คำค้นหา
หมายเหตุ: คุณยกเว้นไฟล์หลายประเภทในผลการค้นหาได้โดยการเพิ่มข้อความค้นหา ประเภทไฟล์ที่ Google รองรับ ได้แก่
ทั้งนี้อาจมีการเพิ่มประเภทไฟล์อื่นๆ ในอนาคต ดูรายการล่าสุดได้ทุกเมื่อในคำถามที่พบบ่อยเกี่ยวกับประเภทไฟล์ของ Google |
ตัวอย่าง | ตัวอย่างนี้แสดงเอกสารที่พูดถึง "Google" แต่ไม่ใช่เอกสาร PDF ตัวอย่างนี้แสดงเอกสารที่พูดถึง "Google" แต่ยกเว้นทั้งเอกสาร PDF และ Word: |
การกรองประเภทไฟล์ [ filetype: ] | |
---|---|
คำอธิบาย | ข้อความค้นหา
คุณจะจำกัดผลการค้นหาให้แสดงเฉพาะเอกสารที่ตรงกับนามสกุลไฟล์ไฟล์ใดไฟล์หนึ่งได้โดยการเพิ่มข้อความค้นหา โดยค่าเริ่มต้น ผลการค้นหาจะรวมเอกสารที่มีนามสกุลไฟล์ใดก็ได้ ประเภทไฟล์ที่ Google รองรับ ได้แก่
ทั้งนี้อาจมีการเพิ่มประเภทไฟล์อื่นๆ ในอนาคต ดูรายการล่าสุดได้ทุกเมื่อในคำถามที่พบบ่อยเกี่ยวกับประเภทไฟล์ของ Google |
ตัวอย่าง | ตัวอย่างนี้แสดงเอกสาร PDF ที่ระบุ "Google": ตัวอย่างนี้แสดงเอกสาร PDF และ Word ที่พูดถึง "Google" |
รวมข้อความค้นหา [+] | |
---|---|
คำอธิบาย | คำค้นหา "รวม (+)" จะระบุว่าคำหรือวลีหนึ่งๆ ต้องปรากฏในเอกสารทั้งหมดที่อยู่ในผลการค้นหา หากต้องการใช้ข้อความค้นหา "รวม" คุณจะต้องหน้าคำหรือวลีที่ต้องรวมอยู่ในผลการค้นหาทั้งหมดด้วย "+" (เครื่องหมายบวก)
คุณควรใช้ |
ตัวอย่าง | ข้อมูลจากผู้ใช้: Star Wars Episode +I ข้อความค้นหา: q=Star+Wars+Episode+%2BI |
การค้นหาเฉพาะลิงก์ คำทั้งหมด [ allinlinks: ] | |
---|---|
คำอธิบาย | ข้อความค้นหา หากคำค้นหามีคำค้นหา
|
ตัวอย่าง | ข้อมูลจากผู้ใช้:allinlinks: Google search ข้อความค้นหา: q=allinlinks%3A+Google+search |
การค้นหาวลี | |
---|---|
คำอธิบาย | คำค้นหาวลี (") ช่วยให้คุณค้นหาวลีที่สมบูรณ์ด้วยการใส่เครื่องหมายคำพูดล้อมรอบวลี หรือเชื่อมต่อวลีเหล่านั้นกับขีดกลาง
การค้นหาวลีจะมีประโยชน์เป็นพิเศษหากคุณค้นหาคำพูดที่มีชื่อเสียงหรือชื่อเฉพาะ คุณยังใช้พารามิเตอร์คำขอ as_epq เพื่อส่งการค้นหาวลีได้อีกด้วย |
ตัวอย่าง | ข้อมูลจากผู้ใช้:"Abraham Lincoln" ข้อความค้นหา: q=%22Abraham+Lincoln%22 |
การค้นหาข้อความเท่านั้น คำทั้งหมด [allintext:] | |
---|---|
คำอธิบาย | ข้อความค้นหา หากคำค้นหามีคำค้นหา
|
ตัวอย่าง | ตัวอย่างนี้ระบุว่าคำว่า "Google" และ "search" ต้องปรากฏในส่วนเนื้อหาของเอกสารทั้งหมดที่อยู่ในผลการค้นหา ดังนี้ ข้อมูลจากผู้ใช้: allintext:Google search ข้อความค้นหา: q=allintext%3AGoogle+search |
การค้นหาชื่อ, คำเดียว [intitle:] | |
---|---|
คำอธิบาย | คำค้นหา หมายเหตุ: คุณระบุคำมากกว่า 1 คำที่จะรวมไว้ในชื่อเอกสารได้โดยใส่คำค้นหา
|
ตัวอย่าง | ตัวอย่างนี้ระบุว่าคำว่า "Google" ต้องปรากฏในชื่อเอกสารใดก็ตามในผลการค้นหา และคำว่า "ค้นหา" ต้องปรากฏในชื่อ, URL, ลิงก์ หรือเนื้อหาของเอกสารเหล่านั้น ดังนี้ |
การค้นหาชื่อ คำทั้งหมด [allintitle:] | |
---|---|
คำอธิบาย | ข้อความค้นหา หมายเหตุ: การป้อน
|
ตัวอย่าง | ตัวอย่างนี้ระบุว่าคำว่า "Google" และ "ค้นหา" ต้องปรากฏในชื่อเอกสารในผลการค้นหา |
การค้นหา URL, คำเดียว [inurl:] | |
---|---|
คำอธิบาย | ข้อความค้นหา คำค้นหา
|
ตัวอย่าง | ตัวอย่างนี้ระบุว่าคำว่า "Google" ต้องปรากฏใน URL ของเอกสารในผลการค้นหา และคำว่า "ค้นหา" ต้องปรากฏในชื่อ, URL, ลิงก์ หรือเนื้อหาของเอกสารเหล่านั้น ดังนี้ |
การค้นหา URL, คำทั้งหมด [allinurl:] | |
---|---|
คำอธิบาย | ข้อความค้นหา คำค้นหา
|
ตัวอย่าง | ตัวอย่างนี้ระบุว่าคำว่า "Google" และ "search" ต้องปรากฏใน URL ของเอกสารในผลการค้นหา |
ข้อมูลเอกสารในเว็บ [info:] | |
---|---|
คำอธิบาย | ข้อความค้นหา
หมายเหตุ: คุณไม่สามารถระบุคำค้นหาอื่นๆ เมื่อใช้ |
ตัวอย่าง | ข้อมูลจากผู้ใช้: info:www.google.com ข้อความค้นหา: q=info%3Awww.google.com |
การค้นหารูปภาพตัวอย่าง
ตัวอย่างด้านล่างแสดงคำขอ HTTP รูปภาพ 2 รายการเพื่อแสดงวิธีใช้พารามิเตอร์การค้นหาที่แตกต่างกัน คำนิยามสำหรับพารามิเตอร์การค้นหาต่างๆ มีอยู่ในส่วนคำจำกัดความพารามิเตอร์การค้นหารูปภาพของเอกสารนี้
คำขอนี้ขอให้แสดงผลลัพธ์ 5 รายการแรก (start=0&num=5
) สำหรับคำค้นหา "monkey" (q=monkey
) ของประเภทไฟล์ .png สุดท้าย การค้นหาจะระบุค่าสำหรับพารามิเตอร์ client
, output
และ cx
โดยที่ทั้ง 3 ค่าเป็นพารามิเตอร์ที่ต้องระบุ
http://www.google.com/cse? searchtype=image start=0 &num=5 &q=monkey &as_filetype=png &client=google-csbe &output=xml_no_dtd &cx=00255077836266642015:u-scht7a-8i
พารามิเตอร์คำค้นหารูปภาพ
as_filetype | |
---|---|
คำอธิบาย | Optional แสดงรูปภาพในประเภทที่ระบุ ค่าที่อนุญาตคือ |
ตัวอย่าง | q=google&as_filetype=png |
imgsz | |
---|---|
คำอธิบาย | Optional แสดงรูปภาพที่มีขนาดตามที่ระบุ โดยขนาดอาจเป็นค่าใดค่าหนึ่งต่อไปนี้
|
ตัวอย่าง | q=google&as_filetype=png&imgsz=icon |
ประเภทภาพ | |
---|---|
คำอธิบาย | Optional แสดงรูปภาพประเภทหนึ่ง ซึ่งอาจเป็นอย่างใดอย่างหนึ่งต่อไปนี้
|
ตัวอย่าง | q=google&as_filetype=png&imgtype=photo |
imgc | |
---|---|
คำอธิบาย | Optional แสดงรูปภาพขาวดำ โทนสีเทา หรือรูปภาพสี ดังนี้
|
ตัวอย่าง | q=google&as_filetype=png&imgc=gray |
สี imgcolor | |
---|---|
คำอธิบาย | Optional แสดงรูปภาพที่มีสีเด่นที่เฉพาะเจาะจง:
|
ตัวอย่าง | q=google&as_filetype=png&imgcolor=yellow |
as_rights | |
---|---|
คำอธิบาย | Optional ตัวกรองตามการอนุญาตให้ใช้สิทธิ ค่าที่รองรับมีดังนี้
|
ตัวอย่าง | 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 รูปแบบ
วิธีใช้คุณลักษณะนี้
- ตั้งค่าพารามิเตอร์คำขอ c2coff เป็น 0
และ - ทำตามข้อใดข้อหนึ่งต่อไปนี้
ตัวอย่างต่อไปนี้แสดงพารามิเตอร์การค้นหาที่คุณจะรวมไว้ในคำขอผลลัพธ์ทั้งในภาษาจีนแบบย่อและดั้งเดิม (โปรดทราบว่าข้อมูลที่จำเป็นเพิ่มเติม เช่น ไคลเอ็นต์ จะไม่รวมอยู่ในตัวอย่าง)
search?hl=zh-CN &lr=lang_zh-TW|lang_zh-CN &c2coff=0
การกรองผลลัพธ์
Google WebSearch มีวิธีกรองผลการค้นหาหลายวิธี ดังนี้
- การกรองผลการค้นหาโดยอัตโนมัติ
- การกรองภาษาและประเทศ
- การกรองเนื้อหาสำหรับผู้ใหญ่ด้วยฟีเจอร์ค้นหาปลอดภัย
การกรองผลการค้นหาโดยอัตโนมัติ
Google ใช้เทคนิค 2 อย่างต่อไปนี้ในการกรองผลการค้นหาที่มักได้รับการพิจารณาว่าเป็นไม่พึงประสงค์โดยอัตโนมัติ เพื่อแสดงผลการค้นหาที่ดีที่สุด
-
เนื้อหาที่ซ้ำกัน หากเอกสารหลายฉบับมีข้อมูลเหมือนกัน ระบบจะรวมเฉพาะเอกสารที่เกี่ยวข้องที่สุดของชุดนั้นไว้ในผลการค้นหา
-
Host Crowding - หากมีผลการค้นหาจํานวนมากจากเว็บไซต์เดียวกัน Google อาจไม่แสดงผลการค้นหาทั้งหมดจากเว็บไซต์นั้น หรืออาจแสดงผลลัพธ์ใน
อันดับที่ต่ำกว่าที่ควรจะเป็น
เราขอแนะนำให้คุณเปิดใช้ตัวกรองเหล่านี้ไว้สำหรับคำขอการค้นหาโดยทั่วไป เนื่องจากตัวกรองจะช่วยเพิ่มคุณภาพของผลการค้นหาส่วนใหญ่ได้อย่างมาก แต่คุณข้ามตัวกรองอัตโนมัติเหล่านี้ได้โดยตั้งค่าพารามิเตอร์การค้นหา filter เป็น 0 ในคำขอค้นหา
การกรองภาษาและประเทศ
บริการ Google WebSearch แสดงผลการค้นหาจากดัชนีหลักของเอกสารในเว็บทั้งหมด ดัชนีหลักมีเอกสารคอลเล็กชันย่อยที่จัดกลุ่มตามแอตทริบิวต์หนึ่งๆ ซึ่งรวมถึงภาษาและประเทศต้นทาง
คุณสามารถใช้พารามิเตอร์คำขอ lr และ cr เพื่อจำกัดผลการค้นหาไว้เฉพาะเอกสารคอลเล็กชันย่อยที่เขียนในภาษาหนึ่งๆ หรือมาจากประเทศหนึ่งๆ ตามลำดับ
Google WebSearch ระบุภาษาของเอกสารโดยวิเคราะห์สิ่งต่อไปนี้
- โดเมนระดับบนสุด (TLD) ของ URL ของเอกสาร
- เมตาแท็กภาษาภายในเอกสาร
- ภาษาหลักที่ใช้ในข้อความเนื้อหาของเอกสาร
นอกจากนี้ โปรดดูคำจำกัดความของพารามิเตอร์ lr ส่วนในการค้นหาเอกสารที่เขียนในภาษาที่เฉพาะเจาะจง และค่าคอลเล็กชันภาษาที่ใช้เป็นค่าสำหรับพารามิเตอร์ lr ได้ เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับการจำกัดผลลัพธ์ตามภาษา
Google WebSearch ระบุประเทศของเอกสารด้วยการวิเคราะห์สิ่งต่อไปนี้
- โดเมนระดับบนสุด (TLD) ของ URL ของเอกสาร
- สถานที่ตั้งทางภูมิศาสตร์ของที่อยู่ IP ของเว็บเซิร์ฟเวอร์
นอกจากนี้ โปรดดูคำจำกัดความของพารามิเตอร์ cr และค่าคอลเล็กชันประเทศ ที่ใช้เป็นค่าสำหรับพารามิเตอร์ cr ได้เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับการจำกัดผลลัพธ์ตามประเทศต้นทาง
หมายเหตุ: คุณรวมค่าภาษาและค่าประเทศเพื่อปรับแต่งผลการค้นหาได้ เช่น อาจขอเอกสารที่เขียนเป็นภาษาฝรั่งเศสและมาจากฝรั่งเศสหรือแคนาดา หรือขอเอกสารที่มาจากฮอลแลนด์แต่ไม่ได้เขียนเป็นภาษาอังกฤษก็ได้ ทั้งพารามิเตอร์ lr และ cr รองรับโอเปอเรเตอร์บูลีน
การกรองเนื้อหาสำหรับผู้ใหญ่ด้วยฟีเจอร์ค้นหาปลอดภัย
ลูกค้า Google จำนวนมากไม่ต้องการให้แสดงผลการค้นหาเว็บไซต์ที่มีเนื้อหาสำหรับผู้ใหญ่ คุณสามารถใช้ตัวกรองค้นหาปลอดภัยเพื่อคัดกรองผลการค้นหาที่มีเนื้อหาสำหรับผู้ใหญ่และกำจัดเนื้อหาดังกล่าว ตัวกรองของ Google ใช้เทคโนโลยีที่เป็นกรรมสิทธิ์เพื่อตรวจสอบคีย์เวิร์ด วลี และ URL แม้ว่าจะไม่มีตัวกรองใดที่ทำงานได้ถูกต้อง 100 เปอร์เซ็นต์ แต่ฟีเจอร์ค้นหาปลอดภัยจะนำเนื้อหาสำหรับผู้ใหญ่ส่วนใหญ่ออกจากผลการค้นหาของคุณ
Google มุ่งมั่นที่จะทำให้ฟีเจอร์ค้นหาปลอดภัยเป็นปัจจุบันและครอบคลุมมากที่สุดด้วยการรวบรวมข้อมูลเว็บอย่างต่อเนื่องและรวบรวมการอัปเดตจากคำแนะนำของผู้ใช้
ฟีเจอร์ค้นหาปลอดภัยมีให้บริการในภาษาต่อไปนี้
ดัตช์ อังกฤษ ฝรั่งเศส เยอรมัน |
อิตาลี โปรตุเกส (บราซิล) สเปน จีนตัวเต็ม |
คุณปรับระดับที่ Google กรองผลการค้นหาที่มีเนื้อหาสำหรับผู้ใหญ่ได้โดยใช้พารามิเตอร์การค้นหาที่ปลอดภัย ตารางต่อไปนี้อธิบายการตั้งค่าฟีเจอร์ค้นหาปลอดภัยของ Google และวิธีที่การตั้งค่าเหล่านั้นจะส่งผลต่อผลการค้นหา
ระดับฟีเจอร์ค้นหาปลอดภัย | คำอธิบาย |
---|---|
สูง | เปิดใช้งานฟีเจอร์ค้นหาปลอดภัยเวอร์ชันเข้มงวดยิ่งขึ้น |
medium | บล็อกหน้าเว็บที่มีภาพอนาจารและเนื้อหาเกี่ยวกับเรื่องเพศที่โจ่งแจ้งอื่นๆ |
ปิด | ไม่กรองเนื้อหาสำหรับผู้ใหญ่ออกจากผลการค้นหา |
* ระบบจะปิดการตั้งค่าฟีเจอร์ค้นหาปลอดภัยเริ่มต้นไว้
หากเปิดใช้งานฟีเจอร์ค้นหาปลอดภัยแล้ว แต่พบเว็บไซต์ที่มีเนื้อหาไม่เหมาะสมในผลการค้นหา โปรดส่งอีเมล URL ของเว็บไซต์ไปยัง safesearch@google.com แล้วเราจะตรวจสอบเว็บไซต์นั้น
ผลลัพธ์ XML
- ผลลัพธ์ที่เป็น XML ของ Google
- เกี่ยวกับการตอบกลับ XML
- ผลลัพธ์ XML สำหรับคำค้นหาทั่วไปและขั้นสูง
- การค้นหาทั่วไป/ขั้นสูง: ตัวอย่างคำค้นหาและผลลัพธ์ XML
- การค้นหาทั่วไป/ขั้นสูง: แท็ก XML
ผลลัพธ์ XML ของ Google DTD
Google ใช้ DTD เดียวกันเพื่ออธิบายรูปแบบ XML สำหรับผลการค้นหาทุกประเภท มีแท็กและแอตทริบิวต์หลายรายการที่ใช้ได้กับการค้นหาทุกประเภท อย่างไรก็ตาม แท็กบางแท็กจะใช้ได้กับการค้นหาบางประเภทเท่านั้น ดังนั้น คำจำกัดความใน DTD อาจมีข้อจำกัดน้อยกว่าคำจำกัดความที่ระบุไว้ในเอกสารนี้
เอกสารนี้อธิบายแง่มุมต่างๆ ของ DTD ที่เกี่ยวข้องกับ WebSearch ในกรณีที่ใช้ WebSearch เมื่อดูที่ DTD คุณจะละเว้นแท็กและแอตทริบิวต์ที่ไม่ได้ระบุไว้ที่นี่ได้ หากคำจำกัดความแตกต่างกันระหว่าง DTD และเอกสาร เราจะระบุข้อเท็จจริงไว้ในเอกสารนี้
Google แสดงผลลัพธ์ XML ได้ทั้งแบบที่มีหรือไม่มีการอ้างอิงถึง DTD ล่าสุด DTD คือคำแนะนำที่จะช่วยให้ผู้ดูแลระบบการค้นหาและโปรแกรมแยกวิเคราะห์ XML เข้าใจผลลัพธ์ XML ของ Google เนื่องจากไวยากรณ์ XML ของ Google อาจเปลี่ยนแปลงเป็นครั้งคราว คุณจึงไม่ควรกำหนดค่าโปรแกรมแยกวิเคราะห์ให้ใช้ DTD เพื่อตรวจสอบผลลัพธ์ XML แต่ละรายการ
นอกจากนี้ คุณไม่ควรกำหนดค่าโปรแกรมแยกวิเคราะห์ XML ให้ดึงข้อมูล DTD ทุกครั้งที่ส่งคำขอการค้นหา Google จะอัปเดต DTD ไม่บ่อยนักและคำขอเหล่านี้จะสร้างข้อกำหนดด้านแบนด์วิดท์และความล่าช้าที่ไม่จำเป็น
Google ขอแนะนำให้คุณใช้รูปแบบเอาต์พุต xml_no_dtd เพื่อรับผลลัพธ์แบบ XML หากคุณระบุรูปแบบ xml เอาต์พุต ในคำขอค้นหา ความแตกต่างเพียงอย่างเดียวคือการรวมบรรทัดต่อไปนี้ในผลลัพธ์ XML
<!DOCTYPE GSP SYSTEM "google.dtd">
คุณเข้าถึง DTD ล่าสุดได้ที่ http://www.google.com/google.dtd
โปรดทราบว่าฟีเจอร์บางรายการใน DTD อาจไม่พร้อมใช้งานหรือรองรับในขณะนี้
เกี่ยวกับการตอบกลับ XML
- ค่าองค์ประกอบทั้งหมดเป็น HTML ที่ถูกต้องที่เหมาะสำหรับการแสดง เว้นแต่จะระบุไว้เป็นอย่างอื่นในคำจำกัดความแท็ก XML
- ค่าองค์ประกอบบางค่าเป็น URL ที่ต้องเข้ารหัส HTML ก่อนที่จะแสดง
- โปรแกรมแยกวิเคราะห์ XML ควรละเว้นแอตทริบิวต์และแท็กที่ไม่ได้ระบุไว้ ซึ่งจะช่วยให้แอปพลิเคชันทำงานต่อได้โดยไม่ต้องแก้ไขหาก Google เพิ่มฟีเจอร์เพิ่มเติมในเอาต์พุต XML
- อักขระบางตัวต้องกำหนดเป็นอักขระหลีกเมื่อใส่เป็นค่าในแท็ก XML ตัวประมวลผล XML ควรแปลงเอนทิตีเหล่านี้กลับไปเป็นอักขระที่เหมาะสม หากไม่แปลงเอนทิตีอย่างถูกต้อง เบราว์เซอร์อาจแสดงผลอักขระ & เป็น "&" เป็นต้น
มาตรฐาน XML ได้บันทึกอักขระเหล่านี้ไว้ โดยอักขระเหล่านี้จะมีการทำซ้ำในตารางด้านล่าง
อักขระ ฟอร์มที่ใช้ Escape เอนทิตี รหัสอักขระ สัญลักษณ์แทนคำว่า "และ" & & & เครื่องหมายคำพูดเดี่ยว ' ' ' เครื่องหมายคำพูดคู่ " " " เครื่องหมายมากกว่า > > > เครื่องหมายน้อยกว่า < < <
ผลลัพธ์ XML สำหรับคำค้นหาทั่วไปและขั้นสูง
การค้นหาทั่วไป/ขั้นสูง: ข้อความค้นหาตัวอย่างและผลลัพธ์ XML
ตัวอย่างคำขอ WebSearch นี้ขอผลลัพธ์ 10 รายการ (num=10
) เกี่ยวกับข้อความค้นหา "socer" (q=socer
) ซึ่งเป็นคำว่า "ฟุตบอล" ที่จงใจสะกดไม่ถูกต้องในตัวอย่างนี้)
http://www.google.com/search?
q=socer
&hl=en
&start=10
&num=10
&output=xml
&client=google-csbe
&cx=00255077836266642015:u-scht7a-8i
คำขอนี้แสดงผลลัพธ์ XML ด้านล่าง โปรดทราบว่าผลลัพธ์ XML มีความคิดเห็นหลายรายการเพื่อระบุตำแหน่งที่แท็กบางรายการที่ไม่รวมอยู่ในผลลัพธ์จะปรากฏ
<?xml version="1.0" encoding="ISO-8859-1" standalone="no" ?>
<GSP VER="3.2">
<TM>0.452923</TM>
<Q>socer</Q>
<PARAM name="cx" value="00255077836266642015:u-scht7a-8i" original_value="00255077836266642015%3Au-scht7a-8i"/>
<PARAM name="hl" value="en" original_value="en"/>
<PARAM name="q" value="socer" original_value="socer"/>
<PARAM name="output" value="xml" original_value="xml"/>
<PARAM name="client" value="google-csbe" original_value="google-csbe"/>
<PARAM name="num" value="10" original_value="10"/>
<Spelling>
<Suggestion q="soccer"><b><i>soccer</i></b></Suggestion>
</Spelling>
<Context>
<title>Sample Vacation CSE</title>
<Facet>
<FacetItem>
<label>restaurants</label>
<anchor_text>restaurants</anchor_text>
</FacetItem>
<FacetItem>
<label>wineries</label>
<anchor_text>wineries</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>golf_courses</label>
<anchor_text>golf courses</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>hotels</label>
<anchor_text>hotels</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>nightlife</label>
<anchor_text>nightlife</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>soccer_sites</label>
<anchor_text>soccer sites</anchor_text>
</FacetItem>
</Facet>
</Context>
<RES SN="1" EN="10">
<M>6080</M>
/*
* The FI tag after the comment indicates that the result
* set has been filtered. If the number of results were exact, the
* FI tag would be replaced by an XT tag in the same format.
*/
<FI />
<NB>
/*
* Since the request is for the first page of results, the PU tag,
* which contains a link to the previous page of search results,
* is not included in this XML result. If the sample result did include
* a previous page of results, it would be listed here, in the same format
* as the NU tag on the following line
*/
<NU>/search?q=socer&hl=en&lr=&ie=UTF-8&output=xml&client=test&start=10&sa=N</NU>
</NB>
<R N="1">
<U>http://www.soccerconnection.net/</U>
<UE>http://www.soccerconnection.net/</UE>
<T>SoccerConnection.net</T>
<CRAWLDATE>May 21, 2007</CRAWLDATE>
<S><b>soccer</b>; players; coaches; ball; world cup;<b>...</b></S>
<Label>transcodable_pages</Label>
<Label>accessible</Label>
<Label>soccer_sites</Label>
<LANG>en</LANG>
<HAS>
<DI>
<DT>SoccerConnection.net</DT>
<DS>Post your <b>soccer</b> resume directly on the Internet.</DS>
</DI>
<L/>
<C SZ="8k" CID="kWAPoYw1xIUJ"/>
<RT/>
</HAS>
</R>
/*
* The result includes nine more results, each enclosed by an R tag.
*/
</RES>
</GSP>
การค้นหาทั่วไป/ขั้นสูง: แท็ก XML
การตอบกลับด้วย XML สำหรับคำขอการค้นหาทั่วไปและคำขอการค้นหาขั้นสูงจะใช้แท็ก XML ชุดเดียวกัน แท็ก XML เหล่านี้จะแสดงในตัวอย่าง XML ด้านบนและอธิบายไว้ในตารางด้านล่าง
แท็ก XML ด้านล่างแสดงตามตัวอักษรตามชื่อแท็ก และคำจำกัดความแท็กแต่ละข้อมีคำอธิบายแท็ก ตัวอย่างที่แสดงวิธีที่แท็กจะปรากฏในผลลัพธ์ XML และรูปแบบเนื้อหาของแท็ก หากแท็กนั้นเป็นแท็กย่อยของแท็ก XML อื่น หรือหากแท็กนั้นมีแท็กย่อยหรือแอตทริบิวต์ของตนเอง ข้อมูลดังกล่าวจะมีอยู่ในตารางคำจำกัดความของแท็กด้วย
สัญลักษณ์บางอย่างอาจแสดงถัดจากแท็กย่อยบางรายการในคำจำกัดความด้านล่าง สัญลักษณ์และความหมายของสัญลักษณ์มีดังนี้
* = อินสแตนซ์ของแท็กย่อยเป็นศูนย์หรือมากกว่า
+ = อินสแตนซ์ของแท็กย่อยอย่างน้อย 1 อินสแตนซ์
B | C | ง | เ | ผู้ประกอบวิชาชีพ | ล้าน | คำถาม | R | T | ใช้ | X |
anchor_text | |
---|---|
คำจำกัดความ | แท็ก <anchor_text> ระบุข้อความที่คุณควรแสดงต่อผู้ใช้เพื่อระบุป้ายกำกับการปรับแต่งที่เชื่อมโยงกับชุดผลการค้นหา เนื่องจากป้ายกำกับการปรับเกณฑ์การค้นหาจะใช้ขีดล่างแทนอักขระที่ไม่ใช่ตัวเลขหรือตัวอักษร คุณจึงไม่ควรแสดงค่าของแท็ก <label> ในอินเทอร์เฟซผู้ใช้ คุณควรแสดงค่าของแท็ก <anchor_text> แทน |
ตัวอย่าง | <anchor_text>สนามกอล์ฟ</anchor_text> |
แท็กย่อยของ | FacetItem |
รูปแบบเนื้อหา | ข้อความ |
บล็อก | |
---|---|
คำจำกัดความ | แท็กนี้สรุปเนื้อหาของบล็อกในบรรทัดเนื้อหาของผลลัพธ์การสนับสนุน แต่ละบล็อกจะมีแท็กย่อย T, U และ L แท็ก T ที่ไม่ว่างเปล่าหมายความว่าบล็อกมีข้อความ แท็ก U และ L ที่ไม่ว่างเปล่าหมายความว่าบล็อกนั้นมีลิงก์ (โดยมี URL ที่ระบุในแท็กย่อย U และ anchor text ในแท็กย่อย L) |
แท็กย่อย | T, U, L |
แท็กย่อยของ | BODY_LINE |
รูปแบบเนื้อหา | ว่าง |
BODY_LINE | |
---|---|
คำจำกัดความ | แท็กนี้สรุปเนื้อหาของบรรทัดในเนื้อหาผลลัพธ์ที่โปรโมต บรรทัดเนื้อหาแต่ละบรรทัดประกอบด้วยแท็ก BLOCK หลายแท็ก ซึ่งมีข้อความหรือลิงก์ที่มี URL และ anchor text |
แท็กย่อย | บล็อก* |
แท็กย่อยของ | SL_MAIN |
รูปแบบเนื้อหา | ว่าง |
C | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
คำจำกัดความ | แท็ก <C> ระบุว่าบริการ WebSearch เรียก URL ผลการค้นหาเวอร์ชันที่แคชไว้ได้ คุณเรียกข้อมูลหน้าที่แคชไว้ผ่าน XML API ไม่ได้ แต่เปลี่ยนเส้นทางผู้ใช้ไปยัง www.google.com สำหรับเนื้อหานี้ได้ |
|||||||||
แอตทริบิวต์ |
|
|||||||||
ตัวอย่าง | <C SZ="6k" CID="kvOXK_cYSSgJ" /> | |||||||||
แท็กย่อยของ | HAS | |||||||||
รูปแบบเนื้อหา | ว่าง |
C2C | |
---|---|
คำจำกัดความ | แท็ก <C2C> บ่งบอกว่าผลการค้นหาหมายถึงหน้าภาษาจีนตัวเต็ม แท็กนี้จะปรากฏเฉพาะเมื่อเปิดใช้การค้นหาภาษาจีนตัวย่อและตัวเต็มเท่านั้น ดูคำจำกัดความของพารามิเตอร์การค้นหา c2coff สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการเปิดและปิดใช้ฟีเจอร์นี้ |
รูปแบบเนื้อหา | ข้อความ |
บริบท | |
---|---|
คำจำกัดความ | แท็ก <Context> สรุปรายการป้ายกำกับปรับเกณฑ์การค้นหาที่เชื่อมโยงกับชุดผลการค้นหา |
ตัวอย่าง | <Context> |
แท็กย่อย | title, Facet+ |
รูปแบบเนื้อหา | คอนเทนเนอร์ |
วันที่รวบรวมข้อมูล | |
---|---|
คำจำกัดความ | แท็ก <CRAWLDATE> ระบุวันที่ที่มีการ Crawl หน้าเว็บครั้งล่าสุด |
ตัวอย่าง | <CRAWLDATE>21 พฤษภาคม 2005</CRAWLDATE> |
แท็กย่อยของ | R |
รูปแบบเนื้อหา | ข้อความ |
DI | |
---|---|
คำจำกัดความ | แท็ก <DI> สรุปข้อมูลหมวดหมู่ Open Directory Project (ODP) สำหรับผลการค้นหารายการเดียว |
ตัวอย่าง | <DI> |
แท็กย่อย | DT, DS ใช่ไหม |
แท็กย่อยของ | HAS |
รูปแบบเนื้อหา | ว่าง |
DS | |
---|---|
คำจำกัดความ | แท็ก <DS> มีข้อมูลสรุปที่แสดงสำหรับหมวดหมู่เดียวในไดเรกทอรี ODP |
ตัวอย่าง | <DS>โพสต์ <b>ฟุตบอล</b> อ่านต่อ ใน อินเทอร์เน็ตโดยตรง</DS> |
แท็กย่อยของ | DI |
รูปแบบเนื้อหา | ข้อความ (อาจมี HTML) |
DT | |
---|---|
คำจำกัดความ | แท็ก <DT> ระบุชื่อหมวดหมู่เดียวที่แสดงในไดเรกทอรี ODP |
ตัวอย่าง | <DT>SoccerConnection.net</DT> |
แท็กย่อยของ | DI |
รูปแบบเนื้อหา | ข้อความ (อาจมี HTML) |
ข้อมูลประกอบ | |
---|---|
คำจำกัดความ | แท็ก <Facet> มีการจัดกลุ่มแท็ก <FacetItem> ตามตรรกะ คุณสร้างการจัดกลุ่มเหล่านี้ได้โดยใช้รูปแบบข้อกำหนด XML ของ Programmable Search Engine หากคุณไม่สร้างกลุ่มเหล่านี้ แท็ก results_xml_tag_Context><Context> จะมีแท็ก <Facet> สูงสุด 4 รายการ ระบบจะจัดกลุ่มรายการภายในแท็ก <Facet> แต่ละรายการเพื่อวัตถุประสงค์ในการแสดงผล แต่อาจไม่มีความสัมพันธ์เชิงตรรกะ |
ตัวอย่าง | <Facet> |
แท็กย่อย | FacetItem+, ชื่อ+ |
แท็กย่อยของ | Context |
รูปแบบเนื้อหา | คอนเทนเนอร์ |
FacetItem | |
---|---|
คำจำกัดความ | แท็ก <FacetItem> สรุปข้อมูลเกี่ยวกับป้ายกำกับการปรับเกณฑ์การค้นหาที่เชื่อมโยงกับชุดผลการค้นหา |
ตัวอย่าง | <FacetItem> |
แท็กย่อย | label, anchor_text+ |
แท็กย่อยของ | ข้อมูลประกอบ |
รูปแบบเนื้อหา | FacetItem |
FI | |
---|---|
คำจำกัดความ | แท็ก <FI> ทำหน้าที่เป็นแฟล็กที่ระบุว่ามีการกรองเอกสารสำหรับการค้นหาหรือไม่ ดูข้อมูลเพิ่มเติมเกี่ยวกับตัวกรองผลการค้นหาของ Google ในส่วนการกรองอัตโนมัติของเอกสารนี้ |
ตัวอย่าง | <FI /> |
แท็กย่อยของ | RES |
รูปแบบเนื้อหา | ว่าง |
GSP | |||||||
---|---|---|---|---|---|---|---|
คำจำกัดความ | แท็ก <GSP> สรุปข้อมูลทั้งหมดที่แสดงผลในผลการค้นหา XML ของ Google "GSP" เป็นตัวย่อของ "Google Search Protocol" |
||||||
แอตทริบิวต์ |
|
||||||
ตัวอย่าง | <GSP VER="3.2"> | ||||||
แท็กย่อย | PARAM+, Q, RES, หน่วยความจำคำแปล | ||||||
รูปแบบเนื้อหา | ว่าง |
HAS | |
---|---|
คำจำกัดความ | แท็ก <HAS> สรุปข้อมูลเกี่ยวกับพารามิเตอร์คำขอการค้นหาพิเศษที่รองรับสำหรับ URL หนึ่งๆ
หมายเหตุ: คำจำกัดความของ <HAS> สำหรับ WebSearch มีข้อจำกัดมากกว่าใน DTD |
แท็กย่อย | DI, ?, C?, RT? |
แท็กย่อยของ | R |
ISURL | |
---|---|
คำจำกัดความ | Google จะแสดงแท็ก <ISURL> หากคําค้นหาที่เกี่ยวข้องเป็น URL |
แท็กย่อยของ | GSP |
รูปแบบเนื้อหา | ว่าง |
L | |
---|---|
คำจำกัดความ | การมีแท็ก <L> บ่งบอกว่าบริการ WebSearch จะหาเว็บไซต์อื่นๆ ที่ลิงก์ไปยัง URL ของผลการค้นหานี้ได้ หากต้องการค้นหาเว็บไซต์เช่นนี้ ให้ใช้คำค้นหาพิเศษ link: |
แท็กย่อยของ | HAS |
รูปแบบเนื้อหา | ว่าง |
ป้ายกำกับ | |
---|---|
คำจำกัดความ | แท็ก <label> ระบุป้ายกำกับการปรับเกณฑ์การค้นหา ที่คุณสามารถใช้เพื่อกรองผลการค้นหาที่คุณได้รับ หากต้องการใช้ป้ายกำกับการปรับแต่ง ให้เพิ่มสตริง more:[[label tag value]] ลงในค่าของพารามิเตอร์ q ในคำขอ HTTP ที่ส่งไปยัง Google ตามที่แสดงในตัวอย่างต่อไปนี้ โปรดทราบว่าค่านี้ต้องกำหนดเป็นอักขระหลีกกับ URL ก่อนที่จะส่งคำค้นหาไปยัง Google This example uses the refinement label golf_courses to หมายเหตุ: แท็ก <label> ไม่เหมือนกับแท็ก <Label> ซึ่งใช้ระบุป้ายกำกับการปรับแต่งที่เชื่อมโยงกับ URL หนึ่งๆ ในผลการค้นหา |
ตัวอย่าง | <label>golf_courses</label> |
แท็กย่อยของ | FacetItem |
รูปแบบเนื้อหา | ข้อความ |
ภาษา | |
---|---|
คำจำกัดความ | แท็ก <LANG> มีการคาดเดาที่ดีที่สุดของ Google เกี่ยวกับภาษาของผลการค้นหา |
ตัวอย่าง | <LANG>en</LANG> |
แท็กย่อยของ | R |
รูปแบบเนื้อหา | ข้อความ |
M | |
---|---|
คำจำกัดความ | แท็ก <M> จะระบุจำนวนผลการค้นหาทั้งหมดโดยประมาณ หมายเหตุ: ค่าประมาณนี้อาจไม่ถูกต้อง |
ตัวอย่าง | <M>16200000</M> |
แท็กย่อยของ | RES |
รูปแบบเนื้อหา | ข้อความ |
แรกเกิด | |
---|---|
คำจำกัดความ | แท็ก <NB> สรุปข้อมูลการนำทาง (ลิงก์ไปยังหน้าผลการค้นหาถัดไปหรือหน้าก่อนหน้าของผลการค้นหา) สำหรับชุดผลการค้นหา หมายเหตุ: แท็กนี้จะปรากฏก็ต่อเมื่อมีผลลัพธ์เพิ่มเติมเท่านั้น |
ตัวอย่าง | <NB> |
แท็กย่อย | NU PU |
แท็กย่อยของ | RES |
รูปแบบเนื้อหา | ว่าง |
ไม่มีข้อมูล | |
---|---|
คำจำกัดความ | แท็ก <NU> มีลิงก์ที่เกี่ยวข้องเพื่อไปยังหน้าถัดไปของผลการค้นหา |
ตัวอย่าง | <NU>/search?q=flowers&num=10&hl=th&ie=UTF-8 &output=xml&client=test&start=10</NU> |
แท็กย่อยของ | NB |
รูปแบบเนื้อหา | ข้อความ (URL สัมพัทธ์) |
พารามิเตอร์ | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
คำจำกัดความ | แท็ก <PARAM> ระบุพารามิเตอร์อินพุตที่ส่งในคำขอ HTTP ที่เชื่อมโยงกับผลลัพธ์ XML ข้อมูลเกี่ยวกับพารามิเตอร์นี้อยู่ในแอตทริบิวต์แท็ก ได้แก่ ชื่อ ค่า ค่าต้นฉบับ และจะมีแท็ก PARAM 1 รายการสำหรับแต่ละพารามิเตอร์ที่ส่งในคำขอ HTTP |
||||||||||||
แอตทริบิวต์ |
|
||||||||||||
ตัวอย่าง | <PARAM name="cr" value="countryNZ" original_value="countryNZ" /> | ||||||||||||
แท็กย่อยของ | GSP | ||||||||||||
รูปแบบเนื้อหา | ซับซ้อน |
หนังเทียม | |
---|---|
คำจำกัดความ | แท็ก <PU> มีลิงก์ที่เกี่ยวข้องกับหน้าผลการค้นหาก่อนหน้า |
ตัวอย่าง | <PU>/search?q=flowers&num=10&hl=th&output=xml &client=test&start=10</PU> |
แท็กย่อยของ | NB |
รูปแบบเนื้อหา | ข้อความ (URL สัมพัทธ์) |
Q | |
---|---|
คำจำกัดความ | แท็ก <Q> ระบุคำค้นหาที่ส่งในคำขอ HTTP ที่เชื่อมโยงกับผลลัพธ์ XML |
ตัวอย่าง | <Q>pizza</Q> |
แท็กย่อยของ | GSP |
รูปแบบเนื้อหา | ข้อความ |
R | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
คำจำกัดความ | แท็ก <R> สรุปรายละเอียดของผลการค้นหาแต่ละรายการ หมายเหตุ: คำจำกัดความของแท็ก <R> สำหรับ WebSearch มีการจำกัดมากกว่าใน DTD |
|||||||||
แอตทริบิวต์ |
|
|||||||||
แท็กย่อย | U, UE, T, CRAWLDATE, S?, LANG, HAS | |||||||||
แท็กย่อยของ | RES |
RES | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
คำจำกัดความ | แท็ก <RES> สรุปชุดผลการค้นหาแต่ละรายการและรายละเอียดเกี่ยวกับผลการค้นหาเหล่านั้น |
|||||||||
แอตทริบิวต์ |
|
|||||||||
ตัวอย่าง | <RES SN="1" EN="10"> | |||||||||
แท็กย่อย | , FI, XT แล้ว NB R* | |||||||||
แท็กย่อยของ | GSP | |||||||||
รูปแบบเนื้อหา | ว่าง |
S | |
---|---|
คำจำกัดความ | แท็ก <S> มีข้อความที่ตัดตอนมาสำหรับผลการค้นหาที่แสดงข้อความค้นหาที่ไฮไลต์เป็นตัวหนา ตัวแบ่งบรรทัดจะรวมอยู่ในข้อความที่ตัดตอนมาเพื่อให้ตัดข้อความได้อย่างถูกต้อง |
ตัวอย่าง | <S>วอชิงตัน (CNN) -- ราคาเสนอเพื่อยุติการยืนหยัดของวุฒิสภาเหนือประธานาธิบดี บุช บุช ตัดสิน ช่วยให้ผู้ได้รับการเสนอชื่อเข้าชิงตำแหน่ง 5 คนสามารถโหวตขั้นสุดท้ายได้ในขณะที่ยังรักษา&<>...><> |
แท็กย่อยของ | R |
รูปแบบเนื้อหา | ข้อความ (HTML) |
SL_MAIN | |
---|---|
คำจำกัดความ | แท็กนี้สรุปเนื้อหาของผลลัพธ์โปรโมชัน ใช้เพื่อแยกวิเคราะห์โปรโมชัน ข้อความ Anchor และ URL ของลิงก์ชื่อจะอยู่ในแท็กย่อย T และ U ตามลำดับ บรรทัดของข้อความและลิงก์ของเนื้อหาจะอยู่ในแท็กย่อย BODY_LINE |
แท็กย่อย | BODY_LINE*, T, U |
แท็กย่อยของ | SL_RESULTS |
รูปแบบเนื้อหา | ว่าง |
SL_RESULTS | |
---|---|
คำจำกัดความ | คอนเทนเนอร์แท็กสำหรับผลการค้นหาที่โปรโมต โฆษณาประเภทใดประเภทหนึ่งจะปรากฏเมื่อใดก็ตามที่คุณมีโปรโมชันในผลการค้นหา แท็กย่อย SL_MAIN มีข้อมูลผลการค้นหาหลัก |
แท็กย่อย | SL_MAIN* |
แท็กย่อยของ | R |
รูปแบบเนื้อหา | ว่าง |
การสะกด | |
---|---|
คำจำกัดความ | แท็ก <Spelling> สรุปคำแนะนำการสะกดคำแบบอื่นสำหรับคำค้นหาที่ส่ง แท็กนี้จะปรากฏเฉพาะในหน้าแรกของผลการค้นหา คำแนะนำการสะกดมีให้บริการในภาษาอังกฤษ จีน ญี่ปุ่น และเกาหลี หมายเหตุ: Google จะแสดงเฉพาะคำแนะนำการสะกดสำหรับคำค้นหาที่ค่าพารามิเตอร์ gl เป็นอักษรตัวพิมพ์เล็กเท่านั้น |
ตัวอย่าง | <Spelling> |
แท็กย่อย | คำแนะนำ |
แท็กย่อยของ | GSP |
รูปแบบเนื้อหา | ว่าง |
คำแนะนำ | |||||||
---|---|---|---|---|---|---|---|
คำจำกัดความ | แท็ก <Suggestion> มีคำแนะนำการสะกดแบบอื่นสำหรับคำค้นหาที่ส่ง คุณใช้เนื้อหาของแท็กเพื่อแนะนำการสะกดแบบอื่นแก่ผู้ใช้การค้นหาได้ ค่าของแอตทริบิวต์ q คือคำแนะนำการสะกดคำที่ใช้อักขระหลีกกับ URL ซึ่งคุณใช้เป็นข้อความค้นหาได้ | ||||||
แอตทริบิวต์ |
|
||||||
ตัวอย่าง | <Suggestion q="soccer"><b><i>ฟุตบอล</i></b></Suggestion> | ||||||
แท็กย่อยของ | การสะกด | ||||||
รูปแบบเนื้อหา | ข้อความ (HTML) |
T | |
---|---|
คำจำกัดความ | แท็ก <T> มีชื่อของผลลัพธ์ |
ตัวอย่าง | <T>ร้านพิซซ่าอะมิซีส์ อีสต์โคสต์</T> |
แท็กย่อยของ | R |
รูปแบบเนื้อหา | ข้อความ (HTML) |
title | |
---|---|
คำจำกัดความ | ในฐานะลูกของ <Context> แท็ก <title> จะมีชื่อของ Programmable Search Engine ในฐานะย่อยของ <Facet> แท็ก <title> จะให้ชื่อของชุด Facet |
ตัวอย่าง | ในฐานะลูกของ <Context>: <title>เครื่องมือค้นหาของฉัน</title> เป็นบุตรหลานของ <Facet>: <title>facet title</title> |
แท็กย่อยของ | บริบท, ข้อมูลประกอบ |
รูปแบบเนื้อหา | ข้อความ |
TM | |
---|---|
คำจำกัดความ | แท็ก <TM> ระบุเวลารวมของเซิร์ฟเวอร์ที่ต้องใช้ในการแสดงผลการค้นหา โดยวัดเป็นวินาที |
ตัวอย่าง | <TM>0.100445</TM> |
แท็กย่อยของ | GSP |
รูปแบบเนื้อหา | ข้อความ (หมายเลขจุดลอย) |
TT | |
---|---|
คำจำกัดความ | แท็ก <TT> มีเคล็ดลับ ในการค้นหา |
ตัวอย่าง | <TT>>เคล็ดลับ: สำหรับเบราว์เซอร์ส่วนใหญ่ การกดแป้น Return จะให้ผลลัพธ์เดียวกับการคลิกปุ่มค้นหา</i></TT> |
แท็กย่อยของ | GSP |
U | |
---|---|
คำจำกัดความ | แท็ก <U> ระบุ URL ของผลการค้นหา |
ตัวอย่าง | <U>http://www.dominos.com/</U> |
แท็กย่อยของ | R |
รูปแบบเนื้อหา | ข้อความ (URL ที่สมบูรณ์) |
UDID | |
---|---|
คำจำกัดความ | แท็ก <UD> ระบุ URL ที่เข้ารหัส IDN (ชื่อโดเมนสากล) สำหรับผลการค้นหา ค่านี้ช่วยให้โดเมนแสดงโดยใช้ภาษาท้องถิ่นได้ เช่น ระบบอาจถอดรหัส http://www.%E8%8A%B1%E4%BA%95.com URL ที่เข้ารหัส IDN และแสดงเป็น http://www.花\r鮨.com. แท็ก <UD> นี้จะรวมอยู่ในผลการค้นหาของคําขอที่มีพารามิเตอร์ ud เท่านั้น หมายเหตุ: ฟีเจอร์นี้อยู่ในเวอร์ชันเบต้า |
ตัวอย่าง | <UD>http://www.%E8%8A%B1%E4%BA%95.com/</UD> |
แท็กย่อยของ | R |
รูปแบบเนื้อหา | ข้อความ (URL ที่เข้ารหัส IDN) |
UE | |
---|---|
คำจำกัดความ | แท็ก <UE> ระบุ URL ของผลการค้นหา ค่านี้ใช้ Escape กับ URL เพื่อให้เหมาะสำหรับการส่งเป็นพารามิเตอร์การค้นหาใน URL |
ตัวอย่าง | <UE>http://www.dominos.com/</UE> |
แท็กย่อยของ | R |
รูปแบบเนื้อหา | ข้อความ (URL ที่ใช้อักขระหลีกกับ URL) |
XT | |
---|---|
คำจำกัดความ | แท็ก <XT> บ่งบอกว่าจำนวนผลลัพธ์ทั้งหมดโดยประมาณ ตามที่ระบุโดยแท็ก M แต่ที่จริงแล้วแสดงจำนวนผลลัพธ์ทั้งหมด ดูรายละเอียดเพิ่มเติมได้ที่ส่วนการกรองอัตโนมัติของเอกสารนี้ |
ตัวอย่าง | <XT/ |
แท็กย่อยของ | RES |
รูปแบบเนื้อหา | ว่าง |
ผลลัพธ์ XML สำหรับคำค้นหารูปภาพ
คำขอรูปภาพตัวอย่างนี้ขอผลลัพธ์ 5 รายการ (ตัวเลข=5) เกี่ยวกับข้อความค้นหา "monkey" (q=monkey)
http://www.google.com/cse? searchtype=image &num=2 &q=monkey &client=google-csbe &output=xml_no_dtd &cx=00255077836266642015:u-scht7a-8i
คำขอนี้แสดงผลลัพธ์ XML ด้านล่าง
<GSP VER="3.2"> <TM>0.395037</TM> <Q>monkeys</Q> <PARAM name="cx" value="011737558837375720776:mbfrjmyam1g" original_value="011737558837375720776:mbfrjmyam1g" url_<escaped_value="011737558837375720776%3Ambfrjmyam1g" js_escaped_value="011737558837375720776:mbfrjmyam1g"/> <PARAM name="client" value="google-csbe" original_value="google-csbe" url_escaped_value="google-csbe" js_escaped_value="google-csbe"/> <PARAM name="q" value="monkeys" original_value="monkeys" url_escaped_value="monkeys" js_escaped_value="monkeys"/> <PARAM name="num" value="2" original_value="2" url_escaped_value="2" js_escaped_value="2"/> <PARAM name="output" value="xml_no_dtd" original_value="xml_no_dtd" url_escaped_value="xml_no_dtd" js_escaped_value="xml_no_dtd"/> <PARAM name="adkw" value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" original_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" url_escaped_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" js_escaped_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A"/> <PARAM name="hl" value="en" original_value="en" url_escaped_value="en" js_escaped_value="en"/> <PARAM name="oe" value="UTF-8" original_value="UTF-8" url_escaped_value="UTF-8" js_escaped_value="UTF-8"/> <PARAM name="ie" value="UTF-8" original_value="UTF-8" url_escaped_value="UTF-8" js_escaped_value="UTF-8"/> <PARAM name="boostcse" value="0" original_value="0" url_escaped_value="0" js_escaped_value="0"/> <Context> <title>domestigeek</title> </Context> <ARES/> <RES SN="1" EN="2"> <M>2500000</M> <NB> <NU>/images?q=monkeys&num=2&hl=en&client=google-csbe&cx=011737558837375720776:mbfrjmyam1g&boostcse=0&output=xml_no_dtd &ie=UTF-8&oe=UTF-8&tbm=isch&ei=786oTsLiJaaFiALKrPChBg&start=2&sa=N </NU> </NB> <RG START="1" SIZE="2"/> <R N="1" MIME="image/jpeg"> <RU>http://www.flickr.com/photos/fncll/135465558/</RU> <U> http://farm1.static.flickr.com/46/135465558_123402af8c.jpg </U> <UE> http://farm1.static.flickr.com/46/135465558_123402af8c.jpg </UE> <T>Computer <b>Monkeys</b> | Flickr - Photo Sharing!</T> <RK>0</RK> <BYLINEDATE>1146034800</BYLINEDATE> <S>Computer <b>Monkeys</b> | Flickr</S> <LANG>en</LANG> <IMG WH="500" HT="305" IID="ANd9GcQARKLwzi-t4lpWi2AERV3kJb4ansaQzTn3MNDZR9fD_JDiktPKByKUBLs"> <SZ>88386</SZ> <IN/> </IMG> <TBN TYPE="0" WH="130" HT="79" URL="http://t0.gstatic.com/images?q=tbn:ANd9GcQARKLwzi- t4lpWi2AERV3kJb4ansaQzTn3MNDZR9fD_JDiktPKByKUBLs"/> </R> <R N="2" MIME="image/jpeg"> <RU> http://www.flickr.com/photos/flickerbulb/187044366/ </RU> <U> http://farm1.static.flickr.com/73/187044366_506a1933f4.jpg </U> <UE> http://farm1.static.flickr.com/73/187044366_506a1933f4.jpg </UE> <T> one. ugly. <b>monkey</b>. | Flickr - Photo Sharing! </T> <RK>0</RK> <BYLINEDATE>1152514800</BYLINEDATE> <S>one. ugly. <b>monkey</b>.</S> <LANG>en</LANG> <IMG WH="400" HT="481" IID="ANd9GcQ3Qom0bYbee4fThCQVi96jMEwMU6IvVf2b8K5vERKVw- EF4tQQnDDKOq0"><SZ>58339</SZ> <IN/> </IMG> <TBN TYPE="0" WH="107" HT="129" URL="http://t1.gstatic.com/images?q=tbn:ANd9GcQ3Qom0bYbee4fThCQ Vi96jMEwMU6IvVf2b8K5vERKVw-EF4tQQnDDKOq0"/> </R> </RES> </GSP>
ค้นหารูปภาพ: แท็ก XML
ตารางด้านล่างแสดงแท็ก XML เพิ่มเติมที่ใช้ในการตอบสนอง XML สำหรับคำค้นหารูปภาพ
สัญลักษณ์บางอย่างอาจแสดงถัดจากแท็กย่อยบางรายการในคำจำกัดความด้านล่าง สัญลักษณ์และความหมายของสัญลักษณ์มีดังนี้
* = อินสแตนซ์ของแท็กย่อยเป็นศูนย์หรือมากกว่า
+ = อินสแตนซ์ของแท็กย่อยอย่างน้อย 1 อินสแตนซ์
สาย RG | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
คำจำกัดความ | แท็ก <RG> ระบุรายละเอียดของผลการค้นหารูปภาพแต่ละรายการ |
|||||||||
แอตทริบิวต์ |
| |||||||||
แท็กย่อยของ | RES |
RU | |
---|---|
คำจำกัดความ | แท็ก <RU tag> ระบุรายละเอียดผลการค้นหารูปภาพแต่ละรายการ |
แท็กย่อยของ | R |