Register a domain  |  Cloud Domains  |  Google Cloud (2024)

In the Google Cloud console, go to theCloud Domains page.

Go to Cloud Domains

Click add_shopping_cart Selectnext to the domain name that you want to purchase.You can add as many domains as you like, subject to your availablequota. For details, see Quotas and limits.

The total pricing based on your selection is calculated and displayedin the Search domain section. To remove a domain from your cart,click deleteDeselect next to thedomain name.

After you set up billing and complete your domain registration,Cloud Domains automatically sets the registration toAuto-renew.

Click Continue.

In the DNS configuration section, choose one of the following DNSproviders for your name servers. If you are registering multipledomains, you can choose individual settings for each domain.

• If you select the default value Use Cloud DNS (Recommended),Google Cloud automatically creates a zone for you. To editthe zone name and other details, do the following:

  1. In the Cloud DNS zone list, select Setup new zone.
  2. Make the required edits, and then click Save and continue.

  If you already created a zone in Cloud DNS,Cloud Domains selects that zone by default.

• If you select Use custom name servers, enter at least two nameservers. To add more name servers, click Add another name server.

Click Continue.

By default, privacy protection is turned on. However, you can change thesettings to one of the privacy options in the following table.

For information about how to use contact privacy, see the ContactPrivacy section in the reference documentation.

To limit which information is available to the public, selectLimit your info available to the public. This option is onlyavailable for .com and .net domains.

To make all contact information publicly available, selectMake all contact info public.

If you agree with the statement in the dialog, click I agree.

Click Continue.

Enter your contact informationfor the domain, which is necessary forICANN toreach you if there are any problems. By default, the same contactdetails that you enter are applied to the registrant, administrative,and technical contacts. To enter different information for each type ofcontact, you can edit your contactsettingslater.

If you are registering more than one domain, you can choose toapply the same contact details to all domains or chooseto enter different contact details for each domain.

Click Register.

Processing your registration can take a few minutes.

Cloud Domains or Squarespace sends a verificationemail to the email address that you enter.

To search for an available domain name, use thegcloud domains registrations search-domains command:

gcloud domains registrations search-domains SEARCH_TERM

Replace SEARCH_TERM with any non-empty string tosearch for a domain name, such as example. This search returnssuggestions for possible domain names that you can register.

To check up-to-date availability for a domain name and get theparameters needed to register a new domain, including price,availability, supported privacy modes, and notices, use thegcloud domains registrations get-register-parameters command:

gcloud domains registrations get-register-parameters DOMAIN_NAME

Replace DOMAIN_NAME with the domain name that youwant to check availability for, such as example.app.

Your output looks similar to the following:

 availability: AVAILABLE domainName: example.app domainNotices: ‐ HSTS_PRELOADED supportedPrivacy: ‐ PRIVATE_CONTACT_DATA ‐ PUBLIC_CONTACT_DATA yearlyPrice: currencyCode: USD units: '12'

You can choose a DNS provider for your name servers based on theDNS provider options explainedin the overview. If you choose Cloud DNS as your DNS provider,you must first create a managed public zone for your domain.

To create a managed public zone, use thedns managed-zones create command:

gcloud dns managed-zones create CLOUD_DNS_ZONE_NAME \ --description="DESCRIPTION" \ --dns-name=DOMAIN_NAME \

Replace the following:

• CLOUD_DNS_ZONE_NAME: a name for your zone
• DESCRIPTION: a description for your zone

• DOMAIN_NAME: the DNS domain name for your zone,such as example.com

  Use the same domain name that you used in the previous commands,which is the domain name that you are registering.

To register the domain, use the gcloud domains registrationsregister command:

gcloud domains registrations register DOMAIN_NAME

Replace DOMAIN_NAME with the domain name that you wantto register, such as example.app.

Your output looks similar to the following when you register the domainexample.com by using name servers provided by Cloud DNS:

Yearly price: 12.00 USDDo you agree to pay this yearly price for your domain (y/N)? yYou can provide your DNS settings by specifying name servers or a CloudDNS Managed Zone name [1] Provide name servers list [2] Provide Cloud DNS managed zone namePlease enter your numeric choice (2): NAME_SERVER_CHOICECloud DNS Managed Zone name: CLOUD_DNS_ZONECloud DNS Zone 'CLOUD_DNS_ZONE' is not signed. DNSSEC won't be enabled.Contact data not provided using the --contact-data-from-file flag.Do you want to enter it interactively (Y/n)? yFull name: NAMEOrganization (if applicable): ORGANIZATIONEmail: EMAIL_ADDRESSEnter phone number with country code, e.g. "+1.8005550123".Phone number: PHONE_NUMBEREnter fax number with country code, e.g. "+1.8005550123".Fax number (if applicable): FAX_NUMBEREnter two-letter Country / Region code, e.g. "US" or "PL".Refer to the guidelines for entering address field information at https://support.google.com/business/answer/6397478.Country / Region code: COUNTRY_CODEPostal / ZIP code: ZIP_CODEState / Administrative area (if applicable): STATECity / Locality: CITYAddress Line 1: ADDRESS_LINE_1Address Line 2 (if applicable): ADDRESS_LINE_2Address Line 3 (if applicable):Specify contact privacy [1] private-contact-data [2] public-contact-dataPlease enter your numeric choice (1): DATA_PRIVACY_CHOICEWaiting for 'operation-1597880129306-5ad437580410d-2c65d582-0861c5b7' tocomplete...done.Created registration [example.com] Note:The domain is not yet registered.Wait until the registration resource changes state to ACTIVE.

Replace the following:

• NAME_SERVER_CHOICE: choose the name server optionbased on yourDNS provider choice
• CLOUD_DNS_ZONE: the Cloud DNS managed zonename
• NAME: your full name—for example,Alice Smith
• ORGANIZATION: (optional) your organization—forexample, Doe Corp
• EMAIL_ADDRESS: your email address forverification—for example, [email protected]
• PHONE_NUMBER: the phone number of the contact ininternational format—for example, +1-800-555-0123
• FAX_NUMBER: (optional) the phone number of thecontact in international format—for example, +1-800-555-0123
• COUNTRY_CODE: the country or region code of theaddress—for example, US for United States
• ZIP_CODE: the postal code or ZIP code of theaddress—for example, 94043
• STATE: the state or administrative area of theaddress—for example, CA
• CITY: the city or locality of theaddress—for example, Mountain View

• ADDRESS_LINE_1: the first address line of theregistrant—for example, 1599 Bayview Parkway

  You can have up to 5 address lines, but only the first one is required.

• ADDRESS_LINE_2: (optional) the second address lineof the registrant—for example, APT. 123

  You must enter the address accurately because it is used for domainrecovery in case you lose access to your registration. For details, seethe guidelines for entering address field information.

• DATA_PRIVACY_CHOICE: your data privacy choice

  For detailed information about privacy options, seePrivacy protection.

To search for an available domain name, use theregistrations.searchDomains methodwith an empty request body:

GET https://domains.googleapis.com/v1/projects/PROJECT_ID/locations/global/registrations:searchDomains?query=SEARCH_TERM

Replace the following:

• PROJECT_ID: the ID of the project where the domainregistration is created

• SEARCH_TERM: any non-empty string tosearch for a domain name, such as example

  This search returns suggestions for possible domain names that you canregister.

To check up-to-date availability for a domain name and get theparameters needed to register a new domain, including price,availability, supported privacy modes, and notices, use theregistrations.retrieveRegisterParameters methodwith an empty body:

GET https://domains.googleapis.com/v1/projects/PROJECT_ID/locations/global/registrations:retrieveRegisterParameters?domainName=DOMAIN_NAME

Replace the following:

• PROJECT_ID: the ID of the project where themanaged zone is created
• DOMAIN_NAME: the domain name that you want to checkavailability for, such as example.app

The resulting response contains the yearlyPrice for the domain, whichyou need to use in the registrations.register API call.

You can choose a DNS provider for your name servers based on theDNS provider options explainedin the overview. If you choose Cloud DNS as your DNS provider,you must first create a managed public zone for your domain.

To create a managed public zone, use themanagedZones.create method:

POST https://dns.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones{ "name": "ZONE_NAME", "description": "DESCRIPTION", "dnsName": "DOMAIN_NAME.", "visibility": "public"}

Replace the following:

• PROJECT_ID: the ID of the project where the managedzone is created
• ZONE_NAME: a name for your zone
• DESCRIPTION: a description for your zone

• DOMAIN_NAME.: the DNS suffix for your zone,such as example.com

The resulting response contains a nameServers list that you must usein the registrations.register API call.

To register the domain, use the registrations.registermethod:

POST https://domains.googleapis.com/v1/projects/PROJECT_ID/locations/global/registrations:register{ "registration": { "domainName": "DOMAIN_NAME", "dnsSettings": { "customDns": { "nameServers": [ "NAME_SERVERS" ] } }, "contactSettings": { "privacy": "CONTACT_PRIVACY", "registrantContact": { "postalAddress": { "regionCode": "REGION_CODE", "postalCode": "POSTAL_CODE", "administrativeArea": "SUBDIVISION", "locality": "CITY", "addressLines": [ "ADDRESS" ], "recipients": [ "CONTACT_NAME" ], "organization": "ORGANIZATION" }, "email": "EMAIL_ADDRESS", "phoneNumber": "PHONE_NUMBER", "faxNumber": "FAX_NUMBER" }, "adminContact": { "postalAddress": { "regionCode": "REGION_CODE", "postalCode": "POSTAL_CODE", "administrativeArea": "SUBDIVISION", "locality": "CITY", "addressLines": [ "ADDRESS" ], "recipients": [ "CONTACT_NAME" ], "organization": "ORGANIZATION" }, "email": "EMAIL_ADDRESS", "phoneNumber": "PHONE_NUMBER", "faxNumber": "FAX_NUMBER" }, "technicalContact": { "postalAddress": { "regionCode": "REGION_CODE", "postalCode": "POSTAL_CODE", "administrativeArea": "SUBDIVISION", "locality": "CITY", "addressLines": [ "ADDRESS" ], "recipients": [ "CONTACT_NAME" ], "organization": "ORGANIZATION" }, "email": "EMAIL_ADDRESS", "phoneNumber": "PHONE_NUMBER", "faxNumber": "FAX_NUMBER" } } }, "yearlyPrice": { "currencyCode": "CURRENCY_CODE", "units": NUMBER_OF_UNITS }}

Replace the following:

• PROJECT_ID: the ID of the project where you createdthe registration resource
• DOMAIN_NAME: the domain name that you want toregister, such as example.com

• NAME_SERVERS: the name servers that you want to use

  If you are usingCloud DNS, use the nameServers field output that you gotfrom the managedZones.create.post API call.

• CONTACT_PRIVACY: the preferred privacy setting forthe contact data

  For detailed information about the available privacy options, see theContactPrivacy resourcein the Cloud Domains API.

Replace the following values for registrantContact, adminContact,and technicalContact. For detailed information about each type ofcontact, seeContact information.

• REGION_CODE: the region code of theaddress—for example, US for United States
• POSTAL_CODE: the postal code of theaddress—for example, 94043
• SUBDIVISION: the highest administrative subdivisionof an address, such as a state, a province, an oblast, or aprefecture—for example, CA for the state of California
• CITY: the name of the city or town of theaddress—for example, Mountain View
• ADDRESS: the lower levels of an address—forexample, 1599 Amphitheater Parkway
• CONTACT_NAME: the name of the contact
• ORGANIZATION: (optional) the name of theorganization that is registering the domain—for example,Doe Corporation
• EMAIL_ADDRESS: the email address of thecontact—for example, [email protected]
• PHONE_NUMBER: the phone number of the contact ininternational format—for example, +1-800-555-0123

• FAX_NUMBER: (optional) the fax number of thecontact in international format—for example, +1-800-555-0123

  You must enter the address accurately because it is used for domainrecovery in case you lose access to your registration. For details, seethe guidelines for entering address fieldinformation.

Replace the following values for the yearly price of the domain. This isthe amount obtained from the yearlyPrice field in theregistrations.retrieveRegisterParameters API call:

• CURRENCY_CODE: the three-letter currency codeas defined in ISO4217—forexample, USD
• NUMBER_OF_UNITS: the whole units of theamount—for example, if currencyCode is USD, then one unitis one US dollar