Method: domains.list
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Elenca i domini registrati dal cliente. L'ordine dei domini nella risposta non è specificato e non è deterministico. I domini appena creati non verranno necessariamente aggiunti alla fine di questo elenco.
Richiesta HTTP
GET https://gmailpostmastertools.googleapis.com/v1/domains
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri di query
| Parametri |
pageSize |
integer
Dimensioni della pagina richiesta. Il server potrebbe restituire meno domini rispetto a quelli richiesti. Se non viene specificato, il server sceglierà un valore predefinito appropriato.
|
pageToken |
string
Il valore nextPageToken restituito da una precedente richiesta di elenco, se presente. Questo è il valore di ListDomainsResponse.next_page_token restituito dalla chiamata precedente al metodo domains.list.
|
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
Messaggio di risposta per domains.list.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
| Rappresentazione JSON |
{
"domains": [
{
object (Domain)
}
],
"nextPageToken": string
} |
| Campi |
domains[] |
object (Domain)
L'elenco dei domini.
|
nextPageToken |
string
Token per recuperare la pagina di risultati successiva o vuoto se non ci sono altri risultati nell'elenco.
|
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/postmaster.readonly
Per ulteriori informazioni, consulta la Guida all'autorizzazione.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[null,null,["Ultimo aggiornamento 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)."]]
