شروع سریع Node.js

مراحل شرح‌داده‌شده در ادامه این صفحه را تکمیل کنید و در حدود پنج دقیقه یک برنامه خط فرمان Node.js ساده خواهید داشت که درخواست‌هایی به YouTube Data API ارسال می‌کند.

کد نمونه استفاده‌شده در این راهنما منبع channel را برای کانال YouTube‏ GoogleDevelopers بازیابی می‌کند و برخی اطلاعات پایه را از آن منبع چاپ می‌کند.

پیش‌نیازها

برای اجرای این راهنمای شروع سریع، به موارد زیر نیاز دارید:

  • Node.js نصب شده باشد.
  • ابزار مدیریت بسته npm (همراه با Node.js ارائه می‌شود).
  • دسترسی به اینترنت و مرورگر وب.
  • «حساب Google».

مرحله ۱: YouTube Data API را روشن کنید

  1. از این دستیار برای ایجاد یا انتخاب پروژه در «کنسول Google Developers» و فعال کردن خودکار API استفاده کنید. روی ادامه، سپس رفتن به اطلاعات کاربری کلیک کنید.

  2. در صفحه ایجاد اطلاعات اعتباری، روی دکمه لغو کلیک کنید.

  3. در بالای صفحه، برگه صفحه کسب رضایت OAuth را انتخاب کنید. نشانی ایمیل را انتخاب کنید، اگر نام محصول ازقبل تنظیم نشده است، آن را وارد کنید و روی دکمه ذخیره کلیک کنید.

  4. برگه اعتبارنامه‌ها را انتخاب کنید، روی دکمه ایجاد اعتبارنامه‌ها کلیک کنید و شناسه کارخواه OAuth را انتخاب کنید.

  5. نوع برنامه دیگر را انتخاب کنید، نام «شروع سریع YouTube Data API» را وارد کنید، و روی دکمه ایجاد کلیک کنید.

  6. برای بستن کادر گفتگوی حاصل، روی تأیید کلیک کنید.

  7. روی دکمه (بارگیری JSON) در سمت چپ شناسه کارخواه کلیک کنید.

  8. فایل بارگیری‌شده را به فهرست راهنمای کاری‌تان منتقل کنید و نام آن را به client_secret.json تغییر دهید.

مرحله ۲: نصب کتابخانه کارخواه

برای نصب کتابخانه‌ها بااستفاده از npm، فرمان‌های زیر را اجرا کنید:

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

مرحله ۳: راه‌اندازی نمونه

فایلی با نام 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);
    }
  });
}

مرحله ۴: اجرای نمونه

نمونه را بااستفاده از فرمان زیر اجرا کنید:

node quickstart.js

اولین‌باری که نمونه را اجرا می‌کنید، از شما خواسته می‌شود دسترسی را مجاز کنید:

  1. در مرورگر وب خود به نشانی وب ارائه‌شده بروید.

    اگر قبلاً به سیستم حساب Google خود وارد نشده باشید، از شما خواسته می‌شود به سیستم وارد شوید. اگر به سیستم چند حساب Google وارد شده باشید، از شما خواسته می‌شود یک حساب را برای استفاده در مجوز انتخاب کنید.

  2. روی دکمه پذیرفتن کلیک کنید.
  3. کدی را که به شما داده شده است کپی کنید، آن را در پیام‌واره خط فرمان جای‌گذاری کنید، و کلید Enter را فشار دهید.

یادداشت‌ها

  • اطلاعات صدور مجوز در سیستم فایل ذخیره می‌شود، بنابراین اجراهای بعدی درخواست صدور مجوز نخواهند کرد.
  • جریان مجوز در این مثال برای برنامه خط فرمان طراحی شده است. برای اطلاعات درباره نحوه انجام مجوزدهی در برنامه وب که از YouTube Data API استفاده می‌کند، به استفاده از OAuth 2.0 برای برنامه‌های وب سرور مراجعه کنید.

    برای کسب اطلاعات درباره نحوه انجام دادن صدور مجوز در زمینه‌های دیگر، به بخش صدور مجوز و اصالت‌سنجی در فایل README کتابخانه مراجعه کنید.

مطالعه بیشتر