傳回執行搜尋的相關中繼資料、用於搜尋的搜尋引擎相關中繼資料,以及搜尋結果。使用少量網址模式。
HTTP 要求
GET https://customsearch.googleapis.com/customsearch/v1/siterestrict
這個網址使用 gRPC 轉碼語法。
查詢參數
參數 | |
---|---|
c2coff |
啟用或停用簡體中文和繁體中文版搜尋。 這項參數的預設值是 0,表示這項功能已啟用。支援的值如下:
|
cr |
將搜尋結果限制為來自特定國家/地區的文件。您可以在 cr 參數的值中使用 Boolean 運算子。 Google 搜尋透過以下方式判斷文件的國家/地區:
如需這個參數的有效值清單,請參閱國家/地區參數值。 |
cx |
要用於此要求的程式化搜尋引擎 ID。 |
dateRestrict |
根據日期限制搜尋結果範圍。支援的值包括:
|
exactTerms |
用於識別詞組中所有文件都必須包含的詞組。 |
excludeTerms |
識別不應在搜尋結果中出現在任何文件中的字詞或詞組。 |
fileType |
限制結果,只能在指定擴充功能的檔案中顯示。您可以在 Google Search Console 的說明中心查看 Google 可建立索引的檔案類型清單。 |
filter |
開啟或關閉重複內容篩選器。
可接受的值為:
|
gl |
使用者的地理位置。
|
googlehost |
已淘汰。請使用 用來執行搜尋的當地 Google 網域 (例如 google.com、google.de 或 google.fr)。 |
highRange |
指定搜尋範圍的結束值。
|
hl |
設定使用者介面語言。
|
hq |
將指定的查詢字詞附加至查詢,就像將字詞與邏輯 AND 運算子合併一樣。 |
imgColorType |
傳回黑白、灰階、透明或彩色圖片。可接受的值為:
|
imgDominantColor |
傳回特定主色圖像的圖片。可接受的值為:
|
imgSize |
傳回指定大小的圖片。可接受的值為:
|
imgType |
傳回類型的圖片。可接受的值為:
|
linkSite |
指定所有搜尋結果都應包含特定網址的連結。 |
lowRange |
指定搜尋範圍的起始值。使用 |
lr |
將搜尋範圍限定為以特定語言 (例如 可接受的值為:
|
num |
要傳回的搜尋結果數量。
|
orTerms |
提供其他文件可供查看的文件,文件中的每份文件都必須含有至少一個其他搜尋字詞。 |
q |
查詢 |
relatedSite |
指定所有搜尋結果都必須是與指定網址相關的網頁。 |
rights |
根據授權篩選。支援的值包括: |
safe |
搜尋安全層級。可接受的值為:
|
searchType |
指定搜尋類型: 可接受的值為:
|
siteSearch |
指定要一律從搜尋結果中納入或排除的指定網站 (請參閱下方的 |
siteSearchFilter |
控制是否要在 可接受的值為:
|
sort |
要套用至結果的排序運算式。排序參數會指定結果是依照指定的運算式排序,即依日期排序。範例:sort=date。 |
start |
第一個要傳回的結果的索引。每頁的預設結果數為 10,因此 |
要求主體
要求主體必須為空白。
回應主體
如果成功,回應主體會包含 Search
的執行例項。
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/cse
詳情請參閱 OAuth 2.0 總覽。