Mengirim konten pilihan

Tingkat coding: Pemula
Durasi: 20 menit
Jenis project: Otomatisasi dengan pemicu berbasis peristiwa

Tujuan

• Pahami fungsi solusi.
• Pahami fungsi layanan Apps Script dalam solusi.
• Siapkan skrip.
• Jalankan skrip.

Tentang solusi ini

Jika memiliki berbagai jenis konten yang ingin ditawarkan kepada audiens, Anda dapat mengizinkan pengguna memilih konten yang mereka terima dari Anda dengan Google Formulir. Solusi ini memungkinkan pengguna memilih topik yang mereka minati, lalu secara otomatis mengirimkan konten yang mereka pilih melalui email.

Cara kerjanya

Skrip menginstal pemicu berbasis peristiwa yang berjalan setiap kali pengguna mengirimkan formulir. Dengan setiap pengiriman formulir, skrip membuat dan mengirim email dari template Google Dokumen. Email tersebut menyertakan nama pengguna dan konten yang dipilihnya. Konten yang Anda tawarkan dapat berupa jenis apa pun selama dirujuk oleh URL.

Layanan Apps Script

Solusi ini menggunakan layanan berikut:

• Layanan skrip–Menginstal pemicu berbasis peristiwa yang diaktifkan setiap kali seseorang mengirimkan formulir.
• Layanan dokumen–Membuka template Dokumen yang digunakan skrip untuk membuat email.
• Layanan email–Membuat dan mengirim email dengan nama pengguna dan pilihan konten.
• Layanan spreadsheet–Menambahkan konfirmasi ke sheet Respons formulir setelah skrip mengirimkan email.

Prasyarat

Untuk menggunakan sampel ini, Anda memerlukan prasyarat berikut:

• Akun Google (akun Google Workspace mungkin memerlukan persetujuan administrator).
• Browser web dengan akses ke internet.

Menyiapkan skrip

1. Klik tombol berikut untuk membuat salinan spreadsheet Kirim konten pilihan. Project Apps Script untuk solusi ini dilampirkan ke spreadsheet.
   Buat salinan

2. Di spreadsheet yang Anda salin, klik Ekstensi > Apps Script.

3. Di dropdown fungsi, pilih installTrigger.

4. Klik Run.

5. Saat diminta, izinkan skrip. Jika layar izin OAuth menampilkan peringatan Aplikasi ini belum diverifikasi, lanjutkan dengan memilih Lanjutan > Buka {Project Name} (tidak aman).

Penting: Jika Anda menjalankan installTrigger lebih dari sekali, skrip akan membuat beberapa pemicu yang masing-masing mengirim email saat pengguna mengirimkan formulir. Untuk menghapus pemicu tambahan dan menghindari email duplikat, klik Pemicu . Klik kanan setiap pemicu tambahan lalu klik Hapus pemicu.

Jalankan skrip:

1. Kembali ke spreadsheet dan klik Alat > Kelola formulir > Buka formulir aktif.
2. Isi formulir lalu klik Kirim.
3. Periksa email Anda untuk menemukan email yang berisi link ke konten yang Anda pilih.

Meninjau kode

Untuk meninjau kode Apps Script untuk solusi ini, klik Lihat kode sumber di bawah:

Melihat kode sumber

Code.gs

solutions/automations/content-signup/Code.js

Lihat di 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) {
  let 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.
  let timestamp = responses.Timestamp[0];
  let email = responses['Email address'][0].trim();
  let name = responses.Name[0].trim();
  let 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).
  let topics = Object.keys(topicUrls).filter(function(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.
  let sheet = SpreadsheetApp.getActiveSheet();
  let row = sheet.getActiveRange().getRow();
  let 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(function(topic) {
  let 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.
  let 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.
  let url = "https://docs.google.com/feeds/download/documents/export/Export?id=" +
            docId + "&exportFormat=html";
  let param = {
    method: "get",
    headers: {"Authorization": "Bearer " + ScriptApp.getOAuthToken()},
    muteHttpExceptions: true,
  };
  return UrlFetchApp.fetch(url, param).getContentText();
}

Kontributor

Contoh ini dikelola oleh Google dengan bantuan Pakar Developer Google.

Langkah berikutnya

• Pemicu berbasis peristiwa
• Referensi layanan Spreadsheet