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

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

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

پیش نیازها

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

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

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

  1. Google Drive را در مرورگر وب خود باز کنید.
  2. روی New > Google Sheets کلیک کنید.
  3. در صفحه گسترده جدید، روی Extensions > 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. روی پروژه Untitled در بالا سمت چپ کلیک کنید، Quickstart را تایپ کنید و روی تغییر نام کلیک کنید.

مرحله ۲: YouTube Data API را روشن کنید

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

مرحله 3: نمونه را اجرا کنید

  1. صفحه گسترده خود را دوباره بارگیری کنید. اگر اولین باری است که صفحه گسترده را پس از افزودن کد بارگیری می‌کنید، ردیف اول باید با سرصفحه‌های ID ، عنوان و تعداد مشاهده پر شود.
  2. در نوار منو، روی YouTube Data > Add Google Developers کلیک کنید تا اطلاعات مربوط به کانال GoogleDevelopers را به صفحه گسترده خود اضافه کنید. (منوی YouTube Data باید در کنار منوهای استاندارد - فایل، ویرایش، مشاهده و غیره ظاهر شود)

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

    1. روی بررسی مجوزها کلیک کنید.
    2. یک حساب کاربری انتخاب کنید.
    3. روی Allow کلیک کنید.
  3. در نوار منو، روی داده‌های YouTube > افزودن داده‌های کانال کلیک کنید تا داده‌های کانال مورد نظر خود را اضافه کنید. هنگامی که از شما خواسته شد، نام کانال را وارد کنید (به عنوان مثال "GoogleDevelopers" یا "SaturdayNightLive") و روی OK کلیک کنید. اسکریپت داده های آن کانال را بازیابی می کند و به صفحه گسترده اضافه می کند.

در ادامه مطلب

عیب یابی

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

این خطا زمانی رخ می دهد که API در ویرایشگر کد Apps Script روشن نشده باشد. مرحله 2.b را مجدداً مشاهده کنید و مطمئن شوید که کلید مربوطه روی روشن تنظیم شده است.