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 元素。

url.type

string

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

url.template

string

這個 API 的實際 OpenSearch 範本

queries

object

包含一或多組查詢中繼資料,並以角色名稱做為索引鍵。可能的角色名稱包括 OpenSearch 查詢角色定義的 request,以及兩個自訂角色:nextPagepreviousPage

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

使用程式化搜尋引擎控制台建立的引擎 ID。這是 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

提供要在文件中查看的其他搜尋字詞,而且搜尋結果中的每份文件必須包含至少一個額外搜尋字詞。您也可以在這類查詢中使用「布林值 OR」查詢字詞。

queries.previousPage[].relatedSite

string

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

queries.previousPage[].dateRestrict

string

根據日期限制搜尋結果。支援的值包括:

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

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

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

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

queries.previousPage[].lowRange

string

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

queries.previousPage[].highRange

string

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

queries.previousPage[].fileType

string

限制系統顯示特定擴充功能檔案的結果。Google 支援的檔案類型包括:

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

  • Adobe PostScript (ps)

  • 蓮花 1-2-3 (wk1wk2wk3wk4wk5wkiwkswku)

  • Lotus WordPro (lwp)

  • Macwrite (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wkswpswdb)

  • Microsoft Write (wri)

  • RTF 格式 (rtf)

  • 衝擊波閃光燈 (swf)

  • 文字 (anstxt)。

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

queries.previousPage[].rights

string

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

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived

queries.previousPage[].searchType

string

允許的值為 webimage。如果未指定,搜尋結果將只會顯示網頁。

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

使用程式化搜尋引擎控制台建立的引擎 ID。這是 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

提供要在文件中查看的其他搜尋字詞,而且搜尋結果中的每份文件必須包含至少一個額外搜尋字詞。您也可以在這類查詢中使用「布林值 OR」查詢字詞。

queries.request[].relatedSite

string

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

queries.request[].dateRestrict

string

根據日期限制搜尋結果。支援的值包括:

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

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

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

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

queries.request[].lowRange

string

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

queries.request[].highRange

string

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

queries.request[].fileType

string

限制系統顯示特定擴充功能檔案的結果。Google 支援的檔案類型包括:

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

  • Adobe PostScript (ps)

  • 蓮花 1-2-3 (wk1wk2wk3wk4wk5wkiwkswku)

  • Lotus WordPro (lwp)

  • Macwrite (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wkswpswdb)

  • Microsoft Write (wri)

  • RTF 格式 (rtf)

  • 衝擊波閃光燈 (swf)

  • 文字 (anstxt)。

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

queries.request[].rights

string

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

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived

queries.request[].searchType

string

允許的值為 webimage。如果未指定,搜尋結果將只會顯示網頁。

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

使用程式化搜尋引擎控制台建立的引擎 ID。這是 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

提供要在文件中查看的其他搜尋字詞,而且搜尋結果中的每份文件必須包含至少一個額外搜尋字詞。您也可以在這類查詢中使用「布林值 OR」查詢字詞。

queries.nextPage[].relatedSite

string

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

queries.nextPage[].dateRestrict

string

根據日期限制搜尋結果。支援的值包括:

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

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

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

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

queries.nextPage[].lowRange

string

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

queries.nextPage[].highRange

string

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

queries.nextPage[].fileType

string

限制系統顯示特定擴充功能檔案的結果。Google 支援的檔案類型包括:

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

  • Adobe PostScript (ps)

  • 蓮花 1-2-3 (wk1wk2wk3wk4wk5wkiwkswku)

  • Lotus WordPro (lwp)

  • Macwrite (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wkswpswdb)

  • Microsoft Write (wri)

  • RTF 格式 (rtf)

  • 衝擊波閃光燈 (swf)

  • 文字 (anstxt)。

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

queries.nextPage[].rights

string

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

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived

queries.nextPage[].searchType

string

允許的值為 webimage。如果未指定,搜尋結果將只會顯示網頁。

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

限制條件標籤和相關修正作業。