دليل البدء السريع في Google Apps Script

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

يوضّح نموذج التطبيق كيفية إضافة بيانات قناة على YouTube إلى جدول بيانات.

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

لتشغيل هذا الدليل السريع، ستحتاج إلى ما يلي:

  • إمكانية وصول إلى الإنترنت ومتصفّح ويب
  • حساب Google
  • الوصول إلى Google Drive

الخطوة 1: إنشاء النص البرمجي

  1. افتح Google Drive في متصفّح الويب.
  2. انقر على جديد > جداول بيانات Google.
  3. في جدول البيانات الجديد، انقر على الإضافات > برمجة تطبيقات Google.
  4. استبدِل محتوى محرِّر النصوص البرمجية بالرمز التالي: 
    // Note: Apps Script automatically requests authorization
// based on the API's used in the code.

function channelsListByUsername(part, params) {
  var response = YouTube.Channels.list(part,
                                       params);
  var channel = response.items[0];
  var dataRow = [channel.id, channel.snippet.title, channel.statistics.viewCount];
  SpreadsheetApp.getActiveSpreadsheet().appendRow(dataRow);
}

function getChannel() {
  var ui = SpreadsheetApp.getUi();
  var channelName = ui.prompt("Enter the channel name: ").getResponseText();
  channelsListByUsername('snippet,contentDetails,statistics',
                         {'forUsername': channelName});
}

function getGoogleDevelopersChannel() {
  channelsListByUsername('snippet,contentDetails,statistics',
                         {'forUsername': 'GoogleDevelopers'});
}

function onOpen() {
  var firstCell = SpreadsheetApp.getActiveSheet().getRange(1, 1).getValue();
  if (firstCell != 'ID') {
    var headerRow = ["ID", "Title", "View count"];
    SpreadsheetApp.getActiveSpreadsheet().appendRow(headerRow);
  }
  var ui = SpreadsheetApp.getUi();
  ui.createMenu('YouTube Data')
  .addItem('Add channel data', 'getChannel')
  .addSeparator()
  .addItem('Add GoogleDevelopers data', 'getGoogleDevelopersChannel')
  .addToUi();
}
  5. انقر على "حفظ" .
  6. انقر على مشروع بلا عنوان في أعلى يمين الصفحة، واكتب Quickstart، ثم انقر على إعادة تسمية.

الخطوة 2: تفعيل YouTube Data API

  1. على يمين الصفحة، انقروا على أداة التعديل .
  2. على يمين الشاشة، بجانب "الخدمات"، انقر على "إضافة خدمة" .
  3. انقر على YouTube Data API، ثم انقر على إضافة.

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

  1. أعِد تحميل جدول البيانات. إذا كانت هذه هي المرة الأولى التي يتم فيها تحميل جدول البيانات بعد إضافة الرمز، يجب أن يتم ملء الصف الأول بعناوين المعرّف والعنوان وعدد المشاهدات.

  2. في شريط القوائم، انقر على بيانات YouTube > إضافة بيانات GoogleDevelopers لإضافة معلومات عن قناة GoogleDevelopers إلى جدول البيانات. (من المفترض أن تظهر قائمة YouTube Data بجانب القوائم العادية، مثل "ملف" و"تعديل" و"عرض" وما إلى ذلك).

    في المرة الأولى التي تشغّل فيها النموذج، سيطلب منك منح الإذن بالوصول:

    1. انقر على مراجعة الأذونات.
    2. اختر حسابًا.
    3. انقر على سماح.

  3. في شريط القوائم، انقر على بيانات YouTube > إضافة بيانات قناة لإضافة بيانات لقناة من اختيارك. عندما يُطلب منك ذلك، أدخِل اسم القناة (مثلاً "GoogleDevelopers" أو "SaturdayNightLive") وانقر على حسنًا. يستردّ النص البرمجي البيانات لتلك القناة ويضيفها إلى جدول البيانات.

محتوى إضافي للقراءة

تحديد المشاكل وحلّها

ReferenceError: لم يتم تحديد "[اسم واجهة برمجة التطبيقات]"

يحدث هذا الخطأ عندما لا يتم تفعيل واجهة برمجة التطبيقات في محرّر رمز Apps Script. يُرجى الرجوع إلى الخطوة 2.ب والتأكّد من ضبط مفتاح التبديل المقابل على تفعيل.