Custom Domain untuk Web Google Apps Script: 3 Cara yang Bisa Dipakai

Web yang dibuat dengan Google Apps Script (GAS) punya alamat yang panjang dan sulit diingat, misalnya script.google.com/macros/s/AKfy.../exec. Sayangnya, Google tidak menyediakan cara langsung untuk menggantinya dengan domain sendiri seperti app.namaanda.com. Solusinya adalah menaruh "perantara" di depan web GAS Anda. Artikel ini menjelaskan 3 cara yang bisa dipakai, dari yang paling mudah sampai yang paling rapi.
Pilih cara yang sesuai
| Cara | Cocok untuk | Kelebihan | Kekurangan |
|---|---|---|---|
| 1. Cloudflare Worker sebagai perantara | Web yang hanya mengirim data (API) | Cepat dipasang, alamat rapi | Halaman tampilan GAS sering berantakan lewat perantara |
| 2. Tampilan dipindah, GAS jadi "dapur" saja | Aplikasi yang punya tampilan lengkap | Tampilan bebas, cepat, bisa muncul di Google | Perlu memisahkan kode tampilan dan kode GAS |
| 3. Ditempel di Google Sites | Halaman sederhana | Tanpa kode tambahan | Tampil di dalam bingkai, pengaturan tampilan terbatas |
Istilah yang perlu Anda tahu
- Cloudflare Worker: program kecil gratis di server Cloudflare. Di sini ia berperan seperti resepsionis: menerima tamu di alamat domain Anda, lalu meneruskan pesannya ke GAS.
- API: "jalur pesan" antar program. Isinya data mentah (biasanya format JSON), bukan halaman tampilan.
- Frontend: bagian yang dilihat pengunjung (halaman, tombol, formulir).
Cara 1: Worker sebagai perantara
Worker menerima kunjungan di domain Anda, meneruskannya ke alamat GAS, lalu mengembalikan jawabannya ke pengunjung. Cara ini paling cocok kalau web GAS Anda berupa API.
- Di Apps Script, deploy web Anda dengan akses Anyone (siapa saja), lalu salin alamat yang berakhiran
/exec. - Di dashboard Cloudflare, buat Worker baru, lalu ganti isinya dengan kode berikut. Ganti
ISI_ID_DEPLOY_ANDAdengan alamat GAS Anda:
const GAS = 'https://script.google.com/macros/s/ISI_ID_DEPLOY_ANDA/exec';
export default {
async fetch(request) {
const url = new URL(request.url);
const init = { method: request.method, redirect: 'follow' };
if (request.method === 'POST') {
init.body = await request.text();
init.headers = { 'Content-Type': 'text/plain;charset=utf-8' };
}
const res = await fetch(GAS + url.search, init);
const out = new Response(res.body, res);
out.headers.set('Access-Control-Allow-Origin', '*');
return out;
}
};Penjelasan singkat: kode ini meneruskan setiap kunjungan (beserta datanya) ke GAS, lalu mengirim balik jawaban GAS. Bagian redirect: 'follow' wajib ada, karena GAS selalu "melempar" jawabannya lewat alamat Google yang lain dulu.
- Buka Workers & Pages, pilih Worker Anda, masuk ke Settings > Domains & Routes, klik Add > Custom Domain, ketik misalnya
api.namaanda.com, lalu klik Add Custom Domain. Domain Anda harus sudah terdaftar di Cloudflare. Pengaturan alamat dan gembok HTTPS dibuat otomatis. - Coba buka
https://api.namaanda.com/?aksi=tesdi browser.
Cara 2: Tampilan dipindah, GAS jadi "dapur"
Ini cara paling rapi untuk aplikasi sungguhan. Bayangkan sebuah restoran: ruang makan (tampilan) dipindah ke tempat yang lebih bagus, yaitu Cloudflare Pages di domain Anda. GAS cukup jadi dapur yang menerima pesanan dan mengirim hasil dalam bentuk data.
// Code.gs: GAS hanya menerima dan mengirim data
function doPost(e) {
const data = JSON.parse(e.postData.contents);
const hasil = prosesData(data); // logika lama Anda
return ContentService
.createTextOutput(JSON.stringify(hasil))
.setMimeType(ContentService.MimeType.JSON);
}// Di halaman tampilan: mengirim pesanan ke GAS
const res = await fetch(GAS_URL, {
method: 'POST',
headers: { 'Content-Type': 'text/plain;charset=utf-8' },
body: JSON.stringify({ aksi: 'simpan', nama: 'Budi' })
});
const hasil = await res.json();Semua perintah google.script.run di halaman lama diganti dengan fetch seperti di atas. Format text/plain sengaja dipakai supaya browser tidak mengirim "permintaan izin" tambahan yang tidak bisa dijawab GAS. Domain Anda dipasang di Cloudflare Pages tempat halaman tampilan berada.
Cara 3: Ditempel di Google Sites
Buat situs di Google Sites, sisipkan web GAS lewat menu Sematkan (Embed), lalu hubungkan domain Anda dari pengaturan situs. Pengunjung melihat domain Anda, tetapi aplikasinya tampil di dalam bingkai, seperti foto dalam pigura.
Catatan penting
- Akses "Anyone" berarti siapa saja yang tahu alamatnya bisa mengirim data. Jangan menaruh kata sandi di halaman tampilan, dan selalu periksa data yang masuk di kode GAS.
- GAS punya batas harian dan kadang lambat. Untuk aplikasi yang ramai, pertimbangkan memindahkan data ke database sungguhan (lihat artikel migrasi Apps Script ke Cloudflare D1).
- Hindari nama data
cdansiddi alamat, karena dipakai Google sendiri dan bisa menimbulkan galat 405.
Sumber: Web apps, Google Apps Script dan Custom Domains, Cloudflare Workers.