Sites: list
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
需要授權
列出使用者的 Search Console 網站。
立即試用。
要求
HTTP 要求
GET https://www.googleapis.com/webmasters/v3/sites
授權
這項要求需要至少擁有下列其中一個範圍的授權 (進一步瞭解驗證和授權)。
| 範圍 |
|---|
https://www.googleapis.com/auth/webmasters.readonly |
https://www.googleapis.com/auth/webmasters |
要求主體
請勿使用這個方法提供請求主體。
回應
如果成功的話，這個方法會傳回回應內文，其結構如下：
試試看！
使用下方的 APIs Explorer，針對即時資料呼叫這個方法，看看會有什麼結果。
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2024-08-24 (世界標準時間)。
[null,null,["上次更新時間：2024-08-24 (世界標準時間)。"],[[["\u003cp\u003eLists the Search Console sites that a user has access to, along with their permission levels.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization using specific scopes to access the data.\u003c/p\u003e\n"],["\u003cp\u003eUses a simple \u003ccode\u003eGET\u003c/code\u003e request to retrieve the list of sites.\u003c/p\u003e\n"],["\u003cp\u003eReturns a response containing an array of \u003ccode\u003esiteEntry\u003c/code\u003e objects, each representing a Search Console site with its associated permissions.\u003c/p\u003e\n"]]],["This document outlines how to list a user's Search Console sites via the Webmasters API v3. The `GET` request to `https://www.googleapis.com/webmasters/v3/sites` requires authorization using either the `webmasters.readonly` or `webmasters` scope. No request body is needed. A successful response returns a JSON object containing a `siteEntry` list. Each entry details permission level information for a Search Console site. The provided link gives more information on Search Console permissions.\n"],null,["# Sites: list\n\n**Requires [authorization](#auth)**\n\nLists the user's Search Console sites.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nGET https://www.googleapis.com/webmasters/v3/sites\n```\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes ([read more about authentication and authorization](/webmaster-tools/v1/how-tos/authorizing)).\n\n| Scope |\n|-------------------------------------------------------|\n| `https://www.googleapis.com/auth/webmasters.readonly` |\n| `https://www.googleapis.com/auth/webmasters` |\n\n### Request body\n\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure:\n\n```objective-c\n{\n \"siteEntry\": [\n sites Resource\n ]\n}\n```\n\n| Property name | Value | Description | Notes |\n|---------------|--------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `siteEntry[]` | `list` | Contains permission level information about a Search Console site. For more information, see [Permissions in Search Console](https://support.google.com/webmasters/answer/2451999). | |\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response."]]
