Google AI Studio Cloud Firestore ve Firebase Authentication, web uygulamalarına otomatik olarak kurulup entegre edilebilir. Bu sayede, Google AI Studio'daki Google AI Studio özelliği, kalıcı veri depolama ve güvenli oturum açma akışları içeren uygulamalar oluşturmayı kolaylaştırır. 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
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.Firebase entegrasyonunu etkinleştirin: Görünen kartta kurulumunuzu yapılandırın:
- Projeyi veya konumu özelleştirme (isteğe bağlı): Ayarlar simgesini tıklayın, ardından kullanmak istediğiniz konumu veya Google Cloud projeyi seçin.
- Seçiminizi onaylayın: Devam etmek için Firebase'i etkinleştir düğmesini tıklayın.
Ardından aracı, uygulamanızı Firebase projenize otomatik olarak bağlar ve Cloud Firestore ile Authentication kodunu (
/src/lib/firebase.tsdosyası vefirestore.rulesdosyası dahil) oluşturur.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 veya dağıtmadan ö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:
- Aracıyla konuşma: Aracıya, 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çenekte de Firebase entegrasyonu kurulum akışı başlatılı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 ve 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ı "AI shared quota" veritabanı grubuna yerleştirilir. Bu türlerin tümünde şu özellikler bulunur:
- Paylaşılan kota: Gruptaki tüm veritabanları bir 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.
| Metrik | Kota |
|---|---|
| Depolanan veriler | Toplam 1 GiB |
| Ağ çıkışı | Ayda 10 GiB |
| Yazma birimleri | Günde 40.000 yazma işlemi |
| Birimleri okuma | Günde 50.000 okuma |
| Gerçek zamanlı güncelleme birimleri | Günde 50.000 güncelleme |
(İ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: Fatura bilgilerini ekleyin (henüz yapmadıysanız).
Faturalandırma ayarlarını doğrudan Google AI Studio içinde yapabilirsiniz.
- Google AI Studio üzerinden Projeler sayfasına gidin.
- Yükseltmek istediğiniz projenin yanındaki Faturalandırma ayarlarını yap'ı tıklayın.
- Ülkenizi seçmek, şartları kabul etmek ve ödeme yöntemi eklemek ya da 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 yansıtılmaz).
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.
- Firebase konsoluna gidin ve yükseltmek istediğiniz veritabanını içeren projeyi seçin.
- Soldaki gezinme bölmesinde Databases & Storage > Firestore'a (Veritabanları ve Depolama > Firestore) gidin.
- Projeniz birden fazla Cloud Firestore veritabanı örneği içeriyorsa yükseltmek istediğiniz örneği seçin.
- 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 olup olmadığına bakın. 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ğildir veya veritabanı daha önce 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 olur.
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ının değişikliklerden haberdar 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
Firebase entegrasyonunu ilk kez etkinleştirdiğinizde, isteğe bağlı olarak sahip olduğunuz mevcut bir Google Cloud projesini seçebilirsiniz:
- Açılan kartta Ayarlar simgesini tıklayın.
- 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 alanından yönetici erişimine izin vermek için
ais-sandbox@PROJECT_ID.iam.gservice.comadlı 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 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:
Firebase konsoluna gidin ve
AI Studioetiketli projeyi seçin.Soldaki gezinme bölmesinden 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ızla 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 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 konumu proje için 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, Google AI Studio veya oturum açma ekranı ayarlamanızı istediğinizde Google ile oturum açma özelliğini ayarlar.Authentication Uygulamanıza ek oturum açma yöntemleri eklemek için yapmanız gerekenler şunlardır:
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.
Google AI Studio'a 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 yalnızca web uygulamaları için desteklendiğini, Android uygulamaları için desteklenmediğini unutmayın. Android uygulaması geliştiriyorsanız bu hizmetlere ihtiyacınız varsa Firebase'i manuel olarak entegre etmeniz gerekir.
Desteklenen özellikler hakkında daha fazla bilgiyi Google AI Studio aracı belgelerinde bulabilirsiniz.
Ancak Google AI Studio tarafından oluşturulan web uygulamalarına, 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 sizin için kurulumu 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 Veritabanını yükselt düğmesini kullanmanız gerekir. Cloud Firestore'yı 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'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 aracısı, gerekli arka uç kaynaklarının sağlanmasına ve kod oluşturulmasına yardımcı olmak için tasarlanmıştır Security Rules. 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österilen kartta mevcut projenizi seçin. Ayarlar simgesini 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ıya mevcut projenizi kullanmasını söyleyebilirsiniz. Örneğin:
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 var 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
Ayarlar > Genel sayfasında bulabilirsiniz.DATABASE_ID : Cloud Firestore veritabanı kimliği, bu kimlik, uygulama kimliğinizle eşleşir. Bu veritabanı kimliğini Google AI Studio içinde bulmak için Ayarlar > Entegrasyonlar'a gidin ve 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 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 konsolunun API'ler ve Hizmetler > Kimlik bilgileri sayfasında 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şlara genellikle
Browser key (auto created by Firebase),Android key (auto created by Firebase)veyaiOS 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 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.