Method: cse.list

會傳回所執行搜尋的相關中繼資料、搜尋用引擎的中繼資料,以及搜尋結果。

HTTP 要求

GET https://customsearch.googleapis.com/customsearch/v1

這個網址使用 gRPC 轉碼語法。

查詢參數

參數
c2coff

string

啟用或停用「簡體中文搜尋」

這個參數的預設值為 0 (零),表示這項功能已啟用。支援的值如下:

  • 1:已停用

  • 0:已啟用 (預設)

cr

string

限制顯示來自特定國家/地區的文件搜尋結果。您可以在 cr 參數值中使用布林運算子

Google 搜尋會分析以下項目,判斷文件所屬國家/地區:

  • 文件網址的頂層網域 (TLD)

  • 網路伺服器 IP 位址的地理位置

如需這個參數的有效值清單,請參閱國家/地區參數值頁面。

cx

string

要用於這項要求的程式化搜尋引擎 ID。

dateRestrict

string

以日期來限制系統顯示網址的結果。支援的值包括:

  • d[number]:要求過去天數的結果。

  • w[number]:要求過去幾週的結果。

  • m[number]:要求過去幾個月的結果。

  • y[number]:要求以過去幾年指定數量的結果。

exactTerms

string

識別搜尋結果中所有文件都必須包含的詞組。

excludeTerms

string

識別不應出現在任何文件文件的字詞或詞組。

fileType

string

限制系統只傳回指定擴充功能檔案的結果。你可以在 Search Console 說明中心找到 Google 可建立索引的檔案類型清單。

filter

string

控管是否開啟重複內容篩選器。

  • 如要進一步瞭解 Google 的搜尋結果篩選器,請參閱自動篩選。請注意,主機群眾篩選功能僅適用於多網站搜尋。

  • 根據預設,Google 會對所有搜尋結果套用篩選功能,以改善這些搜尋結果的品質。

可接受的值為:

  • 0:關閉重複內容篩選器。

  • 1:啟用重複內容篩選器。

gl

string

使用者的地理位置。

  • gl 參數值為雙字母的國家/地區代碼。gl 參數會強化來源國家/地區與參數值相符的搜尋結果。如需有效值的清單,請參閱國家/地區代碼頁面。

  • 指定 gl 參數值應能帶來更相關的結果。對國際客戶而言更是如此,更明確地說,對於使用英語系國家/地區以外的客戶來說更是如此。

googlehost

string

已淘汰。使用 gl 參數即可產生類似效果。

執行搜尋時所用的當地 Google 網域 (例如 google.com、google.de 或 google.fr)。

highRange

string

指定搜尋範圍的結束值。

  • 使用 lowRangehighRange,在查詢中附加包含 lowRange...highRange 的搜尋範圍。
hl

string

設定使用者介面語言。

hq

string

將指定查詢字詞附加至查詢,如同與邏輯 AND 運算子合併一樣。

imgColorType

enum (ImgColorType)

傳回黑白、灰階、透明或彩色圖片。可接受的值為:

  • "color"

  • "gray"

  • "mono":黑白

  • "trans":透明背景

imgDominantColor

enum (ImgDominantColor)

傳回特定主色的圖片。可接受的值為:

  • "black"

  • "blue"

  • "brown"

  • "gray"

  • "green"

  • "orange"

  • "pink"

  • "purple"

  • "red"

  • "teal"

  • "white"

  • "yellow"

imgSize

enum (ImgSize)

傳回指定大小的圖片。可接受的值為:

  • "huge"

  • "icon"

  • "large"

  • "medium"

  • "small"

  • "xlarge"

  • "xxlarge"

imgType

enum (ImgType)

傳回特定類型的圖片。可接受的值為:

  • "clipart"

  • "face"

  • "lineart"

  • "stock"

  • "photo"

  • "animated"

lowRange

string

指定搜尋範圍的起始值。使用 lowRangehighRange,在查詢中附加包含 lowRange...highRange 的搜尋範圍。

lr

string

僅搜尋特定語言 (例如lr=lang_ja).

可接受的值為:

  • "lang_ar":阿拉伯文

  • "lang_bg":保加利亞文

  • "lang_ca":加泰隆尼亞文

  • "lang_cs":捷克文

  • "lang_da":丹麥文

  • "lang_de":德文

  • "lang_el":希臘文

  • "lang_en":英文

  • "lang_es":西班牙文

  • "lang_et":愛沙尼亞文

  • "lang_fi":芬蘭文

  • "lang_fr":法文

  • "lang_hr":克羅埃西亞文

  • "lang_hu":匈牙利文

  • "lang_id":印尼文

  • "lang_is":冰島文

  • "lang_it":義大利文

  • "lang_iw":希伯來文

  • "lang_ja":日文

  • "lang_ko":韓文

  • "lang_lt":立陶宛文

  • "lang_lv":拉脫維亞文

  • "lang_nl":荷蘭文

  • "lang_no":挪威文

  • "lang_pl":波蘭文

  • "lang_pt":葡萄牙文

  • "lang_ro":羅馬尼亞文

  • "lang_ru":俄文

  • "lang_sk":斯洛伐克文

  • "lang_sl":斯洛維尼亞文

  • "lang_sr":塞爾維亞文

  • "lang_sv":瑞典文

  • "lang_tr":土耳其文

  • "lang_zh-CN":中文 (簡體)

  • "lang_zh-TW":中文 (繁體)

num

integer

要傳回的搜尋結果數量。

  • 有效值是介於 1 到 10 (含首尾) 之間的整數。
orTerms

string

提供要在文件中尋找的其他搜尋字詞,讓搜尋結果中的每份文件必須包含至少一個其他搜尋字詞。

q

string

查詢

relatedSite
(deprecated)

string

已淘汰。

rights

string

依授權建立的篩選器。支援的值包括:cc_publicdomaincc_attributecc_sharealikecc_noncommercialcc_nonderived 及其組合。查看一般組合

safe

enum (Safe)

搜尋安全層級。可接受的值為:

  • "active":啟用安全搜尋篩選功能。

  • "off":停用安全搜尋篩選功能。(預設)

searchType

enum (SearchType)

指定搜尋類型:image。如果未指定,搜尋結果僅限於網頁。

可接受的值為:

  • "image":自訂圖片搜尋。
siteSearchFilter

enum (SiteSearchFilter)

控管要納入或排除 siteSearch 參數所命名網站的結果。

可接受的值為:

  • "e":排除

  • "i":加入

sort

string

要套用至結果的排序運算式。排序參數會指定根據指定運算式 (例如按日期排序) 排序結果。範例:Sort=date

start

integer (uint32 format)

要傳回的第一個結果的索引。每頁的預設結果數為 10,因此 &start=11 會從第二頁的頂端開始顯示。注意:即使有超過 100 份文件與查詢相符,JSON API 一律不會傳回超過 100 筆結果。因此,將 start + num 的總和設為大於 100 的數字會產生錯誤。另請注意,num 的最大值是 10。

要求主體

要求主體必須為空白。

回應主體

如果成功,回應主體會包含 Search 的執行例項。

授權範圍

需要下列 OAuth 範圍:

  • https://www.googleapis.com/auth/cse

詳情請參閱 OAuth 2.0 總覽