Node.js 版快速入门

完成本页其余部分中介绍的步骤，大约 5 分钟后，您将拥有一个简单的 Node.js 命令行应用，该应用可向 YouTube Data API 发出请求。

本指南中使用的示例代码会检索 GoogleDevelopers YouTube 频道的 channel 资源，并输出该资源中的部分基本信息。

前提条件

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

  • 已安装 Node.js。
  • npm 软件包管理工具（随 Node.js 一起提供）。
  • 能够连接到互联网并使用网络浏览器。
  • Google 账号。

第 1 步：启用 YouTube Data API

  1. 使用此向导在 Google Developers Console 中创建或选择项目，并自动启用该 API。点击继续，然后点击转到凭据。

  2. 在创建凭据页面上，点击取消按钮。

  3. 在页面顶部，选择 OAuth 权限请求屏幕标签页。 选择电子邮件地址，输入商品名（如果尚未设置），然后点击保存按钮。

  4. 选择凭据标签页，点击创建凭据按钮，然后选择 OAuth 客户端 ID。

  5. 选择应用类型 Other，输入名称“YouTube Data API Quickstart”，然后点击 Create 按钮。

  6. 点击确定以关闭随即显示的对话框。

  7. 点击客户端 ID 右侧的 （下载 JSON）按钮。

  8. 将下载的文件移至您的工作目录，并将其重命名为 client_secret.json。

第 2 步：安装客户端库

运行以下命令以使用 npm 安装库：

npm install googleapis --save
npm install google-auth-library --save

第 3 步：设置示例

在工作目录中创建一个名为 quickstart.js 的文件，并复制以下代码：

var fs = require('fs');
var readline = require('readline');
var {google} = require('googleapis');
var OAuth2 = google.auth.OAuth2;

// If modifying these scopes, delete your previously saved credentials
// at ~/.credentials/youtube-nodejs-quickstart.json
var SCOPES = ['https://www.googleapis.com/auth/youtube.readonly'];
var TOKEN_DIR = (process.env.HOME || process.env.HOMEPATH ||
    process.env.USERPROFILE) + '/.credentials/';
var TOKEN_PATH = TOKEN_DIR + 'youtube-nodejs-quickstart.json';

// Load client secrets from a local file.
fs.readFile('client_secret.json', function processClientSecrets(err, content) {
  if (err) {
    console.log('Error loading client secret file: ' + err);
    return;
  }
  // Authorize a client with the loaded credentials, then call the YouTube API.
  authorize(JSON.parse(content), getChannel);
});

/**
 * Create an OAuth2 client with the given credentials, and then execute the
 * given callback function.
 *
 * @param {Object} credentials The authorization client credentials.
 * @param {function} callback The callback to call with the authorized client.
 */
function authorize(credentials, callback) {
  var clientSecret = credentials.installed.client_secret;
  var clientId = credentials.installed.client_id;
  var redirectUrl = credentials.installed.redirect_uris[0];
  var oauth2Client = new OAuth2(clientId, clientSecret, redirectUrl);

  // Check if we have previously stored a token.
  fs.readFile(TOKEN_PATH, function(err, token) {
    if (err) {
      getNewToken(oauth2Client, callback);
    } else {
      oauth2Client.credentials = JSON.parse(token);
      callback(oauth2Client);
    }
  });
}

/**
 * Get and store new token after prompting for user authorization, and then
 * execute the given callback with the authorized OAuth2 client.
 *
 * @param {google.auth.OAuth2} oauth2Client The OAuth2 client to get token for.
 * @param {getEventsCallback} callback The callback to call with the authorized
 *     client.
 */
function getNewToken(oauth2Client, callback) {
  var authUrl = oauth2Client.generateAuthUrl({
    access_type: 'offline',
    scope: SCOPES
  });
  console.log('Authorize this app by visiting this url: ', authUrl);
  var rl = readline.createInterface({
    input: process.stdin,
    output: process.stdout
  });
  rl.question('Enter the code from that page here: ', function(code) {
    rl.close();
    oauth2Client.getToken(code, function(err, token) {
      if (err) {
        console.log('Error while trying to retrieve access token', err);
        return;
      }
      oauth2Client.credentials = token;
      storeToken(token);
      callback(oauth2Client);
    });
  });
}

/**
 * Store token to disk be used in later program executions.
 *
 * @param {Object} token The token to store to disk.
 */
function storeToken(token) {
  try {
    fs.mkdirSync(TOKEN_DIR);
  } catch (err) {
    if (err.code != 'EEXIST') {
      throw err;
    }
  }
  fs.writeFile(TOKEN_PATH, JSON.stringify(token), (err) => {
    if (err) throw err;
    console.log('Token stored to ' + TOKEN_PATH);
  });
}

/**
 * Lists the names and IDs of up to 10 files.
 *
 * @param {google.auth.OAuth2} auth An authorized OAuth2 client.
 */
function getChannel(auth) {
  var service = google.youtube('v3');
  service.channels.list({
    auth: auth,
    part: 'snippet,contentDetails,statistics',
    forUsername: 'GoogleDevelopers'
  }, function(err, response) {
    if (err) {
      console.log('The API returned an error: ' + err);
      return;
    }
    var channels = response.data.items;
    if (channels.length == 0) {
      console.log('No channel found.');
    } else {
      console.log('This channel\'s ID is %s. Its title is \'%s\', and ' +
                  'it has %s views.',
                  channels[0].id,
                  channels[0].snippet.title,
                  channels[0].statistics.viewCount);
    }
  });
}

nodejs-quickstart.js

第 4 步：运行示例代码

使用以下命令运行示例：

node quickstart.js

首次运行该示例时，系统会提示您授予访问权限：

  1. 在网络浏览器中浏览到提供的网址。

    如果您尚未登录 Google 账号，系统会提示您登录。如果您登录了多个 Google 账号，系统会要求您选择一个账号来进行授权。

  2. 点击接受按钮。
  3. 复制您获得的代码，将其粘贴到命令行提示符中，然后按 Enter 键。

备注

  • 授权信息存储在文件系统中，因此后续执行时不会提示授权。
  • 此示例中的授权流程专为命令行应用而设计。如需了解如何在使用 YouTube Data API 的 Web 应用中执行授权，请参阅针对 Web 服务器应用使用 OAuth 2.0。

    如需了解如何在其他上下文中执行授权，请参阅该库自述文件的授权和身份验证部分。

深入阅读