Google AI Studio uygulamanıza Cloud Firestore ve Kimlik Doğrulama'yı ekleme

Google AI Studio, doğrudan Cloud Firestore ve Firebase Authentication ile entegre olarak kalıcı veriler ve güvenli oturum açma akışları içeren uygulamalar oluşturmanıza olanak tanır. Google AI Studio'da "Firebase arka ucu ekle" özelliğini kullandığınızda, aracı gerekli kodu oluşturur ve uygulamanızı bir Firebase projesine bağlar.

Genel bakış: Google AI Studio uygulamanıza arka uç ekleme

1. Fikrinizi açıklayın: Google AI Studio'da yeni bir uygulama oluşturun ve veritabanı veya kimlik doğrulama gerektiren bir özelliği açıklayın (örneğin, "Paylaşılan bir yapılacaklar listesi oluştur").

2. Firebase entegrasyonunu etkinleştirin: Firebase arka ucu ekle çipini seçin. Aracı, /src/lib/firebase.ts dosyası ve firestore.rules dosyası da dahil olmak üzere gerekli kodu oluşturur ve ardından uygulamanızı Cloud Firestore ile Firebase Authentication'e bağlar.

3. Dağıtma: Hazır olduğunda Paylaş > Yayınla seçeneğini kullanarak uygulamanızı Cloud Run'ya dağıtın.

Cloud Firestore için paylaşılan kotayı anlama

Cloud Firestore aracısı tarafından sağlanan tüm veritabanları, Firebase projenizdeki aynı veritabanı "grubuna" yerleştirilir.Google AI Studio Bu türlerin ortak özellikleri şunlardır:

• Paylaşılan kota: Gruptaki tüm veritabanları bir kullanım kotasını paylaşır (ayrıntıları aşağıda bulabilirsiniz).
• Hesap Cloud Billing gerekmez: Faturalandırma eklemeden uygulamanızı oluşturup test edebilirsiniz. Faturalandırmayı isteğe bağlı olarak ekleme hakkında ayrıntılı bilgiyi aşağıda bulabilirsiniz.
• Günlük sıfırlamalar: Günlük kota sınırına (örneğin, 50.000 okuma/gün) ulaşırsanız hizmet, gruptaki tüm veritabanları için duraklatılır ve ertesi gün Pasifik saatine göre gece yarısı civarında devam eder.

Paylaşılan kota grubundaki Cloud Firestore veritabanları aşağıdaki sınırları paylaşır:

(İsteğe bağlı) Daha fazla Cloud Firestore kotası almak için faturalandırma ekleyin

Uygulamanız ilgi görmeye başlarsa ve Cloud Firestore için ücretsiz sınırların ötesine geçmeniz gerekirse projenizi kullandıkça öde Blaze fiyatlandırma planına yükseltebilirsiniz.

1. Faturalandırma ekleyin (henüz yapmadıysanız): Firebase konsoluna gidin ve bir faturalandırma hesabını projenize bağlayın.

2. Veritabanını yükseltme: Cloud Firestore aracısı tarafından oluşturulan Google AI Studio veritabanları, fiyatlandırma planınızı yükselttikten sonra bile varsayılan olarak paylaşılan kotayı kullanmaya devam eder. Belirli bir veritabanı için tam ücretli ölçeklendirmeyi etkinleştirmek istiyorsanız curl komutunu kullanarak veritabanını manuel olarak gruptan çıkarmanız gerekir.

   • PROJECT_ID : Firebase proje kimliği. Bu kimliği Firebase konsolunun Proje Ayarları bölümünde bulabilirsiniz.
   • DATABASE_ID : Cloud Firestore veritabanı kimliği. Bu kimlik, applet kimliğinizle eşleşir. Bu veritabanı kimliğini Firebase konsolundaki Name (Ad) sütununda, Cloud Firestore veritabanları sayfasında bulabilirsiniz.

   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}'
   

Security Rules oluşturma

Uygulamanızın mantığına göre Google AI Studio otomatik olarak oluşturur.Firebase Security Rules Bu Security Rules,"varsayılan olarak reddetme" şeklinde tasarlanmıştır. Yani uygulamanızın son kullanıcıları yalnızca kendi verilerine erişebilir.

Security Rules değerini doğrudan Firebase konsolunda manuel olarak ayarlarsanız Google AI Studio aracısının değişikliklerden haberi olmayacağını ve sonraki uygulama yinelemeleri sırasında bu değişikliklerin üzerine yazılacağını unutmayın. Değişikliklerinizin korunmasını ve uygulamanızın mantığıyla uyumlu olmasını sağlamak için Google AI Studio aracısını kullanarak Firebase Security Rules ayarlarınızı yapmanızı öneririz.

Mevcut bir projeyi kullanma

Ayrıca Google AI Studio temsilcinin, Cloud Firestore sahibi olduğunuz mevcut bir Google Cloud projede kaynak sağlamasını da isteyebilirsiniz. Aşağıdaki gibi bir istemle mevcut projenizi kullanmasını isteyin:

Add Firestore to this app using project PROJECT_ID.

• Paylaşılan kota kullanılarak ilgili projede yeni bir Cloud Firestore veritabanı sağlanır.
• Firebase Authentication ile Google ile Oturum Açma yapılandırılır.
• Bir hizmet hesabına Cloud Firestore veritabanınıza erişim izni verilir. Google AI Studio adresinden yönetici erişimine izin vermek için ais-sandbox@PROJECT_ID.iam.gservice.com adlı yeni bir hizmet hesabına Cloud Firestore veritabanınıza erişim izni verilir. Bu hesap yalnızca Google AI Studio uygulamalarınızla ilişkilendirilmiştir.
• Sınırlamalar: Firebase projesinde zaten bir Cloud Firestore veritabanı varsa aracı ek bir veritabanı ekleyemez. Kullanmak için yeni ve boş bir proje oluşturmanız gerekir.

Firebase konsolunu kullanma

Uygulamanızın verilerini ve ayarlarını Firebase konsolunda görüntüleyebilirsiniz. Google AI Studio ile ilişkili projelerinize erişmek için şu adımları uygulayın:

1. Firebase konsoluna gidin ve AI Studio etiketli projeyi seçin.
2. Cloud Firestore'daki verilerinizi görüntülemek ve düzenlemek için sol gezinme bölmesinde Oluştur > Cloud Firestore Veritabanı'nı tıklayın. Authentication ayarlarınızı ve verilerinizi yapılandırmak için Oluştur > Authentication'ı tıklayın.

Sorun giderme ve SSS

Sık sorulan soruların yanıtlarını bulun ve Firebase'i Google AI Studio uygulamanızla entegre ederken sorunları nasıl çözeceğinizi öğrenin.

Hangi kimlik doğrulama yöntemleri desteklenir?

Google AI Studio aracısı, Firebase arka ucu ekle özelliğini kullandığınızda Google ile oturum açma özelliğini ayarlar. Ek yöntemler ayarlamak için bunları Firebase konsolunda etkinleştirin ve Google AI Studio aracısından kod tabanınızı güncelleme konusunda yardım isteyin.

firebase-blueprint.json dosyası nedir?

Bu, Google AI Studio aracısı tarafından uygulamanızın kod tabanını anlamak için kullanılan bir ara dosyadır. Bu dosyayı manuel olarak değiştirmeyin. Aksi takdirde aracı yanlış kod veya güvenli olmayan Security Rules oluşturabilir.

"Kota aşıldı" hatası alırsam ne yapmalıyım?

Cloud Firestore kota sınırına ulaşmak, uygulamanızın Cloud Firestore veritabanı paylaşılan kota grubu için günlük kullanım sınırına ulaştığı anlamına gelir. Bu sorunu çözmenin iki yolu vardır:

• 1. seçenek: Bekleyin: Kotalar her gün Pasifik saatine göre gece yarısı civarında sıfırlanır.
• 2. seçenek: Yükseltme: Kullandıkça öde Blaze fiyatlandırma planına yükseltin.
  • Google AI Studio aracısı sizin için Cloud Firestore kurulumunu yaptıysa veritabanınızı normal ücretli duruma geçirmek için Daha fazla Cloud Firestore kotası almak için faturalandırma ekleme başlıklı makalede açıklanan curl komutunu kullanmanız gerekir. Cloud Firestore manuel olarak ayarladıysanız curl komutunu çalıştırmanız gerekmez.

"Eksik veya yetersiz izinler" hatası alırsam ne yapmalıyım?

Bu hata, uygulamanız Cloud Firestore veritabanınıza veri okumaya veya yazmaya çalıştığında ancak istek Security Rules tarafından reddedildiğinde oluşur. Bu hata, Security Rules'nın mevcut kimlik doğrulama durumuna veya veri yoluna göre denenmekte olan işleme izin vermediğini gösterir. Google AI Studio aracısından Security Rules düzeltmesini istemek için Hatayı düzelt düğmesini tıklayın.

Google AI Studio uygulamamı sildiğimde Firebase arka uçuma ne olur?

Uygulamanızı Google AI Studio'da sildiğinizde bağlı Firebase projesi, Cloud Firestore veritabanı veya Firebase Authentication yapılandırmaları otomatik olarak silinmez.

Firebase arka ucu eklediyseniz Firebase konsoluna manuel olarak gidip projeyi silmeniz veya tüm verilerin ve yapılandırmaların kaldırıldığından emin olmak için tek tek kaynakları (ör. Cloud Firestore veritabanı örneği ve Authentication sağlayıcılar) temizlemeniz gerekir.

Google AI Studio aracısı, Cloud Firestore veritabanımdaki verileri silebilir veya düzenleyebilir mi?

Google AI Studio temsilcisi, gerekli arka uç kaynaklarını sağlamaya ve kod oluşturmaya yardımcı olmak için tasarlanmıştır Security Rules. Aracı, Cloud Firestore veritabanınızdaki veri girişlerini doğrudan silemez, düzenleyemez veya değiştiremez ancak bu işlemleri gerçekleştirmek için tasarlanmış kodu uygulamanıza yazabilir. Girişleri silme gibi veri yönetimi görevlerini gerçekleştirmek için Firebase konsolunda Cloud Firestore veritabanı sayfasına gidin.

Google Cloud kullanan bir kuruluşta çalışıyorum. Google AI Studio uygulamamı kuruluşumun Google Cloud ortamındaki mevcut bir projeye bağlayabilir miyim?

Firebase projenizin belirli bir Google Cloud kuruluş klasörüne yerleştirildiğinden emin olun:

1. Firebase projenizi önceden manuel olarak oluşturun.

2. Firebase arka uçunuzu Google AI Studio içinde ayarlarken aracıya mevcut projenizi kullanmasını söyleyin:

   Add Firestore to this app using project PROJECT_ID.
   

Firebase konsolunda neden belirli dokümanları bulamıyorum?

AI Studio aracısı, verileri önce üst dokümanı (user1) oluşturmadan iç içe yerleştirilmiş bir yola (ör. /users/user1/messages/msg1) kaydettiğinde olmayan üst doküman olarak bilinen bir doküman oluşturur. Bu belgeler Firebase konsolunda gösterilmez. Bu nedenle, Cloud Firestore veritabanınıza göz atarken bu belgeleri bulmak zor olabilir. Bu durum uygulamanızın çalışmasını etkilemese de eksik üst dokümanları oluşturması için yapay zeka aracısına sorunu açıklayabilirsiniz.

Daha fazla bilgi için Olmayan üst dokümanlar başlıklı makaleyi inceleyin.

Cloud Firestore veritabanımın konumu nasıl seçilir?

Şu anda Cloud Firestore veritabanınızın konumu, bulunduğunuz yere göre otomatik olarak seçilir ve değiştirilemez veya manuel olarak belirtilemez. Belirli bir konumu seçme özelliğini kullanmak istiyorsanız Google AI Studio'da Ayarlar > �Geri bildirim gönder'e giderek bize bildirin.

Google, Google AI Studio'da verilerimi (ör. kod ve istemler) nasıl kullanır?

Verilerinizin nasıl kullanıldığıyla ilgili ayrıntılar için Gemini API Ek Hizmet Şartları'nı inceleyin.