Краткое руководство по Google Apps Script

Выполните инструкции, приведенные на этой странице, и уже через несколько минут у вас будет простой Google Apps Script, который отправляет запросы к YouTube Data API.

Пример приложения демонстрирует, как добавить данные канала YouTube в электронную таблицу.

Требования

Чтобы выполнить это краткое руководство, вам понадобится:

  • Доступ к интернету и веб-браузер.
  • Аккаунт Google.
  • Доступ к Google Диску.

Шаг 1. Создайте скрипт

  1. Откройте Google Диск в браузере.
  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. В левом верхнем углу нажмите Проект без названия, введите Быстрый старт и нажмите Переименовать.

Шаг 2. Включите YouTube Data API

  1. В меню слева выберите Редактор .
  2. Слева рядом с пунктом "Сервисы" нажмите "Добавить сервис" .
  3. Нажмите YouTube Data API, а затем Добавить.

Шаг 3. Запустите пример

  1. Перезагрузите таблицу. Если вы загружаете таблицу впервые после добавления кода, в первой строке должны появиться заголовки ID, Название и Количество просмотров.

  2. В строке меню нажмите Данные YouTube > Добавить данные GoogleDevelopers, чтобы добавить в таблицу информацию о канале GoogleDevelopers. (Меню YouTube Data должно появиться рядом со стандартными меню – "Файл", "Правка", "Вид" и т. д.)

    При первом запуске образца вам будет предложено авторизовать доступ:

    1. Нажмите Проверить разрешения.
    2. Выберите
    3. Нажмите Разрешить.

  3. На панели меню нажмите Данные YouTube > Добавить данные канала, чтобы добавить данные для нужного канала. В появившемся окне введите название канала (например, GoogleDevelopers или SaturdayNightLive) и нажмите ОК. Скрипт получает данные для этого канала и добавляет их в таблицу.

Дополнительные сведения

Устранение неполадок

ReferenceError: "[API NAME]" is not defined

Эта ошибка возникает, если API не включен в редакторе кода Apps Script. Вернитесь к шагу 2б и убедитесь, что переключатель находится в положении включено.