快速入门介绍了如何设置和运行调用 Google Workspace API。
Google Workspace 快速入门使用 API 客户端库来处理一些 身份验证和授权流程的详细信息。我们建议 您需要为自己的应用使用客户端库本快速入门使用 适用于测试的简化身份验证方法 环境对于生产环境,我们建议您了解 身份验证和授权 早于 选择访问凭据 适合您应用的广告格式
创建向 Google 文档 API 发出请求的 JavaScript 网络应用。
目标
- 设置环境。
- 设置示例。
- 运行该示例。
前提条件
- Node.js 和npm 已安装。
- Google Cloud 项目。
- Google 账号
设置环境
如需完成本快速入门,请设置您的环境。
启用 API
在使用 Google API 之前,您需要先在 Google Cloud 项目中启用这些 API。 您可以在单个 Google Cloud 项目中启用一个或多个 API。在 Google Cloud 控制台中,启用 Google 文档 API。
配置 OAuth 权限请求页面
如果您使用新的 Google Cloud 项目来完成本快速入门,请配置 OAuth 权限请求页面,并将您自己添加为测试用户。如果您已经 已完成此步骤,请跳到下一部分。
- 在 Google Cloud 控制台中,点击“菜单”图标 > API 和服务 > OAuth 同意屏幕。
- 对于用户类型,选择内部,然后点击创建。
- 填写应用注册表单,然后点击保存并继续。
现在,您可以跳过添加范围,然后点击保存并继续。 以后,如果您要创建一款应用供用户使用 Google Workspace 组织,您必须将用户类型更改为外部,然后执行以下操作: 添加您的应用所需的授权范围。
- 查看应用注册摘要。如需进行更改,请点击修改。如果应用 点击 Back to Dashboard(返回信息中心)。
为 Web 应用授权凭据
如需对最终用户进行身份验证并访问应用中的用户数据,您需要执行以下操作: 创建一个或多个 OAuth 2.0 客户端 ID。客户端 ID 用于标识 连接到 Google OAuth 服务器。如果您的应用在多个平台上运行 您必须为每个平台创建一个单独的客户端 ID。- 在 Google Cloud 控制台中,依次点击“菜单”图标 > API 和服务 > 凭据。
- 依次点击创建凭据 > OAuth 客户端 ID。
- 点击应用类型 > Web 应用。
- 在名称字段中,输入凭据的名称。此名称仅在 Google Cloud 控制台中显示。
- 添加与您的应用相关的已获授权的 URI:
<ph type="x-smartling-placeholder">
- </ph>
- 客户端应用 (JavaScript) - 在已获授权的 JavaScript 来源下,点击添加 URI。然后,输入要用于浏览器请求的 URI。这用于标识您的应用可以从哪些网域向 OAuth 2.0 服务器发送 API 请求。
- 服务器端应用(Java、Python 等) - 在已获授权的重定向 URI 下,点击添加 URI。然后,输入 OAuth 2.0 服务器可向其发送响应的端点 URI。
- 点击创建。系统会显示“OAuth 客户端创建”屏幕,其中显示了您的新客户端 ID 和客户端密钥。
记下客户端 ID。客户端密钥不用于 Web 应用。
- 点击 OK。新创建的凭据会显示在 OAuth 2.0 客户端 ID 下。
请记下这些凭据,因为您在本快速入门的后面部分需要用到它们。
创建 API 密钥
- 在 Google Cloud 控制台中,点击“菜单”图标 > API 和服务 > 凭据。
- 点击创建凭据 > API 密钥。
- 此时将显示您的新 API 密钥。
- 点击“复制”图标 复制 API 密钥,以便在应用代码中使用。API 密钥也可以是 可在“API 密钥”中找到部分。
- 点击限制密钥以更新高级设置并限制密钥的使用 您的 API 密钥。如需了解详情,请参阅应用 API 密钥限制。
设置示例
- 在您的工作目录中,创建一个名为
index.html
的文件。 在
index.html
文件中,粘贴以下示例代码:替换以下内容:
YOUR_CLIENT_ID
:您创建的客户端 ID 当你 Web 应用的授权凭据。YOUR_API_KEY
:您作为 API 密钥创建的 一个前提条件。
运行示例
在您的工作目录中,安装 http-server 软件包:
npm install http-server
在您的工作目录中,启动网络服务器:
npx http-server -p 8000
- 在浏览器中,前往
http://localhost:8000
。 -
您会看到授予访问权限的提示:
<ph type="x-smartling-placeholder">
- </ph>
- 如果您尚未登录 Google 账号,请在系统提示时登录。如果 如果您登录了多个账号,请选择一个用于授权的账号。
- 点击接受。
您的 JavaScript 应用程序运行并调用 Google 文档 API。