本頁面由 Cloud Translation API 翻譯而成。

追蹤 YouTube 影片觀看次數和留言

程式碼程度：初學者
所需時間：20 分鐘
專案類型：使用時間觸發條件進行自動化

目標

瞭解解決方案的功能。
瞭解解決方案中的 Apps Script 服務功能。
設定指令碼。
執行指令碼。

認識這項解決方案

這項解決方案會在 Google 試算表追蹤公開 YouTube 影片的成效，包括觀看次數、按讚數和留言數。觸發條件每天都會檢查是否有更新資訊，如果影片有新的留言活動，就會傳送 Gmail 郵件，方便你回覆問題和留言。

運作方式

這項指令碼會使用進階 YouTube 服務，取得每個工作表「影片連結」欄位中列出的 YouTube 影片詳細資料和統計資料。如果清單中影片的留言數增加，腳本會將電子郵件通知傳送至工作表名稱所對應的電子郵件地址。

Apps Script 服務

這項解決方案會使用下列服務：

試算表服務：從試算表取得 YouTube 網址資訊。
YouTube Data API 進階服務：取得每個影片網址的 YouTube 影片詳細資料和統計資料。
郵件服務：在 Gmail 中建立並傳送電子郵件，內含收到新留言的影片清單。

必要條件

如要使用這個範例，您必須符合下列先決條件：

Google 帳戶 (Google Workspace 帳戶可能需要管理員核准)。
可連上網際網路的網路瀏覽器。

設定指令碼

建立 Apps Script 專案

按一下下方按鈕，複製「追蹤 YouTube 影片觀看次數和留言」試算表。這個解決方案的 Apps Script 專案已附加至試算表。
建立副本
在複製的試算表中，將「Your_Email_Address」Your_Email_Address工作表名稱變更為您的電子郵件地址。
新增要追蹤的 YouTube 影片網址，或使用提供的網址進行測試。網址開頭必須為 www.youtube.com/watch?v= 格式。
依序點選「擴充功能」>「Apps Script」。如果「服務」下方已列出「YouTube」，請略過接下來的 2 個步驟。
按一下「服務」旁的「新增服務」圖示。
從清單中選取「YouTube Data API」，然後按一下「新增」。

建立觸發條件

在 Apps Script 專案中，依序按一下「觸發條件」 >「新增觸發條件」。
在「Choose which function to run」(選擇要執行的函式) 中，選取「markVideos」。
在「選取事件來源」中，選取「時間驅動」。
在「選取時間觸發條件類型」中，選取「每日計時器」。
在「選取時段」中，選擇偏好的時間。
出現提示訊息時，請授權執行指令碼。如果 OAuth 同意畫面顯示「這個應用程式未經驗證」警告，請依序選取「進階」>「前往『{專案名稱}』(不安全)」，繼續操作。

執行指令碼

您設定的觸發條件每天都會執行一次指令碼。您可以手動執行指令碼來測試。

在 Apps Script 專案中，按一下「編輯器」。
在函式下拉式選單中，選取「markVideos」markVideos。
按一下「執行」。
切換回試算表，查看指令碼在工作表新增的資訊。
開啟電子郵件，查看內含留言數大於零的影片清單。日後執行指令碼時，系統只會傳送電子郵件，內含自上次執行指令碼以來，留言數增加的影片。

檢查程式碼

如要查看這項解決方案的 Apps Script 程式碼，請按一下下方的「查看原始碼」：

查看原始碼

Code.gs

solutions/automations/youtube-tracker/Code.js

前往 GitHub 查看

// To learn how to use this script, refer to the documentation:
// https://developers.google.com/apps-script/samples/automations/youtube-tracker

/*
Copyright 2022 Google LLC

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/

// Sets preferences for email notification. Choose 'Y' to send emails, 'N' to skip emails.
const EMAIL_ON = 'Y';

// Matches column names in Video sheet to variables. If the column names change, update these variables.
const COLUMN_NAME = {
  VIDEO: 'Video Link',
  TITLE: 'Video Title',
};

/**
 * Gets YouTube video details and statistics for all
 * video URLs listed in 'Video Link' column in each
 * sheet. Sends email summary, based on preferences above, 
 * when videos have new comments or replies.
 */
function markVideos() {
  let ss = SpreadsheetApp.getActiveSpreadsheet();
  let sheets = SpreadsheetApp.getActiveSpreadsheet().getSheets();

  // Runs through process for each tab in Spreadsheet.
  sheets.forEach(function(dataSheet) {
    let tabName = dataSheet.getName();
    let range = dataSheet.getDataRange();
    let numRows = range.getNumRows();
    let rows = range.getValues();
    let headerRow = rows[0];

    // Finds the column indices.
    let videoColumnIdx = headerRow.indexOf(COLUMN_NAME.VIDEO);
    let titleColumnIdx = headerRow.indexOf(COLUMN_NAME.TITLE);

    // Creates empty array to collect data for email table.
    let emailContent = [];

    // Processes each row in spreadsheet.
    for (let i = 1; i < numRows; ++i) {
      let row = rows[i];
      // Extracts video ID.
      let videoId = extractVideoIdFromUrl(row[videoColumnIdx])
      // Processes each row that contains a video ID.
      if(!videoId) { 
        continue;
      }
      // Calls getVideoDetails function and extracts target data for the video.
      let detailsResponse = getVideoDetails(videoId);
      let title = detailsResponse.items[0].snippet.title;
      let publishDate = detailsResponse.items[0].snippet.publishedAt;
      let publishDateFormatted = new Date(publishDate);
      let views = detailsResponse.items[0].statistics.viewCount;
      let likes = detailsResponse.items[0].statistics.likeCount;
      let comments = detailsResponse.items[0].statistics.commentCount;
      let channel = detailsResponse.items[0].snippet.channelTitle;

      // Collects title, publish date, channel, views, comments, likes details and pastes into tab.
      let detailsRow = [title,publishDateFormatted,channel,views,comments,likes];
      dataSheet.getRange(i+1,titleColumnIdx+1,1,6).setValues([detailsRow]);

      // Determines if new count of comments/replies is greater than old count of comments/replies.
      let addlCommentCount = comments - row[titleColumnIdx+4];

      // Adds video title, link, and additional comment count to table if new counts > old counts.
      if (addlCommentCount > 0) {
        let emailRow = [title,row[videoColumnIdx],addlCommentCount]
        emailContent.push(emailRow);
      }
    }
    // Sends notification email if Content is not empty.
    if (emailContent.length > 0 && EMAIL_ON == 'Y') {
      sendEmailNotificationTemplate(emailContent, tabName);
    }
  });
}

/**
 * Gets video details for YouTube videos
 * using YouTube advanced service.
 */
function getVideoDetails(videoId) {
  let part = "snippet,statistics";
  let response = YouTube.Videos.list(part,
      {'id': videoId});
 return response;
}

/**
 * Extracts YouTube video ID from url.
 * (h/t https://stackoverflow.com/a/3452617)
 */
function extractVideoIdFromUrl(url) {
  let videoId = url.split('v=')[1];
  let ampersandPosition = videoId.indexOf('&');
  if (ampersandPosition != -1) {
    videoId = videoId.substring(0, ampersandPosition);
  }   
 return videoId;
}

/**
 * Assembles notification email with table of video details. 
 * (h/t https://stackoverflow.com/questions/37863392/making-table-in-google-apps-script-from-array)
 */
function sendEmailNotificationTemplate(content, emailAddress) {
  let template = HtmlService.createTemplateFromFile('email');
  template.content = content;
  let msg = template.evaluate();  
  MailApp.sendEmail(emailAddress,'New comments or replies on YouTube',msg.getContent(),{htmlBody:msg.getContent()});
}

email.html

solutions/automations/youtube-tracker/email.html