Naming Your API Service

This page describes how to name your API service.

Google Cloud Endpoints uses DNS-compatible names to uniquely identify services, so your API service must have a globally unique name. Because Cloud Platform Console projects are guaranteed to have a globally unique name, you can always use your project name, for example, as your API service name.

If you don't want to use the domain, you can alternatively use a custom domain that you are authorized to use.

To name your API service:

  1. Open your API project's OpenAPI specification (openapi.yaml) file and locate the line for host:.

  2. If you want to use the domain, which is available without further verification, name the service using this pattern:


    Replace the placeholder [PROJECT-ID] with your project ID. Replace the placeholder [API-NAME] with your API's name (e.g. bookstore, or books-apis, etc.)

  3. If you don't want to use an domain for your API service, you can use your own domain as your service name, for example,

    1. Verify ownership of the domain.

    2. Name your API with any subdomain name under the verified domain. For example, owners of domain can create services with names,,

Send feedback about...

Cloud Endpoints with OpenAPI