Method: projects.locations.registrations.import

Deprecated: For more information, see Cloud Domains feature deprecation

Imports a domain name from Google Domains for use in Cloud Domains.

To transfer a domain from another registrar, use the registrations.transfer method instead.

Since individual users can own domains in Google Domains, the calling user must have ownership permission on the domain.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Required. The parent resource of the Registration. Must be in the format projects/*/locations/*.

Authorization requires the following IAM permission on the specified resource parent:

  • domains.registrations.create

Request body

The request body contains data with the following structure:

JSON representation
  "domainName": string,
  "labels": {
    string: string,


Required. The domain name. Unicode domain names must be expressed in Punycode format.


map (key: string, value: string)

Set of labels associated with the Registration.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Response body

If successful, the response body contains an instance of Operation.

Authorization scopes

Requires the following OAuth scope:


For more information, see the Authentication Overview.