ตอบกลับคำขอการค้นหาที่กำหนดเอง
| การแสดง JSON |
|---|
{ "kind": string, "url": { "type": string, "template": string }, "queries": { "previousPage": [ { "title": string, "totalResults": string, "searchTerms": string, "count": integer, "startIndex": integer, "startPage": integer, "language": string, "inputEncoding": string, "outputEncoding": string, "safe": string, "cx": string, "sort": string, "filter": string, "gl": string, "cr": string, "googleHost": string, "disableCnTwTranslation": string, "hq": string, "hl": string, "siteSearch": string, "siteSearchFilter": string, "exactTerms": string, "excludeTerms": string, "linkSite": string, "orTerms": string, "relatedSite": string, "dateRestrict": string, "lowRange": string, "highRange": string, "fileType": string, "rights": string, "searchType": string, "imgSize": string, "imgType": string, "imgColorType": string, "imgDominantColor": string } ], "request": [ { "title": string, "totalResults": string, "searchTerms": string, "count": integer, "startIndex": integer, "startPage": integer, "language": string, "inputEncoding": string, "outputEncoding": string, "safe": string, "cx": string, "sort": string, "filter": string, "gl": string, "cr": string, "googleHost": string, "disableCnTwTranslation": string, "hq": string, "hl": string, "siteSearch": string, "siteSearchFilter": string, "exactTerms": string, "excludeTerms": string, "linkSite": string, "orTerms": string, "relatedSite": string, "dateRestrict": string, "lowRange": string, "highRange": string, "fileType": string, "rights": string, "searchType": string, "imgSize": string, "imgType": string, "imgColorType": string, "imgDominantColor": string } ], "nextPage": [ { "title": string, "totalResults": string, "searchTerms": string, "count": integer, "startIndex": integer, "startPage": integer, "language": string, "inputEncoding": string, "outputEncoding": string, "safe": string, "cx": string, "sort": string, "filter": string, "gl": string, "cr": string, "googleHost": string, "disableCnTwTranslation": string, "hq": string, "hl": string, "siteSearch": string, "siteSearchFilter": string, "exactTerms": string, "excludeTerms": string, "linkSite": string, "orTerms": string, "relatedSite": string, "dateRestrict": string, "lowRange": string, "highRange": string, "fileType": string, "rights": string, "searchType": string, "imgSize": string, "imgType": string, "imgColorType": string, "imgDominantColor": string } ] }, "promotions": [ { object ( |
| ช่อง | |
|---|---|
kind |
ตัวระบุที่ไม่ซ้ำกันสำหรับประเภทออบเจ็กต์ปัจจุบัน สำหรับ API นี้จะเป็น customsearch#search |
url |
องค์ประกอบ URL ของ OpenSearch ที่กำหนดเทมเพลตสำหรับ API นี้ |
url.type |
ประเภท MIME ของเทมเพลต URL ของ OpenSearch สำหรับ Custom Search JSON API |
url.template |
เทมเพลต OpenSearch จริงสำหรับ API นี้ |
queries |
ประกอบด้วยข้อมูลเมตาของการค้นหาอย่างน้อย 1 ชุดโดยคีย์ตามชื่อบทบาท ชื่อบทบาทที่เป็นไปได้ประกอบด้วย |
queries.previousPage[] |
ข้อมูลเมตาที่แสดงหน้าผลลัพธ์ก่อนหน้า หากมี |
queries.previousPage[].title |
คำอธิบายของการค้นหา |
queries.previousPage[].totalResults |
จำนวนผลการค้นหาทั้งหมดโดยประมาณ อาจไม่ถูกต้อง |
queries.previousPage[].searchTerms |
ข้อความค้นหาที่ผู้ใช้ป้อน |
queries.previousPage[].count |
จำนวนผลการค้นหาที่แสดงในชุดนี้ |
queries.previousPage[].startIndex |
ดัชนีของชุดผลการค้นหาปัจจุบันในชุดผลการค้นหาทั้งหมด โดยที่ดัชนีของผลลัพธ์แรกคือ 1 |
queries.previousPage[].startPage |
หมายเลขหน้าของผลการค้นหาชุดนี้ ซึ่งกำหนดความยาวของหน้าโดยพร็อพเพอร์ตี้ |
queries.previousPage[].language |
ภาษาของผลการค้นหา |
queries.previousPage[].inputEncoding |
การเข้ารหัสอักขระที่รองรับสำหรับคำขอการค้นหา |
queries.previousPage[].outputEncoding |
การเข้ารหัสอักขระที่สนับสนุนสำหรับผลการค้นหา |
queries.previousPage[].safe |
ระบุระดับค้นหาปลอดภัยที่ใช้ในการกรองผลลัพธ์สำหรับผู้ใหญ่ออก พร็อพเพอร์ตี้นี้เป็นพร็อพเพอร์ตี้ที่กำหนดเองซึ่งไม่ได้ระบุไว้ในข้อกำหนดของ OpenSearch ค่าพารามิเตอร์ที่ถูกต้อง ได้แก่
|
queries.previousPage[].cx |
ตัวระบุของเครื่องมือค้นหาที่สร้างขึ้นโดยใช้แผงควบคุมของ Programmable Search Engine พร็อพเพอร์ตี้นี้เป็นพร็อพเพอร์ตี้ที่กำหนดเองซึ่งไม่ได้ระบุไว้ในข้อกำหนดของ OpenSearch ต้องระบุพารามิเตอร์นี้ |
queries.previousPage[].sort |
ระบุว่าผลลัพธ์ควรจัดเรียงตามนิพจน์ที่ระบุ เช่น จัดเรียงตามวันที่ |
queries.previousPage[].filter |
เปิดหรือปิดใช้งานการกรองอัตโนมัติสำหรับผลการค้นหาของ Google ดูการกรองอัตโนมัติสำหรับข้อมูลเพิ่มเติมเกี่ยวกับตัวกรองผลการค้นหาของ Google ค่าที่ถูกต้องสำหรับพารามิเตอร์นี้คือ
หมายเหตุ: โดยค่าเริ่มต้น Google จะใช้การกรองกับผลการค้นหาทั้งหมดเพื่อปรับปรุงคุณภาพของผลการค้นหาเหล่านั้น |
queries.previousPage[].gl |
บูสต์ผลการค้นหาที่ประเทศต้นทางตรงกับค่าพารามิเตอร์ โปรดดูรายการค่าที่ถูกต้องในรหัสประเทศ การระบุค่าพารามิเตอร์ |
queries.previousPage[].cr |
จำกัดผลการค้นหาเฉพาะเอกสารที่มาจากประเทศที่กำหนด คุณจะใช้โอเปอเรเตอร์บูลีนในค่าพารามิเตอร์ Google WebSearch ระบุประเทศของเอกสารด้วยการวิเคราะห์ข้อมูลต่อไปนี้
โปรดดูค่าพารามิเตอร์ประเทศ (cr) สำหรับรายการค่าที่ถูกต้องสำหรับพารามิเตอร์นี้ |
queries.previousPage[].googleHost |
ระบุโดเมน Google (เช่น google.com, google.de หรือ google.fr) ที่ควรจำกัดการค้นหา |
queries.previousPage[].disableCnTwTranslation |
เปิดหรือปิดใช้ฟีเจอร์การค้นหาภาษาจีนตัวย่อและตัวเต็ม ค่าที่รองรับมีดังนี้
|
queries.previousPage[].hq |
นำคำค้นหาที่ระบุต่อท้ายคำค้นหา ราวกับว่ามีการรวมกับโอเปอเรเตอร์ |
queries.previousPage[].hl |
ระบุภาษาอินเทอร์เฟซ (ภาษาโฮสต์) ของอินเทอร์เฟซผู้ใช้ การตั้งค่าพารามิเตอร์นี้อย่างชัดแจ้งจะช่วยปรับปรุงประสิทธิภาพและคุณภาพของผลการค้นหา ดูข้อมูลเพิ่มเติมได้ที่ส่วนภาษาอินเทอร์เฟซของการค้นหาเป็นสากลและการนำเสนอผลลัพธ์ และดูภาษาของอินเทอร์เฟซที่รองรับเพื่อดูรายการภาษาที่รองรับ |
queries.previousPage[].siteSearch |
จำกัดผลการค้นหาเฉพาะ URL จากเว็บไซต์ที่ระบุ |
queries.previousPage[].siteSearchFilter |
ระบุว่าจะรวมหรือยกเว้นผลการค้นหาจากเว็บไซต์ที่มีชื่อในพารามิเตอร์
|
queries.previousPage[].exactTerms |
ระบุวลีที่เอกสารทั้งหมดในผลการค้นหาต้องมี |
queries.previousPage[].excludeTerms |
ระบุคำหรือวลีที่ไม่ควรปรากฏในเอกสารใดๆ ในผลการค้นหา |
queries.previousPage[].linkSite |
ระบุว่าผลลัพธ์ทั้งหมดควรมีลิงก์ไปยัง URL ที่ระบุ |
queries.previousPage[].orTerms |
ระบุข้อความค้นหาเพิ่มเติมที่ต้องตรวจสอบในเอกสาร โดยเอกสารแต่ละรายการในผลการค้นหาต้องมีคำค้นหาเพิ่มเติมอย่างน้อย 1 รายการ คุณยังสามารถใช้คำค้นหาบูลีน OR สำหรับคำค้นหาประเภทนี้ได้ด้วย |
queries.previousPage[].relatedSite |
ระบุว่าผลการค้นหาทั้งหมดควรเป็นหน้าที่เกี่ยวข้องกับ URL ที่ระบุ ค่าพารามิเตอร์ควรเป็น URL |
queries.previousPage[].dateRestrict |
จำกัดผลการค้นหาให้แสดงเฉพาะ URL ตามวันที่ ค่าที่รองรับมีดังนี้
|
queries.previousPage[].lowRange |
ระบุค่าเริ่มต้นสำหรับช่วงการค้นหา ใช้ |
queries.previousPage[].highRange |
ระบุค่าสิ้นสุดสำหรับช่วงการค้นหา ใช้ |
queries.previousPage[].fileType |
จำกัดผลการค้นหาเฉพาะไฟล์ที่มีนามสกุลที่ระบุ ประเภทไฟล์ที่ Google รองรับมีดังนี้
อาจมีการเพิ่มประเภทไฟล์อื่นๆ ในอนาคต คุณดูรายการที่อัปเดตได้ทุกเมื่อในคำถามที่พบบ่อยเกี่ยวกับประเภทไฟล์ของ Google |
queries.previousPage[].rights |
ตัวกรองตามการอนุญาตให้ใช้สิทธิ ค่าที่รองรับมีดังนี้
|
queries.previousPage[].searchType |
ค่าที่อนุญาตคือ |
queries.previousPage[].imgSize |
จำกัดผลการค้นหาเฉพาะภาพที่มีขนาดที่ระบุ ค่าที่รองรับมีดังนี้
|
queries.previousPage[].imgType |
จำกัดผลการค้นหาเฉพาะภาพประเภทที่ระบุ ค่าที่รองรับมีดังนี้
|
queries.previousPage[].imgColorType |
จำกัดผลการค้นหาเฉพาะภาพประเภทสีที่ระบุ ค่าที่รองรับมีดังนี้
|
queries.previousPage[].imgDominantColor |
จำกัดผลลัพธ์สำหรับรูปภาพที่มีสีเฉพาะที่โดดเด่นเท่านั้น ค่าที่รองรับมีดังนี้
|
queries.request[] |
ข้อมูลเมตาที่แสดงถึงคำขอปัจจุบัน |
queries.request[].title |
คำอธิบายของการค้นหา |
queries.request[].totalResults |
จำนวนผลการค้นหาทั้งหมดโดยประมาณ อาจไม่ถูกต้อง |
queries.request[].searchTerms |
ข้อความค้นหาที่ผู้ใช้ป้อน |
queries.request[].count |
จำนวนผลการค้นหาที่แสดงในชุดนี้ |
queries.request[].startIndex |
ดัชนีของชุดผลการค้นหาปัจจุบันในชุดผลการค้นหาทั้งหมด โดยที่ดัชนีของผลลัพธ์แรกคือ 1 |
queries.request[].startPage |
หมายเลขหน้าของผลการค้นหาชุดนี้ ซึ่งกำหนดความยาวของหน้าโดยพร็อพเพอร์ตี้ |
queries.request[].language |
ภาษาของผลการค้นหา |
queries.request[].inputEncoding |
การเข้ารหัสอักขระที่รองรับสำหรับคำขอการค้นหา |
queries.request[].outputEncoding |
การเข้ารหัสอักขระที่สนับสนุนสำหรับผลการค้นหา |
queries.request[].safe |
ระบุระดับค้นหาปลอดภัยที่ใช้ในการกรองผลลัพธ์สำหรับผู้ใหญ่ออก พร็อพเพอร์ตี้นี้เป็นพร็อพเพอร์ตี้ที่กำหนดเองซึ่งไม่ได้ระบุไว้ในข้อกำหนดของ OpenSearch ค่าพารามิเตอร์ที่ถูกต้อง ได้แก่
|
queries.request[].cx |
ตัวระบุของเครื่องมือค้นหาที่สร้างขึ้นโดยใช้แผงควบคุมของ Programmable Search Engine พร็อพเพอร์ตี้นี้เป็นพร็อพเพอร์ตี้ที่กำหนดเองซึ่งไม่ได้ระบุไว้ในข้อกำหนดของ OpenSearch ต้องระบุพารามิเตอร์นี้ |
queries.request[].sort |
ระบุว่าผลลัพธ์ควรจัดเรียงตามนิพจน์ที่ระบุ เช่น จัดเรียงตามวันที่ |
queries.request[].filter |
เปิดหรือปิดใช้งานการกรองอัตโนมัติสำหรับผลการค้นหาของ Google ดูการกรองอัตโนมัติสำหรับข้อมูลเพิ่มเติมเกี่ยวกับตัวกรองผลการค้นหาของ Google ค่าที่ถูกต้องสำหรับพารามิเตอร์นี้คือ
หมายเหตุ: โดยค่าเริ่มต้น Google จะใช้การกรองกับผลการค้นหาทั้งหมดเพื่อปรับปรุงคุณภาพของผลการค้นหาเหล่านั้น |
queries.request[].gl |
บูสต์ผลการค้นหาที่ประเทศต้นทางตรงกับค่าพารามิเตอร์ โปรดดูรายการค่าที่ถูกต้องในรหัสประเทศ การระบุค่าพารามิเตอร์ |
queries.request[].cr |
จำกัดผลการค้นหาเฉพาะเอกสารที่มาจากประเทศที่กำหนด คุณจะใช้โอเปอเรเตอร์บูลีนในค่าพารามิเตอร์ Google WebSearch ระบุประเทศของเอกสารด้วยการวิเคราะห์ข้อมูลต่อไปนี้
โปรดดูค่าพารามิเตอร์ประเทศ (cr) สำหรับรายการค่าที่ถูกต้องสำหรับพารามิเตอร์นี้ |
queries.request[].googleHost |
ระบุโดเมน Google (เช่น google.com, google.de หรือ google.fr) ที่ควรจำกัดการค้นหา |
queries.request[].disableCnTwTranslation |
เปิดหรือปิดใช้ฟีเจอร์การค้นหาภาษาจีนตัวย่อและตัวเต็ม ค่าที่รองรับมีดังนี้
|
queries.request[].hq |
นำคำค้นหาที่ระบุต่อท้ายคำค้นหา ราวกับว่ามีการรวมกับโอเปอเรเตอร์ |
queries.request[].hl |
ระบุภาษาอินเทอร์เฟซ (ภาษาโฮสต์) ของอินเทอร์เฟซผู้ใช้ การตั้งค่าพารามิเตอร์นี้อย่างชัดแจ้งจะช่วยปรับปรุงประสิทธิภาพและคุณภาพของผลการค้นหา ดูข้อมูลเพิ่มเติมได้ที่ส่วนภาษาอินเทอร์เฟซของการค้นหาเป็นสากลและการนำเสนอผลลัพธ์ และดูภาษาของอินเทอร์เฟซที่รองรับเพื่อดูรายการภาษาที่รองรับ |
queries.request[].siteSearch |
จำกัดผลการค้นหาเฉพาะ URL จากเว็บไซต์ที่ระบุ |
queries.request[].siteSearchFilter |
ระบุว่าจะรวมหรือยกเว้นผลการค้นหาจากเว็บไซต์ที่มีชื่อในพารามิเตอร์
|
queries.request[].exactTerms |
ระบุวลีที่เอกสารทั้งหมดในผลการค้นหาต้องมี |
queries.request[].excludeTerms |
ระบุคำหรือวลีที่ไม่ควรปรากฏในเอกสารใดๆ ในผลการค้นหา |
queries.request[].linkSite |
ระบุว่าผลลัพธ์ทั้งหมดควรมีลิงก์ไปยัง URL ที่ระบุ |
queries.request[].orTerms |
ระบุข้อความค้นหาเพิ่มเติมที่ต้องตรวจสอบในเอกสาร โดยเอกสารแต่ละรายการในผลการค้นหาต้องมีคำค้นหาเพิ่มเติมอย่างน้อย 1 รายการ คุณยังสามารถใช้คำค้นหาบูลีน OR สำหรับคำค้นหาประเภทนี้ได้ด้วย |
queries.request[].relatedSite |
ระบุว่าผลการค้นหาทั้งหมดควรเป็นหน้าที่เกี่ยวข้องกับ URL ที่ระบุ ค่าพารามิเตอร์ควรเป็น URL |
queries.request[].dateRestrict |
จำกัดผลการค้นหาให้แสดงเฉพาะ URL ตามวันที่ ค่าที่รองรับมีดังนี้
|
queries.request[].lowRange |
ระบุค่าเริ่มต้นสำหรับช่วงการค้นหา ใช้ |
queries.request[].highRange |
ระบุค่าสิ้นสุดสำหรับช่วงการค้นหา ใช้ |
queries.request[].fileType |
จำกัดผลการค้นหาเฉพาะไฟล์ที่มีนามสกุลที่ระบุ ประเภทไฟล์ที่ Google รองรับมีดังนี้
อาจมีการเพิ่มประเภทไฟล์อื่นๆ ในอนาคต คุณดูรายการที่อัปเดตได้ทุกเมื่อในคำถามที่พบบ่อยเกี่ยวกับประเภทไฟล์ของ Google |
queries.request[].rights |
ตัวกรองตามการอนุญาตให้ใช้สิทธิ ค่าที่รองรับมีดังนี้
|
queries.request[].searchType |
ค่าที่อนุญาตคือ |
queries.request[].imgSize |
จำกัดผลการค้นหาเฉพาะภาพที่มีขนาดที่ระบุ ค่าที่รองรับมีดังนี้
|
queries.request[].imgType |
จำกัดผลการค้นหาเฉพาะภาพประเภทที่ระบุ ค่าที่รองรับมีดังนี้
|
queries.request[].imgColorType |
จำกัดผลการค้นหาเฉพาะภาพประเภทสีที่ระบุ ค่าที่รองรับมีดังนี้
|
queries.request[].imgDominantColor |
จำกัดผลลัพธ์สำหรับรูปภาพที่มีสีเฉพาะที่โดดเด่นเท่านั้น ค่าที่รองรับมีดังนี้
|
queries.nextPage[] |
ข้อมูลเมตาที่แทนผลลัพธ์หน้าถัดไป (หากมี) |
queries.nextPage[].title |
คำอธิบายของการค้นหา |
queries.nextPage[].totalResults |
จำนวนผลการค้นหาทั้งหมดโดยประมาณ อาจไม่ถูกต้อง |
queries.nextPage[].searchTerms |
ข้อความค้นหาที่ผู้ใช้ป้อน |
queries.nextPage[].count |
จำนวนผลการค้นหาที่แสดงในชุดนี้ |
queries.nextPage[].startIndex |
ดัชนีของชุดผลการค้นหาปัจจุบันในชุดผลการค้นหาทั้งหมด โดยที่ดัชนีของผลลัพธ์แรกคือ 1 |
queries.nextPage[].startPage |
หมายเลขหน้าของผลการค้นหาชุดนี้ ซึ่งกำหนดความยาวของหน้าโดยพร็อพเพอร์ตี้ |
queries.nextPage[].language |
ภาษาของผลการค้นหา |
queries.nextPage[].inputEncoding |
การเข้ารหัสอักขระที่รองรับสำหรับคำขอการค้นหา |
queries.nextPage[].outputEncoding |
การเข้ารหัสอักขระที่สนับสนุนสำหรับผลการค้นหา |
queries.nextPage[].safe |
ระบุระดับค้นหาปลอดภัยที่ใช้ในการกรองผลลัพธ์สำหรับผู้ใหญ่ออก พร็อพเพอร์ตี้นี้เป็นพร็อพเพอร์ตี้ที่กำหนดเองซึ่งไม่ได้ระบุไว้ในข้อกำหนดของ OpenSearch ค่าพารามิเตอร์ที่ถูกต้อง ได้แก่
|
queries.nextPage[].cx |
ตัวระบุของเครื่องมือค้นหาที่สร้างขึ้นโดยใช้แผงควบคุมของ Programmable Search Engine พร็อพเพอร์ตี้นี้เป็นพร็อพเพอร์ตี้ที่กำหนดเองซึ่งไม่ได้ระบุไว้ในข้อกำหนดของ OpenSearch ต้องระบุพารามิเตอร์นี้ |
queries.nextPage[].sort |
ระบุว่าผลลัพธ์ควรจัดเรียงตามนิพจน์ที่ระบุ เช่น จัดเรียงตามวันที่ |
queries.nextPage[].filter |
เปิดหรือปิดใช้งานการกรองอัตโนมัติสำหรับผลการค้นหาของ Google ดูการกรองอัตโนมัติสำหรับข้อมูลเพิ่มเติมเกี่ยวกับตัวกรองผลการค้นหาของ Google ค่าที่ถูกต้องสำหรับพารามิเตอร์นี้คือ
หมายเหตุ: โดยค่าเริ่มต้น Google จะใช้การกรองกับผลการค้นหาทั้งหมดเพื่อปรับปรุงคุณภาพของผลการค้นหาเหล่านั้น |
queries.nextPage[].gl |
บูสต์ผลการค้นหาที่ประเทศต้นทางตรงกับค่าพารามิเตอร์ โปรดดูรายการค่าที่ถูกต้องในรหัสประเทศ การระบุค่าพารามิเตอร์ |
queries.nextPage[].cr |
จำกัดผลการค้นหาเฉพาะเอกสารที่มาจากประเทศที่กำหนด คุณจะใช้โอเปอเรเตอร์บูลีนในค่าพารามิเตอร์ Google WebSearch ระบุประเทศของเอกสารด้วยการวิเคราะห์ข้อมูลต่อไปนี้
โปรดดูค่าพารามิเตอร์ประเทศ (cr) สำหรับรายการค่าที่ถูกต้องสำหรับพารามิเตอร์นี้ |
queries.nextPage[].googleHost |
ระบุโดเมน Google (เช่น google.com, google.de หรือ google.fr) ที่ควรจำกัดการค้นหา |
queries.nextPage[].disableCnTwTranslation |
เปิดหรือปิดใช้ฟีเจอร์การค้นหาภาษาจีนตัวย่อและตัวเต็ม ค่าที่รองรับมีดังนี้
|
queries.nextPage[].hq |
นำคำค้นหาที่ระบุต่อท้ายคำค้นหา ราวกับว่ามีการรวมกับโอเปอเรเตอร์ |
queries.nextPage[].hl |
ระบุภาษาอินเทอร์เฟซ (ภาษาโฮสต์) ของอินเทอร์เฟซผู้ใช้ การตั้งค่าพารามิเตอร์นี้อย่างชัดแจ้งจะช่วยปรับปรุงประสิทธิภาพและคุณภาพของผลการค้นหา ดูข้อมูลเพิ่มเติมได้ที่ส่วนภาษาอินเทอร์เฟซของการค้นหาเป็นสากลและการนำเสนอผลลัพธ์ และดูภาษาของอินเทอร์เฟซที่รองรับเพื่อดูรายการภาษาที่รองรับ |
queries.nextPage[].siteSearch |
จำกัดผลการค้นหาเฉพาะ URL จากเว็บไซต์ที่ระบุ |
queries.nextPage[].siteSearchFilter |
ระบุว่าจะรวมหรือยกเว้นผลการค้นหาจากเว็บไซต์ที่มีชื่อในพารามิเตอร์
|
queries.nextPage[].exactTerms |
ระบุวลีที่เอกสารทั้งหมดในผลการค้นหาต้องมี |
queries.nextPage[].excludeTerms |
ระบุคำหรือวลีที่ไม่ควรปรากฏในเอกสารใดๆ ในผลการค้นหา |
queries.nextPage[].linkSite |
ระบุว่าผลลัพธ์ทั้งหมดควรมีลิงก์ไปยัง URL ที่ระบุ |
queries.nextPage[].orTerms |
ระบุข้อความค้นหาเพิ่มเติมที่ต้องตรวจสอบในเอกสาร โดยเอกสารแต่ละรายการในผลการค้นหาต้องมีคำค้นหาเพิ่มเติมอย่างน้อย 1 รายการ คุณยังสามารถใช้คำค้นหาบูลีน OR สำหรับคำค้นหาประเภทนี้ได้ด้วย |
queries.nextPage[].relatedSite |
ระบุว่าผลการค้นหาทั้งหมดควรเป็นหน้าที่เกี่ยวข้องกับ URL ที่ระบุ ค่าพารามิเตอร์ควรเป็น URL |
queries.nextPage[].dateRestrict |
จำกัดผลการค้นหาให้แสดงเฉพาะ URL ตามวันที่ ค่าที่รองรับมีดังนี้
|
queries.nextPage[].lowRange |
ระบุค่าเริ่มต้นสำหรับช่วงการค้นหา ใช้ |
queries.nextPage[].highRange |
ระบุค่าสิ้นสุดสำหรับช่วงการค้นหา ใช้ |
queries.nextPage[].fileType |
จำกัดผลการค้นหาเฉพาะไฟล์ที่มีนามสกุลที่ระบุ ประเภทไฟล์ที่ Google รองรับมีดังนี้
อาจมีการเพิ่มประเภทไฟล์อื่นๆ ในอนาคต คุณดูรายการที่อัปเดตได้ทุกเมื่อในคำถามที่พบบ่อยเกี่ยวกับประเภทไฟล์ของ Google |
queries.nextPage[].rights |
ตัวกรองตามการอนุญาตให้ใช้สิทธิ ค่าที่รองรับมีดังนี้
|
queries.nextPage[].searchType |
ค่าที่อนุญาตคือ |
queries.nextPage[].imgSize |
จำกัดผลการค้นหาเฉพาะภาพที่มีขนาดที่ระบุ ค่าที่รองรับมีดังนี้
|
queries.nextPage[].imgType |
จำกัดผลการค้นหาเฉพาะภาพประเภทที่ระบุ ค่าที่รองรับมีดังนี้
|
queries.nextPage[].imgColorType |
จำกัดผลการค้นหาเฉพาะภาพประเภทสีที่ระบุ ค่าที่รองรับมีดังนี้
|
queries.nextPage[].imgDominantColor |
จำกัดผลลัพธ์สำหรับรูปภาพที่มีสีเฉพาะที่โดดเด่นเท่านั้น ค่าที่รองรับมีดังนี้
|
promotions[] |
ชุดของโปรโมชัน นำเสนอต่อเมื่อไฟล์การกำหนดค่าของ Custom Search Engine ระบุผลการค้นหาที่ได้รับการสนับสนุนสำหรับคำค้นหาดังกล่าวเท่านั้น |
context |
ข้อมูลเมตาและการปรับแต่งที่เกี่ยวข้องกับเครื่องมือค้นหาที่ระบุ ซึ่งรวมถึง:
|
searchInformation |
ข้อมูลเมตาเกี่ยวกับการค้นหานี้ รวมถึงเวลาที่ค้นหาและผลการค้นหาทั้งหมด |
searchInformation.searchTime |
เวลาที่เซิร์ฟเวอร์ใช้ในการแสดงผลการค้นหา |
searchInformation.formattedSearchTime |
เวลาที่เซิร์ฟเวอร์ใช้ในการแสดงผลการค้นหา ซึ่งอยู่ในรูปแบบตามสไตล์ภาษา |
searchInformation.totalResults |
จำนวนผลการค้นหาทั้งหมดที่แสดงจากข้อความค้นหา |
searchInformation.formattedTotalResults |
จำนวนผลการค้นหาทั้งหมด ซึ่งจัดรูปแบบตามสไตล์ภาษา |
spelling |
สรุปการค้นหาที่แก้ไขแล้ว |
spelling.correctedQuery |
คำค้นหาที่แก้ไขแล้ว |
spelling.htmlCorrectedQuery |
คำค้นหาที่แก้ไขแล้วซึ่งอยู่ในรูปแบบ HTML |
items[] |
ผลการค้นหาที่กำหนดเองชุดปัจจุบัน |
โปรโมชัน
ผลการโปรโมต
| การแสดง JSON |
|---|
{ "title": string, "htmlTitle": string, "link": string, "displayLink": string, "bodyLines": [ { "title": string, "htmlTitle": string, "url": string, "link": string } ], "image": { "source": string, "width": integer, "height": integer } } |
| ช่อง | |
|---|---|
title |
ชื่อของโปรโมชัน |
htmlTitle |
ชื่อของโปรโมชันในรูปแบบ HTML |
link |
URL ของโปรโมชัน |
displayLink |
URL ของผลการค้นหานี้ในรูปแบบย่อ เช่น www.example.com |
bodyLines[] |
อาร์เรย์ของออบเจ็กต์บล็อกสำหรับโปรโมชันนี้ |
bodyLines[].title |
ข้อความของออบเจ็กต์บล็อก หากมีข้อความ |
bodyLines[].htmlTitle |
ข้อความของออบเจ็กต์บล็อกใน HTML หากมีข้อความ |
bodyLines[].url |
URL ลิงก์ของออบเจ็กต์บล็อก (หากมี) |
bodyLines[].link |
Anchor Text ของลิงก์ของออบเจ็กต์บล็อก หากมีลิงก์ |
image |
รูปภาพที่เชื่อมโยงกับการโปรโมตนี้ หากมี |
image.source |
URL ของรูปภาพสำหรับลิงก์โปรโมชันนี้ |
image.width |
ความกว้างของรูปภาพเป็นพิกเซล |
image.height |
ความสูงของรูปภาพเป็นพิกเซล |
ผลลัพธ์
ผลการค้นหาที่กำหนดเอง
| การแสดง JSON |
|---|
{ "kind": string, "title": string, "htmlTitle": string, "link": string, "displayLink": string, "snippet": string, "htmlSnippet": string, "cacheId": string, "formattedUrl": string, "htmlFormattedUrl": string, "pagemap": { object }, "mime": string, "fileFormat": string, "image": { "contextLink": string, "height": integer, "width": integer, "byteSize": integer, "thumbnailLink": string, "thumbnailHeight": integer, "thumbnailWidth": integer }, "labels": [ { "name": string, "displayName": string, "label_with_op": string } ] } |
| ช่อง | |
|---|---|
kind |
ตัวระบุที่ไม่ซ้ำกันสำหรับประเภทออบเจ็กต์ปัจจุบัน สำหรับ API นี้จะเป็น |
title |
ชื่อของผลการค้นหาเป็นข้อความธรรมดา |
htmlTitle |
ชื่อของผลการค้นหาในรูปแบบ HTML |
link |
URL แบบเต็มที่ผลการค้นหาชี้ไป เช่น http://www.example.com/foo/bar. |
displayLink |
URL ของผลการค้นหานี้ในรูปแบบย่อ เช่น www.example.com |
snippet |
ตัวอย่างข้อมูลของผลการค้นหาในข้อความธรรมดา |
htmlSnippet |
ตัวอย่างข้อมูลของผลการค้นหา ใน HTML |
cacheId |
ระบุรหัสของผลการค้นหาเวอร์ชันที่แคชไว้ของ Google |
formattedUrl |
URL ที่แสดงหลังตัวอย่างข้อมูลของผลการค้นหาแต่ละรายการ |
htmlFormattedUrl |
URL รูปแบบ HTML ที่แสดงหลังตัวอย่างข้อมูลของผลการค้นหาแต่ละรายการ |
pagemap |
มีข้อมูล PageMap สำหรับผลการค้นหานี้ |
mime |
ประเภท MIME ของผลการค้นหา |
fileFormat |
รูปแบบไฟล์ของผลการค้นหา |
image |
สรุปข้อมูลทั้งหมดเกี่ยวกับรูปภาพที่ปรากฏในผลการค้นหา |
image.contextLink |
URL ที่ชี้ไปยังหน้าเว็บที่โฮสต์รูปภาพ |
image.height |
ความสูงของรูปภาพเป็นพิกเซล |
image.width |
ความกว้างของรูปภาพในหน่วยพิกเซล |
image.byteSize |
ขนาดของรูปภาพในหน่วยไบต์ |
image.thumbnailLink |
URL ไปยังภาพขนาดย่อ |
image.thumbnailHeight |
ความสูงของภาพขนาดย่อในหน่วยพิกเซล |
image.thumbnailWidth |
ความกว้างของรูปภาพขนาดย่อในหน่วยพิกเซล |
labels[] |
สรุปข้อมูลทั้งหมดเกี่ยวกับป้ายกำกับการปรับแต่ง |
labels[].name |
ชื่อของป้ายกำกับการปรับเกณฑ์การค้นหาที่คุณสามารถใช้เพื่อปรับแต่งการค้นหา ไม่แสดงข้อมูลนี้ในอินเทอร์เฟซผู้ใช้ของคุณ ให้ใช้ displayName แทน |
labels[].displayName |
ชื่อที่แสดงของป้ายกำกับการปรับแต่ง นี่คือชื่อที่คุณควรแสดงในอินเทอร์เฟซผู้ใช้ของคุณ |
labels[].label_with_op |
ป้ายกำกับการปรับแต่งและการดำเนินการปรับเกณฑ์การค้นหาที่เกี่ยวข้อง |