Добавьте Cloud Firestore и аутентификацию в свое приложение Google AI Studio.

В режиме сборки Google AI Studio можно автоматически настроить и интегрировать Cloud Firestore и Firebase Authentication в веб-приложения, что упрощает создание приложений с постоянным хранением данных и безопасными процессами авторизации. Всего одним запросом и несколькими щелчками мыши вы позволяете агенту Google AI Studio настроить проект Firebase, подключить ваше приложение к этому проекту и сгенерировать весь код Cloud Firestore и Authentication непосредственно в вашем приложении.

Обзор: Добавьте бэкэнд в ваше приложение Google AI Studio.

1. Опишите свою идею : Создайте новое приложение в Google AI Studio и опишите функцию, которая требует использования базы данных или аутентификации. Например, вы можете ввести следующее: Build a shared to-do list app using Firebase as a backend.

2. Включите интеграцию с Firebase : в появившейся карточке вы можете настроить параметры:

   • Выберите местоположение (необязательно) : выберите местоположение для вашей базы данных и вашего приложения, используя раскрывающийся список местоположений.
   • Выберите проект (необязательно) : нажмите значок « Настройки» settings выберите проект Google Cloud , который хотите использовать, и нажмите «Сохранить» .
   • Подтвердите свой выбор: Для продолжения нажмите кнопку «Включить Firebase» .

   Затем агент автоматически подключает ваше приложение к вашему проекту Firebase и генерирует необходимый код Cloud Firestore и Authentication , включая файл /src/lib/firebase.ts и файл firestore.rules .

3. Развертывание : После завершения процесса используйте опцию «Поделиться > Опубликовать» , чтобы развернуть веб-приложение в Cloud Run . Ваше приложение автоматически развернется в том же проекте, который вы выбрали во время настройки.

Разберитесь с общей квотой для Cloud Firestore

Все базы данных Cloud Firestore созданные агентом Google AI Studio, помещаются в одну и ту же «группу» баз данных в вашем проекте Firebase. Все они обладают следующими характеристиками:

• Общая квота : Все базы данных в группе используют общую квоту ( подробности см. ниже ).
• Для Cloud Billing не требуется учетная запись : вы можете создавать и тестировать свое приложение без добавления платной подписки. Подробнее о добавлении платной подписки см. ниже .
• Ежедневное обновление : Если вы достигнете дневного лимита квоты (например, 50 000 операций чтения в день), работа сервиса будет приостановлена ​​для всех баз данных в группе и возобновится на следующий день примерно в полночь по тихоокеанскому времени.

Базы данных Cloud Firestore входящие в общую группу квот, имеют следующие общие ограничения:

(Необязательно) Добавьте платную подписку, чтобы получить больше квоты Cloud Firestore

Если ваше приложение станет популярным и вам потребуется выйти за рамки бесплатных ограничений Cloud Firestore , вы можете перейти на тарифный план Blaze с оплатой по мере использования .

1. Добавьте платежную систему (если вы еще этого не сделали) : перейдите в консоль Firebase и свяжите платежный аккаунт с вашим проектом .

2. Обновление базы данных : по умолчанию базы данных Cloud Firestore созданные агентом Google AI Studio, продолжают использовать общую квоту даже после обновления тарифного плана . Чтобы включить полное масштабирование для конкретной базы данных, необходимо вручную исключить ее из группы с помощью команды curl .

   • PROJECT_ID : Идентификатор проекта Firebase; этот идентификатор можно найти в настройках проекта в консоли Firebase .

   • DATABASE_ID : Идентификатор базы данных Cloud Firestore , который будет соответствовать идентификатору вашего апплета; этот идентификатор базы данных можно найти в столбце «Имя» на странице баз данных Cloud Firestore в консоли Firebase .

   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

Агент Google AI Studio автоматически генерирует Firebase Security Rules на основе логики вашего приложения. Эти Security Rules разработаны таким образом, чтобы по умолчанию разрешать доступ только тем конечным пользователям вашего приложения, которым они владеют.

Обратите внимание, что если вы вручную измените Security Rules непосредственно в консоли Firebase , агент Google AI Studio не узнает об изменениях, и они будут перезаписаны при последующих итерациях приложения. Мы рекомендуем использовать агент Google AI Studio для изменения Firebase Security Rules , чтобы гарантировать сохранение изменений и их соответствие логике вашего приложения.

Используйте существующий проект

При первом включении интеграции с Firebase вы можете дополнительно выбрать существующий проект Google Cloud , который принадлежит вам:

1. В появившейся карточке нажмите settings «Настройки» .
2. Выберите свой проект и нажмите «Сохранить» .

В процессе доработки приложения вы также можете указать агенту использовать другой проект, используя, например, следующую команду:

Add Firestore to this app using project PROJECT_ID.

При выборе проекта происходят следующие действия:

• В рамках этого проекта будет создана новая база данных Cloud Firestore с использованием выделенной квоты.
• Будет настроена Firebase Authentication с использованием входа через Google.
• Сервисному аккаунту будет предоставлен доступ к вашей базе данных Cloud Firestore . Для предоставления доступа администратору из Google AI Studio будет создан новый сервисный аккаунт с именем ais-sandbox@ PROJECT_ID .iam.gservice.com , которому будет предоставлено разрешение на доступ к вашей базе данных Cloud Firestore . Этот аккаунт будет связан только с вашими приложениями Google AI Studio .
• Ограничения : Если в проекте Firebase уже есть база данных Cloud Firestore , агент не сможет добавить дополнительную. Вам потребуется выбрать другой проект или создать новый пустой проект для использования.

Используйте консоль Firebase

Вы можете просмотреть данные и настройки своего приложения в консоли Firebase . Чтобы получить доступ к проектам, связанным с Google AI Studio , выполните следующие действия:

1. Перейдите в консоль Firebase и выберите проект с названием AI Studio .
2. В левой панели навигации щелкните Build > Cloud Firestore Database , чтобы просмотреть и отредактировать данные в Cloud Firestore , или щелкните Build > Authentication чтобы настроить параметры Authentication и данные.

Устранение неполадок и часто задаваемые вопросы

Найдите ответы на часто задаваемые вопросы и узнайте, как решать проблемы при интеграции Firebase с вашим приложением Google AI Studio .

Как определяется местоположение и мой проект Google Cloud / Firebase?

При запросе бэкенда Firebase для приложения вы можете дополнительно выбрать местоположение и проект в появившейся карточке:

• Выберите местоположение (необязательно) : выберите местоположение для вашей базы данных и вашего приложения, используя раскрывающийся список местоположений.
• Выберите проект (необязательно) : нажмите значок « Настройки» settings выберите проект Google Cloud , который хотите использовать, и нажмите «Сохранить» .

Учитывайте следующее:

• Местоположение базы данных является постоянным : после выбора местоположения для базы данных вы не сможете изменить его для данного проекта. Этот выбор будет использоваться по умолчанию для других серверных служб.
• Согласованность проекта : Для обеспечения бесшовной интеграции Google AI Studio автоматически использует один и тот же проект как для бэкэнда, так и для развертывания. Вы не можете использовать разные проекты для разных сервисов в рамках одного приложения.

Какие методы аутентификации поддерживаются?

Агент Google AI Studio настраивает вход через Google, когда вы запрашиваете настройку Authentication . Чтобы настроить дополнительные методы, включите их в консоли Firebase и обратитесь к агенту Google AI Studio за помощью в обновлении вашего кода.

Можно ли создать мобильное приложение (например, для Android или iOS) с помощью Google AI Studio ?

В настоящее время агент Google AI Studio может создавать только веб-приложения . Подробнее о поддерживаемых функциях можно узнать в документации к агенту Google AI Studio .

Следует отметить, что, как и все веб-приложения, приложения, созданные в Google AI Studio, доступны в виде мобильных веб-приложений в браузерах, установленных на мобильных устройствах.

Что представляет собой файл firebase-blueprint.json ?

Это промежуточный файл, используемый агентом Google AI Studio для анализа кода вашего приложения. Не изменяйте этот файл вручную, так как это может привести к генерации агентом некорректного кода или небезопасных Security Rules .

Что делать, если я получаю ошибку "Превышен лимит квоты"?

Превышение лимита квоты Cloud Firestore означает, что ваше приложение достигло дневного лимита использования для вашей группы квот базы данных Cloud Firestore . Есть два способа решить эту проблему:

• Вариант 1: Подождать : Квоты обновляются ежедневно около полуночи по тихоокеанскому времени.
• Вариант 2: Обновление : Перейдите на тарифный план Blaze с оплатой по факту использования.
  • Если агент Google AI Studio настроил для вас Cloud Firestore , вам необходимо использовать команду curl , описанную в разделе «Добавление платёжных опций для увеличения квоты Cloud Firestore» , чтобы перевести вашу базу данных в обычный платный режим. Если вы настраивали Cloud Firestore вручную, выполнение команды curl не требуется.

Что делать, если появляется ошибка "Отсутствуют или недостаточны права доступа"?

Эта ошибка возникает, когда ваше приложение пытается прочитать или записать данные в базу данных Cloud Firestore , но запрос отклоняется Security Rules . Это указывает на то, что Security Rules не разрешают попытку выполнения операции на основе текущего состояния аутентификации или пути к данным. Нажмите кнопку «Исправить ошибку» , чтобы агент Google AI Studio попытался исправить Security Rules .

Что произойдёт с моим бэкендом Firebase, если я удалю приложение Google AI Studio ?

Удаление приложения в Google AI Studio не приводит к автоматическому удалению подключенного проекта Firebase, базы данных Cloud Firestore или конфигураций Firebase Authentication .

Если вы добавили бэкенд Firebase, вам необходимо вручную перейти в консоль Firebase и удалить проект или очистить отдельные ресурсы (например, экземпляр базы данных Cloud Firestore и поставщиков Authentication ), чтобы убедиться, что все данные и конфигурации удалены.

Может ли агент Google AI Studio удалять или редактировать данные в моей базе данных Cloud Firestore ?

Агент Google AI Studio предназначен для подготовки необходимых ресурсов бэкэнда, генерации кода и Security Rules . Хотя сам агент не может напрямую удалять, редактировать или изменять записи данных в вашей базе данных Cloud Firestore , он может писать код в вашем приложении, предназначенный для выполнения этих действий. Для выполнения задач управления данными, таких как удаление записей, перейдите на страницу базы данных Cloud Firestore в консоли Firebase .

Я работаю в организации, использующей Google Cloud ; могу ли я подключить свое приложение Google AI Studio к существующему проекту в среде Google Cloud моей организации?

Да. Убедитесь, что ваш проект Firebase находится в папке вашей организации Google Cloud , а затем подключите проект, используя один из следующих способов:

• В процессе включения : При первом включении интеграции Firebase в Google AI Studio выберите свой существующий проект на появившейся карточке. Нажмите значок settings Настройки» , выберите свой проект и нажмите «Сохранить» .

• В процессе итерации : Если вы уже включили Firebase или хотите переключиться на другой проект позже, вы можете указать агенту использовать существующий проект, используя, например, следующую команду:

    Add Firestore to this app using project PROJECT_ID.
  

Почему я не могу найти некоторые документы в консоли Firebase ?

Когда агент AI Studio сохраняет данные во вложенный путь (например, /users/user1/messages/msg1 ), не создав предварительно родительский документ ( user1 ), он создает так называемый несуществующий родительский документ . Эти документы не отображаются в консоли Firebase , что может затруднить их поиск при просмотре базы данных Cloud Firestore . Хотя это не влияет на работу вашего приложения, вы часто можете описать проблему агенту AI Studio, чтобы он создал отсутствующие родительские документы.

Для получения более подробной информации см. раздел «Несуществующие родительские документы» .

Могу ли я выбрать местоположение для своей базы данных Cloud Firestore ?

Да. При первом включении интеграции Firebase в Google AI Studio вы можете выбрать местоположение для вашей базы данных Cloud Firestore .

Обратите внимание, что выбранное вами местоположение применяется ко всем базам данных Cloud Firestore , которые агент Google AI Studio создает в этом проекте Firebase. После установки это местоположение для этих баз данных изменить нельзя.

Как Google использует мои данные (например, код и подсказки) в Google AI Studio ?

Подробную информацию об использовании ваших данных см. в Дополнительных условиях предоставления услуг API Gemini .

Я получил электронное письмо от Google Cloud о «общедоступном ключе API Google для вашего проекта Google Cloud ». Что мне нужно сделать?

Если вы получили электронное письмо от Google Cloud о «общедоступном ключе API Google для вашего проекта Google Cloud » , и указанный в письме ключ API — это ваш ключ API Firebase , убедитесь, что этот ключ API соответствует следующим требованиям, чтобы его можно было безопасно включить в ваш код или файлы конфигурации. Вы можете проверить это на панели «API и сервисы» > «Учетные данные» в консоли Google Cloud .

• Это ключ API, который вы используете для своего приложения Firebase и только для сервисов Firebase. Эти ключи обычно называются Browser key (auto created by Firebase) , Android key (auto created by Firebase) или iOS key (auto created by Firebase) .
• В него включены все необходимые API, связанные с Firebase, в список разрешенных «ограничений API» ключа .
• В списке разрешенных «ограничений API» отсутствуют другие API. В частности, в этот список не должен входить Generative Language API .

Кроме того, убедитесь, что вы используете Firebase Security Rules и App Check , как это рекомендуется для используемых вами продуктов Firebase.

Подробную информацию об API-ключах для Firebase и список часто задаваемых вопросов можно найти в разделе «Узнайте об использовании и управлении API-ключами для Firebase».