This page describes how to create a portal for your Cloud Endpoints service and introduces you to the portal user interface. For each task, the minimum required Identity and Access Management role (or roles) required to complete the task is provided. For more information about IAM permissions, see the following:
- Understanding roles
- Granting, changing, and revoking access to resources
- Creating and managing custom roles
Prerequisites
This page assumes that you have already:
- Created a Google Cloud project.
- Added API management. See the following for more information:
Creating a portal
To create a portal:
- In the Google Cloud console, go to the Endpoints > Developer Portal page.
- Select the Cloud project that the API is in.
- Click Create portal. Generating the portal typically takes between 5 and 10 minutes. When your portal is ready, a URL to it is displayed.
Creating a portal has the following effects:
During portal creation, a service account with the name
service-YOUR_PROJECT_NUMBER@endpoints-portal.iam.gserviceaccount.com
is created with the Role Endpoints Portal Service Agent. (YOUR_PROJECT_NUMBER
is the project number of your Cloud project.) You can see this service account in the Google Cloud console on the IAM & admin > IAM page for your Cloud project.When your portal is created, it uses the domain name
endpointsportal.YOUR_PROJECT_ID.cloud.goog
. (YOUR_PROJECT_ID
is your Cloud project ID.) To support this, an SSL/TLS certificate and a public DNS record containing your project ID are created and are searchable in the public Certificate Transparency logs, even though your portal isn't publicly accessible.
Viewing the portal for an API
To view the portal for an API:
- On the Endpoints > Developer Portal page, in the Portal URL section, click the URL.
Follow the login prompts to continue to your portal. If you have more than one account, make sure to choose the account that is in the Cloud project that the API is in.
The homepage for your portal is displayed. For convenience, we recommend that you bookmark this URL. The portal homepage displays a list with links to all the APIs in the Cloud project.
Click the API that you want to explore. The homepage for the API is displayed.
Introducing the portal UI
At the bottom of the homepage for your API, the following icons provide useful links for your API users.
API Reference displays the first page of the SmartDocs API reference documentation that Endpoints Portal generated from the
openapi.json
file that Endpoints Frameworks created. You can use the navigation bar on the left to view the SmartDocs documentation for each method and resource.Getting Started displays example content in the Getting Started guide. Before you send the portal URL to your API users, customize this documentation to provide information that your API users need to get started using your API in their code. See Adding custom documentation for information on how to modify the content in the Getting Started guide.
Get a Key displays the APIs & Services > API Library page so that users can enable your API in their own Google Cloud projects.
If your API requires an API key, after users enable your API, they can go to the APIs & Services > Credentials page to get an API key that they can use in their code. Before you send the portal URL to your API users, you must grant them access to use your API. See Controlling who can enable your API for more information.
Customizing the appearance of your portal
You might want to change things such as the color schemes and icons displayed on your portal to match your company's website. By changing the appearance and setting up a custom domain for your portal, you can create a branded experience for your users.
To customize the appearance of your portal:
In top-right corner of the page, click Settings
.Click the Site Wide tab. You can change the appearance of the following:
- Logo
- Primary color, which is used as the homepage and title bar background color.
- Secondary color, which is used as the color for icons and links.
- Homepage title.
- Homepage description.
Click Save.
Deleting a portal
To delete a portal:
- In the Google Cloud console, go to the Endpoints > Developer Portal page.
- Select the Cloud project that the API is in.
- Click Delete .
- In the confirmation dialog, click Delete.
What's next
Learn about:
- The fields that Endpoints Portal uses in your Endpoints configuration to generate the SmartDocs reference documentation, and how to regenerate SmartDocs,
- The permissions in the Endpoints Portal Admin role, and
- How to add custom documentation to your portal.