快速入门介绍了如何设置和运行调用 Google Workspace API 的应用。
Google Workspace 快速入门使用 API 客户端库来处理身份验证和授权流程的某些详细信息。我们建议您为自己的应用使用客户端库。本快速入门使用适用于测试环境的简化身份验证方法。对于生产环境,我们建议您先了解身份验证和授权,然后再选择适合您应用的访问凭据。
创建一个 Java 命令行应用,用于向 Google Meet API 发出请求。
目标
- 设置环境。
- 设置示例。
- 运行示例。
前提条件
- Java 1.8 或更高版本。
- Gradle 7.0 或更高版本。
- Google Cloud 项目。
- 拥有已启用 Google Meet 的 Google Workspace 帐号。
设置您的环境
如需完成本快速入门,请设置您的环境。
启用 API
在使用 Google API 之前,您需要在 Google Cloud 项目中启用它们。您可以在单个 Google Cloud 项目中启用一个或多个 API。-
在 Google Cloud 控制台中,启用 Google Meet API。
配置 OAuth 权限请求页面
如果您要使用新的 Google Cloud 项目完成本快速入门,请配置 OAuth 权限请求页面,并将您自己添加为测试用户。如果您已为自己的 Cloud 项目完成此步骤,请跳到下一部分。
- 在 Google Cloud 控制台中,依次点击“菜单”图标 > API 和服务 > OAuth 同意屏幕。
- 对于用户类型,选择内部,然后点击创建。
- 填写应用注册表单,然后点击保存并继续。
目前,您可以跳过添加范围的步骤,点击 Save and Continue(保存并继续)。 将来,当您创建要在 Google Workspace 组织外部使用的应用时,必须将用户类型更改为外部,然后添加您的应用所需的授权范围。
- 查看您的应用注册摘要。如要进行更改,请点击修改。如果应用注册看起来正常,请点击 Back to Dashboard。
为桌面应用授权凭据
如需在您的应用中对最终用户进行身份验证并访问用户数据,您需要创建一个或多个 OAuth 2.0 客户端 ID。客户端 ID 用于向 Google 的 OAuth 服务器标识单个应用。如果您的应用在多个平台上运行,您必须为每个平台创建单独的客户端 ID。- 在 Google Cloud 控制台中,依次点击“菜单”图标 > API 和服务 > 凭据。
- 依次点击创建凭据 > OAuth 客户端 ID。
- 依次点击应用类型 > 桌面应用。
- 在名称字段中,输入凭据的名称。此名称只会显示在 Google Cloud 控制台中。
- 点击创建。系统会显示 OAuth 客户端已创建屏幕,其中显示了您的新客户端 ID 和客户端密钥。
- 点击 OK。新创建的凭据会显示在 OAuth 2.0 客户端 ID 下方。
- 将下载的 JSON 文件另存为
credentials.json
,然后将该文件移动到工作目录。
准备工作区
在工作目录中,创建新的项目结构:
gradle init --type basic mkdir -p src/main/java src/main/resources
在
src/main/resources/
目录中,复制您之前下载的credentials.json
文件。打开默认的
build.gradle
文件,并将其内容替换为以下代码:
设置示例
在
src/main/java/
目录中,创建一个新的 Java 文件,其名称与build.gradle
文件中的mainClassName
值匹配。在新的 Java 文件中添加以下代码:
运行示例
运行示例:
gradle run
-
首次运行示例时,系统会提示您授予访问权限:
- 如果您尚未登录 Google 帐号,请在系统提示时登录。如果您已登录多个帐号,请选择一个帐号用于授权。
- 点击接受。
Java 应用运行并调用 Google Meet API。
授权信息存储在文件系统中,因此当您下次运行示例代码时,系统不会提示您授权。