Editor Skrip Google Apps: Semua yang Perlu Anda Ketahui untuk Memulai

Jika Anda menggunakan layanan Google seperti Google Documents(Google Docs) , Google Sheets , Google Analytics , Gmail , dan lainnya, Anda dapat menghubungkan dan mengotomatiskan layanan tersebut menggunakan Google Apps Script

Pikirkan Google Apps Script seperti versi Google dari skrip VBA Microsoft(Microsoft’s VBA script) . Sama seperti Anda dapat mengotomatiskan tindakan dan tugas atau menyesuaikan makro di Microsoft Word dan Excel dengan VBA(Excel with VBA) , Anda dapat mengotomatiskan tugas dan tindakan di seluruh layanan Google . Dalam layanan seperti Spreadsheet dan Documents(Docs) , Anda bahkan dapat menulis menu kustom Anda sendiri.

Dalam artikel ini Anda akan mempelajari cara mengakses dan mengaktifkan Apps Script di berbagai layanan Google(various Google services) Anda , cara menavigasi Apps Script Editor , dan cara menghubungkan layanan. Anda tidak akan mempelajari fungsi skrip tertentu(learn specific script functions) , tetapi Google memiliki dokumentasi yang sangat baik dan tutorial skrip aplikasi yang tersedia untuk mempelajari cara menulis Skrip Aplikasi(Apps Script) .

Cara Mengakses Editor Skrip Google Apps(Access Google Apps Script Editor)

Anda dapat membuka editor kode Skrip Google Apps(Google Apps Script) dari dalam sejumlah layanan Google . Misalnya, Anda akan menemukan Apps Script di menu Extensions di dalam Google Sheets.

Di layanan lain, Anda dapat membuka editor Skrip Google Apps(Google Apps Script) dengan cara berikut:

  • Google Documents(Google Docs) : Pilih Editor skrip(Script editor) di menu Alat(Tools) .
  • Google Slides : Pilih Script editor di menu Tools .
  • Google Forms : Pilih Script editor di menu tiga titik.
  • Google Drive : Klik kanan ruang kosong, pilih Lainnya(More) , dan pilih Google Apps Script .

Dengan menggunakan salah satu metode ini, Anda akan melihat editor kode Apps Script terbuka di tab baru. (Apps Script)Ini adalah jendela di mana Anda akan menulis setiap fungsi yang membentuk seluruh skrip Anda. Secara default, Anda akan melihat fungsi kosong bernama myFunction() yang siap untuk Anda mulai mengisi kode Anda.

Catatan(Note) : Pemformatan kode sangat penting untuk menghindari kesalahan. Gunakan komentar seperti yang ditunjukkan dalam kode berikut untuk mengingatkan diri Anda sendiri apa yang Anda coba lakukan di dalam bagian kode. Ini sangat mirip dengan cara kerja komentar dalam kode HTML dengan pemrograman web.

Saat Anda menavigasi editor kode, Anda dapat kembali ke bagian ini dengan memilih Code.gs di panel navigasi kiri di jendela Editor . Untuk melihat jendela lain yang tersedia, arahkan kursor ke ikon di panel paling kiri dan panel navigasi utama akan terbuka.

Bagian Ikhtisar(Overview) adalah tempat Anda dapat menemukan statistik tentang skrip Anda seperti berapa banyak kesalahan yang terjadi, berapa kali dijalankan, dan banyak lagi.

Kami akan membahas setiap bagian lain dari editor Skrip Google Apps di setiap bagian di bawah ini.(Google Apps Script)

Menavigasi Editor Skrip Google Apps(Google Apps Script Editor)

Saat Anda mengedit kode Anda di editor, ada baiknya untuk sering memilih ikon disk ( Simpan(Save) ) sehingga Anda tidak kehilangan pekerjaan Anda.

Setelah disimpan, Anda akan melihat opsi menu lainnya menyala. 

Ini termasuk:

  • Jalankan(Run) : Mencoba menjalankan seluruh skrip Anda dari awal hingga akhir.
  • Debug : Langkah melalui skrip Anda satu baris pada satu waktu.
  • Dropdown fungsi(Function dropdown) : Menelusuri dan menavigasi ke setiap fungsi yang Anda buat.
  • Log eksekusi(Execution log) : Lihat status atau pesan kesalahan dari setiap upaya yang Anda lakukan untuk menjalankan skrip Anda.

Opsi Perpustakaan(Libraries) di menu navigasi kiri adalah tempat Anda dapat mengakses perpustakaan yang telah ditulis orang lain (atau Anda telah menulis dan menyimpannya di tempat lain). Ini berguna jika Anda memiliki teman yang telah menulis fitur yang ingin Anda gunakan di Google Spreadsheet(Google Sheets) atau Google Documents(Google Docs) tetapi Anda ingin menambahkan fitur tambahan selain itu.

Yang Anda butuhkan untuk menambahkan pustaka tersebut ke dalam proyek Anda adalah Script ID . Anda dapat menemukan ini di bagian pengaturan proyek, yang akan kami tunjukkan cara menemukannya di akhir artikel ini.

Pengaya Layanan Skrip Google Apps

Bagian Layanan(Services) adalah yang paling berguna. Ini adalah tempat Anda dapat mengintegrasikan skrip Anda saat ini dengan layanan Google lain yang mungkin Anda gunakan. 

Saat Anda memilihnya, Anda akan melihat jendela Add a service terbuka. Gulir(Scroll) ke bawah ke layanan yang ingin Anda gunakan sebagai add-on untuk proyek Anda yang sudah ada. 

Misalnya, jika Anda ingin menarik data dari akun Google Analytics Anda ke dalam skrip ini, Anda dapat memilih Google Analytics API , dan memilih Tambahkan(Add) .

Jika Anda ingin menemukan detail tentang fungsi apa yang tersedia untuk digunakan untuk layanan add-on baru tersebut dan cara menggunakannya, pilih tiga titik di sebelah kanan API dan pilih Lihat dokumentasi(See documentation) .

Ini akan membuka dokumentasi Google Apps Script di tab baru, dibuka secara otomatis ke bagian untuk layanan Google itu .

Jelajahi dokumentasi untuk sintaks fungsi, tutorial, dan contoh kode yang dapat Anda gunakan dalam skrip Anda sendiri.

Perhatikan juga bahwa Anda dapat menavigasi ke bagian lain dari dokumentasi untuk melihat fungsi umum apa yang tersedia di skrip Anda berdasarkan layanan yang Anda gunakan saat pertama kali membuka editor kode Apps Script .

Misalnya, jika Anda membuka editor di Google Spreadsheet(Google Sheets) , periksa bagian Spreadsheet(Sheets) di menu dokumentasi untuk fungsi Google Spreadsheet(Google Sheets) yang dapat Anda gunakan dalam skrip.

Menyiapkan dan Menggunakan Pemicu Skrip Aplikasi(Using Apps Script Triggers)

Fitur berguna lainnya di Google Apps Script adalah kemampuan untuk menyetel pemicu berdasarkan sejumlah acara atau jadwal.

Untuk mengonfigurasi pemicu baru untuk skrip Anda, pilih Pemicu(Triggers) dari menu navigasi paling kiri. Di jendela Pemicu(Triggers) baru yang terbuka, pilih tombol Tambah Pemicu(Add Trigger) .

Jendela Add Trigger memiliki daftar panjang opsi yang membantu Anda menyesuaikan dengan tepat bagaimana dan kapan Anda ingin skrip Anda dijalankan. 

Catatan(Note) : Banyak dari opsi ini bergantung pada layanan tempat Anda menulis skrip atau API yang telah Anda tambahkan(the APIs that you’ve added) .

Untuk menyiapkan pemicu, Anda harus memilih:

  • Fungsi mana yang awalnya diluncurkan
  • Sumber peristiwa seperti waktu, tanggal, atau peristiwa tertentu di layanan Anda seperti saat sel spreadsheet Google berubah atau dokumen pertama kali dibuka
  • Jenis acara seperti ketika sesuatu di spreadsheet atau dokumen Google Anda dibuka atau diedit, atau pengaturan khusus untuk tanggal atau waktu
  • Frekuensi pemberitahuan seberapa sering Anda ingin mendapatkan pembaruan tentang kapan skrip Anda gagal

Setelah memilih Simpan(Save) , Anda mungkin melihat pesan “ Otorisasi skrip(Script) gagal” jika ini adalah pertama kalinya Anda menyimpan pemicu baru.

Ini biasanya dipicu jika Anda mengaktifkan pemblokir pop-up di browser Anda. Jika Anda menggunakan Google Chrome , cukup pilih ikon jendela kecil dengan tanda "X" merah di atasnya. Ubah pengaturan ke Selalu izinkan munculan(Always allow pop-ups) dan pilih Selesai(Done) .

Saat memilih Simpan(Save) lagi, Anda harus melalui proses untuk mengotorisasi skrip yang telah Anda tulis agar berjalan di bawah akun Google atau Google Workspace .

Pertama, pilih akun Google yang ingin Anda izinkan untuk menjalankan skrip Anda.

Anda akan melihat peringatan bahwa fungsi khusus atau skrip yang Anda tulis tidak "diverifikasi" oleh Google . Jika Anda adalah orang yang menulis skrip, maka ini tidak masalah dan aman untuk dijalankan di bawah Akun(Google Account) Google atau Google Workspace Anda sendiri .

Untuk mengabaikan peringatan ini, cukup pilih Lanjutan(Advanced) lalu pilih tautan Go to <project> (unsafe) di bagian bawah.

Terakhir, di jendela izin, pilih Izinkan(Allow) untuk mengizinkan fungsi dan skrip khusus Anda berjalan di bawah akun Google Anda atau Google Workspace .

Anda tidak perlu mengulangi proses ini lagi, hanya saat pertama kali Anda menyimpan atau menjalankan proyek skrip  Google Apps khusus Anda.(Google Apps)

Mengakses ID Skrip Google Anda

Satu catatan terakhir – Anda mungkin ingin memberikan skrip Anda kepada teman atau kolega sehingga mereka dapat menggunakan skrip Anda atau menambahkannya sebagai pustaka ke skrip mereka sendiri. 

Anda dapat menemukan ID Skrip(Script ID) Anda di bawah ikon Pengaturan(Settings) di panel navigasi paling kiri.

ID Skrip(Script ID) dapat ditemukan di bawah bagian ID(IDs) , di sebelah kanan ID Skrip(Script ID) .

Seperti yang Anda lihat, editor Skrip Google Apps(Google Apps Script) cukup mudah jika Anda tahu cara menavigasi ke setiap fitur yang ingin Anda gunakan. Pastikan untuk mempelajari dokumentasi Skrip Aplikasi(Apps Script) Google dengan baik sehingga Anda dapat mulai mempelajari cara menulis skrip dan semua fungsi yang tersedia untuk digunakan .(Just)



About the author

audiophile engineer dan spesialis produk audio dengan pengalaman lebih dari 10 tahun. Saya mengkhususkan diri dalam menciptakan speaker musik dan headphone berkualitas dari awal hingga akhir. Saya ahli dalam memecahkan masalah audio serta merancang pengeras suara dan sistem headphone baru. Pengalaman saya lebih dari sekadar membuat produk yang bagus; Saya juga memiliki hasrat untuk membantu orang lain menjadi diri mereka yang terbaik, baik itu melalui pendidikan atau pengabdian masyarakat.



Related posts