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