Web Service API JSON: Validasi Parameter dan Penyimpanan ke Google Sheets

Eksperimen kedua kali ini melanjutkan eksperimen sebelumnya untuk mulai menangani parameter-parameter tambahan dari user dan data-data yang disimpan di Google Sheets.

BAHAN BAKU

Untuk mengimplementasikan eksperimen kedua ini perlu dipersiapkan beberapa hal:

1. Eksperimen ini kelanjutan dari eksperimen sebelumnya yang harus anda pahami dulu sebelum melajutkan ke eksperimen ini.
2. Satu file Google Sheets yang telah di-publish dalam bentuk web, simak caranya di artikel ini.
3. ID dari Google Sheets tersebut, cara mendapatkan ID silahkan simak dalam artikel ini.
4. Satu file Apps Script, anda bisa menyimak cara membuatnya dan deployment Web Apps di artikel ini.
5. Script eksperimen ini yang dapat unduh atau salin dari repository.
6. ID User anda sebagai admin bot yang akan digunakan untuk menampung keterangan error bila terjadi kendala, gunakan @simrsinfobot untuk mengetahui ID User anda.

PARAMETER REQUEST

Misalkan dalam registrasi online user perlu menyertakan biodatanya, data-data yang diperlukan tersebut dijadikan parameter-parameter yang nantinya dilampirkan atau disisipkan bersamaan dengan datangnya request melalui gerbang URL Web Apps.

Berikut contoh data-data yang dikirimkan user yang akan menjadi parameter-parameter lampiran dalam request user:

First Name: John
Last Name: Doe
Username: johndoe

Cara melampirkan parameter ke dalam request ada di sisi client yang menjadi urusan user, Web Apps hanya menerima dan memilah lampiran parameter tersebut dari request SiLiKiDi

Parameter Dalam Query URL HTTP GET

Bila user mengirimkan request melalui HTTP GET maka parameter-parameter tersebut akan dituliskan menempel di akhir URL Web Apps anda. Misalkan URL Web Apps anda:

https://script.google.com/macros/s/.../exec

Maka notasinya URL Web Apps yang disertai parameter dalam pengiriman via GET akan tampak sebagai berikut:

https://script.google.com/macros/s/.../exec?firstname=John&lastname=doe&username=johndoe

Ciri khas pembeda parameternya dapat anda amati dari tanda berikut:

• Diawali dengan tanda tanya ?
• Tiap parameter dipisahkan dengan ampersand &
• Nama field/key dengan nilainya dipisahkan tanda sama dengan =

Perlu anda ingat aturan penulisan dalam URL tidak mengenal spasi dan harus diencoding ke dalam HTTP Encode agar karakter khusus yang bisa dikirimkan tanpa masalah melalui protokol HTTP GET.

Anda bisa mempelajari lebih lanjut tentang aturan dan enkoding HTTP ini di sumber online SiLiKiDi

Parameter Dalam HTTP POST

Parameter dalam HTTP POST tidak vulgar terlihat dituliskan secara tekstual sehingga hanya bisa diketahui dari sisi scripting.

Berikut adalah contoh letak parameter dalam pengiriman via POST yang dalam platform Apps Script ada di properti payload:

let urlWebApps = "https://script.google.com/macros/s/1234567890/exec";
let dataRequest = {
    method: "post",
    payload: {
      firstname: "John",
      lastname: "Doe",
      username: "johndoe"
    }
};
UrlFetchApp.fetch( urlWebApps, dataRequest );