Method: domains.list
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
רשימה של הדומיינים שרשומים על ידי הלקוח. הסדר של הדומיינים בתגובה לא מצוין ולא דטרמיניסטי. דומיינים חדשים שנוצרים לא בהכרח יתווספו לסוף הרשימה הזו.
בקשת HTTP
GET https://gmailpostmastertools.googleapis.com/v1/domains
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של שאילתה
| פרמטרים |
pageSize |
integer
גודל הדף המבוקש. יכול להיות שהשרת יחזיר פחות דומיינים מהמספר שביקשת. אם לא מציינים ערך, השרת יבחר ברירת מחדל מתאימה.
|
pageToken |
string
הערך של nextPageToken שהוחזר מבקשת List קודמת, אם יש כזו. זהו הערך של ListDomainsResponse.next_page_token שהוחזר מהקריאה הקודמת לשיטה domains.list.
|
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
הודעת התגובה עבור domains.list.
אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:
| ייצוג ב-JSON |
{
"domains": [
{
object (Domain)
}
],
"nextPageToken": string
} |
| שדות |
domains[] |
object (Domain)
רשימת הדומיינים.
|
nextPageToken |
string
אסימון לאחזור של דף התוצאות הבא, או ריק אם אין יותר תוצאות ברשימה.
|
היקפי הרשאה
נדרש היקף הרשאות OAuth הבא:
https://www.googleapis.com/auth/postmaster.readonly
מידע נוסף זמין במדריך ההרשאות.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[null,null,["עדכון אחרון: 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)."]]
