XML API 參考資料

本頁面說明 Custom Search JSON API 的 XML 版本,該 API 僅供 Google 站內搜尋客戶。

  1. 總覽
  2. 程式化搜尋引擎要求格式
    1. 要求總覽
    2. 查詢字詞
    3. 要求參數
      1. 網頁搜尋查詢範例
      2. WebSearch 查詢參數定義
      3. 進階搜尋
      4. 進階搜尋查詢參數
      5. 特殊查詢字詞
      6. 圖片查詢範例
      7. 圖片搜尋查詢參數
      8. 要求限制
    4. 國際化查詢和結果簡報
      1. 字元編碼
      2. 介面語言
      3. 簡體中文和繁體中文搜尋
    5. 篩選結果
      1. 自動篩選搜尋結果
      2. 語言與國家/地區篩選
      3. 使用安全搜尋過濾成人內容
  3. XML 結果
    1. Google XML 結果 DTD
    2. 關於 XML 回應
    3. 一般、圖片和 進階搜尋查詢
      1. 一般/進階搜尋:查詢範例和 XML 結果
      2. 一般/進階搜尋:XML 標記
      3. 圖片搜尋查詢的 XML 結果
      4. 圖片搜尋:查詢範例和 XML 結果
      5. 圖片搜尋:XML 標記

總覽

Google WebSearch 服務啟用 Google 站內搜尋 客戶在自家網站上顯示 Google 搜尋結果。 WebSearch 服務使用簡單的 HTTP 型通訊協定來提供搜尋 也就是預測結果搜尋管理員可全面掌控 要求搜尋結果,以及使用者將結果呈現給 而非個別使用者的帳戶本文件將介紹 搜尋要求和結果的格式

為了擷取 Google WebSearch 結果,應用程式會將 向 Google 發出簡單的 HTTP 要求接著 Google 會傳回 XML 格式的搜尋結果 格式。XML 格式的結果可讓您自訂 決定搜尋結果的顯示方式

WebSearch 要求格式

請求總覽

Google 搜尋要求是標準的 HTTP GET 指令。這項服務 包含一組與您業務相關的參數 舉個簡單的例子,您可以定義情境 並指示 AI 如何回應服務中心查詢這些參數會以 name=value 的形式包含在要求網址中 字元,並以連接號 (&) 分隔。參數包括 像是搜尋查詢和專屬引擎編號 (cx),用來識別 提供 HTTP 要求的 App Engine 範例WebSearch 或圖片搜尋服務會傳回 XML 會產生 HTTP 要求的回應。

查詢字詞

大多數搜尋要求都包含一或多個查詢字詞。查詢字詞 會顯示為參數的值

查詢字詞可以指定多種類型的資訊來篩選和 以便整理 Google 傳回的搜尋結果。查詢可以指定:

  • 要包含或排除的字詞或詞組 排除
    • 搜尋查詢中的所有字詞 (預設)
    • 搜尋查詢中的完全相符詞組
    • 搜尋查詢中的任何字詞或詞組
  • 文件中的哪個位置: 搜尋字詞
    • 文件中的任何位置 (預設)
    • 僅限文件內文
    • 僅限在文件標題中
    • 僅限文件網址
    • 僅限文件中的連結
  • 文件本身的限制
    • 加入或排除特定檔案類型的文件 (例如 PDF 檔案或 Word 文件)
  • 傳回的特殊網址查詢 特定網址的相關資訊,而不是搜尋
    • 會傳回網址一般資訊的查詢,例如 網站的 Open Directory 類別、程式碼片段或語言
    • 會回傳連至特定網址的一系列網頁的查詢
    • 會傳回一組與特定網址類似的網頁的查詢

預設搜尋

搜尋查詢參數值必須是網址逸出。請注意, 會以加號 (「+」) 取代 使用者的搜尋查詢。我們將在本文的「網址逸出」一節中進一步說明。

系統會使用 q 參數。A 罩杯 搜尋查詢的範例如下:

q=horses+cows+pigs

根據預設,Google WebSearch 服務只會傳回 在搜尋查詢中加入所有字詞。

要求參數

本節列出可用於建立行動應用程式或競價時可使用的參數 搜尋要求。參數會分成兩份清單,第一份清單內含與所有搜尋要求相關的參數。第二份清單包含 是 只與進階搜尋要求相關。

您必須提供以下三個要求參數:

  • client 參數必須設為 google-csbe
  • output 參數會指定 傳回的 XML 結果格式;結果可能會連同 (xml) 一併傳回 或不含 (xml_no_dtd) 指向 Google DTD 的參照。建議做法 將這個值設為 xml_no_dtd注意:如果未指定這個參數,系統就會在 而不是 XML。
  • cx 參數,代表不重複的 引擎的編號。

最常使用的請求參數 包括:

  • num:所要求的搜尋結果數量
  • q:搜尋字詞
  • start:結果的起始索引

網頁搜尋查詢範例

下列範例顯示幾個 WebSearch HTTP 要求 詳細介紹各種查詢參數的使用方式。「 不同的查詢參數在 WebSearch 查詢 參數定義和進階搜尋 參數」一節。

這項要求要求前 10 筆結果 (start=0&num=10) 針對查詢字詞「紅襪」(q=red+sox)。這個查詢也會 指定結果應來自加拿大網站 (cr=countryCA) 且應以法文 (lr=lang_fr) 撰寫。最後,查詢 指定 clientoutput 和 和 cx 參數,這三個是必要項目。

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 參數可啟用或停用簡化版 和繁體中文搜尋功能。

這個參數的預設值為 0 (零),也就是 即可使用這項功能c2coff 參數的值如下:

動作
1 已停用
0 已啟用
範例 q=google&c2coff=1

用戶端
說明

必填client 參數必須設為 google-csbe

範例 q=google&client=google-csbe

cr
說明

(選用) cr 參數會將搜尋結果限制為來自 特定國家/地區。您可以使用 Boolean 中的 cr 參數 值。

Google WebSearch 會根據 正在分析:

  • 文件網址的頂層網域 (TLD)
  • 網路伺服器 IP 位址的地理位置

請參閱國家/地區 (cr) 參數 值一節,查看這個參數的有效值清單。

範例 q=Frodo&cr=countryNZ

CX
說明

必填cx 參數可指定在 指出自訂程式碼 。您必須使用 cx 參數指定程式化搜尋引擎,才能從該引擎擷取搜尋結果。

如要查看 cx 參數的值,請前往「控制台」>「代碼 標籤,位於文字區域 到 [將此程式碼貼到要放置搜尋框的位置] 下方 顯示。搜尋結果會顯示在 Google 代管的網頁上。

範例 q=Frodo&cx=00255077836266642015:u-scht7a-8i

篩選器
說明

(選用) filter 參數會啟動或 停用 Google 搜尋結果的自動篩選功能。詳情請參閱下文的「自動篩選」一節 這份文件。

filter 參數的預設值為 1。 ,表示功能已啟用。此項目的有效值 參數如下:

動作
1 已停用
0 已啟用

注意:根據預設,Google 會將篩選功能套用至所有 來改進這些搜尋結果的品質

範例 q=google&filter=0

gl
說明

(選用) gl 參數值是 雙字母的國家/地區代碼。針對 WebSearch 結果,gl 參數會提高來源國家/地區與 參數值。如需有效值的清單,請參閱國家/地區代碼一節。

在 WebSearch 要求中指定 gl 參數值 可提高搜尋結果的關聯性這在 對國際客戶而言更是如此 美國以外國家/地區的英文客戶。

範例

這項要求會申請更多英國地區的文件 網頁搜尋結果:
q=pizza&gl=uk


hl
說明

(選用) hl 參數會指定 使用者介面的語言 (主機語言)。為了改善 廣告的成效和品質 強烈建議您明確設定這個參數。

請參閱國際化查詢介面語言部分 與結果簡報。支援的介面語言與 查看支援的語言清單

範例

這項要求指定法文的葡萄酒廣告。(Vin 是 法國「葡萄酒」一詞)。

q=vin&ip=10.10.10.10&ad=w5&hl=fr

hQ
說明

(選用) hq 參數會將指定查詢字詞附加至 就像使用邏輯 AND 運算子合併查詢一樣。

範例

這項要求會搜尋「披薩」然後加上「起司」;運算式與 q=pizza+cheese 相同。

q=pizza&hq=cheese


ie
說明

(選用) ie 參數會設定 編碼配置。 ie 的預設值為 latin1

如要瞭解可能需要使用這個參數的時機,請參閱字元編碼一節。

請參閱字元編碼 可能的 ie 值清單配置區段。

範例 q=google&ie=utf8&oe=utf8
lr
說明

(選用) lr (語言限制) 參數會將搜尋結果限制為文件 以特定語言撰寫而成

Google WebSearch 會根據以下項目決定文件語言: 正在分析:

  • 文件網址的頂層網域 (TLD)
  • 文件內的語言中繼標記
  • 文件內文使用的主要語言
  • 次要語言 (如有) 用於文件內文

查看語言 (lr) 「Collection Value」部分,查看這項屬性的有效值清單 參數。

範例 q=Frodo&lr=lang_en

數字
說明

(選用) num 參數會識別 傳回的結果數量。

預設值為 num,最大值為 10 值為 20。如果您要求的結果超過 20 筆,則只會要求 20 筆結果 就會傳回結果

注意:如果搜尋結果總數較少 超過要求的結果數,則所有可用的搜尋結果 。

範例 q=google&num=10

oe
說明

(選用) oe 參數會設定 這套編碼配置的編碼模式,可用來解碼 XML 結果。 oe 的預設值為 latin1

如要瞭解可能需要使用這個參數的時機,請參閱字元編碼一節。

請參閱字元編碼 可能的 oe 值清單配置區段。

範例 q=google&ie=utf8&oe=utf8

output
說明

必填output 參數會指定 XML 結果的格式。唯一有效的 此參數的值為 xmlxml_no_dtd。 以下圖表說明這些參數值的差異。

輸出格式
xml_no_dtd XML 結果將不會包含 !DOCTYPE 陳述式。(建議採用)
xml XML 結果會包含 Google DTD 參照。結果的第二行是指定 結果使用的定義類型 (DTD):
    <!DOCTYPE GSP SYSTEM "google.dtd">
範例 output=xml_no_dtd
output=xml

q
說明

(選用) q 參數會指定搜尋 輸入的查詢。雖然這是選用參數 必須為至少一個查詢參數 (as_epqas_lqas_oqas_q) 指定值 以便取得搜尋結果。

又有哪些特殊的查詢字詞 用於 q 參數的 值。如需這些字詞的清單和定義,請參閱特殊查詢字詞

Google 搜尋控制台 提供了 使用 q 參數提交的查詢。

注意:q 參數指定的值 都必須逸出網址。

範例 q=vacation&as_oq=london+paris

安全
說明

(選用) safe 參數會指定以成人和成人為條件篩選搜尋結果的方式 色情內容。safe 參數的預設值為 off。有效的參數值 是:

動作
off 停用安全搜尋
medium 啟用安全搜尋
high 啟用更強大的安全搜尋功能

請參閱過濾成人內容 ,進一步瞭解這項功能。

範例 q=adult&safe=high

start
說明

(選用) start 參數代表應納入的第一個相符結果 在搜尋結果中start 參數採用從 0 開始的索引,表示第一個結果是 0、 就是 1,依此類推

start 參數適用於 搭配 num 參數來判斷 指定要傳回的搜尋結果請注意,即使符合查詢的文件數量超過 1000 份,任何查詢一律不會傳回超過 1,000 筆結果。因此,如果將設定值設為 1000 以上,就不會產生任何結果。

範例 start=10

排序
說明

(選用) sort 參數會指定依照指定運算式排序結果。例如按日期排序。

範例

sort=date


ud
說明

(選用) ud 參數代表 XML 回應是否應包含搜尋結果的 IDN 編碼網址。 IDN (國際網域名稱) 編碼允許使用本機網域顯示 例如:

http://www.花井鮨.com

這個參數的有效值為 1 (預設值),表示 XML 結果應該 包含 IDN 編碼網址和 0,表示 XML 結果不應包含 IDN 編碼 網址。如果 ud 參數設為 1,則 IDN 編碼的網址會顯示在 放在 XML 結果中的 UD 標記內。

如果 ud 參數設為 0,則上述範例的網址會是 顯示方式:

http://www.xn--elq438j.com.

注意:這是 Beta 版功能。

範例 q=google&ud=1

圖片下方列出的其他查詢參數與進階搜尋查詢相關。 提交進階搜尋時,多個參數的值 (例如 as_eqas_epqas_oq 等) 都會納入考量 特定字詞圖片顯示 Google 的「進階搜尋」頁面。圖片中每個項目的名稱 進階搜尋參數是以紅色文字顯示,位置在前後或旁邊 網頁上與參數對應的欄位。



進階搜尋查詢參數

as_dt
說明

(選用) as_dt 參數控制的是 以包含或排除 as_sitesearch 參數中所指定網站的結果。 值 ie 分別表示包含和排除。

範例 as_dt=i,as_dt=e

as_epq
說明

(選用) as_epq 參數會識別 搜尋結果中所有文件都必須包含此詞組。你可以 您也可以使用詞組搜尋查詢字詞 查詢字詞

範例 as_epq=abraham+lincoln

as_eq
說明

(選用) as_eq 參數用於識別字詞 搜尋時不應出現於任何文件 也就是預測結果您也可以使用「排除」查詢 確保特定字詞或詞組不會出現在 一組搜尋結果

範例

q=bass&as_eq=music


as_lq
說明

(選用) as_lq 參數會指定 所有搜尋結果都應包含特定網址的連結。你也可以 使用 link: 查詢字詞。

範例

as_lq=www.google.com


as_nlo
說明

(選用) as_nlo 參數會指定 搜尋範圍。使用 as_nloas_nhi 執行多元包容搜尋 查詢 as_nlo...as_nhi 的範圍。

範例

以下指令會設定 5 到 10 (含) 的搜尋範圍:

as_nlo=5&as_nhi=10

as_nhi
說明

(選用) as_nhi 參數會指定 結尾值。使用 as_nloas_nhi 附加 將 as_nlo...as_nhi 的搜尋範圍納入查詢。

範例

以下指令會設定 5 到 10 (含) 的搜尋範圍:

as_nlo=5&as_nhi=10

as_oq
說明

(選用) as_oq 參數提供了 其他要檢查的搜尋字詞,以及每份文件 搜尋結果至少必須包含 搜尋字詞。您也可以使用 Boolean OR 查詢字詞 這類查詢

範例

q=vacation&as_oq=London+Paris


as_q
說明

(選用) as_q 參數會提供搜尋功能 查詢字詞。此參數也很常用 讓使用者指定額外字詞,以便搜尋集合內的特定字詞 結果。

範例

q=president&as_q=John+Adams


as_qdr
說明

(選用) as_qdr 參數要求搜尋 來自指定時間範圍 (快速日期範圍) 的結果。支援下列值:

d[number] 會要求指定過去天數的結果。
w[number] 會要求指定過去幾週的結果。
m[number] 會要求取得過去幾個月的結果。
y[number] 會要求過去幾年指定數的結果。

範例

以下範例要求取得過去一年的結果:

as_qdr=y

以下範例要求過去 10 天的結果:

as_qdr=d10

as_sitesearch
說明

(選用) as_sitesearch 參數可讓你指定所有搜尋結果應為特定網站的網頁。設定 as_dt 參數後,您也可以使用它,從搜尋結果中排除特定網站的網頁。

範例

q=vacation&as_sitesearch=www.google.com


特殊查詢字詞

Google WebSearch 允許使用多個特殊查詢字詞, 存取 Google 搜尋引擎的其他功能。這些 特殊查詢字詞應包含在 q 請求參數的值中。和其他查詢字詞一樣 特殊查詢字詞必須經過網址逸出。A 罩杯 內含冒號 (:) 的特殊查詢字詞數量。這個字元 也必須逸出網址;其網址逸出值為 %3A

反向連結 [link:]
說明

link: 查詢字詞會擷取網頁的集合 並連結至特定網址搜尋查詢的格式應為 link:URL,在 link: 查詢字詞和網址之間留有空格。

link: 的網址逸出版本為 link%3A

您也可以使用 as_lq 要求 用來提交 link: 要求的參數。

注意:在下列情況中,您無法指定任何其他查詢字詞 使用 link:

範例

http://www.google.com/search?q=link%3Awww.example.com


布林值 OR 搜尋 [ 或 ]
說明

OR 查詢字詞會擷取含有 。如何使用 OR 查詢 這時您可以插入搜尋字詞 OR,也就是大寫 。

您也可以使用 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

排除查詢字詞 [-]
說明

排除 (-) 查詢字詞限制了 針對「不含」 特定字詞或詞組如要使用排除查詢字詞,您必須 前方加上要從相符文件中排除的字詞或詞組 並以「-」表示(減號)。

- 的網址逸出版本為 %2D

如果搜尋字詞較多 多個意義例如「bass」可能會傳回結果 不管是魚還是音樂如果您要尋找與以下主題相關的文件: 就可以在搜尋結果中排除音樂相關文件 排除查詢字詞

您也可以使用 as_eq 要求 參數,用於排除與特定字詞或詞組相符的文件 在搜尋結果中

範例 使用者輸入內容: bass -music
查詢字詞: q=bass+%2Dmusic

檔案類型排除 [ -filetype:]
說明

-filetype: 查詢字詞會排除含有 特定的副檔名,例如「.pdf」或「.doc」來自搜尋結果 也就是預測結果搜尋查詢的格式應為 -filetype:EXTENSION,且 -filetype: 查詢字詞與 指定的副檔名。

-filetype: 的網址逸出版本為 %2Dfiletype%3A

注意:您可以排除多個項目 新增更多 -filetype: 查詢,即可從搜尋結果排除檔案類型 查詢字詞。您應有一個 -filetype: 查詢字詞 列入搜尋查詢中,應排除的每個副檔名 。

Google 支援的檔案類型包括:

  • Adobe 可攜式文件格式 (pdf)
  • Adobe PostScript (ps)
  • 蓮花 1-2-3 (週 1、wk2、wk3、wk4、wk5、wki、wks、wku)
  • Lotus WordPro (lwp)
  • Macwrite (mw)
  • Microsoft Excel (xls)
  • Microsoft PowerPoint (ppt)
  • Microsoft Word (文件)
  • Microsoft Works (wks、wps、wdb)
  • Microsoft Write (wri)
  • RTF 格式
  • 衝擊波快閃 (swf)
  • 文字 (ans、txt)。

日後可能會新增其他檔案類型。最新資訊 您隨時可以在 Google 的檔案類型常見問題中找到檔案清單。

範例

這個範例會傳回提及「Google」的文件但那 並非 PDF 文件:
q=Google+%2Dfiletype%3Apdf

這個範例會傳回提及「Google」的文件但 不含 PDF 和 Word 文件:
q=Google+%2Dfiletype%3Apdf+%2Dfiletype%3Adoc


檔案類型篩選 [filetype: ]
說明

filetype: 查詢字詞會將搜尋結果限制為: 附有特定副檔名的文件,例如「.pdf」或「.doc」。 搜尋查詢的格式應為 filetype:EXTENSION,並使用 filetype: 查詢字詞與指定值之間沒有空格 。

filetype: 的網址逸出版本為 filetype%3A

你可以限制搜尋功能 將結果新增到符合多個副檔名的文件 更多 filetype: 查詢字詞。對於要納入搜尋結果的副檔名,搜尋查詢時,請在搜尋查詢中輸入一個 filetype: 查詢字詞。多個 filetype: 查詢字詞必須以 OR 查詢字詞分隔。

根據預設,搜尋結果 納入任何副檔名的文件。

Google 支援的檔案類型包括:

  • Adobe 可攜式文件格式 (pdf)
  • Adobe PostScript (ps)
  • 蓮花 1-2-3 (週 1、wk2、wk3、wk4、wk5、wki、wks、wku)
  • Lotus WordPro (lwp)
  • Macwrite (mw)
  • Microsoft Excel (xls)
  • Microsoft PowerPoint (ppt)
  • Microsoft Word (文件)
  • Microsoft Works (wks、wps、wdb)
  • Microsoft Write (wri)
  • RTF 格式
  • 衝擊波快閃 (swf)
  • 文字 (ans、txt)。

日後可能會新增其他檔案類型。最新資訊 您隨時可以在 Google 的檔案類型常見問題中找到檔案清單。

範例

以下範例會傳回提及「Google」的 PDF 文件:
q=Google+filetype%3Apdf

此範例會傳回提及上述內容的 PDF 和 Word 文件 「Google」:
q=Google+filetype%3Apdf+OR+filetype%3Adoc


包含查詢字詞 (+)
說明

包含 (+) 查詢字詞指出某個字詞或詞組。 都必須出現在搜尋結果的所有文件中。如要使用 就必須在必須加上查詢字詞 包含在所有具有「+」的搜尋結果中(加號)。

+ 的網址逸出版本 (加號) 為 %2B

您應該在 Google 常用的字詞之前使用 + 通常會先捨棄資源,再識別搜尋結果

範例 使用者輸入內容: Star Wars Episode +I
查詢字詞: q=Star+Wars+Episode+%2BI

只連結搜尋,所有字詞 [allinlinks: ]
說明

allinlinks: 查詢字詞要求下列文件 搜尋結果包含網址中的所有字詞 連結。搜尋查詢的格式應為 allinlinks:,後面加上搜尋查詢的字詞。

如果搜尋查詢包含 allinlinks: 查詢 字詞時,Google 只會檢查文件中的網址連結 忽略文件中的其他文字, 文件標題和每份文件的網址。請注意,文件 網址與文件中所含的網址連結不同。

allinlinks: 的網址逸出版本為 allinlinks%3A

範例 使用者輸入內容:allinlinks: Google search
查詢字詞:q=allinlinks%3A+Google+search

詞組搜尋
說明

詞組搜尋 (") 可讓您搜尋 完整詞組:以半形引號括住這些詞組,或是 以連字號連結

" 的網址逸出版本 (半形引號) 為 %22

詞組搜尋特別適合用於搜尋 。

您也可以使用 as_epq 要求 用來提交詞組搜尋的參數。

範例 使用者輸入內容:"Abraham Lincoln"
查詢字詞: q=%22Abraham+Lincoln%22

純文字搜尋,所有字詞 [allintext:]
說明

allintext: 查詢字詞均須包含 搜尋結果會包含搜尋查詢中的所有字詞 文件內文查詢的格式應為 allintext:,後面加上你的搜尋查詢文字。

如果搜尋查詢包含 allintext: 查詢 字詞時,Google 只會檢查文件內文是否含有字詞 在搜尋查詢中忽略這些文件中的連結 標題和文件網址

allintext: 的網址逸出版本為 allintext%3A

範例 這個範例將指定 「Google」和「搜尋」必須出現在所有附屬文件的內文中 搜尋結果中:
使用者輸入內容:allintext:Google search
查詢字詞:q=allintext%3AGoogle+search

標題搜尋,單一字詞 [intitle:]
說明

intitle: 查詢字詞會將搜尋結果限制為: 文件標題中含有特定字詞的文件。 搜尋查詢的格式應為 intitle:WORD,不含空格 介於 intitle: 查詢字詞與下一個字詞之間。

注意:您可以指定更多 而必須加入文件標題中的一個字詞 intitle: 查詢字詞。你可以 也可以使用 allintitle: 查詢字詞 指定所有查詢字詞都必須包含在 。

intitle: 的網址逸出版本為 intitle%3A

範例

這個範例指定「Google」一詞必須在 搜尋結果中任何文件的標題,以及 「搜尋」必須出現在標題、網址、連結或內文中的任何位置 的文件:
使用者輸入內容:intitle:Google search
查詢字詞:q=intitle%3AGoogle+search


標題搜尋,所有字詞 [allintitle:]
說明

allintitle: 查詢字詞會將搜尋結果限制為: 。目的地: 請使用 allintitle: 查詢字詞,並納入「allintitle:」的 搜尋查詢的開頭。

注意:在搜尋查詢的開頭輸入 allintitle:,等同於在搜尋中的每個字詞前方加入 intitle:

allintitle: 的網址逸出版本為 allintitle%3A

範例

這個範例指定「Google」字詞和「搜尋」 必須出現在搜尋結果中任何文件的標題:
使用者輸入內容: allintitle: Google search
查詢字詞: q=allintitle%3A+Google+search


網址搜尋,單一字詞 [inurl:]
說明

inurl: 查詢字詞會將搜尋結果限制為: 。 搜尋查詢的格式應為 inurl:WORD,無空格 介於 inurl: 查詢字詞與下一個字詞之間。

inurl: 查詢 字詞會忽略標點符號,而且只會使用 inurl: 運算子後的第一個字詞。您可以指定多個必須加入字詞 將 inurl: 查詢字詞放在文件網址的前面 輸入所有這類字詞您也可以使用 allinurl: 查詢字詞,指定網址必須包含所有查詢字詞 。

inurl: 的網址逸出版本為 inurl%3A

範例

這個範例指定「Google」一詞必須在 搜尋結果中任何文件的網址,以及「search」一詞 必須出現在這些項目的標題、網址、連結或內文中 文件:
使用者輸入內容: inurl:Google search
查詢字詞: q=inurl%3AGoogle+search


網址搜尋,所有字詞 [allinurl:]
說明

allinurl: 查詢字詞會將搜尋結果限制為: 。目的地: 使用 allinurl: 查詢字詞,並在開頭加入「allinurl:」 您的搜尋查詢。

allinurl: 查詢字詞會忽略標點符號,因此僅適用於字詞,無法用於網址 元件。舉例來說,allinurl: uk/scotland 將會限制結果數量 改為含有「uk」字詞的文件以及「scotland」網址中 但不要求這兩個字詞以特定方式呈現 或是以斜線分隔

allinurl: 的網址逸出版本為 allinurl%3A

範例

這個範例指定「Google」字詞和「搜尋」 都必須出現在搜尋結果中任何文件的網址中:
使用者輸入內容: allinurl: Google search
查詢字詞: q=allinurl%3A+Google+search



網頁文件資訊 [info:]
說明

info: 查詢字詞會擷取一般資訊 。 搜尋查詢的格式應為 info:URL,且不含空格 介於 info: 查詢字詞和網址之間。

info: 的網址逸出版本為 info%3A

注意:在下列情況中,您無法指定任何其他查詢字詞 使用 info:

範例 使用者輸入內容: info:www.google.com
查詢字詞: q=info%3Awww.google.com

圖片查詢範例

下方列舉幾個圖片 HTTP 要求,以說明不同查詢參數的使用方式。不同查詢參數的定義請參閱本文的「圖片查詢參數定義」一節。

這項要求要求查詢字詞「猴子」的前 5 個結果 (start=0&num=5)檔案類型為 .png,(共 q=monkey)。最後,查詢會指定 clientoutputcx 參數的值,這三個是必要參數。

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
說明

(選用) 傳回指定類型的圖片。允許的值包括:bmpgifpngjpgsvg

範例 q=google&as_filetype=png

imgsz
說明

(選用) 傳回指定大小的圖片,其中大小可以是下列其中一個:

  • icon (小)
  • small|medium|large|xlarge (中等)
  • xxlarge (大)
  • huge (超大)

範例 q=google&as_filetype=png&imgsz=icon

圖片類型
說明

(選用) 傳回特定類型的圖片,可以是下列任一種:

  • clipart (高度)
  • face (臉孔)
  • lineart (線性)
  • news (新聞)
  • photo (相片)

範例 q=google&as_filetype=png&imgtype=photo

imgc
說明

(選用) 傳回黑白、灰階或彩色圖片:

  • mono (黑白)
  • gray (灰階)
  • color (顏色)

範例 q=google&as_filetype=png&imgc=gray

imgcolor
說明

(選用) 傳回特定主色的圖片:

  • yellow
  • green
  • teal
  • blue
  • purple
  • pink
  • white
  • gray
  • black
  • brown
範例 q=google&as_filetype=png&imgcolor=yellow

as_rights
說明

(選用) 依授權篩選。支援的值包括:

  • cc_publicdomain
  • cc_attribute
  • cc_sharealike
  • cc_noncommercial
  • cc_nonderived

範例 q=cats&as_filetype=png&as_rights=cc_attribute

要求限制

下表列出了您所提出搜尋要求的限制 傳送給 Google:

元件 限制 註解
搜尋要求長度 2,048 個位元組  
查詢字詞數量 10 包含下列參數中的字詞:qas_epqas_eqas_lqas_oqas_q
結果數量 20 如果您將 num 參數設為大於 20 的數字,系統只會傳回 20 個結果。目的地: 如要取得更多結果,就需要傳送多個請求,並 使用 每個要求

國際化查詢和結果簡報

Google WebSearch 服務可讓你在 享有多種語言的支援服務您可以指定 用於解讀 HTTP 要求,並將 XML 回應編碼 (使用 ieoe 搜尋) 參數)。你也可以篩選結果,讓搜尋結果只包含文件 特定語言的網頁

以下各節將討論與搜尋 相關的問題 多種語言:

字元編碼

伺服器會將網頁等資料傳送給使用者代理程式, 視編碼位元組序列而定。接著,使用者代理程式 會將位元組轉換為字元序列傳送要求給 您可以在 WebSearch 服務中指定 以及您收到的 XML 回應

您可以使用 ie 要求參數來指定 HTTP 要求中字元的編碼機制。你可以 您也可以使用 oe 參數指定編碼的 Google 應使用哪種配置來編碼您的 XML 回應。如果您是 使用 ISO-8859-1 (或 latin1) 以外的編碼架構,請務必指定正確的值 轉換為 ieoe 參數。

注意:如果您為多個商家提供搜尋功能 語言,建議您使用 utf8 (UTF-8) 編碼值 ieoe 參數。

詳情請參閱 編碼配置附錄,其中列出完整的值清單 您可用於 ieoe 參數。

如要進一步瞭解字元編碼的一般資訊,請參閱 http://www.w3.org/TR/REC-html40/charset.html

介面語言

您可以使用 hl 要求參數來 找出圖形介面的語言。hl 參數值可能會影響 XML 搜尋結果,尤其是在 未明確指定語言限制 (使用 lr 參數) 時的國際查詢。因此 若是如此,hl 參數也許會增加搜尋結果 採用與使用者輸入語言相同的語言

建議您明確設定 hl 參數 以確保 Google 能從搜尋結果中 也就是每一筆查詢的結果

請參閱支援的介面 「Languages」(語言) 一節會列出 hl 參數的有效值完整清單。

搜尋以特定語言撰寫的文件

您可以使用 lr 要求參數 將搜尋結果限制為以特定方式寫成的文件 指定語言或語言組合

lr 參數支援布林運算子,方便您指定 應該在搜尋中加入 (或排除) 多種語言 也就是預測結果

以下範例說明如何使用布林運算子在 不同語言

針對以日文撰寫的文件:

lr=lang_jp

如果是義大利文或德文文件:

lr=lang_it|lang_de

如果不是以匈牙利文或捷克文書寫的文件,則適用以下情形:

lr=(-lang_hu).(-lang_cs)

詳情請參閱語言集合 請參閱一節,全面瞭解 lr 參數和 Boolean 可能的值 「運算子」一節,完整討論如何運用這些 運算子

簡體中文和繁體中文是兩種書寫變體 中文版本相同的概念可能會以不同方式寫成 每個變化版本如果使用其中一個變體的查詢,Google WebSearch 服務可以傳回同時包含 子類

這項功能的使用需求如下:

  1. c2coff 要求參數設為 0
  2. 執行下列任一操作:
    • 請勿設定 lr 要求參數
    • lr 要求參數設為 lr=lang_zh-TW|lang_zh-CN

以下範例說明如何在結果請求中加入的查詢參數 簡體中文和繁體中文(請注意,其他必要資訊, 為 client,則不會納入本範例中。)

search?hl=zh-CN
    &lr=lang_zh-TW|lang_zh-CN
    &c2coff=0

篩選結果

Google 網頁搜尋提供多種篩選搜尋結果的方式 結果:

自動篩選搜尋結果

為了盡可能提供最準確的搜尋結果,Google 會運用兩種技巧,自動篩除 通常視為不理想:

  • 重複的內容:如有多份文件內含 生成的內容,那麼只有其中最相關的文件 並顯示在你的搜尋結果中

  • Host Crowding (主機群數):如果搜尋結果與您的網站相符, Google 可能不會顯示該網站的所有搜尋結果, 顯示低於
    的結果 而不是原本情況

建議你為一般搜尋要求保持啟用這些篩選器 因為篩選器可大幅提升多數搜尋作業的品質 也就是預測結果不過,您可以在 filter 查詢參數中設定 0,略過這些自動篩選器。 搜尋要求。

語言和國家/地區篩選

Google WebSearch 服務會傳回來自 主索引的結果 所有網頁文件。主索引含有 按照特定屬性 (包括語言) 分類的文件 和發源國家/地區

您可以使用 lrcr 要求參數,將搜尋結果限制為 特定語言或來源的文件 特定國家/地區。

Google WebSearch 會分析以下項目,判斷文件語言:

  • 文件網址的頂層網域 (TLD)
  • 文件內的語言中繼標記
  • 文件內文使用的主要語言


另請參閱 lr 參數的定義,以及「搜尋 以特定語言撰寫的文件,以及可設定的語言集合值 用來做為 lr 參數的值 的相關資訊,瞭解如何根據語言限制搜尋結果。

Google WebSearch 會分析以下項目,判斷文件的國家/地區:

  • 文件網址的頂層網域 (TLD)
  • 網路伺服器 IP 位址的地理位置

另請參閱 cr 參數的定義和 Country Collection 值:可用來做為 cr 參數的值,進一步瞭解如何依照 來源。

注意:您可以將語言相互結合 以及國家/地區值,藉此自訂搜尋結果。適用對象 舉例來說,您可以要求以法文撰寫的文件 或者,您也可以要求 來自荷蘭,而且沒有英文。lrcr 參數都支援布林運算子

使用安全搜尋功能過濾成人內容

許多 Google 客戶都不希望顯示 網站 含有成人內容的廣告。你可以使用「安全搜尋」篩選器 並移除包含成人內容的搜尋結果。 Google 篩選器使用獨家技術檢查關鍵字、詞組 和網址雖然篩選器無法達到滴水不漏的防堵效果, 將大量成人內容從搜尋中移除 也就是預測結果

Google 致力於提供最新且全面的「安全搜尋」 可能藉由持續檢索網路並納入更新 。

安全搜尋支援下列語言:

荷蘭文
英文
法文
德文
義大利文
葡萄牙文 (巴西)
西班牙文
繁體中文

您可以調整 Google 篩選搜尋結果的程度 成人內容。 下表說明 Google 的安全搜尋設定及其運作方式 設定會影響搜尋結果:

安全搜尋層級 說明
啟用較嚴格的版本 安全搜尋
媒介 封鎖包含下列內容的網頁: 色情和其他煽情露骨內容
關閉 不會過濾成人 搜尋結果中的內容

* 安全搜尋設定預設為「關閉」

如果您啟用「安全搜尋」後,還是找到含有 搜尋結果中的令人反感內容,請透過電子郵件將該網站的網址傳送至 safesearch@google.com, 會調查網站

XML 結果

Google XML 結果 DTD

Google 使用相同的 DTD 來說明所有類型的 XML 格式 搜尋結果。其中有許多標記和屬性都適用於 搜尋類型然而,部分代碼僅適用於 搜尋類型因此 DTD 的定義可能較少 提供的使用限制

本文件將介紹與 DTD 相關的重要面向 適用於 WebSearch。查看 DTD 時 WebSearch,您可以放心忽略 如此處所述如果 DTD 與 也請參閱本文件中的說明。

Google 傳回或不參照 最新的 DTD。DTD 是搜尋管理員的指南 和 XML 剖析器解讀 Google 的 XML 結果由於 Google 的 XML 文法可能會不時變更,因此不應該設定 剖析器來使用 DTD 來驗證每個 XML 結果。

此外,您也不應設定 XML 剖析器來擷取 每次提交搜尋要求時產生的 DTD。Google 更新 DTD 而且這些要求會產生不必要的延遲時間和頻寬 Google Cloud 就是最佳選擇

Google 建議您採用 xml_no_dtd 輸出格式,以取得 XML 結果。 如果您在搜尋要求中指定 xml output 格式, 唯一的差別在於必須在 XML 結果中加入以下這行程式碼:

<!DOCTYPE GSP SYSTEM "google.dtd">

如要取得最新的 DTD,請前往: http://www.google.com/google.dtd.

請注意,目前系統可能無法使用或支援 DTD 的所有功能。

關於 XML 回應

  • 所有元素值都是適合顯示的有效 HTML,除非 會在 XML 標記定義中註明。
  • 部分元素值是需要先進行 HTML 編碼的網址。 就會顯示
  • XML 剖析器應忽略未記錄的屬性和標記。 這可讓應用程式在不修改的情況下繼續運作 Google 會在 XML 輸出中加入更多功能。
  • 某些字元包含在 XML 標記。您的 XML 處理器應將這些實體轉換回 適當的字元。如未正確轉換實體, 舉例來說,瀏覽器可能會將 &做為「&amp;」字元。 XML Standard 記載這些字元;這些字元 請參閱下表:

    特性 逸出形式 實體 字元代碼
    連接符號 &amp; &#38;
    單引號 ' &apos; &#39;
    雙引號 " &quot; &#34;
    大於 > &gt; &#62;
    小於 < &lt; &#60;

一般和進階搜尋查詢的 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 標記的子標記,或標記含有 子標記或屬性, 代碼的定義表

部分子標記旁邊可能會顯示在 定義。這些符號和它們的意義分別是:

?= 選用的子標記
* = 零個以上的子標記例項
+ = 一個以上的子標記例項
A B C D 鍵 週五 G H I L M N P Q R 鍵 S 望遠 U X

anchor_text
定義

&lt;anchor_text&gt; 標記指定 就應該向使用者顯示廣告,以找出 標籤。自修正標籤之後 請用底線取代非英數字元 在使用者介面中顯示 <label> 標記的值。相反地,您應該 設定 &lt;anchor_text&gt; 標記。

範例 <anchor_text>高爾夫球 課程</anchor_text>
子標記 FacetItem
內容格式 文字

封鎖
定義

這個標記會封裝宣傳活動結果內文行中的區塊內容。每個區塊都有子標記:TUL。非空白的 T 標記表示區塊包含文字。非空白的 UL 標記表示區塊包含連結 (透過 U 子標記提供的網址,而錨定文字則是在 L 子標記中註明)。

子標記 TUL
子標記 BODY_LINE
內容格式 空白

BODY_LINE
定義

這個標記會封裝宣傳結果內文中的一行內容。每個內文行都由多個 BLOCK 標記組成,其中包括一些文字,或是含有網址和錨定文字的連結。

子標記 封鎖*
子標記 SL_MAIN
內容格式 空白

C
定義

&lt;C&gt; 標記表示 WebSearch 服務 可以擷取這個搜尋結果網址的快取版本。你無法 透過 XML API 擷取快取網頁,但可以將使用者重新導向 網址是 www.google.com 內容。

屬性
名稱 格式 說明
SZ 文字 (整數 + 「k」) 提供快取版本的大小 以 KB (「k」) 為單位顯示搜尋結果。
CID 文字 識別 Google 快取中的文件。 如要從快取中擷取文件,請傳送以下形式的搜尋字詞: 如下:
cache:CIDtext:escapedURL

逸出網址可在 UE 代碼中找到。

範例 <C SZ=" 6,000"CID=&quot;kvOXK_cYSSgJ&quot;/>
子標記 高可用性
內容格式 空白

C2C
定義 <C2C> 標記會指出 搜尋結果中會參照繁體中文網頁。這個標記 只有在簡體和傳統皆適用 中文搜尋已啟用。如要進一步瞭解啟用及相關資訊,請參閱 c2coff 查詢參數定義。 停用此功能。
內容格式 文字

背景資訊
定義

&lt;Context&gt; 標記會封裝一系列 與一組搜尋結果相關聯的限制條件標籤。

範例 &lt;Context&gt;
子標記 titleFacet+
內容格式 容器

檢索
定義

&lt;CRAWLDATE&gt; 標記會指出 上次檢索網頁的時間。不是每個搜尋結果網頁都傳回 CRAWLDATE

範例 <CRAWLDATE>5 月 21 日, 2005 年</CRAWLDATE>
子標記 R 鍵
內容格式 文字

DI
定義

&lt;DI&gt; 標記會封裝 Open Directory Project (ODP) 類別資訊,

範例 &lt;DI&gt;
子標記 DT?、DS 嗎?
子標記 高可用性
內容格式 空白

DS
定義

&lt;DS&gt; 標記會針對 只有 ODP 目錄的特定類別。

範例 <DS>發布你的 取消直接在以下位置繼續播放: 網際網路</DS>
子標記 DI
內容格式 文字 (可能包含 HTML)

DT:裝置樹狀架構
定義

&lt;DT&gt; 標記提供單則影片的標題 列在 ODP 目錄中

範例 &lt;DT&gt;SoccerConnection.net&lt;/DT&gt;
子標記 DI
內容格式 文字 (可能包含 HTML)

Facet
定義

<Facet> 標記包含 &lt;FacetItem&gt; 標記的邏輯分組。你可以 作 利用程式化搜尋引擎 引擎 XML 規格格式。如果不是 分組,結果為 result_xml_tag_Context><Context>代碼將 包含向上 設為四個 <Facet> 標記。每個 <Facet> 標記內的項目都會依用途分組,但可能不會有邏輯 關係

範例 <Facet>
子標記 FacetItem+、title+
子標記 背景資訊
內容格式 容器

FacetItem
定義

&lt;FacetItem&gt; 標記會封裝資訊 與一組搜尋結果相關聯的限制條件標籤。

範例 &lt;FacetItem&gt;
子標記 labelanchor_text+
子標記 Facet
內容格式 FacetItem

芬蘭
定義 &lt;FI&gt; 標記為標記 指出是否對搜尋執行文件篩選。 請參閱「自動篩選」一節 另一份本文件,針對 Google 搜尋結果的詳細資訊 篩選器。
範例 <FI />
子標記 反抗軍
內容格式 空白

GSP
定義

&lt;GSP&gt; 標記 包含 Google XML 搜尋結果中傳回的所有資料。「GSP」為 Google 搜尋通訊協定的縮寫。

屬性
名稱 格式 說明
VER 文字 (整數) VER 屬性會指定搜尋結果輸出的版本。 目前的輸出版本是「3.2」
範例 <GSP VER="3.2">
子標記 PARAM+、QRES?、TM
內容格式 空白

高可用性
定義 &lt;HAS&gt; 標記會封裝 都有關任何特殊搜尋 請求參數

注意:<HAS> 的定義 WebSearch 比 DTD 更加嚴格。

子標記 DI?、L?、C?、RT
子標記 R 鍵

ISURL
定義 Google 會傳回 &lt;ISURL&gt; 代碼 表示相關的搜尋查詢是網址。
子標記 GSP
內容格式 空白

L
定義 是否有 &lt;L&gt; 標記 表示 WebSearch 服務可以找到其他連結至下列連結的網站 這個搜尋結果網址若要找出這類網站,您可以使用 link: 特殊查詢字詞。
子標記 高可用性
內容格式 空白

標籤
定義

<label> 標記可指定限制條件標籤 可用來篩選搜尋結果使用條件 或修正標籤,請加入字串 more:[[label tag value]] 到 收到 HTTP 請求並傳送給 Google 的 q 參數值, 如以下範例所示請注意,這個值必須為 將查詢傳送至 Google 之前逸出網址。

This example uses the refinement label golf_courses to
filter search results about Palm Springs:
q=Palm+Springs+more:golf_courses

The URL-escaped version of this query is:
q=Palm+Springs+more%3Agolf_courses

注意:<label> 標記與 &lt;Label&gt; 標記,可用於識別修正標籤 顯示特定網址的關聯內容

範例 &lt;label&gt;golf_courses&lt;/label&gt;
子標記 FacetItem
內容格式 文字

LANG
定義

&lt;LANG&gt; 標記包含 Google 對 搜尋結果的語言。

範例 <LANG>英文</LANG>
子標記 R 鍵
內容格式 文字

M
定義

&lt;M&gt; 標記會指出預估的總數 搜尋結果的數量

注意: 這項預估值可能不準確。

範例 <M>16200000</M>
子標記 反抗軍
內容格式 文字

新生兒
定義

&lt;NB&gt; 標記包含瀏覽資訊,也就是 Google 搜尋結果下一頁或上一頁的連結 搜尋結果。

注意:這個標記僅用於 就會有更多結果。

範例 &lt;NB&gt;
子標記 NU?、PU
子標記 反抗軍
內容格式 空白

NU
定義

&lt;NU&gt; 標記包含 下一頁。

範例 <NU>/search?q=flowers&num=10&hl=zh-TW&ie=UTF-8
&output=xml&client=test&start=10</NU>
子標記 新伯倫瑞克
內容格式 文字 (相對網址)

PARAM
定義

&lt;PARAM&gt; 標記 可識別在 HTTP 請求中提交的輸入參數 這個畫面。參數相關資訊位於 標記屬性 (name、value、original_value) 之後 一個 PARAM 標記。

屬性
名稱 格式 說明
name 文字 輸入參數名稱。
value HTML 輸入內容的 HTML 格式版本 參數值。
original_value 文字 輸入參數值的原始網址逸出版本。
範例 <PARAM name="cr"value=&quot;countryNZ&quot; 原始值="國家/地區紐西蘭"/>
子標記 GSP
內容格式 複合式

PU
定義

&lt;PU&gt; 標記會提供 上一頁的搜尋結果

範例 <PU>/search?q=flowers&num=10&hl=zh-TW&output=xml
&client=test&start=10</PU>
子標記 新伯倫瑞克
內容格式 文字 (相對網址)

Q
定義

&lt;Q&gt; 標記代表該搜尋查詢。 透過與 XML 結果相關聯的 HTTP 要求中提交

範例

<Q>披薩</Q>

子標記 GSP
內容格式 文字

R
定義

&lt;R&gt; 標記內含 個別搜尋結果

注意:<R> 標記的定義 WebSearch 比 DTD 更加嚴格。

屬性
名稱 格式 說明
文字 (整數) 表示這個指數的索引 (從 1 開始) 搜尋結果。
MIME 文字 指出搜尋的 MIME 類型 結果。
子標記 UUET?、CRAWLDATES?、LANG?、高可用性
子標記 反抗軍

反抗軍
定義

&lt;RES&gt; 標記會封裝個別的 以及這些結果的詳細資料

屬性
名稱 格式 說明
SN 文字 (整數) 指出 在此結果集中傳回的第一筆搜尋結果。
繁體中文 文字 (整數) 表示最後一個 這個結果集中傳回的搜尋結果。
範例 <RES SN="1"EN="10">
子標記 MFI?、XT?、NB?、R 鍵*
子標記 GSP
內容格式 空白

S
定義

&lt;S&gt; 標記包含搜尋摘錄 顯示以粗體醒目標示的查詢字詞換行符號為 。

範例 <S>華盛頓 (CNN) -- 最終競標 參議員陣亡將士 &lt;b&gt;Bush&#39;s&lt;/b&gt;司法挑選 讓五位入圍者有機會進行最終投票 &lt;b&gt;...&lt;b&gt;...&lt;/b&gt;<S>
子標記 R 鍵
內容格式 文字 (HTML)

SL_MAIN
定義

此標記會封裝宣傳活動結果的內容。用於剖析促銷活動。標題連結的錨定文字和網址則分別包含在 TU 子標記中。內文和連結是位於 BODY_LINE 子標記中。

子標記 BODY_LINE*、TU
子標記 SL_RESULTS
內容格式 空白

SL_RESULTS
定義

宣傳結果的容器標記。如果搜尋結果中有促銷活動,就會顯示其中一個。SL_MAIN 子標記包含主要結果資料。

子標記 SL_MAIN*
子標記 R 鍵
內容格式 空白

拼字
定義

<ARTing> 標記會封裝替代標記。 所提交查詢的拼字建議。這個標記只會在 就能顯示在搜尋結果的第一頁拼字建議適用於 英文、中文、日文和韓文。

注意:Google 只會傳回拼字建議 gl 參數值的查詢 小寫英文字母。

範例 <拼字>
子標記 建議
子標記 GSP
內容格式 空白

建議
定義 &lt;Suggestion&gt; 標記內含 所提交查詢的其他拼字建議。您可以使用 標記的內容,向搜尋使用者建議其他拼法。 q 屬性的值是 網址逸出的拼字建議,可供您當做查詢字詞使用。
屬性
名稱 格式 說明
q 文字 q 屬性會指定 網址逸出的拼字建議。
範例 <建議 q=&quot;soccer&quot;&gt;&amp;lt;b&amp;gt;&amp;lt;i&amp;gt;soccer&amp;lt;/i&amp;gt;&amp;lt;/b&amp;gt;&lt;/Suggestion&gt;
子標記 拼字
內容格式 文字 (HTML)

T
定義 &lt;T&gt; 標記包含標題 結果。
範例 <T>阿米奇東海岸 比薩店</T>
子標記 R 鍵
內容格式 文字 (HTML)

title
定義

&lt;Context&gt; 標記是 &lt;Context&gt; 的子項目,其中包含您的程式化搜尋引擎名稱。

<Facet><Facet> 子標記,可提供一組 facet 的標題。

範例

以下為 <Context> 的子發布商:<title>我的搜尋 Engine&lt;/title&gt;

做為 <Facet> 的子項:<title>facet 標題</title>

子標記 ContextFacet
內容格式 文字

TM
定義

&lt;TM&gt; 標記識別伺服器總時間 以便傳回搜尋結果

範例 <TM>0.100445</TM>
子標記 GSP
內容格式 文字 (浮點數)

TT
定義 &lt;TT&gt; 標記可用來搜尋 提示
範例 <TT>&lt;i&gt;提示:適用於 瀏覽器時,按下 Return 鍵所產生的結果,會與按下 搜尋按鈕&lt;/i&gt;</TT>
子標記 GSP

U
定義 &lt;U&gt; 標記會提供網址 特定資訊的用途
範例 &lt;U&gt;http://www.dominos.com/&lt;/U&gt;
子標記 R 鍵
內容格式 文字 (絕對網址)

UD
定義

&lt;UD&gt; 標記提供 IDN 編碼。 (國際網域名稱) 搜尋結果的網址。這個值可以 以當地語言顯示。舉例來說, http://www.%E8%8A%B1%E4%BA%95.com 經 IDN 編碼的網址,可能會被解碼並顯示為 http://www.F 花菖您目前找到伊含有.com。 這個 &lt;UD&gt; 標記只會出現在 包含 ud 參數的要求。

注意:這是 Beta 版功能。

範例 &lt;UD&gt;http://www.%E8%8A%B1%E4%BA%95.com/&lt;/UD&gt;
子標記 R 鍵
內容格式 文字 (IDN 編碼網址)

UE
定義 &lt;UE&gt; 標記會提供網址 特定資訊的用途這個值為逸出網址,因此適合 ,以在網址中做為查詢參數傳送。
範例 &lt;UE&gt;http://www.dominos.com/&lt;/UE&gt;
子標記 R 鍵
內容格式 文字 (網址逸出的網址)

XT
定義 &lt;XT&gt; 標記指出 根據 M 標記指定的預估結果總數,實際上 結果總數。請參閱自動 正在篩選本文件的一節,瞭解更多細節。
範例 <XT />
子標記 反抗軍
內容格式 空白


圖片搜尋查詢的 XML 結果

這個範例圖片要求會要求 5 筆與搜尋字詞「猴子」相關的 5 筆結果 (num=5)(q=猴子)。

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 標記。

部分子標記旁邊可能會顯示在 定義。這些符號和它們的意義分別是:

?= 選用的子標記
* = 零個以上的子標記例項
+ = 一個以上的子標記例項

RG
定義

&lt;RG&gt; 標記可包含個別圖片搜尋結果的詳細資料。

屬性
名稱 格式 說明
文字 (整數) 表示這個指數的索引 (從 1 開始) 搜尋結果。
MIME 文字 指出搜尋的 MIME 類型 結果。
子標記 反抗軍
RU
定義

<RU tag> 標記內含每筆圖片搜尋結果的詳細資料。

子標記 R 鍵