Добавьте 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 : когда агент предложит это сделать, включите Firebase, выберите местоположение для вашего проекта и примите условия использования 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 , чтобы гарантировать сохранение изменений и их соответствие логике вашего приложения.

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

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

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» агент Google AI Studio автоматически выбирает проект Firebase для использования в качестве бэкэнд-сервисов вашего приложения ( Cloud Firestore и Firebase Authentication ).

Если вы хотите использовать конкретный проект, вы можете указать агенту сделать это с помощью следующего запроса:

Use project PROJECT_ID for the Firebase backend.

Если вы позже решите опубликовать свое приложение в Cloud Run , важно продолжать использовать тот же проект. Выбор другого проекта приведет к ошибкам, поскольку он не будет соответствовать проекту, используемому для вашего бэкэнда.

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

Агент Google AI Studio настраивает вход через Google при использовании функции добавления бэкэнда Firebase . Чтобы настроить дополнительные методы, включите их в консоли 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 :

1. Создайте свой проект Firebase вручную заранее.

2. При настройке бэкенда Firebase в Google AI Studio укажите агенту использовать ваш существующий проект:

   Add Firestore to this app using project PROJECT_ID.
   

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

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

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

Как 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».