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 步，确保将相应的切换开关设置为开启。