Google Apps 脚本快速入门

完成本页其余部分所述的步骤。只需几分钟时间，您就可以获得向 YouTube Data API 发出请求的简单 Google Apps 脚本。

示例应用演示了如何将 YouTube 频道数据添加到电子表格中。

前提条件

如需运行本快速入门，您需要：

  • 访问互联网和网络浏览器。
  • Google 帐号。
  • 访问 Google 云端硬盘。

第 1 步：创建脚本

  1. 在网络浏览器中打开 Google 云端硬盘。
  2. 点击新建 > Google 表格。
  3. 在新电子表格中，依次点击扩展程序 > Apps 脚本。
  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 步：启用 YouTube Data API

  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 名称]”未定义

如果未在 Apps 脚本代码编辑器中启用该 API，便会出现此错误。重新查看第 2.b 步，确保将相应的切换开关设置为开启。