Краткое руководство по сценариям Google Apps

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

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

Предварительные требования

Для запуска этого краткого руководства вам потребуется:

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

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

  1. Откройте Google Диск в веб-браузере.
  2. Нажмите «Создать» > «Google Sheets» .
  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();
}

    quickstart.gs
  5. Нажмите «Сохранить». .
  6. В левом верхнем углу щелкните «Безымянный проект» , введите «Быстрый старт» и нажмите «Переименовать» .

Шаг 2: Включите API данных YouTube.

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

Шаг 3: Запустите образец.

  1. Перезагрузите электронную таблицу. Если вы загружаете таблицу впервые после добавления кода, первая строка должна заполниться заголовками «ID» , «Title» и «View count» .

  2. В строке меню щелкните «Данные YouTube» > «Добавить данные GoogleDevelopers» , чтобы добавить информацию о канале GoogleDevelopers в вашу электронную таблицу. (Меню «Данные YouTube» должно появиться рядом со стандартными меню — «Файл», «Редактировать», «Вид» и т. д.)

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

    1. Нажмите «Проверить права доступа» .
    2. Выберите учетную запись.
    3. Нажмите «Разрешить» .

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

Дополнительная информация

Поиск неисправностей

ReferenceError: "[API NAME]" не определен

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