- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- Domain
- ResourceState
- Try it!
Deprecated: For more information, see Cloud Domains feature deprecation
Lists domain names from Google Domains that can be imported to Cloud Domains using the registrations.import
method.
Since individual users can own domains in Google Domains, the list of domains returned depends on the individual user making the call.
Domains already managed by Cloud Domains are not returned.
HTTP request
GET https://domains.googleapis.com/v1/{location=projects/*/locations/*}/registrations:retrieveImportableDomains
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
location |
Required. The location. Must be in the format Authorization requires the following IAM permission on the specified resource
|
Query parameters
Parameters | |
---|---|
pageSize |
Maximum number of results to return. |
pageToken |
When set to the |
Request body
The request body must be empty.
Response body
Deprecated: For more information, see Cloud Domains feature deprecation. Response for the registrations.retrieveImportableDomains
method.
If successful, the response body contains data with the following structure:
JSON representation |
---|
{
"domains": [
{
object ( |
Fields | |
---|---|
domains[] |
A list of domains that the calling user manages in Google Domains. |
nextPageToken |
When present, there are more results to retrieve. Set |
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview.
Domain
A domain that the calling user manages in Google Domains.
JSON representation |
---|
{ "domainName": string, "resourceState": enum ( |
Fields | |
---|---|
domainName |
The domain name. Unicode domain names are expressed in Punycode format. |
resourceState |
The state of this domain as a |
yearlyPrice |
Price to renew the domain for one year. Only set when |
ResourceState
Possible states of a domain as a Registration
resource.
Enums | |
---|---|
RESOURCE_STATE_UNSPECIFIED |
The assessment is undefined. |
IMPORTABLE |
A Registration resource can be created for this domain by calling registrations.import . |
UNSUPPORTED |
A Registration resource cannot be created for this domain because it is not supported by Cloud Domains; for example, the top-level domain is not supported or the registry charges non-standard pricing for yearly renewals. |
SUSPENDED |
A Registration resource cannot be created for this domain because it is suspended and needs to be resolved with Google Domains. |
EXPIRED |
A Registration resource cannot be created for this domain because it is expired and needs to be renewed with Google Domains. |
DELETED |
A Registration resource cannot be created for this domain because it is deleted, but it may be possible to restore it with Google Domains. |