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

Google AI Studio Cloud Firestore ve Firebase Authentication, web uygulamalarına otomatik olarak kurulup entegre edilebilir. Bu sayede, Google AI Studio'da kalıcı veri depolama ve güvenli oturum açma akışları içeren uygulamalar oluşturmak kolaylaşır. Yalnızca tek bir istem ve birkaç tıklamayla Google AI Studio aracının Firebase projesi oluşturmasına, uygulamanızı bu projeye bağlamasına ve tüm Cloud Firestore ile Authentication kodunu doğrudan uygulamanızda oluşturmasına olanak tanırsınız.

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

1. Fikrinizi açıklayın: Google AI Studio içinde yeni bir uygulama oluşturun ve veritabanı veya kimlik doğrulama gerektiren bir özelliği açıklayın. Örneğin, şu istemi girebilirsiniz: Build a shared to-do list app using Firebase as a backend.

2. Firebase entegrasyonunu etkinleştirin: Aracı tarafından istendiğinde Firebase'i etkinleştirin, projeniz için bir konum seçin ve Firebase Şartları'nı kabul edin. Ardından aracı, uygulamanızı Firebase projenize otomatik olarak bağlar ve uygulamanız için gerekli Cloud Firestore ve Authentication kodunu (/src/lib/firebase.ts dosyası ve firestore.rules dosyası dahil) oluşturur.

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

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

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

• Paylaşılan kota: Gruptaki tüm veritabanları, kullanım kotasını paylaşır (ayrıntılar için aşağıya bakın).
• 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 projenize bir faturalandırma hesabı 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, uygulamacık kimliğinizle eşleşir. Firebase konsolundaki Cloud Firestore veritabanları sayfasının Ad sütununda bu veritabanı kimliğini 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=free_tier_limited" \
   -d '{"free_tier_limited": false}'
   

Security Rules oluşturma

Google AI Studio aracısı, uygulamanızın mantığına göre otomatik olarak Firebase Security Rules oluşturur. Bu Security Rules, "varsayılan olarak reddet" şeklinde tasarlanmıştır. Bu nedenle, 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ı değişikliklerden haberdar olmaz ve bu değişiklikler sonraki uygulama yinelemeleri sırasında üzerine yazılır. 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 temsilcisinin, sahibi olduğunuz mevcut bir Google Cloud projede Cloud Firestore sağlamasını da isteyebilirsiniz. Aşağıdaki gibi bir istemle ajana mevcut projenizi kullanmasını söyleyin:

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.
• Cloud Firestore veritabanınıza bir hizmet hesabının erişmesine izin 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şme 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'deki 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.

Google Cloud / Firebase projem nasıl seçilir?

Firebase arka ucu ekle özelliğini kullandığınızda Google AI Studio aracısı, uygulamanızın arka uç hizmetleri (Cloud Firestore ve Firebase Authentication) için kullanılacak bir Firebase projesini otomatik olarak seçer.

Bunun yerine belirli bir projeyi kullanmak istiyorsanız istem kullanarak temsilciye bu projeyi kullanmasını söyleyebilirsiniz. Örneğin:

Use project PROJECT_ID for the Firebase backend.

Uygulamanızı daha sonra Cloud Run'da yayınlamaya karar verirseniz aynı projeyi kullanmaya devam etmeniz önemlidir. Farklı bir proje seçmek, arka ucunuz için kullanılan projeyle eşleşmeyeceğinden hatalara neden olur.

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.

Google AI Studio ile mobil uygulama (Android veya iOS gibi) oluşturabilir miyim?

Google AI Studio aracısı şu anda yalnızca web uygulamaları oluşturabilir. Desteklenen özellikler hakkında daha fazla bilgiyi Google AI Studio aracı belgelerinde bulabilirsiniz.

Ancak Google AI Studio tarafından oluşturulan uygulamalara, tüm web uygulamalarında olduğu gibi mobil cihazlarda yüklü tarayıcılardan mobil web uygulamaları olarak erişilebileceğini unutmayın.

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 geçin.
  • Google AI Studio aracısı Cloud Firestore kurulumunu sizin için yaptıysa veritabanınızı normal ücretli duruma geçirmek üzere 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, 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ı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 (/users/user1/messages/msg1 gibi) 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 sorunu AI Studio aracısına açıklayarak eksik üst dokümanları oluşturmasını sağlayabilirsiniz.

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

Cloud Firestore veritabanımın konumunu seçebilir miyim?

Evet. Firebase entegrasyonunu ilk kez Google AI Studio içinde etkinleştirdiğinizde Cloud Firestore veritabanınızın konumunu seçebilirsiniz.

Seçtiğiniz konumun, Google AI Studio aracısının söz konusu Firebase projesinde oluşturduğu tüm Cloud Firestore veritabanları için geçerli olduğunu unutmayın. Bu konum ayarlandıktan sonra söz konusu veritabanları için değiştirilemez.

Google, Google AI Studio'daki 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.

Google Cloud projeniz için "Herkese açık Google API anahtarı" hakkında Google Cloud adresinden bir e-posta aldım. Ne yapmanız gerekiyor?

Google Cloud'dan "Google Cloud projeniz için herkese açık Google API anahtarı" hakkında bir e-posta aldıysanız ve e-postada listelenen API anahtarı Firebase API anahtarınızsa API anahtarının kodunuza veya yapılandırma dosyalarınıza güvenli bir şekilde dahil edilebilmesi için aşağıdaki şartları karşıladığından emin olun. Google Cloud konsolundaki API'ler ve Hizmetler > Kimlik Bilgileri panelinde aşağıdakileri doğrulayabilirsiniz.

• Bu, Firebase uygulamanız ve yalnızca Firebase hizmetleri için kullandığınız API anahtarıdır. Bu tuşlar genellikle Browser key (auto created by Firebase) veya Android key (auto created by Firebase) ya da iOS key (auto created by Firebase) olarak adlandırılır.
• Anahtarın "API kısıtlamaları " izin verilenler listesinde gerekli tüm Firebase ile ilgili API'ler bulunur.
• "API kısıtlamaları" izin verilenler listesinde başka API yoktur. Özellikle listede olmamalıdır: Generative Language API.

Ayrıca, kullandığınız Firebase ürünleri için Firebase Security Rules ve App Check'i önerildiği şekilde kullandığınızdan emin olun.

Firebase için API anahtarları hakkında ayrıntılı bilgi edinebilir ve SSS listesini Firebase için API anahtarlarını kullanma ve yönetme hakkında bilgi başlıklı makalede bulabilirsiniz.