Custom Search JSON API Reference
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
本 API 參考資料是依照資源類型編排。各個資源類型都具有一或多種資料表示法,以及一或多種方法。
資源類型
-
CSE
-
Cse.siterestrict
CSE
如要進一步瞭解 CSE 資源,請參閱資源表示法網頁。
方法 |
HTTP 要求 |
說明 |
相對於 https://www.googleapis.com 的 URI (除非另有註明) |
list
|
GET /customsearch/v1
|
cse.list 方法會傳回執行搜尋的相關中繼資料,以及用於搜尋的自訂搜尋引擎相關中繼資料,以及搜尋結果。
必要的查詢參數:
cx 、q |
Cse.siterestrict
如要進一步瞭解 Cse.siterestrict 資源,請參閱資源表示法網頁。
方法 |
HTTP 要求 |
說明 |
相對於 https://www.googleapis.com 的 URI (除非另有註明) |
list
|
GET /customsearch/v1/siterestrict
|
傳回所執行搜尋的相關中繼資料、搜尋用的自訂搜尋引擎的中繼資料,以及搜尋結果。使用少量網址模式。
必要的查詢參數:
cx 、q |
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-25 (世界標準時間)。
[null,null,["上次更新時間:2025-07-25 (世界標準時間)。"],[[["\u003cp\u003eThis API reference is organized by resource type, with each type having one or more data representations and methods.\u003c/p\u003e\n"],["\u003cp\u003eThe two main resource types are CSE and Cse.siterestrict, each with their own set of methods for interacting with them.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ecse.list\u003c/code\u003e method allows you to retrieve metadata about a search, the custom search engine used, and the search results themselves using required query parameters \u003ccode\u003ecx\u003c/code\u003e and \u003ccode\u003eq\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eSimilarly, the \u003ccode\u003esiterestrict.list\u003c/code\u003e method provides similar search metadata and results but utilizes a smaller set of URL patterns and also requires \u003ccode\u003ecx\u003c/code\u003e and \u003ccode\u003eq\u003c/code\u003e query parameters.\u003c/p\u003e\n"]]],[],null,["# Custom Search JSON API Reference\n\nThis API reference is organized by resource type. Each resource type has one or more data representations and one or more methods.\n\nResource types\n--------------\n\n1. [CSE](#CSE)\n2. [Cse.siterestrict](#Cse.siterestrict)\n\nCSE\n---\n\nFor CSE Resource details, see the [resource representation](/custom-search/v1/cse#resource) page.\n\n| Method | HTTP request | Description |\n|------------------------------------|------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| URIs relative to https://www.googleapis.com, unless otherwise noted |||\n| [list](/custom-search/v1/cse/list) | `GET /customsearch/v1` | The [cse.list](#method_search.cse.list) method returns metadata about the search performed, metadata about the custom search engine used for the search, and the search results. \u003cbr /\u003e **Required query parameters:** `cx`, `q` |\n\nCse.siterestrict\n----------------\n\nFor Cse.siterestrict Resource details, see the [resource representation](/custom-search/v1/cse/siterestrict#resource) page.\n\n| Method | HTTP request | Description |\n|-------------------------------------------------|-------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| URIs relative to https://www.googleapis.com, unless otherwise noted |||\n| [list](/custom-search/v1/cse/siterestrict/list) | `GET /customsearch/v1/siterestrict` | Returns metadata about the search performed, metadata about the custom search engine used for the search, and the search results. Uses a small set of url patterns. \u003cbr /\u003e **Required query parameters:** `cx`, `q` |"]]