التشغيل السريع لـ Node.js

أكمِل الخطوات الموضّحة في بقية هذه الصفحة، وسيكون لديك في غضون خمس دقائق تطبيق بسيط لسلسلة أوامر Node.js يُرسل طلبات إلى واجهة برمجة التطبيقات YouTube Data API.

يسترجع نموذج الرمز البرمجي المستخدَم في هذا الدليل مرجع channel لقناتنا على YouTube بعنوان GoogleDevelopers، ويطبع بعض المعلومات الأساسية من هذا المرجع.

المتطلبات الأساسية

لتنفيذ هذه الخطوات السريعة، ستحتاج إلى ما يلي:

  • تثبيت Node.js
  • أداة إدارة الحِزم npm (تتوفر مع Node.js)
  • إمكانية الوصول إلى الإنترنت ومتصفّح ويب
  • حساب على Google

الخطوة 1: تفعيل واجهة برمجة التطبيقات YouTube Data API

  1. استخدِم هذا المعالج لإنشاء مشروع أو اختياره في Google Developers Console وتفعيل واجهة برمجة التطبيقات تلقائيًا. انقر على متابعة، ثم على الانتقال إلى بيانات الاعتماد.

  2. في صفحة إنشاء بيانات الاعتماد، انقر على الزر إلغاء.

  3. في أعلى الصفحة، انقر على علامة التبويب شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth. اختَر عنوان بريد إلكتروني، وأدخِل اسم المنتج إذا لم يكن محدّدًا، ثم انقر على الزر حفظ.

  4. اختَر علامة التبويب بيانات الاعتماد، وانقر على الزر إنشاء بيانات اعتماد واختَر معرِّف عميل OAuth.

  5. اختَر نوع التطبيق غير ذلك، وأدخِل الاسم "البدء السريع لواجهة برمجة التطبيقات YouTube Data API"، ثم انقر على الزر إنشاء.

  6. انقر على حسنًا لإغلاق مربّع الحوار الناتج.

  7. انقر على الزر (تنزيل ملف 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);
    }
  });
}

الخطوة 4: تشغيل العيّنة

شغِّل العيّنة باستخدام الأمر التالي:

node quickstart.js

في المرة الأولى التي تُشغِّل فيها العيّنة، سيُطلَب منك تفويض الوصول:

  1. انتقِل إلى عنوان URL المقدَّم في متصفّح الويب.

    إذا لم تكن مسجِّلاً الدخول إلى حسابك على Google، سيُطلب منك تسجيل الدخول. إذا سجّلت الدخول إلى حسابات متعددة على Google، سيُطلب منك اختيار حساب واحد لاستخدامه في التفويض.

  2. انقر على الزر قبول.
  3. انسخ الرمز الذي تم منحك إياه والصقه في موجّه سطر الأوامر، ثم اضغط على Enter.

ملاحظات

  • يتم تخزين معلومات التفويض في نظام الملفات، لذا لن تطلب عمليات التنفيذ اللاحقة الحصول على إذن.
  • تم تصميم عملية التفويض في هذا المثال لتطبيق سطر برمجي. للحصول على معلومات عن كيفية تنفيذ التفويض في أحد تطبيقات الويب التي تستخدم YouTube Data API، يُرجى الاطّلاع على استخدام OAuth 2.0 لتطبيقات خادم الويب.

    للحصول على معلومات عن كيفية تنفيذ التفويض في سياقات أخرى، اطّلِع على القسم التفويض والمصادقة في ملف README الخاص بالمكتبة.

مراجع إضافية