Search

{
  "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 (Promotion)
    }
  ],
  "context": {
    object
  },
  "searchInformation": {
    "searchTime": number,
    "formattedSearchTime": string,
    "totalResults": string,
    "formattedTotalResults": string
  },
  "spelling": {
    "correctedQuery": string,
    "htmlCorrectedQuery": string
  },
  "items": [
    {
      object (Result)
    }
  ]
}

string

目前物件類型的專屬 ID。這個 API 就是 customsearch#search。

object

定義此 API 範本的 OpenSearch 網址元素。

string

Custom Search JSON API 的 OpenSearch 網址範本 MIME 類型。

string

這個 API 的實際 OpenSearch 範本。

object

包含一或多組查詢中繼資料，各角色名稱的索引鍵。可能的角色名稱包括 OpenSearch 查詢角色定義的 request，以及兩個自訂角色：nextPage 和 previousPage。

object

代表前一頁結果的中繼資料 (如適用)。

string

查詢的說明。

string (int64 format)

預估總搜尋結果數量。可能不準確。

string

使用者輸入的搜尋字詞。

integer

這個組合中傳回的搜尋結果數量。

integer

目前搜尋結果集的索引，會呈現在結果總數中，其中第一個結果的索引為 1。

integer

這組結果的頁碼，頁面長度是由 count 屬性設定。

string

搜尋結果的語言。

string

搜尋要求支援的字元編碼。

string

搜尋結果支援的字元編碼。

string

指定用於過濾成人搜尋結果的安全搜尋層級。這是 OpenSearch 規格中尚未定義的自訂屬性。有效的參數值如下：

• "off"：停用安全搜尋

• "active"：啟用安全搜尋

string

透過程式化搜尋引擎控制台建立的引擎識別碼。這是 OpenSearch 規格中尚未定義的自訂屬性。這是必要參數。

string

指定應根據指定的運算式排序結果。例如依日期排序。

string

啟用或停用 Google 搜尋結果自動篩選功能。如要進一步瞭解 Google 的搜尋結果篩選器，請參閱自動篩選。這個參數的有效值如下：

• 0：已停用

• 1：已啟用 (預設)

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

string

針對來源國家/地區與參數值相符的搜尋結果提升排名。如需有效值的清單，請參閱國家/地區代碼。

在 WebSearch 要求中指定 gl 參數值，應能提高搜尋結果的關聯性。對國際客戶而言更是如此，更精確地說，對使用非美國語系國家/地區的客戶而言更是如此。

string

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

Google WebSearch 會分析下列項目，判斷文件的國家/地區：

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

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

如需這個參數的有效值清單，請參閱國家/地區 (cr) 參數值。

string

指定應限制搜尋的 Google 網域 (例如 google.com、google.de 或 google.fr)。

string

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

支援的值如下：

• 0：已啟用 (預設)

• 1：已停用

string

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

string

指定使用者介面的介面語言 (主機語言)。明確設定這個參數可改善搜尋結果的效能和品質。

詳情請參閱國際化查詢和結果呈現的介面語言一節；如需支援的語言清單，請參閱「支援的語言介面語言」。

string

限制系統只顯示來自指定網站的網址結果。

string

指定要納入或排除 sitesearch 參數所命名網站的結果。支援的值如下：

• i：包含網站內容

• e：從網站上排除內容

string

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

string

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

string

指定所有結果都應包含特定網址的連結。

string

提供要在文件中尋找的其他搜尋字詞，讓搜尋結果中的每份文件必須包含至少一個其他搜尋字詞。您也可以透過「Boolean OR」查詢字詞執行這類查詢。

string

指定所有搜尋結果應為與指定網址相關的網頁。參數值必須是網址。

string

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

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

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

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

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

string

指定搜尋範圍的起始值。使用 cse:lowRange 和 cse:highrange，在查詢中附加包含 lowRange...highRange 的搜尋範圍。

string

指定搜尋範圍的結束值。使用 cse:lowRange 和 cse:highrange，在查詢中附加包含 lowRange...highRange 的搜尋範圍。

string

限制系統只傳回指定擴充功能檔案的結果。Google 支援的檔案類型包括：

• Adobe 可攜式文件格式 (pdf)

• Adobe PostScript (ps)

• Lotus 1-2-3 (wk1、wk2、wk3、wk4、wk5、wki、wks、wku)

• Lotus WordPro (lwp)

• Macwrite (mw)

• Microsoft Excel (xls)

• Microsoft PowerPoint (ppt)

• Microsoft Word (doc)

• Microsoft Works (wks、wps、wdb)

• Microsoft 寫入 (wri)

• RTF 格式 (rtf)

• Shockwave Flash (swf)

• 文字 (ans、txt)。

日後可能會新增其他檔案類型。您隨時可以參閱 Google 的檔案類型常見問題，查看最新清單。

string

依授權建立的篩選器。支援的值包括：

• cc_publicdomain

• cc_attribute

• cc_sharealike

• cc_noncommercial

• cc_nonderived

string

允許的值為 web 或 image。如果未指定，搜尋結果僅限於網頁。

string

限制系統只傳回指定大小圖片的結果。支援的值如下：

• icon (小)

• small | medium | large | xlarge (中)

• xxlarge (大)

• huge (超大)

string

限制系統只傳回指定類型圖片的結果。支援的值如下：

• clipart (插圖)

• face (臉孔)

• lineart (線條繪圖)

• photo (相片)

• animated (動畫)

• stock (圖庫)

string

限制系統只傳回指定色彩類型圖片的結果。支援的值如下：

• mono (黑白)

• gray (灰階)

• color (顏色)

string

限制系統只傳回具有特定主要顏色的圖片。支援的值如下：

• red

• orange

• yellow

• green

• teal

• blue

• purple

• pink

• white

• gray

• black

• brown

object

代表目前要求的中繼資料。

string

查詢的說明。

string (int64 format)

預估總搜尋結果數量。可能不準確。

string

使用者輸入的搜尋字詞。

integer

這個組合中傳回的搜尋結果數量。

integer

目前搜尋結果集的索引，會呈現在結果總數中，其中第一個結果的索引為 1。

integer

這組結果的頁碼，頁面長度是由 count 屬性設定。

string

搜尋結果的語言。

string

搜尋要求支援的字元編碼。

string

搜尋結果支援的字元編碼。

string

指定用於過濾成人搜尋結果的安全搜尋層級。這是 OpenSearch 規格中尚未定義的自訂屬性。有效的參數值如下：

• "off"：停用安全搜尋

• "active"：啟用安全搜尋

string

透過程式化搜尋引擎控制台建立的引擎識別碼。這是 OpenSearch 規格中尚未定義的自訂屬性。這是必要參數。

string

指定應根據指定的運算式排序結果。例如依日期排序。

string

啟用或停用 Google 搜尋結果自動篩選功能。如要進一步瞭解 Google 的搜尋結果篩選器，請參閱自動篩選。這個參數的有效值如下：

• 0：已停用

• 1：已啟用 (預設)

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

string

針對來源國家/地區與參數值相符的搜尋結果提升排名。如需有效值的清單，請參閱國家/地區代碼。

在 WebSearch 要求中指定 gl 參數值，應能提高搜尋結果的關聯性。對國際客戶而言更是如此，更精確地說，對使用非美國語系國家/地區的客戶而言更是如此。

string

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

Google WebSearch 會分析下列項目，判斷文件的國家/地區：

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

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

如需這個參數的有效值清單，請參閱國家/地區 (cr) 參數值。

string

指定應限制搜尋的 Google 網域 (例如 google.com、google.de 或 google.fr)。

string

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

支援的值如下：

• 0：已啟用 (預設)

• 1：已停用

string

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

string

指定使用者介面的介面語言 (主機語言)。明確設定這個參數可改善搜尋結果的效能和品質。

詳情請參閱國際化查詢和結果呈現的介面語言一節；如需支援的語言清單，請參閱「支援的語言介面語言」。

string

限制系統只顯示來自指定網站的網址結果。

string

指定要納入或排除 sitesearch 參數所命名網站的結果。支援的值如下：

• i：包含網站內容

• e：從網站上排除內容

string

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

string

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

string

指定所有結果都應包含特定網址的連結。

string

提供要在文件中尋找的其他搜尋字詞，讓搜尋結果中的每份文件必須包含至少一個其他搜尋字詞。您也可以透過「Boolean OR」查詢字詞執行這類查詢。

string

指定所有搜尋結果應為與指定網址相關的網頁。參數值必須是網址。

string

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

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

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

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

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

string

指定搜尋範圍的起始值。使用 cse:lowRange 和 cse:highrange，在查詢中附加包含 lowRange...highRange 的搜尋範圍。

string

指定搜尋範圍的結束值。使用 cse:lowRange 和 cse:highrange，在查詢中附加包含 lowRange...highRange 的搜尋範圍。

string

限制系統只傳回指定擴充功能檔案的結果。Google 支援的檔案類型包括：

• Adobe 可攜式文件格式 (pdf)

• Adobe PostScript (ps)

• Lotus 1-2-3 (wk1、wk2、wk3、wk4、wk5、wki、wks、wku)

• Lotus WordPro (lwp)

• Macwrite (mw)

• Microsoft Excel (xls)

• Microsoft PowerPoint (ppt)

• Microsoft Word (doc)

• Microsoft Works (wks、wps、wdb)

• Microsoft 寫入 (wri)

• RTF 格式 (rtf)

• Shockwave Flash (swf)

• 文字 (ans、txt)。

日後可能會新增其他檔案類型。您隨時可以參閱 Google 的檔案類型常見問題，查看最新清單。

string

依授權建立的篩選器。支援的值包括：

• cc_publicdomain

• cc_attribute

• cc_sharealike

• cc_noncommercial

• cc_nonderived

string

允許的值為 web 或 image。如果未指定，搜尋結果僅限於網頁。

string

限制系統只傳回指定大小圖片的結果。支援的值如下：

• icon (小)

• small | medium | large | xlarge (中)

• xxlarge (大)

• huge (超大)

string

限制系統只傳回指定類型圖片的結果。支援的值如下：

• clipart (插圖)

• face (臉孔)

• lineart (線條繪圖)

• photo (相片)

• animated (動畫)

• stock (圖庫)

string

限制系統只傳回指定色彩類型圖片的結果。支援的值如下：

• mono (黑白)

• gray (灰階)

• color (顏色)

string

限制系統只傳回具有特定主要顏色的圖片。支援的值如下：

• red

• orange

• yellow

• green

• teal

• blue

• purple

• pink

• white

• gray

• black

• brown

object

代表下一頁結果的中繼資料 (如適用)。

string

查詢的說明。

string (int64 format)

預估總搜尋結果數量。可能不準確。

string

使用者輸入的搜尋字詞。

integer

這個組合中傳回的搜尋結果數量。

integer

目前搜尋結果集的索引，會呈現在結果總數中，其中第一個結果的索引為 1。

integer

這組結果的頁碼，頁面長度是由 count 屬性設定。

string

搜尋結果的語言。

string

搜尋要求支援的字元編碼。

string

搜尋結果支援的字元編碼。

string

指定用於過濾成人搜尋結果的安全搜尋層級。這是 OpenSearch 規格中尚未定義的自訂屬性。有效的參數值如下：

• "off"：停用安全搜尋

• "active"：啟用安全搜尋

string

透過程式化搜尋引擎控制台建立的引擎識別碼。這是 OpenSearch 規格中尚未定義的自訂屬性。這是必要參數。

string

指定應根據指定的運算式排序結果。例如依日期排序。

string

啟用或停用 Google 搜尋結果自動篩選功能。如要進一步瞭解 Google 的搜尋結果篩選器，請參閱自動篩選。這個參數的有效值如下：

• 0：已停用

• 1：已啟用 (預設)

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

string

針對來源國家/地區與參數值相符的搜尋結果提升排名。如需有效值的清單，請參閱國家/地區代碼。

在 WebSearch 要求中指定 gl 參數值，應能提高搜尋結果的關聯性。對國際客戶而言更是如此，更精確地說，對使用非美國語系國家/地區的客戶而言更是如此。

string

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

Google WebSearch 會分析下列項目，判斷文件的國家/地區：

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

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

如需這個參數的有效值清單，請參閱國家/地區 (cr) 參數值。

string

指定應限制搜尋的 Google 網域 (例如 google.com、google.de 或 google.fr)。

string

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

支援的值如下：

• 0：已啟用 (預設)

• 1：已停用

string

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

string

指定使用者介面的介面語言 (主機語言)。明確設定這個參數可改善搜尋結果的效能和品質。

詳情請參閱國際化查詢和結果呈現的介面語言一節；如需支援的語言清單，請參閱「支援的語言介面語言」。

string

限制系統只顯示來自指定網站的網址結果。

string

指定要納入或排除 sitesearch 參數所命名網站的結果。支援的值如下：

• i：包含網站內容

• e：從網站上排除內容

string

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

string

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

string

指定所有結果都應包含特定網址的連結。

string

提供要在文件中尋找的其他搜尋字詞，讓搜尋結果中的每份文件必須包含至少一個其他搜尋字詞。您也可以透過「Boolean OR」查詢字詞執行這類查詢。

string

指定所有搜尋結果應為與指定網址相關的網頁。參數值必須是網址。

string

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

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

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

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

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

string

指定搜尋範圍的起始值。使用 cse:lowRange 和 cse:highrange，在查詢中附加包含 lowRange...highRange 的搜尋範圍。

string

指定搜尋範圍的結束值。使用 cse:lowRange 和 cse:highrange，在查詢中附加包含 lowRange...highRange 的搜尋範圍。

string

限制系統只傳回指定擴充功能檔案的結果。Google 支援的檔案類型包括：

• Adobe 可攜式文件格式 (pdf)

• Adobe PostScript (ps)

• Lotus 1-2-3 (wk1、wk2、wk3、wk4、wk5、wki、wks、wku)

• Lotus WordPro (lwp)

• Macwrite (mw)

• Microsoft Excel (xls)

• Microsoft PowerPoint (ppt)

• Microsoft Word (doc)

• Microsoft Works (wks、wps、wdb)

• Microsoft 寫入 (wri)

• RTF 格式 (rtf)

• Shockwave Flash (swf)

• 文字 (ans、txt)。

日後可能會新增其他檔案類型。您隨時可以參閱 Google 的檔案類型常見問題，查看最新清單。

string

依授權建立的篩選器。支援的值包括：

• cc_publicdomain

• cc_attribute

• cc_sharealike

• cc_noncommercial

• cc_nonderived

string

允許的值為 web 或 image。如果未指定，搜尋結果僅限於網頁。

string

限制系統只傳回指定大小圖片的結果。支援的值如下：

• icon (小)

• small | medium | large | xlarge (中)

• xxlarge (大)

• huge (超大)

string

限制系統只傳回指定類型圖片的結果。支援的值如下：

• clipart (插圖)

• face (臉孔)

• lineart (線條繪圖)

• photo (相片)

• animated (動畫)

• stock (圖庫)

string

限制系統只傳回指定色彩類型圖片的結果。支援的值如下：

• mono (黑白)

• gray (灰階)

• color (顏色)

string

限制系統只傳回具有特定主要顏色的圖片。支援的值如下：

• red

• orange

• yellow

• green

• teal

• blue

• purple

• pink

• white

• gray

• black

• brown

object (Promotion)

促銷活動組合。只有在自訂搜尋引擎的設定檔定義了特定查詢的任何置頂查詢時，才會顯示。

object (Struct format)

與指定搜尋引擎相關的中繼資料和修正項目，包括：

• 查詢使用的搜尋引擎名稱。

• 可用來縮小搜尋範圍的一組 facet 物件 (精細調整)。

object

這項搜尋查詢的中繼資料，包括搜尋時間和總搜尋結果數。

number

伺服器傳回搜尋結果所需的時間。

string

伺服器傳回搜尋結果所需的時間 (根據語言代碼樣式設定)。

string

查詢傳回的搜尋結果總數。

string

根據語言代碼樣式設定格式的搜尋結果總數。

object

封裝修正後的查詢。

string

修正後的查詢。

string

更正後的查詢 (格式為 HTML)。

object (Result)

目前的自訂搜尋結果組合。