Google Apps 脚本快速入门

完成本页其余部分中所述的步骤，只需几分钟，您就能获得一个简单的 Google Apps 脚本，用于向 YouTube Data API 发出请求。

此示例应用演示了如何将 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. 点击左上角的未命名项目，输入 Quickstart，然后点击重命名。

第 2 步：启用 YouTube Data API

  1. 点击左侧的编辑器图标 。
  2. 在左侧，点击“服务”旁边的“添加服务”图标 。
  3. 点击 YouTube Data API，然后点击添加。

第 3 步：运行示例代码

  1. 重新加载电子表格。如果您是首次在添加代码后加载电子表格，则第一行应填充 ID、标题和观看次数标题。

  2. 在菜单栏中，依次点击 YouTube 数据 > 添加 GoogleDevelopers 数据，将 GoogleDevelopers 频道的相关信息添加到您的电子表格中。 （“YouTube 数据”菜单应显示在标准菜单旁边，例如“文件”“编辑”“查看”等。）

    首次运行示例时，系统会提示您授权访问：

    1. 点击查看权限。
    2. 选择账号。
    3. 点击允许。

  3. 在菜单栏中，依次点击 YouTube 数据 > 添加频道数据，以添加所选频道的数据。出现提示时，输入频道名称（例如“GoogleDevelopers”或“SaturdayNightLive”），然后点击确定。该脚本会检索相应渠道的数据，并将其添加到电子表格中。

深入阅读

问题排查

ReferenceError：“[API NAME]”未定义

如果未在 Apps 脚本代码编辑器中切换开启相应 API，则会发生此错误。重新访问第 2.b 步，并确保相应切换开关设置为开启。