This page describes how to edit registration settings, including contact settings, privacy settings, and DNS settings for an existing domain in Cloud Domains.
Edit contact and privacy settings
When you register a domain, you must submit contact information for that domain. There are three types of contact information:
- Registrant: Owner of the domain
- Admin: Person responsible for administrative decisions about your domain
- Technical: Person responsible for technical changes to your domain
You can choose to enter the same information for all three types of contacts for a domain or choose to enter different contact details for each type of contact. You can also edit existing contact settings.
Cloud Domains also enables you to choose the privacy settings for your contact information based on the available options for the domain ending that you choose. The following table shows the various privacy options that might be available:
Privacy option | Description |
---|---|
Privacy protection on | Choosing this option ensures that your contact information is not available to the public. To help protect your contact information and prevent spam, a third party provides alternate (proxy) contact information for your domain in the public directory. The third-party provider forwards all messages that are sent to your proxy contact information to the actual private contact information. Cloud Domains does not offer privacy protection for all domain endings or top-level domains (TLDs). Registries, the organizations that manage domain endings, have policies prohibiting the use of privacy protection for certain TLDs. To see privacy information for a specific TLD, click the TLD on the Supported TLD reference page. Privacy information for the TLD is available in the DNS reference section. |
Limit your info available to the public | Choosing this option makes limited personal contact information available to the public. The actual information available publicly depends on the domain that you have chosen. To see privacy information for a specific TLD, click the TLD on the Supported TLD reference page. Privacy information for the TLD is available in the DNS reference section. |
Make all contact info public | Choosing this option makes all your contact information available to the public through the WHOIS database. |
To edit a registration's contact settings, like email, phone number, and postal address, and to choose privacy settings for the contact information, follow these steps:
Console
- Go to the console.
- Click the domain name that you'd like to edit. You can also click more_vert next to the domain name to see the edit menu.
- To edit contact details including the name, address, and email associated with the domain, click Edit contact details.
- Make the required changes.
- Choose or edit the privacy settings. The privacy options available for the domain you have selected might vary.
- Click Save.
gcloud
Use the gcloud domains registrations configure
contacts
command:
gcloud domains registrations configure contacts DOMAIN_NAME
Replace DOMAIN_NAME
with the name of the registered
domain—for example, example.app
.
The following example shows the output when you change the privacy
settings for a domain example.com
:
Contact data not provided using the --contact-data-from-file flag. Do you want to enter it interactively (y/N)? y Which contact do you want to change? [1] all the contacts to the same value [2] registrant contact [3] admin contact [4] technical contact [5] cancel Please enter your numeric choice (1): 1 Full name: NAME Organization (if applicable): ORGANIZATION Email (darcy@gmail.com): EMAIL_ADDRESS Enter phone number with country code, e.g. "+1.8005550123". Phone number: PHONE_NUMBER Enter fax number with country code, e.g. "+1.8005550123". Fax number (if applicable): FAX_NUMBER Enter two-letter country 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_CODE Postal / ZIP code: ZIP_CODE State / Administrative area (if applicable): STATE City / Locality: CITY Address Line 1: ADDRESS_LINE_1 Address Line 2 (if applicable): ADDRESS_LINE_2 Address Line 3 (if applicable): Your current contact privacy is REDACTED_CONTACT_DATA. Do you want to change it (y/N)? y Specify contact privacy [1] private-contact-data [2] redacted-contact-data [3] public-contact-data Please enter your numeric choice (2): 1 Waiting for 'operation-1596738116518-5ac39903c0348-5391fe45-78f57284' to complete...done. Updated registration [example.com] Note: The contact settings are currently pending. In order to finalize the update you need to confirm the change. An email with instructions has been sent to the registrant.
Replace the following:
NAME
: your full name—for example,Alice Smith
.ORGANIZATION
: (optional) your organization—for example,Doe Corp
.EMAIL_ADDRESS
: your email address for verification—for examplealice@example.net
.PHONE_NUMBER
: the phone number of the contact in international format—for example,+1-800-555-0123
.FAX_NUMBER
: the fax number of the contact in international format—for example,+1-800-555-0123
.COUNTRY_CODE
: the country or region code of the address—for example,US
for United States.ZIP_CODE
: the postal code or ZIP code of the address—for example,94043
.STATE
: the state or administrative area of the address—for example,CA
.CITY
: the city or locality of the address—for example,Mountain View
.ADDRESS_LINE_1
: the first address line of the registrant—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 line of the registrant—for example,APT. 123
.
API
Use the registrations.configureContactSettings
method:
POST https://domains.googleapis.com/v1/projects/PROJECT_ID/locations/global/registrations/DOMAIN_NAME:configureContactSettings
Replace the following:
PROJECT_ID
: the name of your projectDOMAIN_NAME
: the domain for which you want to change contact settings
With a request body like the following:
To change the registrant contact's email address:
{ "contactSettings": { "registrantContact": { "email": "new-registrant@example.com", }, }, "updateMask": "registrantContact.email", }
To change the privacy setting to public:
{ "contactSettings": { "privacy": "PUBLIC_CONTACT_DATA", }, "updateMask": "privacy", "contactNotices": ["PUBLIC_CONTACT_DATA_ACKNOWLEDGEMENT"], }
To change the entire registrant contact and the privacy setting:
{ "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" } }, "updateMask": "privacy,registrantContact", }
Replace the following values for the
registrantContact
,adminContact
or thetechnicalContact
that you want to change:For detailed information on each type of contact, see Contact privacy.
CONTACT_PRIVACY
: the preferred privacy setting for the contact dataREGION_CODE
: the region code of the address—for example,US
for United StatesPOSTAL_CODE
: the postal code of the address—for example,94043
SUBDIVISION
: the highest administrative subdivision of an address, like a state, a province, an oblast, or a prefecture. For example,CA
for the state of CaliforniaCITY
: the name of the city or town of the address. For example,Mountain View
ADDRESS
: the lower levels of an address—for example,1599 Amphitheater Parkway
CONTACT_NAME
: the name of the contactORGANIZATION
: (optional) the name of the organization that is registering the domain—for example,Doe Corporation
EMAIL_ADDRESS
: the email address of the contact—for example,john@example.com
PHONE_NUMBER
: the phone number of the contact in international format—for example,+1-800-555-0123
FAX_NUMBER
: (optional) the fax number of the contact in international format—for example,+1-800-555-0123
.
Edit DNS settings
To edit or configure the DNS settings of a registration, including authoritative name servers for the domain, follow these steps:
Console
- Go to the console.
- Click the domain name that you'd like to edit. You can also click the more_vert icon next to the domain name to see the edit menu.
- To edit the DNS details including the DNS provider option and the DNSSEC
settings, click Edit DNS details. You can choose one of the
following available options:
DNS provider Description Cost Cloud DNS Google recommends that you use Cloud DNS as your DNS provider for all your name servers. Additional Cloud DNS charges apply. For details, see the Cloud DNS pricing page. Google Domains If you choose this option, you can configure your name servers through Cloud Domains, and then use Google Domains to configure the DNS resource records. Note that using Google Domains does not allow API access. No additional cost. Custom name servers Choosing the custom name server option enables you to set up your name servers using Cloud Domains, then configure your DNS resource records with a third-party DNS provider. Check with your DNS provider. - Click Save.
gcloud
Use the gcloud domains
registrations configure dns
command:
gcloud domains registrations configure dns DOMAIN_NAME
Replace the following:
DOMAIN_NAME
: The name of the registered domain—for example,example.app
.
The following example shows the output when you change the DNS provider
from Google Domains to Cloud DNS for the domain example.com
:
Your current DNS settings are: googleDomainsDns: dsState: DS_RECORDS_UNPUBLISHED nameServers: - ns-cloud-b1.googledomains.com - ns-cloud-b2.googledomains.com - ns-cloud-b3.googledomains.com - ns-cloud-b4.googledomains.com You can provide your DNS settings by specifying name servers, Cloud DNS Managed Zone name or by choosing free name servers provided by Google Domains [1] Provide name servers list [2] Provide Cloud DNS Managed Zone name [3] Use free name servers provided by Google Domains [4] cancel Please enter your numeric choice (4): 2 Cloud DNS Managed Zone name: example-app Waiting for 'operation-1596738623568-5ac39ae74fa6f-1025c18d-9d3a4872' to complete...done. Updated registration [example.com].
API
Use the
registrations.configureDnsSettings
method:
POST https://domains.googleapis.com/v1/projects/PROJECT_ID/locations/global/registrations/DOMAIN_NAME:configureDnsSettingsReplace the following:
PROJECT_ID
: the name of your projectDOMAIN_NAME
: the domain you want to change contact settings for
The request body can be one of the following:
To update or switch to custom name servers:
{ "dnsSettings": { "customDns": { "nameServers": [ "ns-cloud-a1.googledomains.com", "ns-cloud-a2.googledomains.com", "ns-cloud-a3.googledomains.com", "ns-cloud-a4.googledomains.com" ] } }, "updateMask": "customDns" }
To update or switch to Google Domains name servers:
{ "dnsSettings": { "googleDomainsDns": { "dsState": "DS_RECORDS_UNPUBLISHED" } }, "updateMask": "googleDomainsDns" }
What's next
- To get started using Cloud Domains, see the Quickstart.
- To get an overview of Cloud Domains, see Cloud Domains overview.
- To access API information, see Cloud Domains API.
- To find solutions for common issues that you might encounter when using Cloud Domains, see Troubleshooting.