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

   • 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.
   • 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.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. 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 & 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 uygulamaların tümü şu özellikleri paylaşı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 faturalandırma ekleyerek Firebase projenizi kullandıkça öde Blaze fiyatlandırma planına yükseltebilirsiniz.

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'da yapabilirsiniz.

1. Google AI Studio üzerinden 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 ya da mevcut bir faturalandırma hesabını 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 Cloud Firestore aracısı tarafından oluşturulan Google AI Studio 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 konsoluna gidin ve yükseltmek istediğiniz veritabanını içeren projeyi seçin.
2. Sol gezinme bölmesinden Veritabanları ve Depolama > Firestore'a gidin.
3. Projeniz birden fazla Cloud Firestore veritabanı örneği içeriyorsa yükseltmek istediğiniz örneği 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 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 ajan 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

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 özelliği 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 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:

1. Firebase konsoluna gidin ve AI Studio etiketli projeyi seçin.

2. 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 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 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, kurulum yapmanızı veya oturum açma ekranı ayarlamanızı istediğinizde Google ile Oturum Açma özelliğini kurar.Authentication Uygulamanıza ek oturum açma yöntemleri eklemek için yapmanız gerekenler şunlardır:

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'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 hizmetleri kullanmak için 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, diğer tüm web uygulamaları 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 yükseltin.
  • Google AI Studio aracısı sizin için kurulumu yaptıysaCloud Firestore, veritabanınızı normal ücretli duruma geçirmek için Daha fazla Cloud Firestore kotası almak için faturalandırma ekleme bölümünde 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, 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 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. Aracı, 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. Veri yönetimi görevlerini (ör. girişleri silme) gerçekleştirmek için Firebase konsolunda Veritabanları ve Depolama > Firestore 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?

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 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 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 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.

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 : Cloud Firestore veritabanı kimliği, bu kimlik, küçük uygulamanızın kimliğiyle 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'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 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) 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 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.