Menu Kustom di Google Workspace

Skrip dapat memperluas produk Google tertentu dengan menambahkan elemen antarmuka pengguna yang, saat diklik, menjalankan fungsi Apps Script. Contoh paling umum adalah menjalankan skrip dari item menu kustom di Google Dokumen, Spreadsheet, Slide, atau Formulir, tetapi fungsi skrip juga dapat dipicu dengan mengklik gambar dan gambar di Google Spreadsheet.

Menu kustom di Google Dokumen, Spreadsheet, Slide, atau Formulir

Apps Script dapat menambahkan menu baru di Google Dokumen, Spreadsheet, Slide, atau Formulir, dengan setiap item menu yang diikat ke fungsi dalam skrip. (Di Google Formulir, menu kustom hanya terlihat oleh editor yang membuka formulir untuk mengubahnya, bukan oleh pengguna yang membuka formulir untuk merespons.)

Skrip hanya dapat membuat menu jika terikat dengan dokumen, spreadsheet, atau formulir. Untuk menampilkan menu saat pengguna membuka file, tulis kode menu dalam fungsi onOpen().

Contoh di bawah ini menunjukkan cara menambahkan menu dengan satu item, diikuti dengan pemisah visual, lalu sub-menu yang berisi item lainnya. (Perhatikan bahwa di Google Spreadsheet, kecuali Anda menggunakan versi baru, Anda harus menggunakan sintaksis addMenu(), dan submenu tidak dapat dilakukan.) Jika pengguna memilih salah satu item menu, fungsi yang sesuai akan membuka dialog alert. Untuk informasi selengkapnya tentang jenis dialog yang dapat Anda buka, lihat panduan untuk dialog dan sidebar.

function onOpen() {
  var ui = SpreadsheetApp.getUi();
  // Or DocumentApp or FormApp.
  ui.createMenu('Custom Menu')
      .addItem('First item', 'menuItem1')
      .addSeparator()
      .addSubMenu(ui.createMenu('Sub-menu')
          .addItem('Second item', 'menuItem2'))
      .addToUi();
}

function menuItem1() {
  SpreadsheetApp.getUi() // Or DocumentApp or FormApp.
     .alert('You clicked the first menu item!');
}

function menuItem2() {
  SpreadsheetApp.getUi() // Or DocumentApp or FormApp.
     .alert('You clicked the second menu item!');
}

Dokumen, spreadsheet, presentasi, atau formulir hanya dapat berisi satu menu dengan nama tertentu. Jika skrip yang sama atau skrip lainnya menambahkan menu dengan nama yang sama, menu yang baru akan menggantikan menu yang lama. Menu tidak dapat dihapus saat file dibuka, meskipun Anda dapat menulis fungsi onOpen() untuk melewati menu di masa mendatang jika properti tertentu ditetapkan.

Gambar yang dapat diklik di Google Spreadsheet

Anda juga dapat menetapkan fungsi Apps Script untuk gambar atau gambar di Google Spreadsheet, asalkan skrip terikat ke spreadsheet. Contoh di bawah menunjukkan cara menyiapkannya.

  1. Di Google Spreadsheet, pilih item menu Ekstensi > Apps Script untuk membuat skrip yang terikat ke spreadsheet.
  2. Hapus kode apa pun di editor skrip dan tempelkan kode di bawah.
    function showMessageBox() {
    Browser.msgBox('You clicked it!');
    }
  3. Kembali ke Spreadsheet dan sisipkan gambar atau gambar dengan memilih Sisipkan > Gambar atau Sisipkan > Gambar.
  4. Setelah menyisipkan gambar, klik gambar tersebut. Pemilih menu drop-down yang kecil akan muncul di pojok kanan atas. Klik dan pilih Tetapkan skrip.
  5. Di kotak dialog yang muncul, ketik nama fungsi Apps Script yang ingin dijalankan, tanpa tanda kurung — dalam hal ini, showMessageBox. Klik OK.
  6. Klik gambar atau gambar lagi. Fungsi sekarang akan dieksekusi.

Anda juga dapat menetapkan fungsi Apps Script ke link dalam Google Sites, asalkan skrip terikat ke situs. Contoh di bawah menunjukkan cara menyiapkannya.

  1. Di Google Sites, klik Lainnya > Kelola situs.
  2. Di sidebar, klik Apps Scripts, lalu Add new script untuk membuat skrip yang terikat ke situs.
  3. Hapus semua kode di editor skrip dan tempelkan kode di bawah ini, yang akan mengirim email saat pengguna mengklik link.
    function sitesLink() {
    var recipient = Session.getActiveUser().getEmail();
    GmailApp.sendEmail(recipient, 'Email from your site', 'You clicked a link!');
    }
  4. Kembali ke Situs Google dan edit halaman. Ketik label yang akan menjadi link, seperti Click me, lalu tandai teks dan pilih Insert > Link.
  5. Pada dialog yang muncul, klik Apps Script, lalu klik fungsi sitesLink yang baru saja Anda buat. Klik OK.
  6. Klik Simpan di bagian atas halaman.
  7. Klik link yang Anda tambahkan ke halaman.
  8. Kotak dialog akan muncul dan memberi tahu Anda bahwa skrip memerlukan otorisasi. Klik OK. Kotak dialog kedua akan meminta otorisasi untuk layanan Google tertentu. Baca pemberitahuan dengan cermat, lalu klik Izinkan, lalu Tutup.
  9. Setelah skrip diotorisasi, klik link yang ditambahkan ke halaman tersebut lagi. Fungsi sekarang akan dieksekusi. Periksa email Anda untuk melihat email yang Anda kirim sendiri.