Sites: list
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Cần phải uỷ quyền
Liệt kê các trang web của người dùng trong Search Console.
Thử ngay.
Yêu cầu
Yêu cầu HTTP
GET https://www.googleapis.com/webmasters/v3/sites
Ủy quyền
Yêu cầu này cần có sự uỷ quyền với ít nhất một trong các phạm vi sau (đọc thêm về tính năng xác thực và uỷ quyền).
| Phạm vi |
|---|
https://www.googleapis.com/auth/webmasters.readonly |
https://www.googleapis.com/auth/webmasters |
Nội dung yêu cầu
Đừng cung cấp nội dung yêu cầu bằng phương thức này.
Phản hồi
Nếu thành công, phương thức này sẽ trả về nội dung phản hồi có cấu trúc như sau:
{
"siteEntry": [
sites Resource
]
}
| Tên tài sản |
Giá trị |
Mô tả |
Ghi chú |
siteEntry[] |
list |
Chứa thông tin về cấp độ quyền của một trang web trong Search Console. Để biết thêm thông tin, hãy xem bài viết Quyền trong Search Console. |
|
Hãy dùng thử!
Hãy sử dụng APIs Explorer (Trình khám phá API) bên dưới để gọi phương thức này trên dữ liệu trực tiếp và xem phản hồi.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2024-08-24 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2024-08-24 UTC."],[[["\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."]]
