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

1. Pengantar

Selamat datang di bagian kelima dari playlist codelab Dasar-dasar Apps Script dengan Google Spreadsheet. Codelab ini mengajarkan 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 mempresentasikan dialog kepada pengguna di Spreadsheet.

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

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

Sebelum memulai

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

1. Makro dan Fungsi Kustom
2. Spreadsheet, Spreadsheet, dan Rentang
3. Bekerja dengan data
4. Format data

Yang Anda butuhkan

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

2. Siapkan

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

1. Klik link ini untuk menyalin sheet data, lalu klik Buat salinan. Spreadsheet baru akan ditempatkan di folder Google Drive dan diberi nama "Salinan Tanggal dan Nilai Tukar USD".
2. Klik judul spreadsheet dan ubah dari "Salinan Tanggal dan Nilai Tukar USD" menjadi "Tanggal dan Nilai Tukar USD". Sheet 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 dibuka:

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

Poin penting: Karena spreadsheet yang disalin memiliki project skrip yang terikat dengannya, saat spreadsheet disalin, maka project skrip juga ikut disalin. Perlu diingat bahwa ini adalah salinan project skrip asli—perubahan yang dibuat pada salinan tidak akan terlihat di file asli dan sebaliknya.

Dengan spreadsheet dan project ini, Anda siap untuk memulai codelab. Pindah 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 terdapat dalam spreadsheet, diagram ini disebut diagram sematan.

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

Anda dapat menggunakan Apps Script untuk membuat diagram sematan kustom dari awal, atau memperbarui diagram yang ada. Bagian ini memperkenalkan dasar-dasar pembuatan diagram tersemat 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 diagram, tetapi tidak mencakup setiap opsi konfigurasi yang memungkinkan. Selain itu, Apps Script juga menggunakan Google Chart API, yang memiliki batasan sendiri.

Karena batasan ini, sering kali bermanfaat untuk menggunakan Apps Script untuk membuat bagan dasar, atau mengedit terlebih dahulu kemudian menyesuaikan format secara manual dalam Spreadsheet. Anda mungkin tidak dapat mengotomatiskan setiap proses terkait diagram di Apps Script, tetapi Anda dapat mengotomatiskannya secara signifikan.

Implementasi

Dalam salinan spreadsheet data, set data "Tanggal dan Nilai Tukar" menunjukkan kurs (untuk 1 dolar AS) mata uang yang berbeda pada tanggal yang berbeda. Anda akan menerapkan fungsi Apps Script yang membuat diagram untuk memvisualisasikan bagian dari data ini.

Lakukan langkah berikut:

1. Di editor Apps Script, tambahkan fungsi berikut ke bagian 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 Anda tambahkan menerapkan fungsi yang dipanggil oleh item menu Diagram "Tanggal dan Kurs Tukar USD USD" 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 tersebut menggunakan notasi A1 untuk menentukan rentang mencakup sel A2 hingga F102 di sheet bernama Set data Tanggal dan Nilai Tukar USD. Dengan menamai sheet secara khusus, kami memastikan item menu berfungsi meskipun sheet yang berbeda aktif karena rentang selalu mencakup posisi data. Mulai dari baris 2, kami menyertakan header kolom dan kami hanya akan memetakan 100 tanggal terbaru (baris).
• hAxisOptions: objek JavaScript dasar yang menyertakan beberapa informasi setelan yang digunakan kode untuk mengonfigurasi tampilan sumbu horizontal. Secara khusus, mereka menetapkan label teks sumbu horizontal dengan kemiringan 60 derajat, dan menyetel jumlah garis kisi vertikal menjadi 12.

Baris berikutnya membuat objek builder diagram garis. Diagram tersemat dalam 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 builder diagram tersemat, menggunakan metodenya untuk menentukan setelan diagram, lalu memanggil metode build() untuk membuat objek EmbeddedChart akhir. Kode Anda tidak pernah memodifikasi objek EmbeddedChart secara langsung karena semua konfigurasi diagram dikelola melalui class builder.

Layanan Spreadsheet menyediakan class EmbeddedChartBuilder induk dan beberapa class builder turunan (seperti EmbeddedLineChartBuilder) yang mewarisi darinya. 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 ini memanggil metode Sheet.newChart() untuk membuat objek EmbeddedChartBuilder, lalu menggunakan EmbeddedChartBuilder.asLineChart() untuk menetapkan jenis builder ke EmbeddedLineChartBuilder.

Kode kemudian membuat diagram menggunakan lineChartBuilder. Bagian kode ini hanyalah serangkaian panggilan metode untuk menentukan setelan diagram, diikuti dengan panggilan build() untuk membuat diagram. Seperti yang Anda lihat dalam codelab sebelumnya, kode menggunakan rantai metode untuk menjaga kode tetap dapat dibaca manusia. Berikut yang dilakukan oleh panggilan metode:

• addRange(range): Menentukan rentang data yang ditampilkan diagram.
• setPosition(anchorRowPos, anchorColPos, offsetX, offsetY): Menentukan lokasi diagram di sheet. Di sini, kode menyisipkan sudut kiri atas diagram di sel H5.
• setTitle(title): Menetapkan judul diagram.
• setNumHeaders(headers): Menentukan 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 di baris tersebut digunakan sebagai label untuk rangkaian data individual 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 yang kompleks. Di sini, kode menetapkan opsi hAxis ke objek hAxisOptions. Ada beberapa opsi yang dapat Anda setel menggunakan metode ini. Opsi dan nilai yang memungkinkan untuk setiap jenis diagram didokumentasikan di Galeri Diagram API Diagram. Misalnya, opsi yang dapat Anda tetapkan untuk diagram garis didokumentasikan di Opsi konfigurasi diagram garis. Metode setOption(option, value) adalah topik tingkat lanjut, jadi sebaiknya Anda tidak menggunakannya hingga 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 sheet yang aktif.

Hasil

Anda dapat melihat cara kerja fungsi format dengan melakukan hal berikut:

1. Jika belum, simpan project skrip Anda di editor Apps Script.
2. Klik item menu Presentasikan set data > Diagram "Tanggal dan set data Nilai Tukar USD".

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

1. Pada dialog aplikasi yang belum diverifikasi, klik Lanjutan.
2. Klik Buka Tanggal dan Kurs USD (tidak aman).
3. Klik Izinkan.

Di seluruh codelab ini, Anda mungkin mendapatkan beberapa permintaan izin. Anda dapat membaca selengkapnya tentang proses ini di Otorisasi untuk Layanan Google.

Skrip Anda sekarang menempatkan diagram baru di sebelah kanan data:

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

4. Mengekspor diagram ke Slide

Salah satu keunggulan hebat Apps Script adalah memungkinkan Anda memindahkan data dari satu aplikasi Google Workspace ke aplikasi lainnya dengan mudah. 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.

Pada bagian ini, Anda akan mempelajari cara mengekspor setiap diagram yang disematkan di 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.

Implementasi

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

1. Di editor Apps Script, tambahkan fungsi berikut ke bagian 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 yang disematkan, yang mengumpulkannya ke dalam array charts. Baris ini menggunakan metode Spreadsheet.getSheets() dan metode Sheet.getCharts() untuk mendapatkan daftar sheet dan diagram. Metode Array.concat() JavaScript digunakan untuk menambahkan daftar diagram dari setiap sheet ke charts.

2: Memeriksa bahwa ada diagram yang akan diekspor

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

Poin penting: Pesan Toast sangat cocok untuk menunjukkan kepada pengguna bahwa sesuatu telah terjadi, tetapi hal tersebut bukanlah reaksi yang tepat. Dalam hal ini, pesan toast akan memberi tahu pengguna bahwa tindakan menu berhasil diselesaikan, tetapi tidak menghasilkan apa pun karena tidak ada diagram yang dapat diekspor.

Jika kode tidak membuat pesan toast, item menu akan tampak seperti tidak melakukan apa-apa bagi item menu dan pengguna mungkin menganggap skrip rusak. Ini adalah praktik terbaik untuk selalu memberi tahu pengguna tentang apa yang dilakukan skrip Anda, bahkan saat skrip mengalami kondisi error.

Jika tidak ada diagram yang dapat diekspor, kode akan membuat pesan toast dan keluar tanpa melakukan apa pun. Jika ada diagram yang akan diekspor, kode terus membuat presentasi di beberapa baris berikutnya.

3: Membuat presentasi

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

Catatan: Class SlidesApp berfungsi sebagai class induk untuk layanan Slide, sama seperti SpreadsheetApp adalah class induk untuk layanan Spreadsheet.

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

4: Mengekspor diagram

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

Catatan: Slide elemen halaman 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 di panduan Elemen halaman dan pengaturan posisi halaman.

Kode akan 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: Membagikan lokasi presentasi

Terakhir, kode harus memberi tahu pengguna di mana presentasi baru berada, dan sebaiknya dengan link yang dapat diklik untuk membukanya. Untuk melakukannya, kode menggunakan HTML layanan Apps Script untuk membuat dialog modal khusus. 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 cocok jika skrip Anda perlu memiliki input tertentu dari pengguna untuk melanjutkan, atau jika Anda ingin memastikan pengguna melihat sesuatu sebelum melanjutkan pekerjaan di Google Spreadsheet.

Layanan HTML Apps Script memungkinkan Anda mengontrol gaya dan konten dialog kustom sepenuhnya dengan HTML dan JavaScript standar. Ini berarti 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 Menayangkan HTML dan Komunikasi klien-server.

Untuk membuat dialog kustom, kode memerlukan HTML yang mendefinisikan kontennya. Ini tersedia di variabel html. Konten ini mencakup paragraf pendek 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 dengan 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 mengimplementasikan item menu kedua, Anda dapat melihat cara kerjanya. Untuk menguji fungsi exportChartsToSlides():

1. Jika belum, simpan project skrip Anda di editor Apps Script.
2. Buka spreadsheet dan klik item menu Presentasikan set data > Diagram "Tanggal dan set data Nilai Tukar USD" untuk membuat diagram yang akan diekspor. Ini akan muncul ditambatkan ke sel H5 di sheet aktif.
3. Klik item menu Presentasikan set data > Ekspor diagram ke Slide. Anda mungkin diminta untuk mengotorisasi ulang skrip.
4. Anda akan melihat skrip memproses permintaan tersebut dan menampilkan dialog kustom.
5. Untuk membuka presentasi Slide baru, klik link Presentasi Nilai Tukar Tanggal dan USD:

Jika diinginkan, Anda juga dapat menambahkan diagram lainnya ke spreadsheet dan memilih ulang item menu untuk membuat presentasi dengan beberapa slide.

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

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

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

5. Kesimpulan

Selamat, kini Anda telah menyelesaikan codelab ini dan seluruh playlist codelab Dasar-Dasar Aplikasi Apps 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 mempresentasikan 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 Chart digunakan untuk membuat dan mengubah diagram yang digunakan di luar Spreadsheet, seperti aplikasi web Apps Script.
2. Pesan Toast digunakan di Spreadsheet untuk memberikan pesan peringatan singkat kepada pengguna, tanpa mengharuskan mereka menindaklanjutinya.
3. Dialog kustom adalah dialog modal yang dibuat dengan HTML dan JavaScript. Saat ditampilkan, dialog kustom mencegah pengguna berinteraksi dengan Spreadsheet. Dialog kustom sangat cocok untuk meminta pengguna memasukkan informasi yang perlu dijalankan oleh skrip, atau untuk membuat pengguna membaca sesuatu sebelum melanjutkan pekerjaan di Spreadsheet.
4. Jika file dengan skrip terikat penampung disalin, salinan file akan menyimpan salinan skrip terikat. Jika Anda mengubah salinan, salinan tersebut tidak ditampilkan dalam versi asli, begitu pun sebaliknya.
5. Diagram tertaut di Slide terhubung ke diagram asli di Spreadsheet. Jika mengedit diagram Spreadsheet asli, Anda dapat memperbarui diagram yang ditautkan di Slide untuk menyesuaikan dengan hasil edit.

Istilah utama:

• Aktif (status): Menunjukkan spreadsheet, sheet, rentang, atau sel yang ditentukan adalah spreadsheet yang sedang dilihat atau disoroti oleh pengguna spreadsheet.
• Sel aktif: Satu sel yang ditandai dalam sheet aktif dengan fokus kursor.
• Rentang aktif: Grup satu atau beberapa sel yang saat ini ditandai dalam sheet aktif.
• Otorisasi: Proses pengguna memberikan izin untuk mengizinkan Apps Script mengakses data pengguna di layanan Google yang relevan atau melakukan tindakan atas nama pengguna.
• Skrip yang terikat dengan penampung: Skrip apa pun yang terikat dan dibuat dari dokumen Google Workspace, seperti Google Spreadsheet atau Google Dokumen.
• Dialog kustom: Jendela dialog modal yang dapat disesuaikan, dibuat dari HTML dan JavaScript, digunakan untuk memberikan informasi atau interaktivitas 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 bantuan: Fungsi, biasanya bersifat pribadi, yang dipanggil oleh fungsi lain untuk menyelesaikan subtugas kecil. Fungsi bantuan digunakan saat subtugas perlu diselesaikan beberapa kali di tempat yang berbeda.
• JSON: Format file untuk menentukan objek data dan karakteristiknya dari teks.
• onOpen(): Jika ditetapkan 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 mengedit diagram Spreadsheet asli, Anda dapat memperbarui diagram yang ditautkan di Slide untuk menyesuaikan dengan hasil edit.
• Dialog modal: Buka dialog kustom.
• Presentasi: File Google Slide yang berada di Google Drive. Class Presentation memungkinkan Anda mengakses dan mengubah presentasi.
• Rentang**: Grup dari 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: Subjenis pemicu di Apps Script dengan nama fungsi pemicu yang dicadangkan dan batasan tertentu.
• Sheet**: Satu halaman spreadsheet. Terkadang digunakan untuk merujuk ke 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 menyediakan titik awal untuk kode yang membaca atau memanipulasi data Google Spreadsheet.
• Spreadsheet**: File Google Spreadsheet yang berada 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 berumur pendek yang digunakan untuk memberi tahu pengguna tentang beberapa peristiwa atau proses di Google Spreadsheet.
• Pemicu: Peristiwa yang dikunci ke fungsi Apps Script. Saat peristiwa (seperti spreadsheet dibuka) terjadi, pemicu "fire" dan otomatis menjalankan fungsi Apps Script yang terkait.
• Layanan Pengambilan URL: Layanan Apps Script yang memungkinkan skrip terhubung ke endpoint URL untuk membuat permintaan dan menerima respons.

Apa selanjutnya

Anda berhasil menyelesaikan playlist ini. Namun, masih ada lagi yang dapat dipelajari tentang Apps Script.

Lihat referensi berikut:

• Dokumentasi Developer Apps Script
• Panduan Apps Script
• Dokumentasi Referensi Apps Script
• Pertanyaan tentang 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 codelab Apps Script lainnya di masa mendatang?

Ya Tidak