Java 快速入门

快速入门介绍了如何设置和运行调用 Google Workspace API 的应用。

Google Workspace 快速入门使用 API 客户端库来处理身份验证和授权流程的一些细节。我们建议您为自己的应用使用客户端库。本快速入门使用适合测试环境的简化身份验证方法。对于生产环境，我们建议您先了解身份验证和授权，然后再选择适合您的应用的访问凭据。

创建一个 Java 命令行应用，用于向 Google Meet API 发出请求。

目标

  • 设置环境。
  • 设置示例。
  • 运行示例。

前提条件

  • 已启用 Google Meet 的 Google Workspace 账号。

设置环境

如需完成本快速入门，请设置您的环境。

启用 API

在使用 Google API 之前，您需要先在 Google Cloud 项目中启用它们。您可以在单个 Google Cloud 项目中启用一个或多个 API。

  • 在 Google Cloud 控制台中，启用 Google Meet API。

    启用 API

如果您使用新的 Google Cloud 项目完成本快速入门，请配置 OAuth 同意屏幕，并将自己添加为测试用户。如果您已为 Cloud 项目完成此步骤，请跳至下一部分。

  1. 在 Google Cloud 控制台中，依次点击“菜单”图标 > API 和服务 > OAuth 权限请求页面。

    转到 OAuth 同意屏幕

  2. 在用户类型字段中，选择内部，然后点击创建。
  3. 填写应用注册表单，然后点击保存并继续。

  4. 现在，您可以跳过添加镜重，然后点击保存并继续。今后，如果您创建的应用要在 Google Workspace 组织之外使用，则必须将用户类型更改为外部，然后添加应用所需的授权范围。

  5. 查看应用注册摘要。如需进行更改，请点击修改。如果应用注册未出现任何问题，请点击返回信息中心。

为桌面应用授权凭据

如需对最终用户进行身份验证并访问应用中的用户数据，您需要创建一个或多个 OAuth 2.0 客户端 ID。客户端 ID 用于向 Google 的 OAuth 服务器标识单个应用。如果您的应用在多个平台上运行，您必须为每个平台分别创建客户端 ID。
  1. 在 Google Cloud 控制台中，依次选择“菜单”图标 > API 和服务 > 凭据。

    进入“凭据”页面

  2. 依次点击创建凭据 > OAuth 客户端 ID。
  3. 依次点击应用类型 > 桌面应用。
  4. 在名称字段中，输入凭据的名称。此名称仅在 Google Cloud 控制台中显示。
  5. 点击创建。系统随即会显示“OAuth 客户端已创建”屏幕，其中显示您的新客户端 ID 和客户端密钥。
  6. 点击确定。新创建的凭据会显示在 OAuth 2.0 客户端 ID 下。
  7. 将下载的 JSON 文件另存为 credentials.json，然后将该文件移至您的工作目录。

准备工作区

  1. 在工作目录中，创建一个新的项目结构：

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

  2. 在 src/main/resources/ 目录中，复制您之前下载的 credentials.json 文件。

  3. 打开默认的 build.gradle 文件，并将其内容替换为以下代码：

    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'
}

设置示例

  1. 在 src/main/java/ 目录中，创建一个新的 Java 文件，其名称与 build.gradle 文件中的 mainClassName 值匹配。

  2. 在新 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();
    }
  }
}

运行示例

  1. 运行示例：

    gradle run
  1. 首次运行该示例时，系统会提示您授予访问权限：
    1. 如果您尚未登录 Google 账号，请在系统提示时登录。如果您登录了多个账号，请选择一个账号用于授权。
    2. 点击接受。

    您的 Java 应用运行并调用 Google Meet API。

    授权信息存储在文件系统中，因此当您下次运行示例代码时，系统不会提示您进行授权。

后续步骤