Guía de inicio rápido de Java

En las guías de inicio rápido, se explica cómo configurar y ejecutar una app que llama a una API de Google Workspace. En esta guía de inicio rápido, se usa un enfoque de autenticación simplificado que es adecuado para un entorno de prueba. En el caso de un entorno de producción, te recomendamos que aprendas sobre la autenticación y autorización antes de elegir las credenciales de acceso adecuadas para tu app.

Como administrador de Google Workspace, puedes usar la API de Alert Center para acceder a las alertas de problemas que afectan a tu dominio.

Objetivos

• Configura el entorno.
• Configura y ejecuta la muestra.

Requisitos previos

• Java 1.8 o superior
• Un proyecto de Google Cloud
• Una Cuenta de Google

Configura tu entorno

Activa la API

Antes de usar las APIs de Google, debes activarlas en un proyecto de Google Cloud. Puedes activar una o más APIs en un solo proyecto de Google Cloud.

• En la consola de Google Cloud, activa la API de Alert Center.

  Activa la API

Crea una cuenta de servicio

Una cuenta de servicio es un tipo especial de cuenta que usa una aplicación, en lugar de una persona. Puedes usar una cuenta de servicio para acceder a los datos o realizar acciones con la cuenta de robot, o bien para acceder a los datos en nombre de los usuarios de Google Workspace o Cloud Identity. Para obtener más información, consulta Comprende las cuentas de servicio.

Consola de Google Cloud

1. En la consola de Google Cloud, ve a Menú > IAM y administración > Cuentas de servicio.

   Ir a Cuentas de servicio

2. Haga clic en Crear cuenta de servicio.
3. Completa los detalles de la cuenta de servicio y, luego, haz clic en Crear y continuar.
   Nota: De forma predeterminada, Google crea un ID de cuenta de servicio único. Si quieres cambiar el ID, modifícalo en el campo ID de la cuenta de servicio.
4. Opcional: Asigna roles a tu cuenta de servicio para otorgar acceso a los recursos de tu proyecto de Google Cloud. Para obtener más detalles, consulta Otorga, cambia y revoca el acceso a los recursos.
5. Haz clic en Continuar.
6. Opcional: Ingresa los usuarios o grupos que pueden administrar esta cuenta de servicio y realizar acciones con ella. Para obtener más detalles, consulta Administra la suplantación de identidad de cuentas de servicio.
7. Haz clic en Listo. Toma nota de la dirección de correo electrónico de la cuenta de servicio.

gcloud CLI

1. Crea la cuenta de servicio:

   gcloud iam service-accounts create SERVICE_ACCOUNT_NAME \
     --display-name="SERVICE_ACCOUNT_NAME"

2. Opcional: Asigna roles a tu cuenta de servicio para otorgar acceso a los recursos de tu proyecto de Google Cloud. Para obtener más detalles, consulta Otorga, cambia y revoca el acceso a los recursos.

Crea credenciales para una cuenta de servicio

Debes obtener credenciales en forma de un par de claves pública/privada. Tu código usa estas credenciales para autorizar las acciones de la cuenta de servicio en tu app.

1. En la consola de Google Cloud, ve a Menú > IAM y administración > Cuentas de servicio.

   Ir a Cuentas de servicio

2. Selecciona tu cuenta de servicio.
3. Haz clic en Claves > Agregar clave > Crear nueva clave.
4. Selecciona JSON y, luego, haz clic en Crear.

   Se generará y descargará el nuevo par de claves pública/privada en tu equipo como un archivo nuevo. Guarda el archivo JSON descargado como credentials.json en tu directorio de trabajo. Este archivo es la única copia de esta clave. Para obtener información sobre cómo almacenar tu clave de forma segura, consulta Cómo administrar claves de cuentas de servicio.

5. Haz clic en Cerrar.

Configura y ejecuta la muestra

1. Obtén credenciales:

   adminSDK/alertcenter/quickstart/src/main/java/AdminSDKAlertCenterQuickstart.java

   Ver en GitHub
   InputStream in = AdminSDKAlertCenterQuickstart.class.getResourceAsStream(CREDENTIALS_FILE_PATH);
   if (in == null) {
     throw new FileNotFoundException("Resource not found: " + CREDENTIALS_FILE_PATH);
   }
   GoogleCredentials credentials = ServiceAccountCredentials
       .fromStream(in)
       .createDelegated(delegatedAdminEmail)
       .createScoped(SCOPES);

2. Crea una instancia del cliente:

   adminSDK/alertcenter/quickstart/src/main/java/AdminSDKAlertCenterQuickstart.java

   Ver en GitHub
   NetHttpTransport transport = GoogleNetHttpTransport.newTrustedTransport();
   AlertCenter service = new AlertCenter.Builder(transport, JSON_FACTORY,
       new HttpCredentialsAdapter(getCredentials(DELEGATED_ADMIN_EMAIL)))
       .setApplicationName(APPLICATION_NAME)
       .build();

3. Mostrar todas las alertas:

   adminSDK/alertcenter/quickstart/src/main/java/AdminSDKAlertCenterQuickstart.java

   Ver en GitHub
   String pageToken = null;
   do {
     ListAlertsResponse listResponse = service.alerts().list().setPageToken(pageToken)
         .setPageSize(20).execute();
     if (listResponse.getAlerts() != null) {
       for (Alert alert : listResponse.getAlerts()) {
         System.out.println(alert);
       }
     }
     pageToken = listResponse.getNextPageToken();
   } while (pageToken != null);

4. Envía comentarios sobre una alerta determinada:

   adminSDK/alertcenter/quickstart/src/main/java/AdminSDKAlertCenterQuickstart.java

   Ver en GitHub
   AlertFeedback newFeedback = new AlertFeedback();
   newFeedback.setType("VERY_USEFUL");
   AlertFeedback feedback = service.alerts().feedback().create(alertId, newFeedback).execute();
   System.out.println(feedback);