工具
兩個工具。助理會根據您的提問選擇參數;本頁說明它可以選擇什麼,以及會得到什麼回應。
| 工具 | 參數 | 用途 |
|---|---|---|
search |
query(必填)、rows、page、snippets |
以一般查詢語法搜尋網頁原始碼。rows 預設為 20,最多為您方案每次查詢的項數上限。snippets: true 會為每個網站附上最多三段符合位置附近的原始碼短片段(約 300 個字元)。 |
account |
無 | 方案、今日已用及剩餘的搜尋次數、每次查詢項數上限、速率限制。不消耗任何配額。 |
兩個工具都只能讀取。同一個回應會以兩種形式提供結果:給助理程式碼使用的結構化數據,以及給模型閱讀的 JSON 文字。
搜尋結果
{
"query": "\"angular.min.js\"",
"total": 73665,
"page": 1,
"rows": 3,
"returned": 3,
"truncated": false,
"index_complete": true,
"took_ms": 6,
"results": [
{ "domain": "imgbox.com", "url": "https://imgbox.com/", "rank": 4229 },
{ "domain": "uc.edu", "url": "https://www.uc.edu/", "rank": 5861 },
{ "domain": "sharemods.com", "url": "https://sharemods.com/", "rank": 10962 }
]
}
各欄位的含義與 API 中相同:
truncated:方案限制令本頁結果被縮短;index_complete: false:部分索引未能及時回應,因此total可能偏低;rank: null:該網站沒有排名;query_note:查詢被解讀的方式與原本寫法不同時出現。
使用 snippets: true 時,每項結果還會帶有 snippets,即一個最多包含三段符合位置附近原始碼字串的列表。這些是他人的程式碼,僅作為數據傳遞。
取得多於一頁的結果
page 及 rows 用於逐頁瀏覽結果:page: 2, rows: 20 即第 21 至 40 項結果。page 乘以 rows 不能超出您方案每次查詢的項數上限——請參閱限制與錯誤。