Theo dõi lượt xem và bình luận của video trên YouTube

Cấp độ lập trình: Sơ cấp
Thời lượng: 20 phút
Loại dự án: Tự động hoá bằng trình kích hoạt theo thời gian

Mục tiêu

  • Tìm hiểu chức năng của giải pháp.
  • Tìm hiểu chức năng của các dịch vụ Google Apps Script trong giải pháp.
  • Thiết lập tập lệnh.
  • Chạy tập lệnh.

Giới thiệu về giải pháp này

Giải pháp này theo dõi hiệu suất của các video công khai trên YouTube, bao gồm cả số lượt xem, lượt thích và bình luận trong một bảng tính Google Trang tính. Trình kích hoạt sẽ kiểm tra thông tin cập nhật mỗi ngày và gửi một thông báo qua Gmail nếu video có hoạt động bình luận mới để bạn có thể tương tác với các câu hỏi và bình luận.

Google Trang tính hiển thị dữ liệu theo dõi video trên YouTube

Cách hoạt động

Tập lệnh sử dụng dịch vụ nâng cao của YouTube để lấy thông tin chi tiết và số liệu thống kê về video trên YouTube cho các URL video được liệt kê trong cột Đường liên kết đến video trong mỗi trang tính. Nếu số lượng bình luận cho một video được liệt kê tăng lên, tập lệnh sẽ gửi thông báo qua email đến địa chỉ email được dùng để đặt tên cho trang tính.

Dịch vụ Apps Script

Giải pháp này sử dụng các dịch vụ sau:

Điều kiện tiên quyết

Để sử dụng mẫu này, bạn cần đáp ứng các điều kiện tiên quyết sau:

  • Tài khoản Google (tài khoản Google Workspace có thể cần được quản trị viên phê duyệt).
  • Một trình duyệt web có quyền truy cập vào Internet.

Thiết lập tập lệnh

Để thiết lập tập lệnh này, hãy làm theo các bước sau:

Tạo dự án Apps Script

  1. Để tạo bản sao của bảng tính Theo dõi lượt xem và bình luận về video trên YouTube, hãy nhấp vào nút sau: Tạo bản sao Dự án Apps Script cho giải pháp này được đính kèm vào bảng tính.
  2. Trong bảng tính đã sao chép, hãy đổi tên trang tính Your_Email_Address thành địa chỉ email của bạn.
  3. Thêm URL của video trên YouTube mà bạn muốn theo dõi hoặc sử dụng các URL được cung cấp để kiểm thử. URL phải bắt đầu bằng định dạng www.youtube.com/watch?v=.
  4. Nhấp vào Tiện ích mở rộng > Apps Script. Nếu YouTube đã được liệt kê trong mục Dịch vụ, bạn có thể bỏ qua 2 bước tiếp theo.
  5. Bên cạnh Dịch vụ, hãy nhấp vào biểu tượng Thêm dịch vụ .
  6. Trong danh sách, hãy chọn YouTube Data API rồi nhấp vào Thêm.

Tạo điều kiện kích hoạt

  1. Trong dự án Apps Script, hãy nhấp vào Trình kích hoạt > Thêm trình kích hoạt.
  2. Đối với Chọn hàm cần chạy, hãy chọn markVideos.
  3. Đối với Chọn nguồn sự kiện, hãy chọn Theo thời gian.
  4. Đối với Chọn loại điều kiện kích hoạt dựa trên thời gian, hãy chọn Bộ hẹn giờ hằng ngày.
  5. Đối với Chọn thời gian trong ngày, hãy chọn thời gian bạn muốn.
  6. Khi được nhắc, hãy cho phép tập lệnh chạy. <<../_snippets/oauth.md>>

Chạy tập lệnh

Trình kích hoạt mà bạn thiết lập sẽ chạy tập lệnh mỗi ngày một lần. Bạn có thể chạy tập lệnh theo cách thủ công để kiểm thử.

  1. Trong dự án Apps Script, hãy nhấp vào Trình chỉnh sửa .
  2. Trong trình đơn thả xuống hàm, hãy chọn markVideos.
  3. Nhấp vào Chạy.
  4. Chuyển lại bảng tính để xem thông tin mà tập lệnh đã thêm vào trang tính.
  5. Mở email để xem email có danh sách các video có nhiều hơn 0 bình luận. Khi chạy trong tương lai, tập lệnh sẽ chỉ gửi email có các video có số lượng bình luận tăng lên kể từ lần chạy tập lệnh gần đây nhất.

Xem lại mã

Để xem lại mã Apps Script cho giải pháp này, hãy nhấp vào Xem mã nguồn:

Xem mã nguồn

Code.gs

solutions/automations/youtube-tracker/Code.js
// 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() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheets = SpreadsheetApp.getActiveSpreadsheet().getSheets();

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

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

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

    // Processes each row in spreadsheet.
    for (let i = 1; i < numRows; ++i) {
      const row = rows[i];
      // Extracts video ID.
      const 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.
      const detailsResponse = getVideoDetails(videoId);
      const title = detailsResponse.items[0].snippet.title;
      const publishDate = detailsResponse.items[0].snippet.publishedAt;
      const publishDateFormatted = new Date(publishDate);
      const views = detailsResponse.items[0].statistics.viewCount;
      const likes = detailsResponse.items[0].statistics.likeCount;
      const comments = detailsResponse.items[0].statistics.commentCount;
      const channel = detailsResponse.items[0].snippet.channelTitle;

      // Collects title, publish date, channel, views, comments, likes details and pastes into tab.
      const 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.
      const addlCommentCount = comments - row[titleColumnIdx + 4];

      // Adds video title, link, and additional comment count to table if new counts > old counts.
      if (addlCommentCount > 0) {
        const 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) {
  const part = "snippet,statistics";
  const 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];
  const 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) {
  const template = HtmlService.createTemplateFromFile("email");
  template.content = content;
  const 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
<!--
 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

      http://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.
-->

<body>
  Hello,<br><br>You have new comments and/or replies on videos: <br><br>
  <table border="1">
    <tr>
      <th>Video Title</th>
      <th>Link</th>
      <th>Number of new replies and comments</th>
    </tr>
    <? for (var i = 0; i < content.length; i++) { ?>
    <tr>
      <? for (var j = 0; j < content[i].length; j++) { ?>
      <td align="center"><?= content[i][j] ?></td>
      <? } ?>
    </tr>
    <? } ?>
  </table>
</body>

Người đóng góp

Mẫu này do Google duy trì với sự trợ giúp của các Chuyên gia về Google Developers.

Các bước tiếp theo