En esta página se describe cómo crear un portal para tu servicio de Cloud Endpoints y se presenta la interfaz de usuario del portal. Para cada tarea, se proporcionan las funciones mínimas de Identity and Access Management que se requieren a fin de completarla. Si quieres obtener más información sobre los permisos de IAM, consulta los siguientes recursos:
- Comprende las funciones
- Cómo otorgar, cambiar y revocar el acceso a los recursos
- Crea y administra funciones personalizadas
Requisitos previos
En esta página, se supone que ya:
- Creaste un proyecto de Google Cloud.
- Agregaste la administración de la API. Consulta los siguientes artículos para obtener más información:
Cómo crear un portal
Para crear un portal, haz lo siguiente:
- En Google Cloud Console, ve a la página Endpoints Portal de desarrolladores.
- Selecciona el proyecto de Cloud en el que se encuentra la API.
- Haz clic en Crear portal. La creación del portal suele tardar entre 5 y 10 minutos. Cuando tu portal esté listo, se mostrará una URL que te llevará a él.
Cuando creas un portal, ocurre lo siguiente:
Durante la creación del portal, se crea una cuenta de servicio con el nombre
service-YOUR_PROJECT_NUMBER@endpoints-portal.iam.gserviceaccount.com
, con la función Agente de servicio del portal de Endpoints (YOUR_PROJECT_NUMBER
es el número del proyecto de Cloud). Puedes ver esta cuenta de servicio en Google Cloud Console en la página IAM del administrador de tu proyecto de Cloud.Cuando se crea tu portal, este usa el nombre de dominio
endpointsportal.YOUR_PROJECT_ID.cloud.goog
YOUR_PROJECT_ID
es el ID del proyecto de Cloud. Para permitirlo, se crean un certificado SSL/TLS y un registro DNS público que contienen el ID del proyecto y se pueden buscar en los registros del Certificado de transparencia, aunque tu portal no sea de acceso público.
Ver el portal para una API
Para ver el portal para una API:
- En la página Endpoints > Portal para desarrolladores, en la sección URL del portal, haz clic en la URL.
Sigue los mensajes de acceso para continuar a tu portal. Si tienes más de una cuenta, asegúrate de elegir la que está en el proyecto de Cloud en el que se encuentra la API.
Se muestra la página principal del portal. Para tu comodidad, te recomendamos que agregues esta URL a favoritos. En la página principal del portal, se muestra una lista con vínculos a todas las API del proyecto de Cloud.
Haz clic en la API que quieres explorar. Se mostrará la página principal de la API.
Presentación de la IU del portal
Los siguientes íconos, que se encuentran en la parte inferior de la página principal de tu API, proporcionan vínculos útiles para los usuarios de esta.
Referencia de la API muestra la primera página de la documentación de referencia de la API de SmartDocs, que generó el portal de Endpoints a partir del archivo
openapi.json
que creó Endpoints Frameworks. Puedes utilizar la barra de navegación de la izquierda para ver la documentación de SmartDocs para cada método y recurso.Comenzar muestra contenido de ejemplo de la guía de introducción. Antes de enviar la URL del portal a los usuarios de la API, personaliza esta documentación a fin de proporcionar la información que necesitan los usuarios de la API para comenzar a utilizarla en su código. Consulta Agregar documentación personalizada para obtener más información sobre cómo modificar el contenido de la guía de introducción.
Obtener una clave muestra la página API y servicios > Biblioteca de API para que los usuarios puedan habilitar la API en sus propios proyectos de Google Cloud.
Si tu API requiere una clave de API luego de que los usuarios habiliten la API, pueden dirigirse a la página API y servicios > Credenciales para obtener una clave de API que puedan utilizar en sus códigos. Antes de enviar la URL del portal a los usuarios de la API, debes otorgarles acceso para usar la API. Consulta Controlar quién puede habilitar tu API para obtener más información.
Personaliza la apariencia de tu portal
Es posible que quieras cambiar algunos elementos como los esquemas de colores y los íconos que se muestran en tu portal para que coincidan con el sitio web de tu empresa. Al realizar un cambio de apariencia y Configurar un dominio personalizado para tu portal, puedes crear una experiencia de marca para tus usuarios.
Para personalizar la apariencia de tu portal, haz lo siguiente:
En la esquina superior derecha de la página, haz clic en Configuración
.Haz clic en la pestaña Todo el sitio. Puedes cambiar la apariencia de los siguientes elementos:
- Logotipo
- Color primario: se utiliza como el color de fondo de la página de inicio y la barra de título
- Color secundario: se utiliza como el color de los íconos y los vínculos
- Título de la página de inicio
- Descripción de la página de inicio
Haz clic en Guardar.
Borrar un portal
Para borrar un portal, haz lo siguiente:
- En Google Cloud Console, ve a la página Endpoints Portal de desarrolladores.
- Selecciona el proyecto de Cloud en el que se encuentra la API.
- Haz clic en Borrar .
- En el diálogo de confirmación, haz clic en Borrar.
¿Qué sigue?
Más información sobre:
- Los campos que el portal de Endpoints utiliza en tu configuración de Endpoints para generar la documentación de referencia de SmartDocs y cómo regenerar SmartDocs.
- Los permisos de la función Administrador del portal de Endpoints
- Cómo agregar documentación personalizada al portal