厳選されたコンテンツを送信する

コーディングレベル: 初級
所要時間: 20 分
プロジェクトタイプ: イベントドリブントリガーによる自動化

目標

ソリューションの機能について理解する。
ソリューション内での Apps Script サービスの機能について理解する。
スクリプトを設定する。
スクリプトを実行する。

このソリューションについて

視聴者に提供したいさまざまな種類のコンテンツがある場合は、Google フォームを使用して、ユーザーが受け取るコンテンツを選択できるようにします。このソリューションを使用すると、ユーザーは興味のあるトピックを選択し、選択したコンテンツが自動的にメールで送信されます。

Google フォームと Gmail でコンテンツを送信するデモ

仕組み

スクリプトは、ユーザーがフォームを送信するたびに実行されるイベントドリブントリガーをインストールします。フォームが送信されるたびに、スクリプトは Google ドキュメントテンプレートからメールを作成して送信します。メールには、ユーザーの名前と選択したコンテンツが含まれます。提供するコンテンツは、URL で参照されていれば、どのようなタイプでもかまいません。

Apps Script サービス

このソリューションでは、次のサービスを使用します。

Script サービス: 誰かがフォームを送信するたびに実行されるイベントドリブントリガーをインストールします。
ドキュメントサービス: スクリプトがメールの作成に使用するドキュメントテンプレートを開きます。
Mail サービス: ユーザーの名前とコンテンツの選択を含むメールを作成して送信します。
Spreadsheet service: スクリプトがメールを送信した後、確認を [フォームの回答] シートに追加します。

前提条件

このサンプルを使用するには、次の前提条件を満たしている必要があります。

Google アカウント（Google Workspace アカウントの場合、管理者の承認が必要となる可能性があります）。
インターネットにアクセスできるウェブブラウザ。

スクリプトを設定する

次のボタンをクリックして、厳選されたコンテンツを送信 するスプレッドシートのコピーを作成します。このソリューションの Apps Script プロジェクトは、スプレッドシートに添付されています。

コピーを作成
コピーしたスプレッドシートで、[拡張機能] [>] [Apps Script] をクリックします。
関数プルダウンで [installTrigger] を選択します。
[実行] をクリックします。
メッセージが表示されたら、スクリプトを承認します。 <<../_snippets/oauth.md>>

重要: installTrigger を複数回実行すると、スクリプトによってユーザーがフォームを送信したときにメールを送信するトリガーが複数作成されます。余分なトリガーを削除してメールの重複を避けるには、[トリガー]をクリックします。余分なトリガーを右クリックして、[トリガーを削除] をクリックします。

スクリプトを実行する

スプレッドシートに戻り、[ツール] >[フォームを管理] >[実際のフォームを開く] をクリックします。
フォームに必要事項を記入し、[送信] をクリックします。
選択したコンテンツへのリンクが記載されたメールが届いているか確認します。

コードを確認する

このソリューションの Apps Script コードを確認するには、 [ソースコードを表示]をクリックします:

ソースコードを表示

Code.gs

solutions/automations/content-signup/Code.js

GitHub で表示

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

/*
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.
*/

// To use your own template doc, update the below variable with the URL of your own Google Doc template.
// Make sure you update the sharing settings so that 'anyone'  or 'anyone in your organization' can view.
const EMAIL_TEMPLATE_DOC_URL =
  "https://docs.google.com/document/d/1enes74gWsMG3dkK3SFO08apXkr0rcYBd3JHKOb2Nksk/edit?usp=sharing";
// Update this variable to customize the email subject.
const EMAIL_SUBJECT = "Hello, here is the content you requested";

// Update this variable to the content titles and URLs you want to offer. Make sure you update the form so that the content titles listed here match the content titles you list in the form.
const topicUrls = {
  "Google Calendar how-to videos":
    "https://www.youtube.com/playlist?list=PLU8ezI8GYqs7IPb_UdmUNKyUCqjzGO9PJ",
  "Google Drive how-to videos":
    "https://www.youtube.com/playlist?list=PLU8ezI8GYqs7Y5d1cgZm2Obq7leVtLkT4",
  "Google Docs how-to videos":
    "https://www.youtube.com/playlist?list=PLU8ezI8GYqs4JKwZ-fpBP-zSoWPL8Sit7",
  "Google Sheets how-to videos":
    "https://www.youtube.com/playlist?list=PLU8ezI8GYqs61ciKpXf_KkV7ZRbRHVG38",
};

/**
 * Installs a trigger on the spreadsheet for when someone submits a form.
 */
function installTrigger() {
  ScriptApp.newTrigger("onFormSubmit")
    .forSpreadsheet(SpreadsheetApp.getActive())
    .onFormSubmit()
    .create();
}

/**
 * Sends a customized email for every form response.
 *
 * @param {Object} event - Form submit event
 */
function onFormSubmit(e) {
  const responses = e.namedValues;

  // If the question title is a label, it can be accessed as an object field.
  // If it has spaces or other characters, it can be accessed as a dictionary.
  const timestamp = responses.Timestamp[0];
  const email = responses["Email address"][0].trim();
  const name = responses.Name[0].trim();
  const topicsString = responses.Topics[0].toLowerCase();

  // Parse topics of interest into a list (since there are multiple items
  // that are saved in the row as blob of text).
  const topics = Object.keys(topicUrls).filter((topic) => {
    // indexOf searches for the topic in topicsString and returns a non-negative
    // index if the topic is found, or it will return -1 if it's not found.
    return topicsString.indexOf(topic.toLowerCase()) !== -1;
  });

  // If there is at least one topic selected, send an email to the recipient.
  let status = "";
  if (topics.length > 0) {
    MailApp.sendEmail({
      to: email,
      subject: EMAIL_SUBJECT,
      htmlBody: createEmailBody(name, topics),
    });
    status = "Sent";
  } else {
    status = "No topics selected";
  }

  // Append the status on the spreadsheet to the responses' row.
  const sheet = SpreadsheetApp.getActiveSheet();
  const row = sheet.getActiveRange().getRow();
  const column = e.values.length + 1;
  sheet.getRange(row, column).setValue(status);

  console.log(`status=${status}; responses=${JSON.stringify(responses)}`);
}

/**
 * Creates email body and includes the links based on topic.
 *
 * @param {string} recipient - The recipient's email address.
 * @param {string[]} topics - List of topics to include in the email body.
 * @return {string} - The email body as an HTML string.
 */
function createEmailBody(name, topics) {
  let topicsHtml = topics
    .map((topic) => {
      const url = topicUrls[topic];
      return `<li><a href="${url}">${topic}</a></li>`;
    })
    .join("");
  topicsHtml = `<ul>${topicsHtml}</ul>`;

  // Make sure to update the emailTemplateDocId at the top.
  const docId = DocumentApp.openByUrl(EMAIL_TEMPLATE_DOC_URL).getId();
  let emailBody = docToHtml(docId);
  emailBody = emailBody.replace(/{{NAME}}/g, name);
  emailBody = emailBody.replace(/{{TOPICS}}/g, topicsHtml);
  return emailBody;
}

/**
 * Downloads a Google Doc as an HTML string.
 *
 * @param {string} docId - The ID of a Google Doc to fetch content from.
 * @return {string} The Google Doc rendered as an HTML string.
 */
function docToHtml(docId) {
  // Downloads a Google Doc as an HTML string.
  const url = `https://docs.google.com/feeds/download/documents/export/Export?id=${docId}&exportFormat=html`;
  const param = {
    method: "get",
    headers: { Authorization: `Bearer ${ScriptApp.getOAuthToken()}` },
    muteHttpExceptions: true,
  };
  return UrlFetchApp.fetch(url, param).getContentText();
}

</section>

寄稿者

このサンプルは、Google デベロッパーエキスパートの協力のもと、Google によって管理されています。

厳選されたコンテンツを送信する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

目標