Comienza a usar la API de Service Management

Esta página describe cómo configurar su entorno de desarrollo para que funcione con la API de administración de servicios. El método más simple para usar la API de administración de servicios (en lugar de solo usar la IU web de Google Cloud Console) y el enfoque que recomendamos para la mayoría de los casos prácticos operativos, es usar la interfaz de la línea de comandos de gcloud. Si necesitas programar en la API de Administración de servicios, te recomendamos que utilices una de nuestras bibliotecas cliente proporcionadas. Para experimentar con la API, puede seguir las instrucciones de configuración alternativas a continuación y utilizar el comando de curl para jugar con la API sin configurar un entorno completo de desarrollo de aplicaciones.

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. En la página Selector de proyectos de Cloud Console, selecciona o crea un proyecto de Cloud.

    Ir a la página Selector de proyectos

  3. Habilita la API de 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.