Comienza a usar la API de Service Management

En esta página, se describe cómo configurar tu entorno de desarrollo para trabajar con la API de Service Management. El enfoque más simple para usar la API de Service Management (que no solo se usa la IU web de Google Cloud Console) y nuestra recomendación para la mayoría de los casos prácticos operativos es 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 uses una de nuestras bibliotecas cliente proporcionadas. Para experimentar con la API, puedes seguir las instrucciones alternativas de configuración a continuación y usar el comando curl para jugar con la API sin configurar un entorno de desarrollo de aplicación completo.

Realiza configuraciones con gcloud

  1. Accede a tu cuenta de Google Cloud. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.
  2. En la página del selector de proyectos de Google Cloud Console, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyectos

  3. Habilita la API Service Management.

    Habilita la API

  4. Instala e inicializa el SDK de Cloud.

Realiza configuraciones para llamar a la API directamente

Esta sección describe los pasos básicos necesarios para configurar su entorno local a fin de experimentar con la API de administración de servicios mediante el comando de curl. Está dirigido a desarrolladores que necesitan programar en la API de Service Management.

Configuración inicial

  1. Vaya a la página Cuentas de servicio de Cloud Console.
    Ir a la página Cuentas de servicio
  2. Haga clic en Seleccionar para elegir el proyecto Google Cloud que desea usar 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, debe otorgar a la cuenta de servicio la función roles/servicemanagement.admin. Para aprender a otorgar funciones a las cuentas de servicio, consulta Asigna funciones a cuentas de servicio.
  4. Ve a la página Credenciales de API de Cloud Console.
    Ir a la página Credenciales de 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 aprender a crear claves de cuentas de servicio, consulta Crea y administra claves de cuentas 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)" -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.

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