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.
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 Endpoints configuration initially. After that first
deployment, you can grant the more restrictive Service Config Editor role to
a user, group, or service account. See
Granting and revoking access to the API
for more information.
On the Record Type Dropdown in the Verify domain ownership via
DNS record banner, use the Recommended methods option if possible.
Sign in to your Domain name provider and complete the verification process
per the instructions. Your Domain name provide may be eligible for
AutoDNS.
Follow the directions provided on Search Console until you complete your domain's verification.
Delegating to developers
After you are verified as a domain owner in Search Console, 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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[[["\u003cp\u003eIf you plan to use your own domain name with Cloud Endpoints, you must verify your ownership of that domain.\u003c/p\u003e\n"],["\u003cp\u003eDomain ownership verification is done via Google Search Console, where you'll need to add your domain without protocol identifiers (e.g., \u003ccode\u003eexample.com\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eOnly the user account that initially verified domain ownership can deploy the Endpoints configuration.\u003c/p\u003e\n"],["\u003cp\u003eOnce domain ownership is verified, you can delegate subdomain access to other developers, enabling them to create Endpoints APIs without separate verification.\u003c/p\u003e\n"],["\u003cp\u003eConfiguring your domain for SSL might be necessary, especially if you plan to use certain types of user authentication with your API.\u003c/p\u003e\n"]]],[],null,["# Verifying a domain name\n\n[OpenAPI](/endpoints/docs/openapi/verify-domain-name \"View this page for the Cloud Endpoints OpenAPI docs\") \\| gRPC\n\n\u003cbr /\u003e\n\nIf you already own a domain name (such as `example.com`), and you want to\nuse this domain name as the name of your Cloud Endpoints service, you must\nprove that you are authorized to use the domain. If you don't have your own\ndomain name, you can use a\n[domain managed by Google](/endpoints/docs/grpc/configure-endpoints#using_a_domain_managed_by_google),\nin which case you don't have to verify ownership.\n\nThis page describes how to verify your ownership of a domain name that you want\nto use for your API running on Google Cloud.\n\nService name requirements\n-------------------------\n\nTypically, you configure your Endpoints service name to be the\nsame as your domain name. Endpoints has the following\nrequirements for the service name:\n\nVerifying ownership\n-------------------\n\nOnly the user account that has verified ownership of the domain name can\ndeploy the Endpoints configuration initially. After that first\ndeployment, you can grant the more restrictive **Service Config Editor** role to\na user, group, or service account. See\n[Granting and revoking access to the API](/endpoints/docs/grpc/control-api-access)\nfor more information.\n\nTo verify that you own the domain name:\n\n1. Go to\n [Search Console](https://search.google.com/search-console/welcome).\n\n2. Click **Domain**.\n\n3. Enter your domain name.\n\n | **Important:** Don't include protocol identifiers such as `http://` or `https://`. Enter only the domain name, such as `example.com` or a subdomain, such as `api.example.com`.\n4. Click **Continue**.\n\n5. On the **Record Type** Dropdown in the **Verify domain ownership via\n DNS record** banner, use the **Recommended methods** option if possible.\n\n6. Sign in to your Domain name provider and complete the verification process\n per the instructions. Your Domain name provide may be eligible for\n [AutoDNS](https://developers.google.com/search/blog/2019/09/auto-dns-verification).\n\n7. Follow the directions provided on **Search Console** until you complete your domain's verification.\n\n| **Important:** The domain name verification is automatically re-confirmed about every 30 days. If you remove the verification string from your DNS settings, you lose the ability to change the configuration within the Google Cloud console. However, if this happens, the serving setup for the domain doesn't change and the app continues to serve over that domain.\n\nDelegating to developers\n------------------------\n\nAfter you are verified as a domain owner in Search Console, you can optionally\ndelegate access to subdomains to developers within the organization. This allows\nthose developers to create Endpoints APIs without having to\nverify domain ownership themselves.\n\nFor more information on delegating, see\n[Managing users, owners, and permissions](https://support.google.com/webmasters/answer/2453966?ref_topic=4564315).\n\nConfiguring your domain for SSL\n-------------------------------\n\nYou might want to configure your domain for SSL. Note that some types of\n[authentication](/endpoints/docs/openapi/authenticating-users) require SSL.\n\nWhat's next\n-----------\n\n- [Serving an API from your domain name](/endpoints/docs/grpc/serving-apis-from-domains)"]]
