Cómo administrar las bibliotecas y las API de Cloud

Puedes acceder a los productos y servicios de Google Cloud Platform de tu código con las API de Cloud. Estas exponen una interfaz JSON REST simple que puedes llamar mediante las bibliotecas cliente.

En este documento, se describe cómo habilitar las API de Cloud, administrar las cuentas de servicio y las variables del entorno para acceder a las API de manera local, y agregar bibliotecas cliente de Cloud para Java a tu proyecto de Maven.

Antes de comenzar

Sigue la guía de inicio rápido para instalar y configurar IntelliJ IDEA.

Cómo agregar las bibliotecas cliente de Cloud

Para agregar bibliotecas a tu proyecto en IntelliJ, sigue estos pasos:

En proyectos de Maven

  1. Selecciona Herramientas > Cloud Code > Agrega bibliotecas de Cloud y administra las API de Cloud.
  2. En el cuadro de diálogo Add Google Cloud Libraries (Agregar bibliotecas de Google Cloud), se muestran las bibliotecas compatibles.

    Captura de pantalla que muestra el cuadro de diálogo Agregar bibliotecas de Cloud.El cuadro de diálogo muestra un menú desplegable para seleccionar un módulo al que agregar las bibliotecas, muestra una lista de las API disponibles para agregar y ofrece un área de trabajo que muestra información sobre la API.
  3. En el campo GCP Project (Proyecto de GCP), asegúrate de que aparezcan el proyecto y la cuenta que correspondan. De lo contrario, haz clic en la elipsis para elegir los correctos.
  4. En el menú desplegable Add Google Cloud Library to Module (Agregar biblioteca de Google Cloud al módulo), selecciona el módulo al que desees agregar la biblioteca.
  5. En el menú desplegable Google Cloud Java (Java en Google Cloud), selecciona la versión de la BOM de Java que deseas usar.
  6. Google Cloud Java (Java en Google Cloud) permite solucionar los conflictos entre versiones, ya que agrega la lista de materiales (BOM) de Java a Google Cloud al archivo pom.xml de tus proyectos.

  7. Selecciona la casilla de verificación de todas las bibliotecas que desees agregar.
  8. Haz clic en Continue (Continuar).
  9. Aparecerá el cuadro de diálogo Enable GCP APIs and Manage Service Accounts Confirmation (Confirmación para habilitar las API de GCP y administrar las cuentas de servicio).

    Captura de pantalla que muestra el cuadro de diálogo de confirmación para agregar funciones a una cuenta de servicio nueva y, además, ingresar una ruta en la que descargar la clave.En este cuadro de diálogo también se muestran las API que se agregarán al proyecto.
  10. En el campo Service account name (Nombre de la cuenta de servicio), mantén el nombre predeterminado o ingresa uno nuevo.
  11. En el campo Download path (Ruta de descarga), navega hasta la ubicación en la que deseas descargar la clave de la cuenta de servicio.
  12. Si tu API lo requiere, selecciona las funciones que deseas agregar a la cuenta de servicio.
  13. Haz clic en OK (Aceptar).
  14. Captura de pantalla que muestra la confirmación de que se creó la cuenta de servicio y la ruta para la clave.

    IntelliJ realiza las siguientes actualizaciones:

    • agrega las dependencias seleccionadas a tu pom.xml.
    • habilita las API seleccionadas en Google Cloud Platform.
    • crea la cuenta de servicio y descarga su clave a la ubicación indicada.
  15. Para acceder de manera local a las API de Google Cloud, configura las variables del entorno GOOGLE_APPLICATION_CREDENTIALS y GOOGLE_CLOUD_PROJECT en tu servidor de desarrollo local o en cualquiera de tus configuraciones que se ejecutan localmente:
    1. Para copiar las variables al portapapeles, haz clic en el ícono de copia.
    2. Edita la configuración de ejecución.
    3. En la sección Variables del entorno, haz clic en el ícono de pegar.
    4. En el servidor local de aplicaciones, esta sección aparece en la pestaña Inicio/Conexión.

    5. Las variables del entorno se insertan automáticamente.

En proyectos ajenos a Maven

  1. Selecciona Herramientas > Cloud Code > Administrar las API de Cloud.
  2. En el cuadro de diálogo Manage Google Cloud APIs (Administrar las API de Google Cloud) se muestran las bibliotecas compatibles.

    Captura de pantalla que muestra el cuadro de diálogo Agregar bibliotecas de Cloud.Este cuadro de diálogo muestra una lista de las API disponibles para agregar y ofrece un área de trabajo que muestra información sobre la API.
  3. En el campo GCP Project (Proyecto de GCP), asegúrate de que aparezcan el proyecto y la cuenta que correspondan. De lo contrario, haz clic en la elipsis para elegir el proyecto y la cuenta correctos.
  4. Selecciona la casilla de verificación de todas las bibliotecas que desees agregar.
  5. Haz clic en Continue (Continuar).
  6. Aparecerá el cuadro de diálogo Enable GCP APIs and Manage Service Accounts Confirmation (Confirmación para habilitar las API de GCP y administrar las cuentas de servicio).

    Captura de pantalla que muestra el cuadro de diálogo de confirmación para agregar funciones a una cuenta de servicio nueva y, además, ingresar una ruta en la que descargar la clave.En este cuadro de diálogo también se muestran las API que se agregarán al proyecto.
  7. En el campo Service account name (Nombre de la cuenta de servicio), mantén el nombre predeterminado o ingresa uno nuevo.
  8. En el campo Download path (Ruta de descarga), navega hasta la ubicación en la que deseas descargar la clave de la cuenta de servicio.
  9. Si tu API lo requiere, selecciona las funciones que deseas agregar a la cuenta de servicio.
  10. Haz clic en OK (Aceptar).
  11. Captura de pantalla que muestra la confirmación de que se creó la cuenta de servicio y la ruta para la clave.

    IntelliJ realiza las siguientes actualizaciones:

    • habilita las API seleccionadas en Google Cloud Platform.
    • crea la cuenta de servicio y descarga su clave a la ubicación indicada.
  12. Para acceder de manera local a las API de Google Cloud, configura las variables del entorno GOOGLE_APPLICATION_CREDENTIALS y GOOGLE_CLOUD_PROJECT en tu servidor de desarrollo local o en cualquiera de tus configuraciones que se ejecutan localmente:
    1. Para copiar las variables al portapapeles, haz clic en el ícono de copia.
    2. Edita la configuración de ejecución.
    3. En la sección Variables del entorno, haz clic en el ícono de pegar.
    4. En el servidor local de aplicaciones, esta sección aparece en la pestaña Inicio/Conexión.

    5. Las variables del entorno se insertan automáticamente.

Cómo obtener asistencia

Si deseas enviar comentarios, informa problemas en GitHub o haz preguntas en Stack Overflow.
¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Cloud Code para IntelliJ