Node.js Quickstart

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

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

پیش‌نیازها

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

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

مرحله ۱: فعال کردن API داده یوتیوب

  1. از این ویزارد برای ایجاد یا انتخاب یک پروژه در کنسول توسعه‌دهندگان گوگل و فعال کردن خودکار API استفاده کنید. روی ادامه کلیک کنید، سپس به اعتبارنامه‌ها بروید .

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

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

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

  5. نوع برنامه را Other انتخاب کنید، نام آن را "YouTube Data API Quickstart" بگذارید و روی دکمه Create کلیک کنید.

  6. برای رد کردن کادر محاوره‌ای حاصل، روی تأیید کلیک کنید.

  7. روی دکمه (دانلود JSON) در سمت راست شناسه کلاینت کلیک کنید.

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

مرحله 2: نصب کتابخانه کلاینت

برای نصب کتابخانه‌ها با استفاده از 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. در مرورگر وب خود به آدرس اینترنتی ارائه شده بروید.

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

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

یادداشت‌ها

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

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

مطالعه بیشتر