Search

自訂搜尋要求的回應。

JSON 表示法 
{
  "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)
    }
  ]
}
欄位
kind

string

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

object

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

string

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

string

這個 API 的實際 OpenSearch 範本。
queries

object

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

object

代表前一頁結果的中繼資料 (如適用)。
queries.previousPage[].title

string

查詢的說明。
queries.previousPage[].totalResults

string (int64 format)

預估總搜尋結果數量。可能不準確。
queries.previousPage[].searchTerms

string

使用者輸入的搜尋字詞。
queries.previousPage[].count

integer

這個組合中傳回的搜尋結果數量。
queries.previousPage[].startIndex

integer

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

integer

這組結果的頁碼，頁面長度是由 count 屬性設定。
queries.previousPage[].language

string

搜尋結果的語言。
queries.previousPage[].inputEncoding

string

搜尋要求支援的字元編碼。
queries.previousPage[].outputEncoding

string

搜尋結果支援的字元編碼。
queries.previousPage[].safe

string

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

  • "off"：停用安全搜尋

  • "active"：啟用安全搜尋
queries.previousPage[].cx

string

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

string

指定應根據指定的運算式排序結果。例如依日期排序。
queries.previousPage[].filter

string

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

  • 0：已停用

  • 1：已啟用 (預設)

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

string

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

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

string

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

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

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

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

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

string

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

string

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

支援的值如下：

  • 0：已啟用 (預設)

  • 1：已停用
queries.previousPage[].hq

string

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

string

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

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

string

限制系統只顯示來自指定網站的網址結果。
queries.previousPage[].siteSearchFilter

string

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

  • i：包含網站內容

  • e：從網站上排除內容
queries.previousPage[].exactTerms

string

識別搜尋結果中所有文件都必須包含的詞組。
queries.previousPage[].excludeTerms

string

識別不應出現在任何文件文件的字詞或詞組。
queries.previousPage[].linkSite

string

指定所有結果都應包含特定網址的連結。
queries.previousPage[].orTerms

string

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

string

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

string

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

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

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

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

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

string

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

string

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

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 的檔案類型常見問題，查看最新清單。
queries.previousPage[].rights

string

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

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived
queries.previousPage[].searchType

string

允許的值為 web 或 image。如果未指定，搜尋結果僅限於網頁。
queries.previousPage[].imgSize

string

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

  • icon (小)

  • small | medium | large | xlarge (中)

  • xxlarge (大)

  • huge (超大)
queries.previousPage[].imgType

string

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

  • clipart (插圖)

  • face (臉孔)

  • lineart (線條繪圖)

  • photo (相片)

  • animated (動畫)

  • stock (圖庫)
queries.previousPage[].imgColorType

string

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

  • mono (黑白)

  • gray (灰階)

  • color (顏色)
queries.previousPage[].imgDominantColor

string

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

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown
queries.request[]

object

代表目前要求的中繼資料。
queries.request[].title

string

查詢的說明。
queries.request[].totalResults

string (int64 format)

預估總搜尋結果數量。可能不準確。
queries.request[].searchTerms

string

使用者輸入的搜尋字詞。
queries.request[].count

integer

這個組合中傳回的搜尋結果數量。
queries.request[].startIndex

integer

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

integer

這組結果的頁碼，頁面長度是由 count 屬性設定。
queries.request[].language

string

搜尋結果的語言。
queries.request[].inputEncoding

string

搜尋要求支援的字元編碼。
queries.request[].outputEncoding

string

搜尋結果支援的字元編碼。
queries.request[].safe

string

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

  • "off"：停用安全搜尋

  • "active"：啟用安全搜尋
queries.request[].cx

string

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

string

指定應根據指定的運算式排序結果。例如依日期排序。
queries.request[].filter

string

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

  • 0：已停用

  • 1：已啟用 (預設)

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

string

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

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

string

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

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

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

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

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

string

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

string

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

支援的值如下：

  • 0：已啟用 (預設)

  • 1：已停用
queries.request[].hq

string

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

string

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

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

string

限制系統只顯示來自指定網站的網址結果。
queries.request[].siteSearchFilter

string

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

  • i：包含網站內容

  • e：從網站上排除內容
queries.request[].exactTerms

string

識別搜尋結果中所有文件都必須包含的詞組。
queries.request[].excludeTerms

string

識別不應出現在任何文件文件的字詞或詞組。
queries.request[].linkSite

string

指定所有結果都應包含特定網址的連結。
queries.request[].orTerms

string

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

string

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

string

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

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

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

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

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

string

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

string

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

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 的檔案類型常見問題，查看最新清單。
queries.request[].rights

string

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

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived
queries.request[].searchType

string

允許的值為 web 或 image。如果未指定，搜尋結果僅限於網頁。
queries.request[].imgSize

string

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

  • icon (小)

  • small | medium | large | xlarge (中)

  • xxlarge (大)

  • huge (超大)
queries.request[].imgType

string

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

  • clipart (插圖)

  • face (臉孔)

  • lineart (線條繪圖)

  • photo (相片)

  • animated (動畫)

  • stock (圖庫)
queries.request[].imgColorType

string

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

  • mono (黑白)

  • gray (灰階)

  • color (顏色)
queries.request[].imgDominantColor

string

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

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown
queries.nextPage[]

object

代表下一頁結果的中繼資料 (如適用)。
queries.nextPage[].title

string

查詢的說明。
queries.nextPage[].totalResults

string (int64 format)

預估總搜尋結果數量。可能不準確。
queries.nextPage[].searchTerms

string

使用者輸入的搜尋字詞。
queries.nextPage[].count

integer

這個組合中傳回的搜尋結果數量。
queries.nextPage[].startIndex

integer

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

integer

這組結果的頁碼，頁面長度是由 count 屬性設定。
queries.nextPage[].language

string

搜尋結果的語言。
queries.nextPage[].inputEncoding

string

搜尋要求支援的字元編碼。
queries.nextPage[].outputEncoding

string

搜尋結果支援的字元編碼。
queries.nextPage[].safe

string

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

  • "off"：停用安全搜尋

  • "active"：啟用安全搜尋
queries.nextPage[].cx

string

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

string

指定應根據指定的運算式排序結果。例如依日期排序。
queries.nextPage[].filter

string

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

  • 0：已停用

  • 1：已啟用 (預設)

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

string

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

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

string

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

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

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

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

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

string

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

string

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

支援的值如下：

  • 0：已啟用 (預設)

  • 1：已停用
queries.nextPage[].hq

string

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

string

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

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

string

限制系統只顯示來自指定網站的網址結果。
queries.nextPage[].siteSearchFilter

string

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

  • i：包含網站內容

  • e：從網站上排除內容
queries.nextPage[].exactTerms

string

識別搜尋結果中所有文件都必須包含的詞組。
queries.nextPage[].excludeTerms

string

識別不應出現在任何文件文件的字詞或詞組。
queries.nextPage[].linkSite

string

指定所有結果都應包含特定網址的連結。
queries.nextPage[].orTerms

string

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

string

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

string

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

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

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

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

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

string

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

string

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

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 的檔案類型常見問題，查看最新清單。
queries.nextPage[].rights

string

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

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived
queries.nextPage[].searchType

string

允許的值為 web 或 image。如果未指定，搜尋結果僅限於網頁。
queries.nextPage[].imgSize

string

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

  • icon (小)

  • small | medium | large | xlarge (中)

  • xxlarge (大)

  • huge (超大)
queries.nextPage[].imgType

string

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

  • clipart (插圖)

  • face (臉孔)

  • lineart (線條繪圖)

  • photo (相片)

  • animated (動畫)

  • stock (圖庫)
queries.nextPage[].imgColorType

string

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

  • mono (黑白)

  • gray (灰階)

  • color (顏色)
queries.nextPage[].imgDominantColor

string

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

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown
promotions[]

object (Promotion)

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

object (Struct format)

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

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

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

object

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

number

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

string

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

string

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

string

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

object

封裝修正後的查詢。
spelling.correctedQuery

string

修正後的查詢。
spelling.htmlCorrectedQuery

string

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

object (Result)

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

宣傳

促銷活動結果。

JSON 表示法 
{
  "title": string,
  "htmlTitle": string,
  "link": string,
  "displayLink": string,
  "bodyLines": [
    {
      "title": string,
      "htmlTitle": string,
      "url": string,
      "link": string
    }
  ],
  "image": {
    "source": string,
    "width": integer,
    "height": integer
  }
}
欄位
title

string

促銷活動的標題。
htmlTitle

string

促銷活動標題，格式為 HTML。
bodyLines[]

object

此促銷活動的區塊物件陣列。
bodyLines[].title

string

區塊物件的文字 (如果包含文字)。
bodyLines[].htmlTitle

string

區塊物件在 HTML 中的文字 (如果包含文字)。
bodyLines[].url

string

區塊物件連結的網址 (如有)。
bodyLines[].link

string

區塊物件連結的錨定文字 (如有連結)。
image

object

與這個促銷活動相關聯的圖片 (如有)。
image.source

string

這個促銷活動連結的圖片網址。
image.width

integer

圖片寬度 (以像素為單位)。
image.height

integer

圖片的高度 (以像素為單位)。

結果

自訂搜尋結果。

JSON 表示法 
{
  "kind": string,
  "title": string,
  "htmlTitle": string,
  "link": string,
  "displayLink": string,
  "snippet": string,
  "htmlSnippet": string,
  "cacheId": string,
  "formattedUrl": string,
  "htmlFormattedUrl": string,
  "pagemap": {
    object
  },
  "mime": string,
  "fileFormat": string,
  "image": {
    "contextLink": string,
    "height": integer,
    "width": integer,
    "byteSize": integer,
    "thumbnailLink": string,
    "thumbnailHeight": integer,
    "thumbnailWidth": integer
  },
  "labels": [
    {
      "name": string,
      "displayName": string,
      "label_with_op": string
    }
  ]
}
欄位
kind

string

目前物件類型的專屬 ID。這個 API 為 customsearch#result.
title

string

以純文字顯示的搜尋結果標題。
htmlTitle

string

HTML 中的搜尋結果標題。
snippet

string

以純文字顯示的搜尋結果摘要。
htmlSnippet

string

搜尋結果的摘要 (在 HTML 中)。
cacheId

string

指出 Google 搜尋結果的快取版本 ID。
formattedUrl

string

每筆搜尋結果在摘要後方顯示的網址。
htmlFormattedUrl

string

每個搜尋結果的摘要後方所顯示的 HTML 格式網址。
pagemap

object (Struct format)

包含這個搜尋結果的 PageMap 資訊。
mime

string

搜尋結果的 MIME 類型。
fileFormat

string

搜尋結果的檔案格式。
image

object

封裝搜尋結果中傳回的圖片的所有資訊。
image.contextLink

string

指向代管該圖片網頁的網址。
image.height

integer

圖片的高度，以像素為單位。
image.width

integer

圖片的寬度，以像素為單位。
image.byteSize

integer

圖片的大小，以位元組為單位。
image.thumbnailLink

string

縮圖網址。
image.thumbnailHeight

integer

縮圖的高度，以像素為單位。
image.thumbnailWidth

integer

縮圖的寬度 (以像素為單位)。
labels[]

object

封裝有關修正標籤的所有資訊。
labels[].name

string

修正標籤的名稱，可用來縮小搜尋範圍。請勿在使用者介面中顯示這項資訊，請改用 displayName。
labels[].displayName

string

修正標籤的顯示名稱。這是您在使用者介面中顯示的名稱。
labels[].label_with_op

string

修正標籤和相關的修正作業。