TutorialBagian 4 dari 12

Menyiapkan Layanan Gratis

Akun Google service, kunci AI Studio, dan e-mail pengirim — seluruhnya tanpa biaya.

Isi halaman ini

DIMETIL bersandar pada beberapa layanan yang seluruhnya memiliki tingkatan gratis. Halaman ini menuntun menyiapkannya satu per satu.

1. Akun layanan Google (untuk Spreadsheet & Drive)

Aplikasi membaca dan menulis Spreadsheet lewat akun layanan — semacam akun robot yang bekerja atas nama aplikasi.

  1. Buka https://console.cloud.google.com
  2. Buat proyek baru, beri nama misalnya dimetil-<daerah>
  3. Buka APIs & Services → Library, aktifkan dua ini:
    • Google Sheets API
    • Google Drive API
  4. Buka APIs & Services → Credentials
  5. Create Credentials → Service Account, beri nama, lalu buat
  6. Buka akun layanan yang baru dibuat → tab KeysAdd Key → Create new key → JSON
  7. Berkas JSON akan terunduh — simpan baik-baik

Dari berkas JSON itu Anda memerlukan dua nilai:

Isi JSONDisimpan sebagai
client_emailGOOGLE_SHEETS_CLIENT_EMAIL
private_keyGOOGLE_SHEETS_PRIVATE_KEY

2. OAuth untuk unggah ke Drive

Unggahan berkas memakai jalur terpisah agar berkasnya tersimpan pada Drive milik instansi, bukan pada penyimpanan akun layanan yang terbatas.

Pada Credentials, buat OAuth client ID bertipe Desktop app, lalu catat Client ID dan Client Secret. Refresh token diperoleh sekali lewat proses persetujuan.

NilaiDisimpan sebagai
Client IDGOOGLE_CLIENT_ID
Client SecretGOOGLE_CLIENT_SECRET
Refresh tokenGOOGLE_REFRESH_TOKEN

3. Kunci AI Studio (opsional)

Dipakai chatbot dan pembacaan dokumen otomatis. Aplikasi tetap berjalan tanpanya.

  1. Buka https://aistudio.google.com/apikey
  2. Tekan Create API key
  3. Pilih proyek tanpa penagihan, atau buat proyek baru
  4. Simpan sebagai GOOGLE_AI_API_KEY

4. E-mail pengirim

Dipakai mengirim pemberitahuan status kepada pemohon.

  1. Pakai akun Gmail instansi
  2. Aktifkan verifikasi dua langkah pada akun itu
  3. Buka Akun Google → Keamanan → Sandi aplikasi
  4. Buat sandi aplikasi baru, salin 16 huruf yang muncul
NilaiDisimpan sebagai
Alamat GmailGMAIL_EMAIL
Sandi aplikasiGMAIL_APP_PASSWORD

5. Supabase

Dibahas tersendiri pada halaman Menyiapkan Basis Data Supabase.

Menyimpan seluruh kunci

Buat berkas bernama .env.local di folder proyek, isi seperti ini:

bash
GOOGLE_SHEET_ID=...
GOOGLE_SHEETS_CLIENT_EMAIL=...@...iam.gserviceaccount.com
GOOGLE_SHEETS_PRIVATE_KEY="-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n"

GOOGLE_CLIENT_ID=...
GOOGLE_CLIENT_SECRET=...
GOOGLE_REFRESH_TOKEN=...

NEXT_PUBLIC_SUPABASE_URL=https://xxxx.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=...
SUPABASE_SERVICE_ROLE_KEY=...

GMAIL_EMAIL=...@gmail.com
GMAIL_APP_PASSWORD=...

GOOGLE_AI_API_KEY=...
NEXT_PUBLIC_BASE_URL=https://domain-anda.go.id
CRON_SECRET=teks-acak-panjang-bebas

Memastikan lengkap

Setelah aplikasi berjalan, buka Dashboard → Diagnostik Sistem. Halaman itu menyebutkan setiap variabel satu per satu beserta keadaannya — terisi atau belum — sehingga Anda tak perlu menebak mana yang tertinggal.