Method: domains.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.
Liệt kê các miền mà ứng dụng khách đã đăng ký. Thứ tự của các miền trong phản hồi không được chỉ định và không xác định. Các miền mới tạo không nhất thiết phải được thêm vào cuối danh sách này.
Yêu cầu HTTP
GET https://gmailpostmastertools.googleapis.com/v1/domains
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số truy vấn
Thông số |
pageSize |
integer
Kích thước trang được yêu cầu. Máy chủ có thể trả về ít miền hơn yêu cầu. Nếu không được chỉ định, máy chủ sẽ chọn một giá trị mặc định phù hợp.
|
pageToken |
string
Giá trị nextPageToken được trả về từ một yêu cầu Liệt kê trước đó, nếu có. Đây là giá trị của ListDomainsResponse.next_page_token được trả về từ lệnh gọi trước đó đến phương thức domains.list .
|
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Nội dung phản hồi
Thông báo phản hồi cho domains.list.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
{
"domains": [
{
object (Domain )
}
],
"nextPageToken": string
} |
Trường |
domains[] |
object (Domain )
Danh sách miền.
|
nextPageToken |
string
Mã thông báo để truy xuất trang kết quả tiếp theo hoặc để trống nếu không còn kết quả nào trong danh sách.
|
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/postmaster.readonly
Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.
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: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[],[],null,["# Method: domains.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListDomainsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists the domains that have been registered by the client. The order of domains in the response is unspecified and non-deterministic. Newly created domains will not necessarily be added to the end of this list.\n\n### HTTP request\n\n`GET https://gmailpostmastertools.googleapis.com/v1/domains`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|-------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` Requested page size. Server may return fewer domains than requested. If unspecified, server will pick an appropriate default. |\n| `pageToken` | `string` The nextPageToken value returned from a previous List request, if any. This is the value of [ListDomainsResponse.next_page_token](/workspace/gmail/postmaster/reference/rest/v1/domains/list#body.ListDomainsResponse.FIELDS.next_page_token) returned from the previous call to `domains.list` method. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse message for domains.list.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"domains\": [ { object (/workspace/gmail/postmaster/reference/rest/v1/domains#Domain) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|----------------------------------------------------------------------------------------------------------|\n| `domains[]` | `object (`[Domain](/workspace/gmail/postmaster/reference/rest/v1/domains#Domain)`)` The list of domains. |\n| `nextPageToken` | `string` Token to retrieve the next page of results, or empty if there are no more results in the list. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/postmaster.readonly`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]