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();
}

    quickstart.gs
  5. 按一下「儲存」圖示 。
  6. 按一下左上方的「未命名的專案」，輸入「快速入門」，然後按一下「重新命名」。

步驟 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 Script 程式碼編輯器中開啟 API，就會發生這個錯誤。返回步驟 2.b，確認對應的切換鈕已設為「開啟」。