Google AI Studio uygulamanıza Firebase'i ekleme

Google AI Studio'daki oluşturma modu, Cloud Firestore ve Firebase Authentication'ı web uygulamalarına otomatik olarak kurup entegre edebilir. Bu sayede, kalıcı veri depolama ve güvenli giriş akışları içeren uygulamalar oluşturmak kolaylaşır. Tek bir istem ve birkaç tıklamayla Google AI Studio aracısı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.

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: Görünen kartta kurulumunuzu yapılandırın:

   1. Projeyi veya konumu özelleştirme (isteğe bağlı): Ayarlar simgesini settings tıklayın, ardından kullanmak istediğiniz konumu veya Google Cloud projeyi seçin.

   2. Seçiminizi onaylayın: Devam etmek için Firebase'i etkinleştir düğmesini tıklayın.

   Ardından aracı, Firebase projenizde geçerli Firebase hizmetlerini otomatik olarak ayarlar, uygulamanızı Firebase projenize bağlar ve geçerli Firebase kodunu ve yapılandırma dosyalarını oluşturur:

   • Web uygulamaları:

     • Olası hizmetler: Cloud Firestore, Authentication ve Firebase Security Rules
     • Dosyalar /src/lib/firebase.ts ve firestore.rules içerir.

3. Dağıtma: Hazır olduğunda Paylaş > Yayınla seçeneğini kullanarak web uygulamanızı Cloud Run'ya dağıtın. Uygulamanız, kurulum sırasında seçtiğiniz projeye otomatik olarak dağıtılır.

   Uygulamanızı paylaşmadan, dağıtmadan veya yayınlamadan önce yapay zekayla üretilen Firebase Security Rules incelediğinizden de emin olun.

Geliştirme sırasında bir uygulamaya Firebase ekleme

Google AI Studio üzerinde çalıştığınız bir uygulamaya Firebase entegrasyonunu eklemek isterseniz yineleme aşamasında aşağıdaki seçeneklerden birini kullanarak bunu istediğiniz zaman yapabilirsiniz:

• Ajanla konuşma: Ajana, veritabanı veya kimlik doğrulama gerektiren bir özellik eklemesini söyleyin (ör. Add a Firestore database to this app).
• Ayarlar menüsünü kullanma: Ayarlar > Entegrasyonlar'a gidin ve Firebase Firestore & Auth kutusunu tıklayın.

Her iki seçenek de Firebase entegrasyonu kurulum akışını başlatır. Bu akışta, genel bakışta açıklandığı gibi bir proje seçebilir, arka uç konumunuzu yapılandırabilir ve uygulamanız için entegrasyonu etkinleştirebilirsiniz.

Entegrasyon etkinleştirildikten sonra Ayarlar > Entegrasyonlar'a gidip Firebase Firestore & Auth kutusunu tıklayarak proje, konum, uygulama destek e-postası ve veritabanı kimliği dahil olmak üzere yapılandırmayı istediğiniz zaman inceleyebilirsiniz.

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

Uygulamanızı ne zaman oluşturduğunuza ve hesabınızın uygunluğuna bağlı olarak veritabanlarınız Google Cloud Başlangıç Katmanı projesinde veya standart bir projede barındırılabilir. Ancak her iki durumda da Cloud Firestore Google AI Studio aracısı tarafından sağlanan tüm veritabanları, projenizdeki aynı "Yapay zeka paylaşılan kotası" veritabanı grubuna yerleştirilir. Bu uygulamaların tümünde şu özellikler bulunur:

• Paylaşılan kota: Gruptaki tüm veritabanları bir kullanım kotasını paylaşır (ayrıntıları aşağıda bulabilirsiniz).
• Cloud Billing hesabı 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 Saati'ne göre gece yarısı civarında devam ettirilir.

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şlar ve Cloud Firestore için ücretsiz sınırların ötesine geçmeniz gerekirse Firebase projenizi kullandıkça öde Blaze fiyatlandırma planına yükselten faturalandırma özelliğini ekleyebilirsiniz.

Nano Banana'yı kullanmak gibi farklı nedenlerle projenize faturalandırma eklemiş olabilirsiniz. Bu durumda projeniz zaten Blaze fiyatlandırma planındadır ve doğrudan Veritabanını yükseltme adımına geçebilirsiniz.

1. Adım: Faturalandırma ekleyin (henüz yapmadıysanız).

Faturalandırma ayarlarını doğrudan Google AI Studio içinde yapabilirsiniz.

1. Google AI Studio bölümünde Projeler sayfasına gidin.
2. Yükseltmek istediğiniz projenin yanındaki Faturalandırma ayarlarını yap'ı tıklayın.
3. Ülkenizi seçmek, şartları kabul etmek ve ödeme yöntemi eklemek veya mevcut bir faturalandırma hesabı seçmek için ekrandaki talimatları uygulayın. Ayrıca, ön ödeme yapmanız da istenebilir (bu ödeme, Firebase ve Google Cloud hizmetlerinin kullanımına dahil değildir).

2. adım: Veritabanını yükseltin

Faturalandırma bilgileri eklendikten sonra bile Google AI Studio aracısı tarafından oluşturulan Cloud Firestore veritabanları, paylaşılan kota grubunda kalır. Belirli bir veritabanı için tam ücretli ölçeklendirmeyi etkinleştirmek üzere veritabanını manuel olarak yükseltmeniz gerekir.

1. Firebase Console'a gidin ve yükseltmek istediğiniz veritabanını içeren projeyi seçin.
2. Soldaki gezinme bölmesinde Databases & Storage > Firestore'a (Veritabanları ve Depolama > Firestore) gidin.
3. Projeniz birden fazla Cloud Firestore veritabanı örneği içeriyorsa yükseltmek istediğinizi seçin.
4. Sayfanın üst kısmına yakın bir yerde, veritabanının yapay zeka paylaşılan kota sınırlarına tabi olduğunu belirten bir banner bulun. Veritabanını yükseltmek için Veritabanını yükselt > Kullandıkça öde planına yükselt'i tıklayın.Bu banner'ı görmüyorsanız veritabanı Google AI Studio aracısı tarafından oluşturulmamış ve paylaşılan kota grubunun bir parçası değil veya zaten yükseltilmiştir.

Paylaşılan kotayı devre dışı bırakıp veritabanınız için kullandıkça öde faturalandırmayı etkinleştirme değişikliği birkaç dakika içinde geçerli olacaktır.

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. 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ı 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 Firebase Security Rules ayarlarınızı düzenlemek üzere Google AI Studio aracını kullanmanızı öneririz.

Mevcut bir projeyi kullanma

Firebase entegrasyonunu ilk kez etkinleştirdiğinizde, isteğe bağlı olarak sahip olduğunuz mevcut bir Google Cloud projesini seçebilirsiniz:

1. Açılan kartta Ayarlar simgesini settings tıklayın.
2. Projenizi seçin ve Firebase'i etkinleştir'i tıklayın.

Uygulamanızı yinelediğinizde, aşağıdaki gibi bir istemle temsilciye farklı bir proje kullanmasını da söyleyebilirsiniz:

Add Firestore to this app using project PROJECT_ID.

Bir proje seçtiğinizde aşağıdaki işlemler gerçekleşir:

• 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 üzerinden 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şkilendirilir.
• Sınırlamalar: Firebase projesinde zaten bir Cloud Firestore veritabanı varsa aracı ek bir veritabanı ekleyemez. Kullanmak için farklı bir proje seçmeniz veya 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 Firebase projesine erişmek için şunları yapın:

1. Firebase Konsolu'na gidin ve AI Studio etiketli projeyi seçin.

2. Soldaki gezinme bölmesinde projenizde etkinleştirilen hizmetleri inceleyin:

   • Depolanan Cloud Firestore verilerinizi görüntülemek ve düzenlemek için Veritabanları ve Depolama > Firestore'a gidin.
   • Authentication ayarlarını ve verilerini görüntülemek veya yapılandırmak için Güvenlik > Kimlik Doğrulama'ya gidin.

Sorun giderme ve SSS

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

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

Bir uygulama için Firebase arka ucu istediğinizde, gösterilen kartta isteğe bağlı olarak bir konum ve proje seçebilirsiniz:

• Projeyi veya konumu özelleştirin (isteğe bağlı): Ayarlar simgesini settings tıklayın, bir konum veya kullanmak istediğiniz Google Cloud projeyi seçin ve ardından Firebase'i etkinleştir'i tıklayın.

Şunları unutmayın:

• Veritabanı konumu kalıcıdır: Veritabanınız için bir konum seçtikten sonra bu projede konumu değiştiremezsiniz. Bu seçim, diğer arka uç hizmetleri için varsayılan olarak kullanılır.
• Proje tutarlılığı: Sorunsuz bir entegrasyon sağlamak için Google AI Studio hem arka uç hem de dağıtımınız için otomatik olarak aynı projeyi kullanır. Aynı uygulama içindeki farklı hizmetler için farklı projeler kullanamazsınız.

Hangi kimlik doğrulama yöntemleri desteklenir?

Google AI Studio temsilcisi, kurulum yapmanızı veya oturum açma ekranı oluşturmanızı istediğinizde Google ile oturum açma özelliğini kurar. Authentication Uygulamanıza ek oturum açma yöntemleri eklemek için:

1. Firebase konsolunda Güvenlik > Kimlik doğrulama > Oturum açma yöntemi sayfasına gidin, ve istediğiniz oturum açma yöntemlerini yapılandırın.

2. Google AI Studio bölümüne geri dönün ve Google AI Studio temsilcisinden kod tabanınızı yeni oturum açma yöntemiyle güncelleme konusunda yardım isteyin.

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

Google AI Studio aracısı hem web uygulamaları hem de Android uygulamaları oluşturmayı destekler.

Ancak Firebase entegrasyonunun (Cloud Firestore ve Authentication ekleme) şu anda Android uygulamaları için değil, yalnızca web uygulamaları için desteklendiğini unutmayın. Android uygulaması geliştiriyorsanız bu hizmetlere ihtiyacınız varsa Firebase'i manuel olarak entegre etmeniz gerekir.

Google AI Studio'da iOS uygulamaları oluşturma desteklenmez. Ancak, tüm web uygulamaları gibi, Google AI Studio tarafından oluşturulan web uygulamalarına da mobil cihazlarda (iOS dahil) yüklü tarayıcılardan mobil web uygulamaları olarak erişilebilir.

Android uygulamaları oluşturma hakkında daha fazla bilgiyi Google AI Studio belgelerinde bulabilirsiniz.

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 Saati'ne 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 StudioAgent kurulumuCloud Firestore sizin için yapıldı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 Veritabanını yükselt düğmesini kullanmanız gerekir. Cloud Firestore manuel olarak ayarladıysanız Veritabanını yükselt düğmesini kullanmanı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 öğelerinin mevcut kimlik doğrulama durumuna veya veri yoluna göre denenmekte olan işleme izin vermediğini gösterir. Google AI Studio aracısının Security Rules'ı düzeltmeye çalışmasını sağlamak 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 temsilcisi, Cloud Firestore veritabanımdaki verileri silebilir veya düzenleyebilir mi?

Google AI Studio aracısı, gerekli arka uç kaynaklarının sağlanmasına ve kod oluşturulmasınaSecurity Rules yardımcı olmak için tasarlanmıştır. Ajanın kendisi Cloud Firestore veritabanınızdaki veri girişlerini doğrudan silemez, düzenleyemez veya değiştiremez ancak uygulamanıza bu işlemleri gerçekleştirmek üzere tasarlanmış kodlar yazabilir. Girişleri silme gibi veri yönetimi görevlerini gerçekleştirmek için Firebase konsolunda Veritabanları ve Depolama > Firestore sayfasına gidin.

Google Cloud kullanan bir kuruluşun üyesiyim. Google AI Studio uygulamamı kuruluşumun Google Cloud ortamındaki mevcut bir projeye bağlayabilir miyim?

Evet. Firebase projenizin Google Cloud kuruluş klasörünüzde olduğundan emin olun ve ardından aşağıdaki yöntemlerden birini kullanarak projenizi bağlayın:

• Etkinleştirme sırasında: Firebase entegrasyonunu ilk kez Google AI Studio bölümünde etkinleştirirken görünen kartta mevcut projenizi seçin. Ayarlar simgesini settings tıklayın ve projenizi seçin.

• Yineleme sırasında: Firebase'i zaten etkinleştirdiyseniz veya projeleri daha sonra değiştirmek istiyorsanız aracıyı mevcut projenizi kullanmaya yönlendirebilirsiniz. Örneğin:

    Add Firestore to this app using project PROJECT_ID.
  

Firebase konsolunda belirli belgeleri neden 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 AI Studio 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 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.

Cloud Firestore veritabanını yükselttikten sonra paylaşılan kota grubuna geri döndürebilir miyim?

Bir veritabanı paylaşılan kota grubundan çıkarılıp normal ücretli örneğe dönüştürüldükten sonra, curl komutunu kullanarak veritabanını paylaşılan kota grubuna geri döndürebilirsiniz. Paylaşılan kota grubundaki tüm veritabanlarının aynı sürümde olması ve aynı bölgede bulunması gerektiğini unutmayın.

• PROJECT_ID : Firebase proje kimliği. Bu kimliği Firebase konsolunun settings Ayarlar > Genel sayfasında bulabilirsiniz.

• DATABASE_ID : Uygulama kimliğinizle eşleşecek Cloud Firestore veritabanı kimliği. Bu veritabanı kimliğini Google AI Studio içinde bulmak için Ayarlar > Entegrasyonlar'a gidip Firebase Firestore & Auth kutusunu tıklayın.

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": true}'

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.

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

Google Cloud tarafından "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, kodunuza veya yapılandırma dosyalarınıza güvenli bir şekilde dahil edilebilmesi için API anahtarının aşağıdaki şartları karşıladığından emin olun. Google Cloud konsolunun API'ler ve Hizmetler > Kimlik Bilgileri sayfasında aşağıdakileri doğrulayabilirsiniz.

• Bu, Firebase uygulamanız için ve yalnızca Firebase hizmetleri için kullandığınız API anahtarıdır. Bu tuşlara genellikle Browser key (auto created by Firebase) veya Android key (auto created by Firebase) ya da iOS key (auto created by Firebase) adı verilir.
• 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 önerilen Firebase Security Rules ve App Check değerlerini 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.