شروع سریع Google Apps Script

مراحل شرح‌داده‌شده در ادامه این صفحه را تکمیل کنید و فقط در چند دقیقه یک Google Apps Script ساده خواهید داشت که درخواست‌هایی را به YouTube Data API ارسال می‌کند.

برنامه نمونه نشان می‌دهد که چگونه داده‌های کانال YouTube را به یک صفحه‌گسترده اضافه کنید.

پیش‌نیازها

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

  • دسترسی به اینترنت و مرورگر وب.
  • حساب Google.
  • دسترسی به Google Drive.

مرحله ۱: ایجاد دستورات

  1. Google Drive را در مرورگر وب باز کنید.
  2. روی جدید > کاربرگ‌نگار Google کلیک کنید.
  3. در صفحه‌گسترده جدید، روی افزونه‌ها > Apps Script کلیک کنید.
  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. در بالا سمت راست، روی پروژه بدون عنوان کلیک کنید، شروع سریع را تایپ کنید، و روی تغییر نام کلیک کنید.

مرحله ۲: YouTube Data API را فعال کنید

  1. در سمت راست، روی تدوین‌گر کلیک کنید.
  2. در سمت راست، در کنار «خدمات»، روی «افزودن خدمات» کلیک کنید.
  3. روی YouTube Data API و سپس افزودن کلیک کنید.

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

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

  2. در نوار منو، روی داده‌های YouTube > افزودن داده‌های GoogleDevelopers کلیک کنید تا اطلاعات مربوط به کانال GoogleDevelopers را به صفحه‌گسترده‌تان اضافه کنید. (منوِ «داده‌های YouTube» باید در کنار منوهای استاندارد – «فایل»، «ویرایش»، «مشاهده»، و غیره – ظاهر شود.)

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

    1. روی مرور اجازه‌ها کلیک کنید.
    2. حسابی انتخاب کنید.
    3. روی اجازه دادن کلیک کنید.

  3. در نوار منو، روی داده‌های YouTube > افزودن داده‌های کانال کلیک کنید تا داده‌های کانال موردنظرتان را اضافه کنید. وقتی از شما خواسته شد، نام کانال را وارد کنید (مثلاً «GoogleDevelopers» یا «SaturdayNightLive») و روی تأیید کلیک کنید. این نوشتار داده‌های آن کانال را بازیابی می‌کند و به صفحه‌گسترده اضافه می‌کند.

مطالعه بیشتر

عیب‌یابی

ReferenceError: «[API NAME]» تعریف نشده است

این خطا زمانی رخ می‌دهد که API در ویرایشگر کد Apps Script روشن نشده باشد. به «مرحله ۲.ب» برگردید و مطمئن شوید که کلید مربوطه روی روشن تنظیم شده است.