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.

Nota: En proyectos que no sean de Maven, Cloud Code no agrega las bibliotecas cliente de Cloud a la compilación, pero sí es compatible con las otras características descritas aquí.

Nota: Esta característica es compatible con los siguientes IDE:

• IntelliJ IDEA: Ultimate
• IntelliJ IDEA: Community
• Otros IDE basados en IntelliJ Platform

Nota: Java 7 no es compatible con las aplicaciones del entorno estándar de App Engine. Consulta la página de GitHub para obtener más información sobre las plataformas compatibles.

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.

En el cuadro de diálogo Add Google Cloud Libraries (Agregar bibliotecas de Google Cloud), se muestran las bibliotecas compatibles.


2. 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.
3. 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.
4. En el menú desplegable Google Cloud Java (Java en Google Cloud), selecciona la versión de la BOM de Java que deseas usar.

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.

5. Selecciona la casilla de verificación de todas las bibliotecas que desees agregar.
Algunas API requieren que las habilites en Google Cloud Platform para poder acceder a ellas. En estas, cuando selecciones la casilla de verificación, automáticamente se marcará la opción Enable the API on the Google Cloud Platform (Habilitar la API en Google Cloud Platform).
6. Haz clic en Continue (Continuar).

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


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.
Debes mantener la clave en una ubicación segura y nunca registrarla en el control de código fuente.
9. Si tu API lo requiere, selecciona las funciones que deseas agregar a la cuenta de servicio.
10. Haz clic en OK (Aceptar).


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

En el servidor local de aplicaciones, esta sección aparece en la pestaña Inicio/Conexión.

4. Las variables del entorno se insertan automáticamente.
Si usas App Engine estándar y tienes configuraciones que se ejecutan de manera local, estas aparecerán en el cuadro de diálogo de confirmación. Selecciona las configuraciones que desees agregar a las variables del entorno y haz clic en Add Variables (Agregar variables).

En proyectos ajenos a Maven

1. Selecciona Herramientas > Cloud Code > Administrar las API de Cloud.

En el cuadro de diálogo Manage Google Cloud APIs (Administrar las API de Google Cloud) se muestran las bibliotecas compatibles.


2. 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.
3. Selecciona la casilla de verificación de todas las bibliotecas que desees agregar.
Algunas API requieren que las habilites en Google Cloud Platform para poder acceder a ellas. En estas, cuando selecciones la casilla de verificación, automáticamente se marcará la opción Enable the API on the Google Cloud Platform (Habilitar la API en Google Cloud Platform).
4. Haz clic en Continue (Continuar).

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


5. En el campo Service account name (Nombre de la cuenta de servicio), mantén el nombre predeterminado o ingresa uno nuevo.
6. 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.
Debes mantener la clave en una ubicación segura y nunca registrarla en el control de código fuente.
7. Si tu API lo requiere, selecciona las funciones que deseas agregar a la cuenta de servicio.
8. Haz clic en OK (Aceptar).


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

En el servidor local de aplicaciones, esta sección aparece en la pestaña Inicio/Conexión.

4. Las variables del entorno se insertan automáticamente.
Si usas App Engine estándar y tienes configuraciones que se ejecutan de manera local, estas aparecerán en el cuadro de diálogo de confirmación. Selecciona las configuraciones que desees agregar a las variables del entorno y haz clic en Add Variables (Agregar variables).

Cómo obtener asistencia

Si deseas enviar comentarios, informa problemas en GitHub o haz preguntas en Stack Overflow.