Cara Menyambungkan Google Sheets ke Aplikasi Anda

Untuk menyambungkan Google Sheets ke aplikasi anda, aktifkan Google Sheets API dalam projek Google Cloud, cipta akaun perkhidmatan, kongsikan hamparan kerja dengan alamat e-mel akaun perkhidmatan itu, dan simpan kuncinya sebagai rahsia di bahagian pelayan. Pelayan anda kemudian boleh membaca baris dengan spreadsheets.values.get dan menambah baris dengan spreadsheets.values.append. Jika pengguna perlu menyambungkan hamparan kerja mereka sendiri, gunakan OAuth, dan jika hamparan kerja itu sepenuhnya awam, kunci API yang ringkas sudah memadai untuk membaca.

Panduan ini meliputi kaedah mana yang sesuai, panggilan yang anda perlukan, kuota dan perangkap, serta contoh gesaan untuk pembina aplikasi AI. Butiran Google adalah daripada dokumentasi pembangun Google setakat September 2026.

Kenapa perlu menyambungkan hamparan kerja

Sebab yang biasa:

• Kekalkan aliran kerja pasukan. Kakitangan terus menyunting senarai harga atau jadual dalam Sheets; aplikasi memaparkannya.
• Kumpul data di tempat orang sudah melihat. Pendaftaran baharu, pesanan atau jawapan borang tiba sebagai baris.
• Pelaporan. Eksport data aplikasi ke hamparan kerja untuk orang yang bekerja dengan hamparan kerja setiap hari.
• Batu loncatan. Mulakan dari hamparan kerja, kemudian beralih ke pangkalan data yang betul. Lihat cara menukar hamparan kerja menjadi aplikasi.

Pilih cara aplikasi anda log masuk ke Google

Panduan kelayakan Google menerangkan tiga jenis:

Bagi kebanyakan aplikasi, akaun perkhidmatan ialah pilihan yang betul: satu set kelayakan, dimiliki oleh anda, dengan akses hanya kepada hamparan kerja yang anda kongsikan secara jelas dengannya.

Langkah demi langkah dengan akaun perkhidmatan

1. Cipta atau pilih projek Google Cloud dan aktifkan Google Sheets API.
2. Cipta akaun perkhidmatan dan kunci untuknya. Kunci ialah fail JSON; layannya seperti kata laluan.
3. Kongsikan hamparan kerja dengan alamat e-mel akaun perkhidmatan, sebagai Viewer untuk baca sahaja atau Editor untuk menulis. Panduan Google menyatakan ini dilakukan melalui skrin perkongsian biasa.
4. Simpan kunci sebagai rahsia di pelayan anda, contohnya GOOGLE_SERVICE_ACCOUNT_JSON, serta ID hamparan kerja (rentetan panjang dalam URL hamparan kerja) sebagai SHEET_ID.
5. Panggil API dari pelayan menggunakan pustaka klien Google untuk bahasa anda.
6. Simpan bacaan dalam cache jika ramai pelawat melihat data yang sama, supaya anda tidak mencapai had kuota.

Panggilan yang akan anda gunakan

Daripada panduan Google untuk membaca dan menulis nilai:

Julat menggunakan notasi A1. Google menyatakan bahawa julat tanpa nama hamparan, seperti A1:B2, digunakan untuk helaian pertama, jadi namakan tab secara jelas untuk mengelak kejutan apabila seseorang menyusun semula tab.

RAW vs USER_ENTERED

Penulisan memerlukan valueInputOption:

• RAW menyimpan tepat apa yang anda hantar, sebagai teks. =1+2 disimpan sebagai teks =1+2.
• USER_ENTERED melayan input seolah-olah ditaip dalam Sheets: tarikh menjadi tarikh dan =1+2 menjadi formula.

Jika anda menulis teks yang pengguna taip dalam aplikasi anda, gunakan RAW. Dengan USER_ENTERED, seseorang boleh menghantar formula yang akan dijalankan apabila rakan sekerjanya membuka hamparan kerja.

Kuota dan ralat

Setakat September 2026, halaman had Sheets API Google menyenaraikan:

Tiada had harian selagi anda kekal dalam kuota seminit. Jika melebihi, ralat 429: Too many requests dikembalikan, dan Google mengesyorkan backoff eksponen terpotong: tunggu lebih lama selepas setiap percubaan yang gagal, dengan kelewatan rawak, sehingga maksimum. Permintaan tunggal yang mengambil lebih daripada 180 saat akan tamat masa.

Dalam amalan: jangan panggil API pada setiap paparan halaman. Simpan data hamparan kerja dalam cache selama sekurang-kurangnya seminit, gabungkan bacaan dengan batchGet, dan gabungkan penulisan jika boleh.

Pilihan dan pertukaran

Bagi apa-apa yang mempunyai ramai pengguna atau data sensitif, pangkalan data ialah sumber kebenaran yang lebih baik. Lihat apa itu pangkalan data.

Gesaan untuk pembina AI anda

Membaca hamparan kerja:

Papar tab "Menu" daripada Google Sheet kami pada halaman menu. Gunakan Google Sheets API dari pelayan dengan akaun perkhidmatan yang kunci JSONnya ada dalam rahsia GOOGLE_SERVICE_ACCOUNT_JSON, dan ID hamparan kerja dalam SHEET_ID. Baca julat Menu!A2:D (nama, penerangan, harga, kategori). Simpan hasilnya dalam cache selama 5 minit. Jika API gagal, papar versi cache terakhir. Jangan sekali-kali hantar kunci ke pelayar.

Menulis baris:

Apabila seseorang menghantar borang hubungi, simpan ke pangkalan data kami dan tambah baris ke tab "Leads" (tarikh, nama, e-mel, mesej) menggunakan spreadsheets.values.append dengan valueInputOption RAW. Jika Google memulangkan 429, cuba semula dengan backoff eksponen; jika masih gagal, simpan lead dalam pangkalan data dan cuba lagi kemudian.

Kesilapan biasa

• Lupa berkongsi hamparan kerja dengan alamat e-mel akaun perkhidmatan. API kemudian memulangkan ralat kebenaran walaupun kuncinya betul.
• Kunci dalam bahagian hadapan atau repositori. Kunci JSON memberi akses kepada setiap hamparan kerja yang dikongsi dengannya. Lihat cara memastikan kunci API selamat.
• Menggunakan USER_ENTERED untuk input pengguna, yang membenarkan suntikan formula.
• Memanggil API pada setiap permintaan dan mencapai had kuota seminit pada lonjakan trafik pertama.
• Bergantung pada kedudukan lajur. Seseorang memasukkan lajur dan aplikasi membaca data yang salah. Baca baris pengepala dan petakan mengikut nama, atau kunci pengepala.
• Berkongsi hamparan kerja lebih luas daripada yang perlu. "Sesiapa sahaja yang mempunyai pautan" menjadikannya awam.
• Menggunakan hamparan kerja sebagai pangkalan data berbilang pengguna. Penulisan serentak dan kebenaran yang hilang menyebabkan data hilang atau bocor.

Senarai semak

• Sheets API diaktifkan; akaun perkhidmatan dicipta
• Hamparan kerja dikongsi dengan e-mel akaun perkhidmatan pada peranan terendah yang diperlukan
• Kunci dan ID hamparan kerja disimpan sebagai rahsia di pelayan
• Semua panggilan dibuat dari pelayan
• Nama tab digunakan dalam julat
• RAW digunakan untuk teks yang diberikan pengguna
• Bacaan disimpan dalam cache; 429 dikendalikan dengan backoff
• Aplikasi berfungsi dengan baik jika Sheets tidak tersedia
• Sumber kebenaran telah diputuskan

Google Sheets dalam Mythex

Mythex mempunyai dua cara berbeza untuk bekerja dengan Sheets. Penyambung memautkan akaun Google anda ke Mythex supaya ejen boleh menggunakannya semasa anda membina, contohnya membaca hamparan kerja untuk membina papan pemuka daripadanya; dokumentasi menyatakan bahawa kelayakan kekal dengan perkhidmatan sambungan Mythex dan tidak pernah masuk ke dalam kod anda (lihat Penyambung, dan luluskan setiap kebenaran yang diminta Google). Bagi aplikasi yang diterbitkan untuk membaca atau menulis hamparan kerja dengan sendirinya, laluan yang boleh dipercayai ialah yang diterangkan dalam panduan ini: kunci akaun perkhidmatan disimpan sebagai rahsia projek dan panggilan Sheets API dari pelayan anda, seperti dalam Integrate any API. Jika anda sudah melebihi kemampuan hamparan kerja, minta ejen memindahkan data ke pangkalan data projek dan bina papan pemuka di atasnya.

Soalan lazim