Menambahkan Cloud Firestore dan Authentication ke aplikasi Google AI Studio Anda

Google AI Studio terintegrasi langsung dengan Cloud Firestore dan Firebase Authentication, sehingga Anda dapat membuat aplikasi dengan data persisten dan alur login yang aman. Saat Anda menggunakan fitur "Tambahkan backend Firebase" di Google AI Studio, agen akan membuat kode yang diperlukan dan menghubungkan aplikasi Anda ke project Firebase.

Ringkasan: Menambahkan backend ke aplikasi Google AI Studio Anda

Jelaskan ide Anda: Buat aplikasi baru di Google AI Studio dan jelaskan fitur yang memerlukan database atau autentikasi (misalnya, "Buat daftar tugas bersama").

Tips: Gunakan Gemini 3 Flash untuk mendapatkan hasil terbaik.
Aktifkan integrasi Firebase: Pilih chip Tambahkan backend Firebase. Agen akan membuat kode yang diperlukan, termasuk file /src/lib/firebase.ts dan file firestore.rules, lalu menghubungkan aplikasi Anda ke Cloud Firestore dan Firebase Authentication.
Deploy: Setelah siap, gunakan opsi Bagikan > Publikasikan untuk men-deploy aplikasi Anda ke Cloud Run.

Memahami kuota bersama untuk Cloud Firestore

Semua database Cloud Firestore yang disediakan oleh agen di Google AI Studio ditempatkan dalam "grup" database yang sama di project Firebase Anda. Semua memiliki karakteristik berikut:

Kuota bersama: Semua database dalam grup berbagi kuota penggunaan (lihat detail di bawah).
Tidak memerlukan akun Cloud Billing: Anda dapat membangun dan menguji aplikasi tanpa menambahkan penagihan. Lihat detail di bawah tentang opsi menambahkan penagihan.
Reset harian: Jika Anda mencapai batas kuota harian (misalnya, 50 ribu pembacaan/hari), layanan akan dijeda untuk semua database dalam grup dan dilanjutkan pada hari berikutnya sekitar tengah malam Waktu Pasifik.

Database Cloud Firestore dalam grup kuota bersama memiliki batas berikut:

Metrik	Kuota
Data tersimpan	1 GiB total
Traffic keluar jaringan	10 GiB per bulan
Unit operasi tulis	40.000 penulisan per hari
Unit operasi baca	50.000 operasi baca per hari
Unit operasi update real-time	50.000 pembaruan per hari

(Opsional) Tambahkan penagihan untuk mendapatkan kuota Cloud Firestore yang lebih besar

Jika aplikasi Anda mendapatkan daya tarik dan Anda perlu melampaui batas tanpa biaya untuk Cloud Firestore, Anda dapat mengupgrade project ke paket harga Blaze bayar sesuai penggunaan.

Tambahkan penagihan (jika Anda belum melakukannya): Buka konsol Firebase dan tautkan akun penagihan ke project Anda.
Mengupgrade database: Secara default, database Cloud Firestore yang dibuat oleh agen Google AI Studio terus menggunakan kuota bersama bahkan setelah Anda mengupgrade paket harga. Untuk mengaktifkan penskalaan berbayar penuh untuk database tertentu, Anda harus memindahkannya secara manual dari grup menggunakan perintah curl.
- PROJECT_ID : Project ID Firebase; temukan ID ini di Project Settings di konsol Firebase.
- DATABASE_ID : ID database Cloud Firestore, yang akan cocok dengan ID applet Anda; temukan ID database ini di kolom Nama di halaman database Cloud Firestore di konsol Firebase.
```
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://firestore.googleapis.com/v1/projects/PROJECT_ID/databases/DATABASE_ID?updateMask=limited_free_tier" \
-d '{"limited_free_tier": false}'
```

Penting: Menautkan akun Cloud Billing tidak otomatis menghapus batas kuota bersama.

Kegagalan bersama: Jika kuota bersama habis, semua database dalam grup akan menampilkan error. Mereka tidak memiliki akses ke akun penagihan tertaut.
Penggunaan tambahan: Untuk mengaktifkan penggunaan tambahan bagi database tertentu, Anda harus memindahkan database tersebut dari grup kuota bersama menggunakan perintah curl yang diberikan. Tindakan ini akan mengonversi instance tersebut menjadi database berbayar reguler dengan semua penggunaan ditagih dengan tarif Cloud Firestore.
Mentransisikan database: Setelah database dipindahkan dari grup kuota bersama dan dikonversi menjadi instance berbayar reguler, Anda dapat membalikkan boolean di perintah curl untuk mengembalikannya ke grup kuota bersama. Perhatikan bahwa semua database dalam grup kuota bersama harus memiliki edisi yang sama dan berada di region yang sama.

Security Rules generasi

Google AI Studio otomatis membuat Firebase Security Rules berdasarkan logika aplikasi Anda. Security Rules ini dirancang untuk "menolak secara default", yang berarti pengguna akhir aplikasi Anda hanya dapat mengakses data yang mereka miliki.

Perhatikan bahwa jika Anda menyesuaikan Security Rules secara manual langsung di konsol Firebase, agen Google AI Studio tidak akan mengetahui perubahan tersebut, dan perubahan tersebut akan ditimpa selama iterasi aplikasi berikutnya. Sebaiknya gunakan agen Google AI Studio untuk menyesuaikan Firebase Security Rules guna memastikan perubahan Anda dipertahankan dan selaras dengan logika aplikasi Anda.

Menggunakan project yang sudah ada

Anda juga dapat meminta agen Google AI Studio untuk menyediakan Cloud Firestore ke project Google Cloud yang sudah ada dan Anda miliki. Instruksikan agen untuk menggunakan project yang sudah ada dengan perintah seperti:

Add Firestore to this app using project PROJECT_ID.

Database Cloud Firestore baru akan disediakan ke dalam project tersebut menggunakan kuota bersama.
Firebase Authentication dengan Login dengan Google akan dikonfigurasi.
Akun layanan akan diberi akses ke database Cloud Firestore Anda. Untuk mengizinkan akses administrator dari Google AI Studio, akun layanan baru bernama ais-sandbox@PROJECT_ID.iam.gservice.com akan diberi izin untuk mengakses database Cloud Firestore Anda. Akun ini hanya dikaitkan dengan aplikasi Google AI Studio Anda.
Batasan: Jika project Firebase sudah memiliki database Cloud Firestore, agen tidak akan dapat menambahkan database lain. Anda harus membuat project baru yang kosong untuk digunakan.

Menggunakan Firebase console

Anda dapat melihat data dan setelan aplikasi di Firebase console. Untuk mengakses project Anda yang terkait dengan Google AI Studio, ikuti langkah-langkah berikut:

Buka konsol Firebase dan pilih project berlabel AI Studio.
Di panel navigasi sebelah kiri, klik Build > Cloud Firestore Database untuk melihat dan mengedit data Anda di Cloud Firestore, atau klik Build > Authentication untuk mengonfigurasi setelan dan data Authentication Anda.

Pemecahan masalah dan pertanyaan umum (FAQ)

Temukan jawaban atas pertanyaan umum dan pelajari cara menyelesaikan masalah saat mengintegrasikan Firebase dengan aplikasi Google AI Studio Anda.

Metode autentikasi apa yang didukung?

Agen Google AI Studio menyiapkan Login dengan Google saat Anda menggunakan fitur Tambahkan backend Firebase. Untuk menyiapkan metode tambahan, aktifkan metode tersebut di konsol Firebase dan minta bantuan agen Google AI Studio untuk memperbarui codebase Anda.

Apa itu file `firebase-blueprint.json`?

Ini adalah file perantara yang digunakan oleh agen Google AI Studio untuk memahami codebase aplikasi Anda. Jangan mengubah file ini secara manual, karena dapat menyebabkan agen membuat kode yang salah atau Security Rules yang tidak aman.

Apa yang harus saya lakukan jika saya mendapatkan error "Kuota terlampaui"?

Mencapai batas kuota Cloud Firestore berarti aplikasi Anda telah mencapai batas penggunaan harian untuk grup kuota bersama database Cloud Firestore. Ada dua cara untuk mengatasi masalah ini:

Opsi 1: Tunggu: Kuota direset setiap hari sekitar tengah malam Waktu Pasifik.
Opsi 2: Upgrade: Upgrade ke paket harga Blaze bayar sesuai penggunaan.
- Jika agen Google AI Studio menyiapkan Cloud Firestore untuk Anda, Anda harus menggunakan perintah curl yang dijelaskan dalam Menambahkan penagihan untuk mendapatkan kuota Cloud Firestore yang lebih besar untuk memindahkan database Anda ke status berbayar reguler. Jika Anda menyiapkan Cloud Firestore secara manual, Anda tidak perlu menjalankan perintah curl.

Apa yang harus saya lakukan jika saya mendapatkan error "Izin tidak ada atau tidak memadai"?

Error ini terjadi saat aplikasi Anda mencoba membaca atau menulis data ke database Cloud Firestore, tetapi permintaan ditolak oleh Security Rules Anda. Hal ini menunjukkan bahwa Security Rules tidak mengizinkan operasi yang dicoba berdasarkan status autentikasi atau jalur data saat ini. Klik tombol Perbaiki error untuk meminta agen Google AI Studio mencoba memperbaiki Security Rules.

Apa yang terjadi pada backend Firebase saya saat saya menghapus aplikasi Google AI Studio?

Menghapus aplikasi di Google AI Studio tidak akan otomatis menghapus project Firebase, database Cloud Firestore, atau konfigurasi Firebase Authentication yang terhubung.

Jika Anda menambahkan backend Firebase, Anda harus membuka Firebase console secara manual dan menghapus project atau membersihkan setiap resource (seperti instance database Cloud Firestore dan penyedia Authentication) untuk memastikan semua data dan konfigurasi dihapus.

Dapatkah agen Google AI Studio menghapus atau mengedit data di database Cloud Firestore saya?

Agen Google AI Studio dirancang untuk membantu menyediakan sumber daya backend yang diperlukan serta membuat kode dan Security Rules. Meskipun agen itu sendiri tidak dapat menghapus, mengedit, atau memanipulasi entri data secara langsung dalam database Cloud Firestore Anda, agen tersebut dapat menulis kode ke dalam applet Anda yang dirancang untuk melakukan tindakan ini. Untuk melakukan tugas pengelolaan data, seperti menghapus entri, buka halaman database Cloud Firestore di konsol Firebase.

Saya tergabung dalam organisasi yang menggunakan Google Cloud; dapatkah saya menghubungkan aplikasi Google AI Studio saya ke project yang sudah ada dalam lingkungan Google Cloud organisasi saya?

Pastikan project Firebase Anda ditempatkan dalam folder organisasi Google Cloud tertentu:

Buat project Firebase Anda secara manual terlebih dahulu.
Saat menyiapkan backend Firebase di Google AI Studio, instruksikan agen untuk menggunakan project yang ada:
```
Add Firestore to this app using project PROJECT_ID.
```

Mengapa saya tidak dapat menemukan dokumen tertentu di konsol Firebase?

Jika agen AI Studio menyimpan data ke jalur bertingkat (seperti /users/user1/messages/msg1) tanpa membuat dokumen induk terlebih dahulu (user1), agen tersebut akan membuat apa yang disebut sebagai dokumen induk yang tidak ada. Dokumen ini tidak ditampilkan di konsol Firebase, sehingga sulit ditemukan saat menjelajahi database Cloud Firestore. Meskipun tidak memengaruhi cara aplikasi Anda berjalan, Anda sering kali dapat menjelaskan masalah tersebut kepada agen AI Studio untuk memintanya membuat dokumen induk yang hilang.

Untuk mengetahui detail selengkapnya, lihat Dokumen induk yang tidak ada.

Bagaimana lokasi untuk database Cloud Firestore saya dipilih?

Saat ini, lokasi untuk database Cloud Firestore Anda dipilih secara otomatis berdasarkan lokasi Anda, dan tidak dapat diubah atau ditentukan secara manual. Jika Anda ingin kemampuan untuk memilih lokasi tertentu, beri tahu kami dengan membuka Setelan > Kirim masukan di dalam Google AI Studio.

Bagaimana cara Google menggunakan data saya (misalnya, kode dan perintah) di Google AI Studio?

Lihat Persyaratan Layanan Tambahan Gemini API untuk mengetahui detail tentang cara data Anda digunakan.