Mode Autentikasi

Gambaran Umum Mode Autentikasi

Perbandingan 5 mode autentikasi yang didukung oleh nuxt-gsheet.

nuxt-gsheet secara otomatis mendeteksi dan mendukung 5 mode autentikasi berbeda tergantung pada tingkat privasi spreadsheet dan kredensial yang kamu gunakan.

Matriks Perbandingan

Mode	Kredensial yang Dibutuhkan	Publik / Privat	Read	Write	Batas Kuota
`gviz`	Tidak ada	Publik Saja	Ya	Tidak	Tanpa Kuota (Google Query API)
`csv`	Tidak ada	Publik Saja	Ya	Tidak	Tanpa Kuota (Ekspor CSV Langsung)
`appscript`	URL Apps Script Web App	Publik & Privat	Ya	Ya	Gratis (Kuota Eksekusi Script)
`apikey`	GCP API Key	Publik Saja	Ya	Tidak	Batas Standar GCP API
`service-account`	JSON GCP Service Account	Privat & Publik	Ya	Ya	Batas Standar GCP API

Prioritas Deteksi Otomatis

Jika opsi auth tidak dideklarasikan secara eksplisit pada nuxt.config.ts, nuxt-gsheet mendeteksi mode yang aktif berdasarkan environment variable di .env dengan urutan prioritas berikut:

appscript: Terdeteksi jika GSHEET_APPSCRIPT_URL diisi.
apikey: Terdeteksi jika GSHEET_API_KEY diisi.
service-account: Terdeteksi jika GSHEET_CLIENT_EMAIL dan GSHEET_PRIVATE_KEY diisi.
gviz / csv: Mode fallback jika hanya GSHEET_SPREADSHEET_ID yang diisi.

useGSheetWrite

Manipulasi data spreadsheet menggunakan fungsi append, update, dan clear.

Mode GViz (Google Visualization API)

Query bergaya SQL untuk Google Sheets publik tanpa perlu API key.