此页面由 Cloud Translation API 翻译。

Node.js 版快速入门

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

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

创建一个向 Gmail API。

目标

设置环境。
安装客户端库。
设置示例。
运行该示例。

前提条件

如需运行本快速入门，您需要满足以下前提条件：

Node.js 和npm。
Google Cloud 项目。

一个已启用 Gmail 的 Google 账号。

设置环境

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

启用 API

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

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

启用 API

配置 OAuth 权限请求页面

如果您使用新的 Google Cloud 项目来完成本快速入门，请配置 OAuth 权限请求页面，并将您自己添加为测试用户。如果您已经已完成此步骤，请跳到下一部分。

在 Google Cloud 控制台中，点击“菜单”图标 > API 和服务 > OAuth 同意屏幕。
转到 OAuth 同意屏幕
对于用户类型，选择内部，然后点击创建。
填写应用注册表单，然后点击保存并继续。
现在，您可以跳过添加范围，然后点击保存并继续。以后，如果您要创建一款应用供用户使用 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，并将复制到您的工作目录中。

安装客户端库

使用 npm 安装库：

npm install googleapis@105 @google-cloud/local-auth@2.1.0 --save

设置示例

在您的工作目录中，创建一个名为 index.js 的文件。

在此文件中，粘贴以下代码：

gmail/quickstart/index.js

在 GitHub 上查看

const fs = require('fs').promises;
const path = require('path');
const process = require('process');
const {authenticate} = require('@google-cloud/local-auth');
const {google} = require('googleapis');

// If modifying these scopes, delete token.json.
const SCOPES = ['https://www.googleapis.com/auth/gmail.readonly'];
// The file token.json stores the user's access and refresh tokens, and is
// created automatically when the authorization flow completes for the first
// time.
const TOKEN_PATH = path.join(process.cwd(), 'token.json');
const CREDENTIALS_PATH = path.join(process.cwd(), 'credentials.json');

/**
 * Reads previously authorized credentials from the save file.
 *
 * @return {Promise<OAuth2Client|null>}
 */
async function loadSavedCredentialsIfExist() {
  try {
    const content = await fs.readFile(TOKEN_PATH);
    const credentials = JSON.parse(content);
    return google.auth.fromJSON(credentials);
  } catch (err) {
    return null;
  }
}

/**
 * Serializes credentials to a file compatible with GoogleAuth.fromJSON.
 *
 * @param {OAuth2Client} client
 * @return {Promise<void>}
 */
async function saveCredentials(client) {
  const content = await fs.readFile(CREDENTIALS_PATH);
  const keys = JSON.parse(content);
  const key = keys.installed || keys.web;
  const payload = JSON.stringify({
    type: 'authorized_user',
    client_id: key.client_id,
    client_secret: key.client_secret,
    refresh_token: client.credentials.refresh_token,
  });
  await fs.writeFile(TOKEN_PATH, payload);
}

/**
 * Load or request or authorization to call APIs.
 *
 */
async function authorize() {
  let client = await loadSavedCredentialsIfExist();
  if (client) {
    return client;
  }
  client = await authenticate({
    scopes: SCOPES,
    keyfilePath: CREDENTIALS_PATH,
  });
  if (client.credentials) {
    await saveCredentials(client);
  }
  return client;
}

/**
 * Lists the labels in the user's account.
 *
 * @param {google.auth.OAuth2} auth An authorized OAuth2 client.
 */
async function listLabels(auth) {
  const gmail = google.gmail({version: 'v1', auth});
  const res = await gmail.users.labels.list({
    userId: 'me',
  });
  const labels = res.data.labels;
  if (!labels || labels.length === 0) {
    console.log('No labels found.');
    return;
  }
  console.log('Labels:');
  labels.forEach((label) => {
    console.log(`- ${label.name}`);
  });
}

authorize().then(listLabels).catch(console.error);

运行示例

在您的工作目录中，运行该示例：
```
node .
```

首次运行该示例时，它会提示您授予访问权限： <ph type="x-smartling-placeholder">
1. 如果您尚未登录 Google 账号，请在系统提示时登录。如果如果您登录了多个账号，请选择一个用于授权的账号。
2. 点击接受。
您的 Nodejs 应用运行并调用 Gmail API。

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