Cara Pakai API AI di Google Sheets (Apps Script) Tanpa Server

Oleh Darus S Alfatah · 2025-09-15 · Tutorial · 7 menit

Cara Pakai API AI di Google Sheets (Apps Script) Tanpa Server

Catatan penulis: Apps Script punya batas waktu; pecah proses panjang menjadi beberapa panggilan yang lebih kecil.

Pendahuluan: AI di Spreadsheet

Google Sheets adalah alat favorit untuk mengelola data — dari daftar produk, konten media sosial, sampai laporan penjualan. Tahukah Anda bahwa Google Sheets bisa langsung memanggil API AI menggunakan Apps Script tanpa perlu server? Artikel ini menunjukkan caranya.

Langkah 1: Buka Apps Script

Di Google Sheets, buka menu Extensions → Apps Script. Hapus kode default dan ganti dengan kode berikut.

Langkah 2: Buat Fungsi AI

function BANKAIAI(prompt) {
  var apiKey = 'sk-bankai-xxxx';
  var url = 'https://bankai.web.id/api/chat/completions';

  var payload = {
    model: 'auto',
    messages: [
      { role: 'system', content: 'Kamu asisten spreadsheet.' },
      { role: 'user', content: prompt }
    ]
  };

  var options = {
    method: 'post',
    contentType: 'application/json',
    headers: { Authorization: 'Bearer ' + apiKey },
    payload: JSON.stringify(payload),
    muteHttpExceptions: true
  };

  var response = UrlFetchApp.fetch(url, options);
  var json = JSON.parse(response.getContentText());
  return json.choices[0].message.content;
}

Langkah 3: Gunakan di Sel

Simpan script, lalu kembali ke spreadsheet. Sekarang Anda bisa memakai rumus:

=BANKAIAI("Buatkan 5 caption Instagram tentang kopi")
=BANKAIAI("Terjemahkan ke bahasa Inggris: " & A2)
=BANKAIAI("Klasifikasikan sentimen dari teks ini: " & B2)

Contoh Penggunaan Praktis

  • Generate caption produk massal dari kolom nama produk.
  • Terjemahkan deskripsi ke banyak bahasa.
  • Klasifikasi ribuan baris feedback pelanggan.
  • Buat ringkasan dari data laporan.

Tips

  • Apps Script punya batas eksekusi — untuk data besar, proses bertahap.
  • Gunakan model murah untuk tugas ringan agar hemat token.

Google Sheets + BankAI = otomatisasi tanpa server yang super murah. Coba sekarang!

Apps Script: Panggilan Pertama

function tanyaAI(prompt) {
  const res = UrlFetchApp.fetch('https://bankai.web.id/api/v1/chat/completions', {
    method: 'post',
    contentType: 'application/json',
    headers: { Authorization: 'Bearer ' + PropertiesService.getScriptProperties().getProperty('API_KEY') },
    payload: JSON.stringify({
      model: 'auto',
      messages: [{ role: 'user', content: prompt }],
      max_tokens: 500
    }),
    muteHttpExceptions: true
  });
  return JSON.parse(res.getContentText()).choices[0].message.content;
}

Pola Batch yang Hemat

Panggilan per sel sangat lambat dan mahal. Lebih baik kirim satu batch berisi beberapa baris, minta model mengembalikan JSON array, lalu tulis hasilnya sekaligus. Gunakan trigger terjadwal (misalnya tiap jam) alih-alih memanggil API setiap kali sel berubah.

Batasan Apps Script

Apps Script punya batas waktu eksekusi dan kuota harian panggilan eksternal. Untuk volume besar, pertimbangkan mengirim data ke server Anda sendiri melalui webhook, lalu memprosesnya di sana. Simpan kunci di Script Properties agar tidak terlihat pengguna yang punya akses edit ke spreadsheet.

Membuat Fungsi Kustom yang Ramah Pengguna

Fungsi kustom di Google Sheets sebaiknya tidak memanggil API setiap kali sel dihitung ulang, karena Sheets menghitung ulang cukup sering. Simpan hasil di sel biasa atau di CacheService dengan masa berlaku beberapa jam. Untuk data yang berubah cepat, sediakan tombol "perbarui" yang menjalankan fungsi secara manual.

Tangani error dengan mengembalikan teks yang jelas, misalnya "kuota habis" atau "input terlalu panjang", bukan pesan teknis. Pengguna spreadsheet biasanya bukan developer dan perlu tahu apa yang harus dilakukan.

Studi Kasus: Analisis Ulasan Produk

Sebuah toko mengumpulkan ulasan dari marketplace ke spreadsheet. Skrip mengirim batch ulasan, meminta model mengelompokkan menjadi tema (kualitas, pengiriman, harga) dan menyertakan sentimen. Hasilnya ditulis ke kolom baru, lalu dibuat pivot table. Proses yang dulu butuh berjam-jam membaca manual kini selesai dalam beberapa menit.

Pastikan data pelanggan dianonimkan sebelum dikirim. Nama dan nomor telepon tidak diperlukan untuk analisis tema.

Menghindari Kuota Habis Karena Recalculate

Google Sheets menghitung ulang rumus setiap kali spreadsheet dibuka atau diedit. Fungsi kustom yang memanggil API akan dieksekusi berkali-kali tanpa disadari. Karena itu, simpan hasil ke sel biasa dan gunakan CacheService sebagai lapisan kedua.

function tanyaSekali(cacheKey, prompt) {
  const cache = CacheService.getScriptCache();
  const hit = cache.get(cacheKey);
  if (hit) return hit;
  const hasil = tanyaAI(prompt);
  cache.put(cacheKey, hasil, 21600); // 6 jam
  return hasil;
}

Membuat Menu Kustom

Tambahkan menu di spreadsheet agar pengguna bisa menjalankan proses tanpa membuka editor skrip. Menu ini juga tempat yang tepat untuk menaruh tombol "perbarui semua ringkasan" agar biaya terkendali oleh manusia, bukan oleh recalculate otomatis.

Batas dan Penanganan Error

Apps Script memiliki batas waktu eksekusi; proses panjang harus dipecah per batch dan dijadwalkan. Tangani error dengan menulis pesan di log sheet agar mudah ditelusuri.

Contoh batch kecil: Proses sepuluh baris per eksekusi agar tidak melewati batas waktu Apps Script, lalu lanjutkan dari baris berikutnya.

Pertanyaan yang Sering Diajukan

Apakah tutorial ini bisa diikuti pemula?

Ya. Langkah-langkahnya dijelaskan berurutan dan menyertakan contoh kode, jadi bisa diikuti pemula maupun developer berpengalaman.

Apakah endpoint BankAI kompatibel dengan library yang sudah saya pakai?

Ya, BankAI 100% kompatibel dengan standar OpenAI, sehingga library seperti OpenAI SDK, LangChain, dan tools sejenis bisa dipakai tanpa mengubah kode selain Base URL dan API key.

Di mana saya mendapatkan API key untuk mengikuti tutorial ini?

API key (dan Secret Token) didapat setelah daftar dan menyelesaikan pembayaran di dashboard BankAI.

Sumber & Referensi

Tentang penulis

Darus S Alfatah — Founder & Penulis

Darus S Alfatah adalah pendiri BankAI. Ia membangun dan mengoperasikan gateway API LLM yang melayani developer Indonesia, dan menulis tentang integrasi LLM, arsitektur gateway, serta cara memakai AI secara praktis dan hemat biaya. Setiap panduan diuji di lingkungan nyata — termasuk kode, konfigurasi, dan perhitungan token — sebelum diterbitkan, dan diperbarui ketika dokumentasi penyedia atau harga berubah.

Kebijakan editorial

Artikel terkait

🚀 Siap Pakai All in One API Key?

Daftar sekarang, top-up pakai QRIS, dan langsung ngoding pake ChatGPT, Claude, DeepSeek & semua AI dalam satu API Key!

🔑 DAFTAR SEKARANG · Harga