Catatan Harian Mas Andri

Silahkan digunakan dengan bijaksana

back

Panduan Mendapatkan Source Code Google Spreadsheet Al-Quran + Script API

22 April 2025 || 22:27:04 WIB || ClassyID

Berikut adalah petunjuk langkah demi langkah untuk mendapatkan dan menggunakan API Al-Quran Digital:

## Langkah 1: Mendapatkan Akses Al-Quran Digital
1. Kunjungi URL: https://s.id/requestAPIQuranSheet
2. Isikan informasi yang diminta:
   - Nama Lengkap
   - Email (harus menggunakan Gmail)
   - Nomor WhatsApp
   - Donasi (opsional, bisa dikosongkan)
3. Klik tombol Dapatkan Al-Quran Digital

## Langkah 2: Menerima Notifikasi
Setelah mengisi formulir, Anda akan menerima 2 notifikasi:
- Email ke alamat Gmail yang Anda daftarkan
- Pesan WhatsApp ke nomor yang Anda daftarkan

Kedua notifikasi tersebut berisi link Google Spreadsheet Al-Quran Digital.

## Langkah 3: Membuat Salinan Spreadsheet
1. Buka link Google Spreadsheet yang diterima dari email atau WhatsApp
2. Klik menu *File* > *Buat salinan*
3. Spreadsheet akan terbuka di tab baru dengan salinan milik Anda

## Langkah 4: Mengakses Apps Script
1. Pada Google Spreadsheet yang telah disalin, klik menu *Ekstensi* > *Apps Script*
2. Google Apps Script akan terbuka di tab baru dengan judul "API ALQURAN-DIGITAL"

## Langkah 5: Menyesuaikan ID Spreadsheet
1. Pada editor Apps Script, cari baris dengan kode:
   ```javascript
   const SPREADSHEET_ID = '';
   ```
2. Ganti `` dengan ID spreadsheet salinan Anda
   - ID spreadsheet dapat dilihat dari URL spreadsheet Anda:
   - Format: `https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit`

## Langkah 6: Deploy Apps Script
1. Klik tombol *Deploy* di pojok kanan atas
2. Pilih *New deployment*
3. Pilih tipe deployment *Web app*
4. Isi deskripsi (opsional)
5. Di bagian *Execute as*, pilih *Me*
6. Di bagian *Who has access*, pilih *Anyone*
7. Klik *Deploy*
8. Berikan izin yang diminta saat muncul prompt

## Langkah 7: Mendapatkan URL API
Setelah berhasil deploy, Anda akan mendapatkan URL web app dengan format:
```
https://script.google.com/macros/s//exec
```

URL ini adalah API Al-Quran Digital Anda yang siap digunakan.

## Langkah 8: Implementasi di Aplikasi Web
Selanjutnya Anda bisa mengintegrasikan API ini ke repository yang telah disediakan:

### Repository 1: Quran Visualization
1. Buka repository: https://github.com/classyid/quran-viz
2. Pada file `index.html`, cari baris ke 347
3. Ganti URL API dengan URL yang Anda dapatkan dari hasil deployment

### Repository 2: Quran Finder Web
1. Buka repository: https://github.com/classyid/quran-finder-web
2. Pada file `index.html`, cari baris ke 291
3. Ganti URL API dengan URL yang Anda dapatkan dari hasil deployment

Setelah mengganti link API pada kedua repository tersebut, aplikasi web akan terhubung dengan data Al-Quran Digital dari Google Spreadsheet Anda.

Semoga bermanfaat dan menjadi ladang amal jariyah!