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

أكمِل الخطوات الموضّحة في بقية هذه الصفحة، وستتمكّن في غضون دقائق قليلة من إنشاء برنامج نصي بسيط في Google Apps Script يرسل طلبات إلى 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', 'getCh
    annel')
 
         .addSeparator()
  .addItem('Add GoogleDevelopers data', 'getGoogleDevelopersChannel')
  .addToUi();
}
quickstart.gs
  5. انقر على "حفظ" .
  6. انقر على مشروع بلا عنوان في أعلى يمين الصفحة، واكتب Quickstart، ثم انقر على إعادة تسمية.

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

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

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

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

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

    عند تشغيل النموذج لأول مرة، سيُطلب منك منح الإذن بالوصول:

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

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

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

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

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

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