Bagaimana cara mengaktifkan skrip google di lembar google?

Memulai

Tutorial dan panduan untuk membawa Anda mulai dari menulis skrip pertama hingga membuat aplikasi

Belajarlah lagi "

Contoh Script

Dari alat produktivitas hingga otomatisasi perusahaan, lihat apa yang dapat Anda bangun dengan Google Apps Script

Belajarlah lagi "

Referensi Pengembang

Lengkapi dokumentasi dengan semua yang perlu Anda ketahui saat Anda membangun dengan Google Apps Script

Belajarlah lagi "

Skrip Google Apps adalah bahasa skrip berbasis awan untuk memperluas fungsionalitas Google Apps dan membuat aplikasi ringan berbasis awan

Artinya, Anda menulis program kecil dengan Apps Script untuk memperluas fitur standar Aplikasi Google Workspace. Ini bagus untuk mengisi kekosongan dalam alur kerja Anda

Dengan Apps Script, Anda dapat melakukan hal-hal keren seperti mengotomatiskan tugas berulang, membuat dokumen, mengirim email ke orang secara otomatis, dan menghubungkan Google Sheets ke layanan lain yang Anda gunakan

Menulis Skrip Google pertama Anda

Dalam tutorial skrip Google Sheets ini, kami akan menulis skrip yang terikat ke Google Sheet kami. Ini disebut skrip terikat wadah

(Jika Anda mencari contoh dan tutorial lebih lanjut, lihat daftar lengkap artikel Skrip Aplikasi di situs web saya. )

Halo Dunia di Skrip Google Apps

Mari kita menulis program pertama kita yang sangat mendasar, program klasik “Hello world” yang disukai oleh departemen pengajaran komputer di seluruh dunia

Mulailah dengan membuat Google Sheet baru

Kemudian klik menu. Ekstensi > Skrip Aplikasi

Ini akan membuka tab baru di browser Anda, yang merupakan jendela editor Google Apps Script

Secara default, itu akan terbuka dengan satu file Google Script (code.gs) dan blok kode default,

function myFunction() {
  Browser.msgBox("Hello World!");
}

function myFunction() {
  
}

Di jendela kode, di antara kurung kurawal setelah sintaks

function myFunction() {
  Browser.msgBox("Hello World!");
}

function myFunction() {
  Browser.msgBox("Hello World!");
}

Jendela kode Anda sekarang akan terlihat seperti ini

Otorisasi Skrip Google Apps

Google Script memiliki perlindungan keamanan yang kuat untuk mengurangi risiko dari aplikasi yang tidak diverifikasi, jadi kami melalui alur kerja otorisasi saat pertama kali mengotorisasi aplikasi kami sendiri

Saat Anda menekan tombol jalankan untuk pertama kalinya, Anda akan diminta untuk mengotorisasi aplikasi untuk dijalankan

Mengklik Tinjau Izin akan memunculkan jendela lain secara bergantian, menunjukkan izin apa yang perlu dijalankan aplikasi Anda. Dalam hal ini aplikasi ingin melihat dan mengelola spreadsheet Anda di Google Drive, jadi klik Izinkan (jika tidak, skrip Anda tidak akan dapat berinteraksi dengan spreadsheet Anda atau melakukan apa pun)

❗️Saat pertama kali menjalankan skrip aplikasi, Anda mungkin melihat layar “aplikasi tidak diverifikasi” dan peringatan tentang apakah Anda ingin melanjutkan

Dalam kasus kami, karena kami adalah pembuat aplikasi, kami tahu ini aman sehingga kami ingin melanjutkan. Selain itu, proyek skrip aplikasi dalam posting ini tidak dimaksudkan untuk dipublikasikan secara publik untuk pengguna lain, jadi kami tidak perlu mengirimkannya ke Google untuk ditinjau (walaupun jika Anda ingin melakukannya, inilah informasi lebih lanjut)

Klik tombol "Lanjutan" di kiri bawah pop-up izin peninjauan, lalu klik "Buka Kode Skrip Pemula (tidak aman)" di bagian bawah layar berikutnya untuk melanjutkan. Kemudian ketikkan kata "Lanjutkan" di layar berikutnya, klik Berikutnya, dan terakhir tinjau izin dan klik "IZINKAN", seperti yang ditunjukkan pada gambar ini (menunjukkan skrip berbeda di editor lama)

Informasi lebih lanjut dapat ditemukan di entri blog mendetail ini dari Pakar Pengembang Google Martin Hawksey

Menjalankan fungsi di Apps Script

Setelah Anda mengotorisasi skrip Google App, fungsi akan berjalan (atau dijalankan)

Jika ada yang salah dengan kode Anda, ini adalah tahap ketika Anda melihat pesan peringatan (alih-alih pesan kuning, Anda akan mendapatkan kotak merah dengan pesan kesalahan di dalamnya)

Kembali ke Google Sheet Anda dan Anda akan melihat output dari program Anda, popup kotak pesan dengan pesan klasik “Hello world. " pesan

Klik Ok untuk menutup

Kerja bagus. Anda sekarang telah menulis program skrip aplikasi pertama Anda

Ganti nama fungsi di Google Apps Script

Kita harus mengganti nama fungsi kita menjadi sesuatu yang lebih bermakna

Saat ini, itu disebut myFunction yang merupakan nama generik default yang dihasilkan oleh Google. Setiap kali saya ingin memanggil fungsi ini (mis. e. jalankan untuk melakukan sesuatu) saya akan menulis

function myFunction() {
  Browser.msgBox("Hello World!");
}

function myFunction() {
  Browser.msgBox("Hello World!");
}

Jadi ubah kode Anda di baris 1 dari ini

function myFunction() {
  Browser.msgBox("Hello World!");
}

untuk ini

function helloWorld() {
  Browser.msgBox("Hello World!");
}

Perhatikan, konvensi dalam Apps Script menggunakan konvensi penamaan CamelCase, dimulai dengan huruf kecil. Oleh karena itu, kami menamai fungsi kami

function myFunction() {
  Browser.msgBox("Hello World!");
}

Menambahkan menu khusus di Google Apps Script

Dalam bentuknya saat ini, program kami sangat tidak berguna karena berbagai alasan, paling tidak karena kami hanya dapat menjalankannya dari jendela editor skrip dan bukan dari spreadsheet kami

Mari kita perbaiki dengan menambahkan menu khusus ke bilah menu spreadsheet kita sehingga pengguna dapat menjalankan skrip di dalam spreadsheet tanpa perlu membuka jendela editor

Ini sebenarnya sangat mudah dilakukan, hanya membutuhkan beberapa baris kode. Tambahkan 6 baris kode berikut ke dalam jendela editor, di atas fungsi

function myFunction() {
  Browser.msgBox("Hello World!");
}

function onOpen() {
  const ui = SpreadsheetApp.getUi();
  ui.createMenu('My Custom Menu')
      .addItem('Say Hello', 'helloWorld')
      .addToUi();
}

function helloWorld() {
  Browser.msgBox("Hello World!");
}

Jika Anda melihat kembali tab spreadsheet Anda di browser sekarang, tidak ada yang berubah. Anda belum memiliki menu khusus di sana. Kita perlu membuka kembali spreadsheet kita (menyegarkannya) atau menjalankan skrip

function myFunction() {
  Browser.msgBox("Hello World!");
}

Untuk menjalankan

function myFunction() {
  Browser.msgBox("Hello World!");
}

Sekarang, saat Anda kembali ke spreadsheet, Anda akan melihat menu baru di sisi kanan opsi Bantuan, yang disebut Menu Kustom Saya. Klik di atasnya dan itu akan terbuka untuk menampilkan pilihan untuk menjalankan program Hello World Anda

Jalankan fungsi dari tombol di Google Sheets

Cara alternatif untuk menjalankan Google Scripts dari Spreadsheet Anda adalah dengan mengikat fungsi ke tombol di Sheet Anda

Sebagai contoh, inilah Lembar template faktur dengan tombol RESET untuk menghapus isinya

Untuk informasi lebih lanjut tentang cara melakukan ini, lihat posting ini. Tambahkan Tombol Google Sheets Untuk Menjalankan Skrip

Contoh Skrip Google Apps

Makro di Google Spreadsheet

Cara hebat lainnya untuk memulai dengan Google Scripts adalah dengan menggunakan Macro. Makro adalah program kecil di Google Spreadsheet yang Anda rekam sehingga Anda dapat menggunakannya kembali (misalnya menerapkan pemformatan standar ke tabel). Mereka menggunakan Apps Script di balik terpal, jadi ini cara yang bagus untuk memulai

Baca lebih banyak. Panduan Lengkap Otomatisasi Sederhana Menggunakan Google Sheets Macros

Fungsi khusus menggunakan Google Apps Script

Mari buat fungsi kustom dengan Apps Script, dan juga demonstrasikan penggunaan Layanan Maps. Kami akan membuat fungsi kustom kecil yang menghitung jarak mengemudi antara dua titik, berdasarkan perkiraan mengemudi Layanan Google Maps

Tujuannya adalah untuk dapat memiliki dua nama tempat di spreadsheet kami, dan mengetikkan fungsi baru di sel baru untuk mendapatkan jarak, sebagai berikut

Solusinya harus

Salin kode berikut ke jendela editor Apps Script dan simpan. Pertama kali, Anda harus menjalankan skrip satu kali dari jendela editor dan klik "Izinkan" untuk memastikan skrip dapat berinteraksi dengan spreadsheet Anda

function distanceBetweenPoints(start_point, end_point) {
  // get the directions
  const directions = Maps.newDirectionFinder()
     .setOrigin(start_point)
     .setDestination(end_point)
     .setMode(Maps.DirectionFinder.Mode.DRIVING)
     .getDirections();
  
  // get the first route and return the distance
  const route = directions.routes[0];
  const distance = route.legs[0].distance.text;
  return distance;
}

Menyimpan data dengan Google Apps Script

Mari kita lihat kasus penggunaan sederhana lainnya untuk tutorial Google Sheets Apps Script ini

Misalkan saya ingin menyimpan salinan beberapa data secara berkala, seperti itu

Dalam skrip ini, saya telah membuat menu khusus untuk menjalankan fungsi utama saya. Fungsi utama,

function myFunction() {
  Browser.msgBox("Hello World!");
}

Kode untuk contoh ini adalah

// custom menu function
function onOpen() {
  const ui = SpreadsheetApp.getUi();
  ui.createMenu('Custom Menu')
      .addItem('Save Data','saveData')
      .addToUi();
}

// function to save data
function saveData() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = ss.getSheets()[0];
  const url = sheet.getRange('Sheet1!A1').getValue();
  const follower_count = sheet.getRange('Sheet1!B1').getValue();
  const date = sheet.getRange('Sheet1!C1').getValue();
  sheet.appendRow([url,follower_count,date]);
}

Lihat posting ini. Cara Menyimpan Data Di Google Sheets Dengan Cap Waktu Menggunakan Apps Script, untuk panduan langkah demi langkah membuat dan menjalankan skrip ini

Contoh Skrip Google Apps di Google Dokumen

Skrip Google Apps sama sekali tidak terbatas pada Spreadsheet saja dan dapat diakses dari alat Google Workspace lainnya

Berikut adalah contoh cepat di Google Docs, menampilkan skrip yang menyisipkan simbol tertentu di mana pun kursor Anda berada

Kami melakukan ini menggunakan Skrip Aplikasi Google sebagai berikut

1. Buat Google Dokumen baru

2. Buka editor skrip dari menu. Ekstensi > Skrip Aplikasi

3. Di tab Script yang baru dibuka, hapus semua kode boilerplate (blok kode "myFunction")

4. Salin dalam kode berikut

// code to add the custom menu
function onOpen() {
  const ui = DocumentApp.getUi();
  ui.createMenu('My Custom Menu')
      .addItem('Insert Symbol', 'insertSymbol')
      .addToUi();
}

// code to insert the symbol
function insertSymbol() {  
  // add symbol at the cursor position
  const cursor = DocumentApp.getActiveDocument().getCursor();
  cursor.insertText('§§');
  
}

5. Anda dapat mengubah karakter khusus di baris ini

function myFunction() {
  Browser.msgBox("Hello World!");
}

untuk apa pun yang Anda inginkan, e. g

function myFunction() {
  Browser.msgBox("Hello World!");
}

6. Klik Simpan dan beri nama proyek skrip Anda (tidak memengaruhi jalannya jadi sebut saja apa yang Anda inginkan e. g. Sisipkan Simbol)

7. Jalankan skrip untuk pertama kali dengan mengklik menu.

function myFunction() {
  Browser.msgBox("Hello World!");
}

8. Google akan mengenali skrip belum diotorisasi dan menanyakan apakah Anda ingin melanjutkan. Klik Lanjutkan

9. Karena ini adalah skrip pertama yang dijalankan, Google Docs meminta Anda untuk mengotorisasi skrip (saya menyebut skrip saya "tes" yang dapat Anda lihat di bawah)

10. Klik Izinkan

11. Kembali ke Google Doc Anda sekarang

12. Anda akan memiliki opsi menu baru, jadi klik di atasnya

function myFunction() {
  Browser.msgBox("Hello World!");
}

13. Klik Sisipkan Simbol dan Anda akan melihat simbol disisipkan di mana pun kursor Anda berada

Kiat Skrip Google Apps. Gunakan kelas Logger

Gunakan untuk menampilkan pesan teks ke file log, untuk membantu kode debug

File log ditampilkan secara otomatis setelah program selesai dijalankan, atau dengan masuk ke menu Eksekusi di opsi menu sidebar kiri (simbol keempat, di bawah simbol jam)

Sintaks dalam bentuknya yang paling dasar adalah

function myFunction() {
  Browser.msgBox("Hello World!");
}

Misalnya, tambahkan skrip ini ke file kode jendela editor Anda

function logTimeRightNow() {
  const timestamp = new Date();
  Logger.log(timestamp);
}

Jalankan skrip di jendela editor dan Anda akan melihatnya

Contoh dunia nyata dari pekerjaan saya sendiri

Saya hanya menggores permukaan dari apa yang mungkin menggunakan G. A. S. untuk memperluas pengalaman Google Apps

Berikut adalah beberapa proyek menarik yang pernah saya kerjakan

1) Aplikasi Spreadsheet/web yang terdiri dari formulir web khusus yang memasukkan data ke Google Spreadsheet (termasuk mengunggah gambar ke Drive dan menampilkan thumbnail di spreadsheet), lalu membuat salinan PDF dari data di spreadsheet dan secara otomatis mengirimkannya melalui email . Dan dengan semua data di Google Sheet master, Anda dapat melakukan analisis data, membuat dasbor yang menampilkan data secara waktu nyata, dan berbagi/berkolaborasi dengan pengguna lain

2) Dasbor yang terhubung ke akun Google Analytics, menarik data media sosial, memeriksa status situs web, dan mengirim tangkapan layar ringkasan melalui email sebagai PDF di akhir setiap hari

3) Template penilaian yang dapat mengirimkan skor/umpan balik kepada siswa melalui email dan Slack, dengan satu klik dari dalam Google Sheets. Baca lebih lanjut di artikel ini. Hemat waktu dengan integrasi Google Sheets, Slack, dan Email khusus ini

Perjalanan saya sendiri menuju Google Apps Script

Teman saya Julian, dari Measure School, mewawancarai saya pada Mei 2017 tentang perjalanan saya ke Apps Script dan pemikiran saya untuk memulai

Sumber Daya Skrip Google Apps

Untuk bacaan lebih lanjut, saya telah membuat daftar sumber informasi dan inspirasi ini

Kursus

Dokumentasi

Dokumentasi Google Resmi

Blog Pengembang Google Workspace

Komunitas

Pertanyaan Stack Overflow GAS

Di Tempat Lain Di Internet

Daftar sumber daya Apps Script yang sangat besar dan terbaru yang dihosting di GitHub

Untuk pertanyaan Javascript umum, saya merekomendasikan halaman tutorial JavaScript ini dari Sekolah W3 saat Anda memulai
​
Saat Anda lebih nyaman dengan dasar-dasar Javascript, maka saya merekomendasikan dokumentasi JavaScript yang komprehensif dari Mozilla

Imajinasi dan kesabaran untuk belajar adalah satu-satunya batasan untuk apa yang dapat Anda lakukan dan ke mana Anda dapat pergi dengan GAS. Saya harap Anda merasa terinspirasi untuk mencoba mengembangkan Spreadsheet dan Dokumen Anda serta mengotomatiskan tugas yang membosankan dan berulang tersebut

Mengapa saya tidak dapat menemukan editor skrip di Google Sheets?

Mengapa skrip Google saya tidak berfungsi?

Di mana skrip di Google Sheets?

Bagaimana cara melihat skrip Google saya?