Verifying a domain name

If you already own a domain name (such as example.com), and you want to use this domain name as the name of your Cloud Endpoints service, you must prove that you are authorized to use the domain. If you don't have your own domain name, you can use a domain managed by Google, in which case you don't have to verify ownership.

This page describes how to verify your ownership of a domain name that you want to use for your API running on Google Cloud Platform (GCP).

Service name requirements

Typically, you configure your Endpoints service name to be the same as your domain name. Endpoints has the following requirements for the service name:

  • The maximum length of the domain name is 253 characters.
  • The domain name must start with a lowercase letter.
  • Each section in the domain name, which is delimited by dots, has the following requirements:
    • Must start with a lowercase letter.
    • Must not end with a dash.
    • The remaining characters can be lowercase letters, numbers, or dashes.
    • The maximum length is 63 characters.

Verifying ownership

Only the user account that has verified ownership of the domain name can deploy the API initially. After that first API deployment, project members with Editor permissions can deploy it.

To verify that you own the domain name:

  1. Go to Google Webmaster Central to add the domain.

  2. Click Add a Property.

  3. Enter your domain URL and click Continue.

  4. On the Verifications methods page, click the Alternate methods tab.

  5. Click Domain name provider and select your provider from the list.

    Webmaster Central UI

  6. Follow the directions provided on the Webmaster Central tab, and then click Verify.

Delegating to developers

After you are verified as a domain owner in Web Central, you can optionally delegate access to subdomains to developers within the organization. This allows those developers to create Endpoints APIs without having to verify domain ownership themselves.

For more information on delegating, see Managing users, owners, and permissions.

Configuring your domain for SSL

You might want to configure your domain for SSL. Note that some types of authentication require SSL.

What's next

Was this page helpful? Let us know how we did:

Send feedback about...

Cloud Endpoints with gRPC
Need help? Visit our support page.