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. 按一下「Save」(儲存) 圖示 。
  6. 按一下左上方的「未命名專案」，輸入「快速入門導覽課程」，然後按一下「重新命名」。

步驟 2：開啟 YouTube Data API

  1. 按一下左側的「編輯器」圖示 。
  2. 按一下左側「服務」旁的「新增服務」圖示 。
  3. 依序點選「YouTube Data API」和「新增」。

步驟 3：執行範例

  1. 重新載入試算表。如果這是您在新增程式碼後首次載入試算表，第一列應會填入「ID」、「Title」和「觀看次數」標頭。

  2. 在選單列中，依序按一下「YouTube Data」 >「Add GoogleDevelopers data」，將 GoogleDevelopers 頻道的相關資訊新增至試算表。(YouTube 資料選單應會顯示在標準選單旁，例如「檔案」、「編輯」、「檢視」等)。

    首次執行範例時，系統會提示您授權存取：

    1. 按一下「Review permissions」(查看權限)。
    2. 選擇所需帳戶。
    3. 按一下「允許」。

  3. 在選單列中，依序點按「YouTube Data」 >「Add channel data」，即可新增所選頻道的資料。出現提示時，請輸入頻道名稱 (例如「GoogleDevelopers」或「SaturdayNightLive」)，然後按一下「OK」。指令碼會擷取該頻道的資料，並新增至試算表。

延伸閱讀

疑難排解

ReferenceError: "[API NAME]" is not defined

如果未在 Apps Script 程式碼編輯器中開啟 API，就會發生這個錯誤。請重新查看步驟 2.b，確認對應的切換鈕已設為「開啟」。