Dasar-Dasar Apps Script dengan Google Spreadsheet #5: Membuat Diagram dan Menyajikan Data di Slide

1. Pengantar

Selamat datang di bagian kelima playlist codelab Dasar-Dasar Apps Script dengan Google Spreadsheet. Codelab ini mengajarkan Anda cara menggunakan layanan Spreadsheet di Apps Script untuk membuat diagram set data. Anda juga akan mempelajari cara menggunakan layanan Slide untuk mengekspor diagram ke presentasi baru di Google Slide.

Yang akan Anda pelajari

• Cara membuat diagram garis dengan Apps Script.
• Cara mengekspor diagram ke presentasi Slide baru.
• Cara menampilkan dialog kepada pengguna di Spreadsheet.

Catatan: Dalam codelab ini, Anda akan bekerja terutama dengan layanan Spreadsheet Apps Script untuk membuat dan memanipulasi diagram sematan.

Apps Script juga memiliki layanan Diagram khusus. Namun, fungsi ini terutama digunakan untuk membuat dan mengedit diagram yang akan digunakan dalam aplikasi di luar Google Spreadsheet. Codelab ini tidak akan membahas kasus penggunaan ini.

Sebelum memulai

Ini adalah codelab kelima dalam playlist Dasar-Dasar Apps Script dengan Google Spreadsheet. Sebelum memulai codelab ini, pastikan untuk menyelesaikan codelab sebelumnya:

1. Makro dan Fungsi Kustom
2. Spreadsheet, Sheet, dan Rentang
3. Menangani data
4. Pemformatan data

Yang Anda butuhkan

• Pemahaman tentang topik dasar Apps Script yang dibahas dalam codelab sebelumnya di playlist ini.
• Pemahaman dasar tentang editor Apps Script
• Pemahaman dasar tentang Google Spreadsheet
• Kemampuan untuk membaca Spreadsheet dengan Notasi A1
• Pemahaman dasar tentang JavaScript dan class String-nya

2. Siapkan

Sebelum melanjutkan, Anda memerlukan spreadsheet dengan beberapa data. Seperti sebelumnya, kami telah menyediakan lembar data yang dapat Anda salin untuk latihan ini. Lakukan langkah-langkah berikut:

1. Klik link ini untuk menyalin lembar data, lalu klik Buat salinan. Spreadsheet baru akan ditempatkan di folder Google Drive Anda dan diberi nama "Salinan Tanggal dan Kurs USD".
2. Klik judul spreadsheet dan ubah dari "Salinan Tanggal dan Kurs USD" menjadi "Tanggal dan Kurs USD". Spreadsheet Anda akan terlihat seperti ini, dengan beberapa informasi dasar tentang nilai tukar dolar AS yang berbeda pada tanggal yang berbeda:

3. Untuk membuka editor skrip, klik Ekstensi> Apps Script.

Untuk menghemat waktu Anda, kami telah menyertakan sedikit kode untuk menyiapkan menu kustom di spreadsheet ini. Anda mungkin melihat menu muncul saat salinan spreadsheet Anda dibuka:

Catatan: Anda dapat mempelajari lebih lanjut menu kustom dan onOpen() di codelab Bekerja dengan data.

Poin penting: Karena spreadsheet yang Anda salin memiliki project skrip yang terikat padanya, saat spreadsheet disalin, project skrip juga akan disalin. Perlu diingat bahwa ini adalah salinan project skrip asli—perubahan yang dilakukan pada salinan tidak akan tercermin dalam project asli dan sebaliknya.

Dengan spreadsheet dan project ini, Anda siap memulai codelab. Lanjutkan ke bagian berikutnya untuk mulai mempelajari grafik dan pemicu berbasis waktu.

3. Membuat diagram di Spreadsheet dengan Apps Script

Misalkan Anda ingin mendesain diagram tertentu untuk memvisualisasikan set data. Anda sebenarnya dapat menggunakan Apps Script untuk membuat, mengedit, dan menyisipkan diagram ke Google Spreadsheet. Jika bagan berada dalam spreadsheet, bagan tersebut disebut bagan sematan.

Diagram digunakan untuk memvisualisasikan satu atau beberapa rangkaian data. Untuk diagram sematan, data yang ditampilkan biasanya berasal dari dalam spreadsheet. Biasanya, memperbarui data di spreadsheet akan menyebabkan Spreadsheet otomatis memperbarui diagram juga.

Anda dapat menggunakan Apps Script untuk membuat diagram sematan yang disesuaikan dari awal, atau untuk memperbarui diagram yang ada. Bagian ini memperkenalkan dasar-dasar pembuatan diagram sematan di Spreadsheet dengan Apps Script dan layanan Spreadsheet.

Peringatan: Meskipun Anda dapat menggunakan Apps Script untuk melakukan beberapa tugas dengan diagram, ada beberapa tindakan yang tidak dapat Anda lakukan. Layanan Spreadsheet menyediakan beberapa class EmbeddedChart yang menyediakan fungsi pembuatan diagram, tetapi tidak mencakup setiap opsi konfigurasi yang mungkin. Selain itu, Apps Script juga menggunakan Google Charts API, yang memiliki batasan sendiri.

Karena batasan ini, sebaiknya gunakan Apps Script untuk membuat diagram dasar, atau edit terlebih dahulu, lalu sesuaikan pemformatan secara manual di Spreadsheet. Anda mungkin tidak dapat mengotomatiskan setiap proses terkait diagram di Apps Script, tetapi Anda dapat mengotomatiskan sebagian besar proses tersebut.

Penerapan

Di salinan spreadsheet data Anda, set data "Tanggal dan Nilai Tukar" menampilkan nilai tukar (untuk 1 dolar AS) berbagai mata uang pada tanggal yang berbeda. Anda akan menerapkan fungsi Apps Script yang membuat diagram untuk memvisualisasikan sebagian data ini.

Lakukan langkah-langkah berikut:

1. Di editor Apps Script, tambahkan fungsi berikut di akhir skrip Code.gs project skrip Anda, setelah fungsi onOpen():

/**
 * Creates and inserts an embedded
 * line chart into the active sheet.
 */
function createEmbeddedLineChart() {
  var sheet = SpreadsheetApp.getActiveSheet();
  var chartDataRange = sheet.getRange(
    'Dates and USD Exchange Rates dataset!A2:F102');
  var hAxisOptions = {
    slantedText: true,
    slantedTextAngle: 60,
    gridlines: {
      count: 12
    }
  };
  
  var lineChartBuilder = sheet.newChart().asLineChart();
  var chart = lineChartBuilder
    .addRange(chartDataRange)
    .setPosition(5, 8, 0, 0)
    .setTitle('USD Exchange rates')
    .setNumHeaders(1)
    .setLegendPosition(Charts.Position.RIGHT)
    .setOption('hAxis', hAxisOptions)
    .setOption("useFirstColumnAsDomain", true)
    .build();
 
  sheet.insertChart(chart);  
}

2. Simpan project skrip Anda.

Peninjauan kode

Kode yang telah Anda tambahkan mengimplementasikan fungsi yang dipanggil oleh item menu Chart "Dates and USD Exchange Rates dataset" untuk membuat diagram garis dasar. Mari kita tinjau kodenya.

Baris pertama menyiapkan tiga variabel berikut:

• sheet: referensi ke sheet aktif saat ini.
• chartDataRange: rentang data yang ingin kita visualisasikan. Kode ini menggunakan notasi A1 untuk menentukan rentang yang mencakup sel A2 hingga F102 dalam sheet bernama Dates and USD Exchange Rates dataset. Dengan memberi nama sheet secara khusus, kita memastikan item menu berfungsi meskipun sheet lain aktif karena rentang selalu mencakup posisi data. Dimulai dari baris 2 berarti kita menyertakan header kolom dan hanya akan memetakan 100 tanggal (baris) terbaru.
• hAxisOptions: objek JavaScript dasar yang menyertakan beberapa informasi setelan yang digunakan kode untuk mengonfigurasi tampilan sumbu horizontal. Secara khusus, kode ini menetapkan label teks sumbu horizontal pada kemiringan 60 derajat, dan menetapkan jumlah garis petak vertikal menjadi 12.

Baris berikutnya membuat objek pembuat diagram garis. Diagram sematan di Apps Script dibuat menggunakan pola desain Builder. Penjelasan lengkap tentang pola desain ini berada di luar cakupan codelab ini, jadi untuk saat ini cukup pahami bahwa layanan Spreadsheet menyediakan beberapa class EmbeddedChartBuilder. Untuk membuat diagram, kode Anda terlebih dahulu membuat objek pembuat diagram sematan, menggunakan metodenya untuk menentukan setelan diagram, lalu memanggil metode build() untuk membuat objek EmbeddedChart akhir. Kode Anda tidak pernah mengubah objek EmbeddedChart secara langsung karena semua konfigurasi diagram dikelola melalui class builder.

Layanan Spreadsheet menyediakan class induk EmbeddedChartBuilder dan beberapa class builder turunan (seperti EmbeddedLineChartBuilder) yang mewarisi class induk tersebut. Class turunan memungkinkan Apps Script menyediakan metode konfigurasi diagram builder yang hanya berlaku untuk jenis diagram tertentu. Misalnya, class EmbeddedPieChartBuilder menyediakan metode set3D() yang hanya berlaku untuk diagram lingkaran.

Dalam kode Anda, baris ini membuat variabel objek builder lineChartBuilder:

var lineChartBuilder = sheet.newChart().asLineChart();

Kode memanggil metode Sheet.newChart() untuk membuat objek EmbeddedChartBuilder, lalu menggunakan EmbeddedChartBuilder.asLineChart() untuk menyetel jenis builder ke EmbeddedLineChartBuilder.

Kemudian, kode akan membuat diagram menggunakan lineChartBuilder. Bagian kode ini hanyalah serangkaian panggilan metode untuk menentukan setelan diagram, diikuti dengan panggilan build() untuk membuat diagram. Seperti yang telah Anda lihat di codelab sebelumnya, kode ini menggunakan penggabungan metode agar kode tetap mudah dibaca. Berikut fungsi panggilan metode:

• addRange(range): Menentukan rentang data yang ditampilkan diagram.
• setPosition(anchorRowPos, anchorColPos, offsetX, offsetY): Menentukan tempat diagram ditempatkan dalam sheet. Di sini, kode menyisipkan sudut kiri atas diagram di sel H5.
• setTitle(title): Menetapkan judul diagram.
• setNumHeaders(headers): Tentukan jumlah baris atau kolom dalam rentang data yang harus diperlakukan sebagai header. Di sini, kode menggunakan baris pertama dalam rentang data sebagai header, yang berarti teks dalam baris tersebut digunakan sebagai label untuk setiap deret data dalam diagram.
• setLegendPosition(position): Memindahkan legenda diagram ke sisi kanan diagram. Metode ini menggunakan enum Charts.Position sebagai parameter.
• setOption(option, value): Menetapkan opsi diagram kompleks. Di sini, kode menetapkan opsi hAxis ke objek hAxisOptions. Ada beberapa opsi yang dapat Anda tetapkan menggunakan metode ini. Opsi dan kemungkinan nilai untuk setiap jenis diagram didokumentasikan di Galeri Diagram Charts API. Misalnya, opsi yang dapat Anda tetapkan untuk diagram garis didokumentasikan di bagian Opsi konfigurasi diagram garis. Metode setOption(option, value) adalah topik lanjutan, jadi sebaiknya hindari penggunaannya hingga Anda lebih memahami pembuatan diagram di Apps Script.
• build(): Membuat dan menampilkan objek EmbeddedChart menggunakan setelan di atas.

Terakhir, kode memanggil Sheet.insertChart(chart) untuk menempatkan diagram yang dibuat ke dalam sheet aktif.

Hasil

Anda dapat melihat fungsi pemformatan beroperasi dengan melakukan hal berikut:

1. Jika belum melakukannya, simpan project skrip Anda di editor Apps Script.
2. Klik item menu Present dataset > Chart "Dates and USD Exchange Rates dataset".

Catatan: Jika Anda menggunakan akun gmail.com, Anda mungkin mendapatkan dialog "Aplikasi ini belum diverifikasi" saat pertama kali menggunakan skrip. Google menggunakan informasi ini untuk memperingatkan pengguna yang mungkin menggunakan kode dari penulis yang tidak dikenal atau tidak tepercaya. Jika Anda melihat dialog ini, Anda dapat melanjutkan karena Anda adalah penulis skrip. Ikuti perintah di layar untuk terus mengizinkan skrip:

1. Pada dialog aplikasi yang tidak terverifikasi, klik Lanjutan.
2. Klik Go to Dates and USD Exchange Rates (unsafe).
3. Klik Izinkan.

Selama codelab ini, Anda mungkin mendapatkan beberapa dialog izin. Anda dapat membaca lebih lanjut proses ini di Otorisasi untuk Layanan Google.

Skrip Anda kini menempatkan diagram baru di sebelah kanan data Anda:

Selamat, Anda telah membuat diagram garis sematan dengan Apps Script. Bagian berikutnya akan mengajarkan cara mengekspor diagram ke Google Slide.

4. Mengekspor diagram ke Slide

Salah satu keunggulan Apps Script adalah Anda dapat memindahkan data dengan mudah dari satu aplikasi Google Workspace ke aplikasi lainnya. Sebagian besar aplikasi ini memiliki layanan Apps Script khusus, mirip dengan layanan Spreadsheet. Misalnya, Gmail memiliki layanan Gmail, Google Dokumen memiliki layanan Dokumen, dan Google Slide memiliki layanan Slide. Dengan semua layanan bawaan ini, Anda dapat mengekstrak data dari satu aplikasi, memprosesnya, dan menulis hasilnya ke aplikasi lain.

Di bagian ini, Anda akan mempelajari cara mengekspor setiap diagram yang disematkan dalam spreadsheet Google ke presentasi Google Slide baru. Anda juga akan melihat dua cara untuk menampilkan pesan kustom pengguna di Spreadsheet.

Catatan: Saat menggunakan layanan Slide, skrip Anda dapat membuat objek Presentation, mengisinya dengan Slides dan Layouts, lalu menambahkan PageElements seperti Shapes, TextRanges, dan Lines. Untuk opsi, layanan Slide hampir sebesar layanan Spreadsheet.

Ada banyak hal yang dapat dilakukan Apps Script dengan Slide, tetapi untuk codelab ini, Anda akan membuat presentasi, membuat slide, dan mengimpor diagram ke dalam slide. Jika Anda ingin mempelajari lebih lanjut, buka dokumentasi Memperluas Google Slide.

Penerapan

Di sini, Anda akan menerapkan fungsi yang dipanggil oleh item menu Tampilkan set data > Ekspor diagram ke Slide. Lakukan langkah-langkah berikut:

1. Di editor Apps Script, tambahkan fungsi berikut di akhir skrip Code.gs project skrip Anda, setelah fungsi createEmbeddedLineChart():

/**
 * Create a Slides presentation and export
 * all the embedded charts in this spreadsheet
 * to it, one chart per slide.
 */
function exportChartsToSlides() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  
  // Fetch a list of all embedded charts in this
  // spreadsheet.
  var charts = [];
  var sheets = ss.getSheets();
  for (var i = 0; i < sheets.length; i++) {
    charts = charts.concat(sheets[i].getCharts());
  }
  
  // If there aren't any charts, display a toast
  // message and return without doing anything
  // else.
  if (charts.length == 0) {
    ss.toast('No charts to export!');
    return;
  }
  
  // Create a Slides presentation, removing the default
  // title slide.
  var presentationTitle =
    ss.getName() + " Presentation";
  var slides = SlidesApp.create(presentationTitle);
  slides.getSlides()[0].remove();  
  
  // Add charts to the presentation, one chart per slide.
  var position = {left: 40, top: 30};
  var size = {height: 340, width: 430};
  for (var i = 0; i < charts.length; i++) {
    var newSlide = slides.appendSlide();
    newSlide.insertSheetsChart(
      charts[i],
      position.left,
      position.top,
      size.width,
      size.height);   
  }
  
  // Create and display a dialog telling the user where to
  // find the new presentation.
  var slidesUrl = slides.getUrl();
  var html = "<p>Find it in your home Drive folder:</p>"
      + "<p><a href=\"" + slidesUrl + "\" target=\"_blank\">"
      + presentationTitle + "</a></p>";
  
  SpreadsheetApp.getUi().showModalDialog(
    HtmlService.createHtmlOutput(html)
      .setHeight(120)
      .setWidth(350),
      "Created a presentation!"
  );
}

2. Simpan project skrip Anda.

Peninjauan kode

Kode ini mungkin lebih pendek dari yang Anda harapkan. Mari kita tinjau apa yang dilakukannya dengan memecah kode menjadi lima bagian:

1: Mendapatkan diagram

Beberapa baris pertama menelusuri spreadsheet aktif untuk menemukan semua diagram sematan, lalu mengumpulkannya ke dalam array charts. Baris ini menggunakan metode Spreadsheet.getSheets() dan metode Sheet.getCharts() untuk mendapatkan daftar sheet dan diagram. Metode JavaScript Array.concat() digunakan untuk menambahkan daftar diagram dari setiap sheet ke charts.

2: Periksa apakah ada diagram yang akan diekspor

Kode ini memverifikasi apakah ada diagram yang akan diekspor. Kita ingin menghindari pembuatan presentasi kosong, jadi jika tidak ada diagram, kode akan membuat pesan toast menggunakan Spreadsheet.toast(message). Ini adalah dialog ‘intip' kecil yang muncul di sudut kanan bawah Spreadsheet, tetap ada selama beberapa detik, lalu menghilang:

Poin penting: Pesan toast sangat bagus untuk menunjukkan bahwa sesuatu telah terjadi pada pengguna, tetapi pengguna tidak perlu bereaksi terhadapnya. Dalam hal ini, pesan toast memberi tahu pengguna bahwa tindakan menu berhasil diselesaikan, tetapi tidak menghasilkan apa pun karena tidak ada diagram yang akan diekspor.

Jika kode tidak membuat pesan toast, item menu akan tampak tidak melakukan apa pun dan pengguna mungkin mengira skripnya rusak. Selalu merupakan praktik terbaik untuk memberi tahu pengguna tentang apa yang dilakukan skrip Anda, bahkan saat skrip mengalami kondisi error.

Jika tidak ada diagram yang akan diekspor, kode akan membuat pesan toast dan keluar tanpa melakukan hal lain. Jika ada diagram yang akan diekspor, kode akan terus membuat presentasi dalam beberapa baris berikutnya.

3: Membuat presentasi

Variabel presentationTitle dibuat untuk menyimpan nama file presentasi baru. Nama ini ditetapkan sebagai nama spreadsheet, dengan " Presentation" yang digabungkan di bagian akhir. Kode kemudian memanggil metode layanan Slide SlidesApp.create(name) untuk membuat presentasi.

Catatan: Class SlidesApp bertindak sebagai class induk untuk layanan Slides, seperti halnya SpreadsheetApp adalah class induk untuk layanan Spreadsheet.

Presentasi baru dibuat dengan satu slide kosong. Kita tidak menginginkannya dalam presentasi, jadi kode akan menghapusnya dengan Presentation.getSlides() dan Slide.remove().

4: Mengekspor diagram

Di bagian berikutnya, kode menentukan position dan size objek JavaScript untuk menetapkan tempat penempatan diagram yang diimpor dalam slide dan seberapa besar diagram tersebut (dalam piksel).

Catatan: Elemen halaman Slide seperti diagram, kotak teks, dan bentuk yang diimpor memerlukan posisi dan ukuran yang ditentukan. Anda dapat mempelajari lebih lanjut cara Apps Script menetapkan nilai ini dalam panduan Mengatur ukuran dan memosisikan elemen halaman.

Kode ini melakukan loop pada setiap diagram dalam daftar diagram. Untuk setiap diagram, newSlide dibuat dengan Presentation.appendSlide(), yang menambahkan slide ke akhir presentasi. Metode Slide.insertSheetsChart(sourceChart, left, top, width, height) digunakan untuk mengimpor diagram ke dalam slide dengan position dan size yang ditentukan.

5: Bagikan lokasi presentasi

Terakhir, kode harus memberi tahu pengguna lokasi presentasi baru, sebaiknya dengan link yang dapat diklik untuk membukanya. Untuk melakukannya, kode menggunakan HTML service Apps Script untuk membuat dialog modal kustom. Dialog modal (juga dikenal sebagai dialog kustom di Apps Script) adalah jendela yang muncul di atas antarmuka Spreadsheet. Saat ditampilkan, dialog kustom mencegah pengguna berinteraksi dengan Spreadsheet.

Poin penting: Dialog modal sangat berguna saat skrip Anda memerlukan input tertentu dari pengguna untuk melanjutkan, atau saat Anda ingin memastikan pengguna melihat sesuatu sebelum melanjutkan pekerjaan di Google Spreadsheet.

Layanan HTML Apps Script memungkinkan Anda mengontrol sepenuhnya gaya dan konten dialog kustom dengan HTML dan JavaScript standar. Artinya, Anda dapat menambahkan teks, tombol, gambar, dan interaktivitas lainnya ke dialog. Topik ini berada di luar cakupan codelab ini, tetapi jika Anda ingin mempelajari lebih lanjut, Anda dapat membuka panduan Membuat dan Menyajikan HTML dan Komunikasi server-klien.

Untuk membuat dialog kustom, kode memerlukan HTML yang menentukan isinya. Ini disediakan dalam variabel html. Isinya mencakup paragraf singkat dan hyperlink. Hyperlink adalah variabel presentationTitle, yang ditautkan ke URL presentasi yang disediakan oleh Presentation.getUrl(). Hyperlink juga menggunakan atribut target="_blank" sehingga presentasi dibuka di tab browser baru, bukan di dalam dialog.

HTML diuraikan menjadi objek HtmlOutput oleh metode HtmlService.createHtmlOutput(html). Objek HtmlOutput memungkinkan kode menetapkan ukuran dialog kustom dengan HtmlOutput.setHeight(height) dan HtmlOutput.setWidth(width).

Setelah htmlOutput dibuat, kode menggunakan metode Ui.showModalDialog(htmlOutput, title) untuk menampilkan dialog dengan judul yang diberikan.

Hasil

Setelah menerapkan item menu kedua, Anda dapat melihat cara kerjanya. Untuk menguji fungsi exportChartsToSlides():

1. Jika belum melakukannya, simpan project skrip Anda di editor Apps Script.
2. Buka spreadsheet Anda dan klik item menu Tampilkan set data > Diagram "Set data Kurs USD dan Tanggal" untuk membuat diagram yang akan diekspor. Diagram akan muncul dan ditambatkan ke sel H5 di sheet aktif.
3. Klik item menu Present dataset > Export charts to Slides. Anda mungkin diminta untuk memberikan otorisasi ulang pada skrip.
4. Anda akan melihat skrip memproses permintaan dan menampilkan dialog kustom.
5. Untuk membuka presentasi Slide baru, klik link Presentasi Kurs Dolar AS dan Tanggal:

Jika mau, Anda juga dapat menambahkan lebih banyak diagram ke spreadsheet dan memilih kembali item menu untuk membuat presentasi dengan beberapa slide.

Catatan: Diagram yang muncul dalam presentasi adalah diagram tertaut. Artinya, diagram tersebut masih terhubung ke diagram asli di Spreadsheet. Jika Anda mengedit diagram Spreadsheet asli, Anda dapat memperbarui diagram yang ditautkan di Slide menggunakan tombol Perbarui pada diagram. Anda juga dapat memuat ulang secara paksa menggunakan metode SheetCharts.refresh().

Sekarang Anda dapat mengekspor diagram yang dibuat di Spreadsheet ke presentasi Slide. Anda juga dapat menulis kode untuk membuat dialog kustom.

Anda telah menyelesaikan latihan terakhir codelab ini. Lanjutkan ke bagian berikutnya untuk meninjau hal yang telah Anda pelajari.

5. Kesimpulan

Selamat, Anda telah menyelesaikan codelab ini dan seluruh playlist codelab Dasar-Dasar Apps Script dengan Google Spreadsheet. Anda dapat menggunakan prinsip-prinsip yang diajarkan dalam playlist ini untuk memperluas pengalaman Spreadsheet dan menjelajahi kemampuan Apps Script.

Apakah codelab ini bermanfaat bagi Anda?

Ya Tidak

Yang telah Anda pelajari

• Cara membuat diagram garis sematan dengan Apps Script.
• Cara menampilkan pesan toast dan dialog kustom kepada pengguna di Spreadsheet.
• Cara mengekspor diagram ke presentasi Slide baru.

Konsep utama:

1. Layanan Spreadsheet menggunakan EmbeddedChart dan class builder terkait untuk membuat dan mengubah diagram yang muncul di Spreadsheet. Layanan Diagram digunakan untuk membuat dan mengubah diagram yang digunakan di luar Spreadsheet, seperti di aplikasi web Apps Script.
2. Pesan toast digunakan di Spreadsheet untuk memberikan pesan pemberitahuan singkat kepada pengguna, tanpa mengharuskan mereka bertindak.
3. Dialog kustom adalah dialog modal yang dibuat dengan HTML dan JavaScript. Saat ditampilkan, dialog kustom mencegah pengguna berinteraksi dengan Spreadsheet. Dialog kustom sangat berguna untuk meminta pengguna memasukkan informasi yang diperlukan skrip untuk dijalankan, atau untuk membuat pengguna membaca sesuatu sebelum melanjutkan pekerjaan di Spreadsheet.
4. Saat file dengan skrip terikat penampung disalin, salinan file akan mempertahankan salinan skrip terikat. Jika Anda mengubah salinan, perubahan tersebut tidak akan tercermin di file asli dan sebaliknya.
5. Diagram tertaut di Slide terhubung ke diagram asli di Spreadsheet. Jika Anda mengedit diagram Spreadsheet asli, Anda dapat memperbarui diagram yang ditautkan di Slide untuk mencerminkan hasil edit.

Istilah utama:

• Aktif (status): Menunjukkan bahwa spreadsheet, sheet, rentang, atau sel yang ditentukan adalah yang sedang dilihat atau ditandai oleh pengguna spreadsheet.
• Sel aktif: Sel yang disorot dalam sheet aktif dengan fokus kursor.
• Rentang aktif: Sekelompok satu atau beberapa sel yang saat ini ditandai dalam sheet aktif.
• Otorisasi: Proses pemberian izin oleh pengguna untuk mengizinkan Apps Script mengakses data pengguna di layanan Google yang relevan atau mengambil tindakan atas nama pengguna.
• Skrip terikat penampung: Skrip apa pun yang terikat ke dan dibuat dari dokumen Google Workspace, seperti Spreadsheet Google atau Dokumen Google.
• Dialog kustom: Jendela dialog modal yang dapat disesuaikan, dibuat dari HTML dan JavaScript, yang digunakan untuk memberikan informasi atau interaktivitas kepada pengguna. Saat ditampilkan, dialog kustom mencegah pengguna berinteraksi dengan Spreadsheet.
• EmbeddedChart: Diagram yang telah disematkan ke dalam spreadsheet.
• EmbeddedChartBuilder: Class atau builder yang digunakan untuk membuat atau mengedit EmbeddedChart.
• Fungsi helper: Fungsi, biasanya bersifat pribadi, yang dipanggil oleh fungsi lain untuk menyelesaikan sub-tugas kecil. Fungsi helper digunakan saat sub-tugas perlu diselesaikan berkali-kali di berbagai tempat.
• JSON: Format file untuk menentukan objek data dan karakteristiknya dari teks.
• onOpen(): Jika ditentukan dalam skrip, ini adalah pemicu sederhana yang diaktifkan setiap kali file dibuka atau dimuat ulang.
• Diagram tertaut: Di Slide, diagram yang terhubung ke diagram asli di Spreadsheet. Jika Anda mengedit diagram Spreadsheet asli, Anda dapat memperbarui diagram yang ditautkan di Slide untuk mencerminkan hasil edit.
• Dialog modal: Buka dialog kustom.
• Presentasi: File Google Slide yang ada di Google Drive. Class Presentation memungkinkan Anda mengakses dan mengubah presentasi.
• Rentang**: Sekelompok satu atau beberapa sel yang berdekatan dalam sheet. Class Range** memberi Anda kemampuan untuk membaca dan memperbarui rentang dalam sheet.
• Editor skrip: Editor kode dalam browser untuk Apps Script.
• Pemicu sederhana: Subtipe pemicu di Apps Script dengan nama fungsi pemicu yang dicadangkan dan batasan tertentu.
• Sheet**: Satu halaman spreadsheet. Terkadang digunakan untuk merujuk pada file Google Spreadsheet dalam Google Drive. Class Sheet** memungkinkan Anda mengakses dan mengubah sheet.
• Slide: Satu slide dalam presentasi. Class Slide memungkinkan Anda mengakses dan mengubah slide.
• SlidesApp: Class ini berfungsi sebagai class induk untuk layanan Slide dan memberikan titik awal untuk kode yang membaca atau memanipulasi data Google Slide.
• SpreadsheetApp: Class ini berfungsi sebagai class induk untuk layanan Spreadsheet dan memberikan titik awal untuk kode yang membaca atau memanipulasi data Google Spreadsheet.
• Spreadsheet**: File Google Spreadsheet yang ada di Google Drive. Class Spreadsheet** memungkinkan Anda mengakses dan mengubah spreadsheet.
• Layanan spreadsheet: Layanan Apps Script yang memungkinkan skrip membuat, mengakses, dan mengubah file Google Spreadsheet.
• Toast: Dialog singkat yang digunakan untuk memberi tahu pengguna tentang beberapa peristiwa atau proses di Google Spreadsheet.
• Pemicu: Peristiwa yang dikaitkan dengan fungsi Apps Script. Saat peristiwa (seperti spreadsheet dibuka) terjadi, pemicu akan "diaktifkan" dan otomatis menjalankan fungsi Apps Script terkait.
• Layanan Pengambilan URL: Layanan Apps Script yang memungkinkan skrip terhubung ke endpoint URL untuk membuat permintaan dan menerima respons.

Langkah berikutnya

Anda telah berhasil menyelesaikan playlist ini. Namun, masih banyak yang perlu dipelajari tentang Apps Script.

Lihat referensi berikut:

• Dokumentasi Developer Apps Script
• Panduan Apps Script
• Dokumentasi Referensi Apps Script
• Pertanyaan Apps Script di StackOverflow
• Contoh kode Apps Script di GitHub

Selamat membuat skrip!

Apakah playlist codelab ini bermanfaat bagi Anda?

Ya Tidak

Apakah Anda ingin melihat lebih banyak codelab Apps Script pada masa mendatang?

Ya Tidak