شروع سریع اسکریپت Google Apps

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

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

پیش‌نیازها

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

  • دسترسی به اینترنت و مرورگر وب.
  • یک حساب گوگل.
  • دسترسی به گوگل درایو.

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

  1. گوگل درایو را در مرورگر وب خود باز کنید.
  2. روی جدید > صفحات گوگل کلیک کنید.
  3. در صفحه گسترده جدید، روی افزونه‌ها > اسکریپت برنامه‌ها کلیک کنید.
  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();
}

    quickstart.gs
  5. روی ذخیره کلیک کنید .
  6. روی پروژه بدون عنوان (Untitled project) در بالا سمت چپ کلیک کنید، عبارت Quickstart را تایپ کنید و روی تغییر نام (Rename) کلیک کنید.

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

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

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

  1. صفحه گسترده خود را دوباره بارگذاری کنید. اگر اولین بار است که پس از اضافه کردن کد، صفحه گسترده را بارگذاری می‌کنید، ردیف اول باید با هدرهای ID ، Title و View count پر شود.

  2. در نوار منو، روی YouTube Data > Add GoogleDevelopers data کلیک کنید تا اطلاعات مربوط به کانال GoogleDevelopers را به صفحه گسترده خود اضافه کنید. (منوی YouTube Data باید در کنار منوهای استاندارد - File، Edit، View و غیره - ظاهر شود.)

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

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

  3. در نوار منو، برای افزودن داده برای کانال مورد نظر خود، روی YouTube Data > Add channel data کلیک کنید. در صورت درخواست، نام کانال (مثلاً "GoogleDevelopers" یا "SaturdayNightLive") را وارد کنید و روی تأیید کلیک کنید. اسکریپت داده‌های آن کانال را بازیابی کرده و به صفحه گسترده اضافه می‌کند.

مطالعه بیشتر

عیب‌یابی

خطای مرجع: "[نام API]" تعریف نشده است

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