Guía de inicio rápido de Java

En los guías de inicio rápido, se explica cómo configurar y ejecutar una app que llama a una API de Google Workspace.

Las guías de inicio rápido de Google Workspace usan las bibliotecas cliente de la API para controlar algunos detalles del flujo de autenticación y autorización. Te recomendamos que uses las bibliotecas cliente para tus propias apps. 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.

Crea una aplicación de línea de comandos de Java que realice solicitudes a la API de Google Meet.

Objetivos

  • Configura el entorno.
  • Configura la muestra.
  • Ejecuta la muestra.

Requisitos previos

  • Una cuenta de Google Workspace con Google Meet habilitado

Configura tu entorno

Para completar esta guía de inicio rápido, configura tu entorno.

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

Si usas un proyecto de Google Cloud nuevo para completar esta guía de inicio rápido, configura la pantalla de consentimiento de OAuth y agrégate como usuario de prueba. Si ya completaste este paso para tu proyecto de Cloud, ve a la siguiente sección.

  1. En la consola de Google Cloud, ve a Menú > APIs y servicios > Pantalla de consentimiento de OAuth.

    Ir a la pantalla de consentimiento de OAuth

  2. En Tipo de usuario, selecciona Interno y, luego, haz clic en Crear.
  3. Completa el formulario de registro de la aplicación y, luego, haz clic en Guardar y continuar.

  4. Por ahora, puedes omitir agregar permisos y hacer clic en Guardar y continuar. En el futuro, cuando crees una app para usarla fuera de tu organización de Google Workspace, debes cambiar el Tipo de usuario a Externo y, luego, agregar los permisos de autorización que requiere tu app.

  5. Revisa el resumen del registro de tu app. Para realizar cambios, haz clic en Editar. Si el registro de la app parece correcto, haz clic en Volver al panel.

Cómo autorizar credenciales para una aplicación de escritorio

Para autenticar a los usuarios finales y acceder a sus datos en tu app, debes crear uno o más IDs de cliente de OAuth 2.0. Un ID de cliente se usa con el fin de identificar una sola app para los servidores de OAuth de Google. Si tu app se ejecuta en varias plataformas, debes crear un ID de cliente independiente para cada una.
  1. En la consola de Google Cloud, ve a Menú > APIs y servicios > Credenciales.

    Ir a Credenciales

  2. Haz clic en Crear credenciales > ID de cliente de OAuth.
  3. Haz clic en Tipo de aplicación > App para computadoras.
  4. En el campo Nombre, escribe un nombre para la credencial. Este nombre solo se muestra en la consola de Google Cloud.
  5. Haz clic en Crear. Aparecerá la pantalla Se creó el cliente de OAuth, que muestra tu nuevo ID de cliente y secreto de cliente.
  6. Haz clic en Aceptar. La credencial recién creada aparecerá en IDs de cliente de OAuth 2.0.
  7. Guarda el archivo JSON descargado como credentials.json y muévelo al directorio de trabajo.

Prepara el lugar de trabajo

  1. En tu directorio de trabajo, crea una nueva estructura de proyecto:

    gradle init --type basic
mkdir -p src/main/java src/main/resources

  2. En el directorio src/main/resources/, copia el archivo credentials.json que descargaste anteriormente.

  3. Abre el archivo build.gradle predeterminado y reemplaza su contenido por el siguiente código:

    meet/quickstart/build.gradle
    apply plugin: 'java'
apply plugin: 'application'

mainClassName = 'MeetQuickstart'
sourceCompatibility = 11
targetCompatibility = 11
version = '1.0'

repositories {
    mavenCentral()
}

dependencies {
    implementation 'com.google.cloud:google-cloud-meet:0.3.0'
    implementation 'com.google.auth:google-auth-library-oauth2-http:1.19.0'
    implementation 'com.google.oauth-client:google-oauth-client-jetty:1.34.1'
}

Configura la muestra

  1. En el directorio src/main/java/, crea un archivo Java nuevo con un nombre que coincida con el valor mainClassName en tu archivo build.gradle.

  2. Incluye el siguiente código en tu nuevo archivo Java:

    meet/quickstart/src/main/java/MeetQuickstart.java
    import java.awt.Desktop;
import java.io.FileNotFoundException;
import java.io.IOException;
import java.io.InputStream;
import java.net.URI;
import java.net.URL;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.util.Collections;
import java.util.List;

import com.google.api.client.extensions.jetty.auth.oauth2.LocalServerReceiver;
import com.google.api.gax.core.FixedCredentialsProvider;
import com.google.apps.meet.v2.CreateSpaceRequest;
import com.google.apps.meet.v2.Space;
import com.google.apps.meet.v2.SpacesServiceClient;
import com.google.apps.meet.v2.SpacesServiceSettings;
import com.google.auth.Credentials;
import com.google.auth.oauth2.ClientId;
import com.google.auth.oauth2.DefaultPKCEProvider;
import com.google.auth.oauth2.TokenStore;
import com.google.auth.oauth2.UserAuthorizer;

/* class to demonstrate use of Drive files list API */
public class MeetQuickstart {
  /**
   * Directory to store authorization tokens for this application.
   */
  private static final String TOKENS_DIRECTORY_PATH = "tokens";

  /**
   * Global instance of the scopes required by this quickstart.
   * If modifying these scopes, delete your previously saved tokens/ folder.
   */
  private static final List<String> SCOPES = Collections
      .singletonList("https://www.googleapis.com/auth/meetings.space.created");

  private static final String CREDENTIALS_FILE_PATH = "/credentials.json";

  private static final String USER = "default";

  // Simple file-based token storage for storing oauth tokens
  private static final TokenStore TOKEN_STORE = new TokenStore() {
    private Path pathFor(String id) {
      return Paths.get(".", TOKENS_DIRECTORY_PATH, id + ".json");
    }

    @Override
    public String load(String id) throws IOException {
      if (!Files.exists(pathFor(id))) {
        return null;
      }
      return Files.readString(pathFor(id));
    }

    @Override
    public void store(String id, String token) throws IOException {
      Files.createDirectories(Paths.get(".", TOKENS_DIRECTORY_PATH));
      Files.writeString(pathFor(id), token);
    }

    @Override
    public void delete(String id) throws IOException {
      if (!Files.exists(pathFor(id))) {
        return;
      }
      Files.delete(pathFor(id));
    }
  };

  /**
   * Initialize a UserAuthorizer for local authorization.
   * 
   * @param callbackUri
   * @return
   */
  private static UserAuthorizer getAuthorizer(URI callbackUri) throws IOException {
    // Load client secrets.
    try (InputStream in = MeetQuickstart.class.getResourceAsStream(CREDENTIALS_FILE_PATH)) {
      if (in == null) {
        throw new FileNotFoundException("Resource not found: " + CREDENTIALS_FILE_PATH);
      }

      ClientId clientId = ClientId.fromStream(in);

      UserAuthorizer authorizer = UserAuthorizer.newBuilder()
          .setClientId(clientId)
          .setCallbackUri(callbackUri)
          .setScopes(SCOPES)
          .setPKCEProvider(new DefaultPKCEProvider() {
            // Temporary fix for https://github.com/googleapis/google-auth-library-java/issues/1373
            @Override
            public String getCodeChallenge() {
              return super.getCodeChallenge().split("=")[0];
            }
          })
          .setTokenStore(TOKEN_STORE).build();
      return authorizer;
    }
  }

  /**
   * Run the OAuth2 flow for local/installed app.
   * 
   * @return An authorized Credential object.
   * @throws IOException If the credentials.json file cannot be found.
   */
  private static Credentials getCredentials()
      throws Exception {

    LocalServerReceiver receiver = new LocalServerReceiver.Builder().build();
    try {
      URI callbackUri = URI.create(receiver.getRedirectUri());
      UserAuthorizer authorizer = getAuthorizer(callbackUri);

      Credentials credentials = authorizer.getCredentials(USER);
      if (credentials != null) {
        return credentials;
      }

      URL authorizationUrl = authorizer.getAuthorizationUrl(USER, "", null);
      if (Desktop.isDesktopSupported() && 
          Desktop.getDesktop().isSupported(Desktop.Action.BROWSE)) {
        Desktop.getDesktop().browse(authorizationUrl.toURI());
      } else {
        System.out.printf("Open the following URL to authorize access: %s\n",
            authorizationUrl.toExternalForm());
      }

      String code = receiver.waitForCode();
      credentials = authorizer.getAndStoreCredentialsFromCode(USER, code, callbackUri);
      return credentials;
    } finally {
      receiver.stop();
    }
  }

  public static void main(String... args) throws Exception {
    // Override default service settings to supply user credentials.
    Credentials credentials = getCredentials();
    SpacesServiceSettings settings = SpacesServiceSettings.newBuilder()
        .setCredentialsProvider(FixedCredentialsProvider.create(credentials))
        .build();

    try (SpacesServiceClient spacesServiceClient = SpacesServiceClient.create(settings)) {
      CreateSpaceRequest request = CreateSpaceRequest.newBuilder()
          .setSpace(Space.newBuilder().build())
          .build();
      Space response = spacesServiceClient.createSpace(request);
      System.out.printf("Space created: %s\n", response.getMeetingUri());
    } catch (IOException e) {
      // TODO(developer): Handle errors
      e.printStackTrace();
    }
  }
}

Ejecuta la muestra

  1. Ejecuta la muestra:

    gradle run
  1. La primera vez que ejecutes la muestra, se te solicitará que autorices el acceso:
    1. Si aún no accediste a tu Cuenta de Google, hazlo cuando se te solicite. Si accedeste a varias cuentas, selecciona una para usarla en la autorización.
    2. Haz clic en Aceptar.

    Tu aplicación de Java se ejecuta y llama a la API de Google Meet.

    La información de autorización se almacena en el sistema de archivos, por lo que la próxima vez que ejecutes el código de muestra, no se te solicitará autorización.

Próximos pasos