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. 按一下「儲存」圖示
  6. 按一下左上角的 [Untitled project],輸入「Quickstart」,然後按一下 [Rename]

步驟 2:啟用 YouTube Data API

  1. 按一下左側的「編輯器」圖示
  2. 在左側的「服務」旁邊,按一下「新增服務」圖示
  3. 按一下 [YouTube Data API],然後按一下 [新增]

步驟 3:執行範例

  1. 重新載入試算表。如果這是您加入程式碼後第一次載入試算表,第一列應填入 IDTitleView count 標頭。
  2. 在選單列中,依序按一下 [YouTube Data] (YouTube 資料) > [Add GoogleDevelopers data] (新增 GoogleDevelopers 資料),即可在試算表中加入 GoogleDevelopers 管道相關資訊。(YouTube 資料選單會顯示在標準選單旁,例如「檔案」、「編輯」、「檢視」等)。

    首次執行範例時,系統會提示您授予存取權。

    1. 按一下 [檢閱權限]。
    2. 選擇所需帳戶。
    3. 按一下 [允許]
  3. 在選單列中,依序按一下 [YouTube 資料] > [新增頻道資料],即可新增所選頻道的資料。按照系統提示輸入頻道名稱 (例如「GoogleDevelopers」或「SaturdayNightLive」) 並按一下 [確定]。指令碼會擷取該頻道的資料,並將其新增至試算表。

延伸閱讀

疑難排解

參考錯誤:未定義「[API 名稱]」

如果在 Apps Script 程式碼編輯器中未開啟 API,就會發生這個錯誤。重新執行步驟 2.b 並確認對應的開關已設為 [開啟]。