Comienza a usar la API de Service Management

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.

Nota: Si creas un servicio con el uso de Cloud Endpoints, debes seguir la Guía de inicio rápido de Endpoints pertinente para conocer cómo configurar y comenzar a usar la API de Service Management para Cloud Endpoints.

Realiza configuraciones con gcloud

1. Accede a tu Cuenta de Google.

   Si todavía no tienes una cuenta, regístrate para obtener una nueva.

2. Selecciona o crea un proyecto de GCP.

   Nota: Si no planeas conservar los recursos de GCP que crees durante este instructivo, crea un proyecto nuevo. Después de terminar, puedes borrar el proyecto y quitar todos los recursos asociados con el proyecto y el instructivo.

   Ir a la página Administrar recursos

3. Habilita las Service Management API necesarias.

   Habilita las API

4. 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

1. Ve a la página Cuentas de servicio de GCP Console.
   Ir a la página Cuentas de servicio
2. Haz clic en Seleccionar para elegir el proyecto de Google Cloud Platform que deseas utilizar para acceder al servicio.
3. 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.
4. Ve a la página Credenciales de la API de GCP Console.
   Ir a la página Credenciales de la API
5. 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.
6. Instala oauth2l en tu máquina local para que puedas interactuar con el sistema Google OAuth.

Realiza pruebas con curl

1. Verifica primero la configuración inicial:

   $ oauth2l header --json ~/credentials.json cloud-platform
   

2. Después de terminar el flujo de OAuth, deberías ver un resultado similar al que figura a continuación:

   Authorization: Bearer y29.xxxxxxx
   

3. 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"'
   

4. 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:

1. Sigue las instrucciones en Crea y borra servicios para crear servicios administrados. Esto creará un recurso de servicio administrado de nivel superior.
2. 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.

Nota: La configuración de servicio no tiene efecto después del envío. Debes seguir el Paso 3 para implementar las configuraciones.

1. Sigue las instrucciones en Implementa configuraciones de servicio para aplicar las configuraciones de servicio.