En esta página, se describe cómo configurar el entorno de desarrollo para trabajar con la API de Service Management. El enfoque más simple para usar la API de Service Management (aparte de usar la IU web de Google Cloud Platform Console), y nuestra recomendación para la mayoría de los casos prácticos operativos, es hacerlo a través de la interfaz de línea de comandos de gcloud
. Si necesitas programar en la API de Service Management, te recomendamos que utilices una de nuestras bibliotecas cliente proporcionadas.
Para experimentar con la API, puedes seguir las instrucciones alternativas de configuración que figuran a continuación y utilizar el comando curl
para practicar con la API sin configurar un entorno de desarrollo de aplicaciones completo.
Realiza configuraciones con gcloud
-
Accede a tu Cuenta de Google.
Si todavía no tienes una cuenta, regístrate para obtener una nueva.
-
Selecciona o crea un proyecto de GCP.
- Habilita las Service Management API necesarias.
- Realiza la instalación y la inicialización del SDK de Cloud.
Realiza configuraciones para llamar a la API directamente
En esta sección se describen los pasos básicos necesarios para configurar el entorno local a fin de experimentar con la API de Service Management mediante el comando curl
. Está dirigido a desarrolladores que necesitan programar en la API de Service Management.
Configuración inicial
- Ve a la página Cuentas de servicio de GCP Console.
Ir a la página Cuentas de servicio - Haz clic en Seleccionar para elegir el proyecto de Google Cloud Platform que deseas utilizar para acceder al servicio.
- Crea una cuenta de servicio. Para obtener información sobre cómo crear cuentas de servicio, consulta Crea y administra cuentas de servicio.
Para seguir las instrucciones de esta sección, debes otorgar la función
roles/servicemanagement.admin
a la cuenta de servicio. Para obtener información sobre cómo otorgar funciones a la cuenta de servicio, consulta Otorga funciones a las cuentas de servicio. - Ve a la página Credenciales de la API de GCP Console.
Ir a la página Credenciales de la API - Crea una clave de cuenta de servicio para la cuenta de servicio nueva y descarga el archivo de credenciales JSON en tu máquina local. En los ejemplos de esta guía se supone que la ruta del archivo es
~/credentials.json
. Para obtener información sobre cómo crear claves de cuenta de servicio, consulta Crea y administra claves de cuenta de servicio. - Instala oauth2l en tu máquina local para que puedas interactuar con el sistema Google OAuth.
Realiza pruebas con curl
Verifica primero la configuración inicial:
$ oauth2l header --json ~/credentials.json cloud-platform
Después de terminar el flujo de OAuth, deberías ver un resultado similar al que figura a continuación:
Authorization: Bearer y29.xxxxxxx
Define un alias de shell conveniente para llamar a las API de REST de Google:
$ alias gcurl='curl -H "$(oauth2l header --json ~/credentials.json cloud-platform userinfo.email)" -H "Content-Type: application/json"'
Intenta crear una lista de los servicios accesibles públicos:
$ gcurl https://servicemanagement.googleapis.com/v1/services
Si ves una lista de servicios, la configuración se realizó correctamente.
Próximos pasos
Si creas un servicio administrado y no utilizas Cloud Endpoints:
- Sigue las instrucciones en Crea y borra servicios para crear servicios administrados. Esto creará un recurso de servicio administrado de nivel superior.
- Sigue las instrucciones en Administra configuraciones de servicio para enviar las configuraciones de servicio a fin de describir las características que utiliza el servicio.
- Sigue las instrucciones en Implementa configuraciones de servicio para aplicar las configuraciones de servicio.