Используйте Google Connected Console, чтобы интегрировать функции приложения для Android на устройстве с Gemini на Android. Создав подключенное приложение с типом подключения Android MCP и связав его с приложением в Google Play, вы позволите Gemini на Android запускать действия и выполнять задачи непосредственно в вашем приложении от имени пользователей.
В этом руководстве описан весь процесс самостоятельной настройки в Google Connected Console, включая создание подключенного приложения, связывание приложения Google Play, настройку карточки общедоступного приложения, загрузку и отправку набора App Bundle, предварительное тестирование на устройстве и публикацию рабочей версии.
Требования
Чтобы начать работу, требуется следующее:
- Доступ к зарегистрированному аккаунту разработчика в Google Connected Console.
- Принятие Условий использования. Когда ваша организация впервые начнет работать с подключенными приложениями в Google Connected Console, владелец аккаунта или администратор должен будет ознакомиться с Условиями использования подключенных приложений и принять их. Только после этого участники команды смогут создавать подключенные приложения.
- Разрешения пользователя. Если вас пригласили в существующий аккаунт разработчика Connected Console, но вы не можете создавать подключенные приложения, попросите владельца аккаунта или администратора предоставить вам разрешение Просмотр подключенных приложений или Создание подключенных приложений и управление ими на странице Пользователи и разрешения. Чтобы загружать наборы App Bundle и управлять выпусками, вам также потребуются разрешения на управление выпусками для нужного приложения в Google Play.
- Существующее приложение Google Play в аккаунте Google Connected Console:
- Приложение Google Play должно находиться в том же аккаунте разработчика, чтобы вы могли связать его с подключенным приложением. Каждое приложение Google Play можно связать только с одним подключенным приложением Android MCP.
- Убедитесь, что у вашего приложения в Google Play есть страница по умолчанию со значком и поддерживаемыми языками. Языки, на которых доступна страница приложения в Google Play, и страны, на которые настроен таргетинг, определяют, где будет доступно ваше приложение, подключенное к MCP для Android.
- Набор Android App Bundle (
.aab) с реализованными функциями приложения.- Настройте набор App Bundle для мобильных устройств Android, которые поддерживают интеграцию с приложением Gemini на устройстве.
- Категория приложения и общедоступные метаданные. Подготовьте ресурсы и сведения, которые будут видны всем пользователям:
- Категория подключенного приложения. Домен или отрасль, к которой относится подключенное приложение. Каждая категория определяет базовые требования к возможностям и не может быть изменена после создания.
- Название приложения. Отображаемое название подключенного приложения, которое пользователи видят в продуктах Google и используют, когда упоминают ваше приложение с помощью
@в Gemini. - Значок подключенного приложения. Значок приложения размером 512 x 512 пикселей в формате JPEG или PNG. Максимальный размер файла – 1 МБ (1024 КБ).
- Описание приложения. Краткое описание того, что ваше подключенное приложение может делать для пользователей.
- Возможности приложения. Как минимум три дополнительные возможности, которые пользователи увидят, когда будут решать, подключать ли приложение. Они будут показаны вместе с возможностями по умолчанию, которые зависят от категории приложения.
- Примеры запросов. Не менее трех примеров запросов, которые показывают пользователям, как вызвать ваше приложение в Gemini, и помогают понять, о чем можно попросить.
- URL политики конфиденциальности. Общедоступный URL вашей политики конфиденциальности.
- URL условий использования. Общедоступный URL, по которому можно ознакомиться с условиями использования.
- URL сайта (необязательно) – общедоступный URL, указывающий на ваш сайт для атрибуции.
Регистрируйте, тестируйте и публикуйте AppFunctions с помощью Gemini
Выполнив предварительные требования, зарегистрируйте подключенное приложение Android MCP, свяжите приложение Google Play, укажите сведения о приложении, загрузите и отправьте AppFunctions, протестируйте приложение на устройстве и опубликуйте рабочую версию.
Шаг 1. Создайте подключенное приложение Android MCP и свяжите его с приложением Google Play
Чтобы создать подключенное приложение и связать его с приложением в Google Play, выполните следующие действия:
- Войдите в Google Connected Console.
- На главной странице нажмите Создать приложение.
- В диалоговом окне Выберите, что вы хотите создать:
- Если вам будет предложено принять Условия использования подключенных приложений, нажмите Посмотреть условия, прочитайте и примите соглашение, а затем выберите Создать. Принять соглашение может только администратор аккаунта.
- В противном случае нажмите Создать на карточке Подключенное приложение.
- В диалоговом окне Укажите название подключенного приложения введите название подключенного приложения. Это название будет показываться пользователям продуктов Google. Оно также применяется для упоминаний через
@. Нажмите Далее. В диалоговом окне Выберите категорию подключенного приложения в меню Выберите категорию укажите домен, категорию или отрасль приложения.
В диалоговом окне Выберите тип подключения выберите Android MCP.
Подробные инструкции по настройке подключенного приложения MCP-сервера можно найти в руководстве по интеграции Google Play Console. Пока для каждого подключенного приложения можно выбрать только один тип подключения, и изменить его позже нельзя.
Выберите Создать подключенное приложение.
В диалоговом окне Выбор приложения найдите и выберите приложение из Google Play, которое содержит или будет содержать ваши AppFunctions. Вы можете отфильтровать список с помощью поиска.
- Приложения Google Play, которые уже связаны с другим подключенным приложением, выбрать нельзя.
- Убедитесь, что вы выбрали правильное приложение Google Play. Выбранное приложение Google Play нельзя будет изменить.
Откроется обзорная страница, на которой можно продолжить настройку подключенного приложения, отслеживать его версии и управлять тестировщиками.
Шаг 2. Укажите сведения о подключенном приложении
Прежде чем загружать наборы App Bundle, содержащие AppFunctions, настройте, как подключенное приложение будет показываться пользователям в Gemini.
Чтобы указать сведения о подключенном приложении, выполните следующие действия:
- На странице управления подключенным приложением на карточке Android MCP в разделе Добавление сведений о подключенном приложении выберите Добавить сведения о приложении (или Управление, если вы обновляете существующие сведения).
- В верхней части страницы Сведения о приложении проверьте поле Название подключенного приложения. При необходимости вы можете изменить название. Оно будет показываться в продуктах Google и использоваться, когда пользователи упоминают ваше приложение с помощью
@. - В разделе Общедоступные сведения в пункте Значок загрузите значок приложения (в формате JPG или PNG, размером до 1 МБ и разрешением 512 x 512 пкс).
Заполните следующие поля:
- Описание. Введите краткое описание (не более 30 слов) основных функций подключенного приложения и его возможностей. Этот текст будет показываться пользователям и не будет использоваться в качестве инструкций для модели.
- Возможности. Укажите не менее трех важных задач, которые может выполнять ваше подключенное приложение. Чтобы добавить другие записи, нажмите Добавить функцию. Не начинайте названия возможностей с цифр. В каждой записи указывайте только одну функцию. Если в категории подключенного приложения есть предопределенные возможности, они будут показаны вверху списка и их нельзя будет изменить.
- Примеры запросов. Укажите хотя бы три примера запросов, чтобы пользователи понимали, о чем можно попросить. Нажмите Добавить пример.
- Начните хотя бы два запроса с
@<YourAppName>(например,@Order Tracker where is my last order?). - Упомяните
<YourAppName>хотя бы в одном запросе, не начиная его с названия приложения (например,Track my recent order on Order Tracker). - Не используйте нумерацию (
1.,2.,3.) и не заключайте запросы в кавычки ("...").
- Начните хотя бы два запроса с
Многоязычная локализация. Чтобы добавить перевод для полей Description (Описание), Capabilities (Возможности) и Example prompts (Примеры запросов), заключите текст для каждого региона в языковые теги в поле ввода. Пример:
<en-US> Play music, manage playlists, and discover artists </en-US> <es-ES> Reproduce música, gestiona listas y descubre artistas </es-ES>Connected Console автоматически проверяет теги и показывает обнаруженные региональные настройки под каждым полем (например,
Found translations for 2 languages: en-US, es-ES).URL условий использования. Укажите действительную ссылку
https://илиhttp://на условия использования.URL политики конфиденциальности. Укажите действительную ссылку
https://илиhttp://на вашу политику конфиденциальности.URL сайта (необязательно). Укажите ссылку на свой сайт для атрибуции.
Шаг 3. Загрузите набор App Bundle, содержащий AppFunctions, и отправьте подключенное приложение
Сохранив сведения о подключенном приложении, загрузите набор Android App Bundle, содержащий AppFunctions, в связанное приложение Google Play и отправьте версию подключенного приложения на тестирование.
Чтобы загрузить набор App Bundle, содержащий AppFunctions, выполните следующие действия:
- На странице управления подключенным приложением найдите карточку Android MCP. В разделе Загрузите набор App Bundle, содержащий AppFunctions нажмите Загрузить набор App Bundle. Откроется страница Тестирование и выпуск для связанного приложения Google Play.
- Вы также можете открыть связанное приложение Google Play прямо в Google Connected Console. В меню навигации слева выберите Тестирование > Внутреннее тестирование (или другой тип тестирования) и нажмите Создать выпуск (или Изменить выпуск, если у вас уже есть черновик).
- В разделе Наборы App Bundle нажмите Загрузить, чтобы загрузить набор
.aabс AppFunctions, или выберите Добавить из библиотеки, если вы загрузили набор после выполнения шага 2. - После загрузки перейдите в раздел В наборе App Bundle обнаружены функции приложения на странице выпуска. Убедитесь, что название подключенного приложения, код версии пакета, количество обнаруженных инструментов, количество языков и таргетинг на страны в Google Play указаны правильно, а автоматические проверки не выявили проблем. Если появятся ошибки проверки, следуйте инструкциям в разделе Устранение неполадок, связанных с AppFunctions.
- Внизу страницы выпуска нажмите Отправить связанное приложение и продолжить.
Если вы выберете Отправить подключенное приложение и продолжить, версия AppFunctions будет отправлена в Gemini для предварительного тестирования, а выпуск Google Play будет перенаправлен на страницу предварительной версии. Если вы хотите тестировать AppFunctions, используя локальные сборки, и не увеличивать код версии набора App Bundle, оставьте выпуск в Google Play в статусе черновика и не нажимайте Сохранить и опубликовать. После публикации выпуска в Google Play код версии набора блокируется, и его нельзя удалить или загрузить повторно. Для любых последующих изменений потребуется увеличить номер версии набора App Bundle. Если тестировщики устанавливают приложение напрямую из канала внутреннего тестирования Google Play, а не из неизвестного источника, завершите выпуск версии для внутреннего тестирования и увеличьте код версии при последующих загрузках.
Шаг 4. Проверьте версию подключенного приложения
Отправьте подключенное приложение со страницы выпуска в Google Play и убедитесь, что его версия готова к предварительному просмотру:
- На странице управления подключенным приложением в карточке Android MCP рядом с пунктом Версии выберите Посмотреть.
- На странице Версии убедитесь, что отправленная версия появилась в разделе Доступно тестировщикам (показывается
Version <N> • Submitted <Date> • Using AppFunctions from app bundle <versionCode>).- Нажмите Посмотреть в строке с нужной версией, чтобы проверить обнаруженные функции AppFunctions и доступные только для чтения сведения о приложении, зафиксированные для этой версии.
- Версии, созданные из загруженного набора App Bundle, для которых вы ещё не нажали Отправить подключенное приложение и продолжить, будут находиться в разделе Ожидает отправки.
Шаг 5. Протестируйте подключенное приложение
Чтобы подключенное приложение стало доступно тестировщикам, добавьте их на странице Управление тестировщиками. Только пользователи из списка тестировщиков могут видеть ваше неопубликованное подключенное приложение и взаимодействовать с ним. В список можно добавлять только пользователей с аккаунтом @gmail.com.
- На обзорной странице подключенного приложения найдите карточку Протестируйте приложение и нажмите Добавить тестировщиков (или Управление тестировщиками, если вы уже добавили их).
- На странице Управление тестировщиками выберите существующие списки рассылки или нажмите Создать список рассылки, чтобы добавить аккаунты Google, которым разрешено тестировать интеграцию. Если вы планируете сами участвовать в тестировании, укажите свой адрес электронной почты.
Нажмите Сохранить.
Тестировщики могут вызвать подключенное приложение в приложении Gemini, введя
@и название подключенного приложения, а затем выбрав его в меню. Вы также можете посмотреть и подключить приложение в Gemini, выбрав Настройки и справка > Подключенные приложения на панели навигации слева.
Прежде чем тестировать приложение на устройстве, убедитесь, что каждый тестировщик соответствует следующим требованиям:
- Войдите в аккаунт Google на телефоне или планшете Android, используя адрес электронной почты, указанный на шаге 5.
- Запустите ту же сборку приложения для Android, код версии набора которой совпадает с кодом версии, указанным на шаге 4.
Рекомендуем тщательно протестировать интеграцию:
- Попробуйте все примеры запросов.
- Протестируйте явные вызовы
@<AppName>и запросы на естественном языке. - Проверьте обработку параметров инструмента, запросы на подтверждение и сквозное выполнение в AppFunctions.
Когда вы будете удовлетворены результатами тестирования, отправьте подключенное приложение на проверку в Google.
Шаг 6. Опубликуйте подключенное приложение для пользователей
В отличие от интеграций MCP на сервере, подключенное приложение Android MCP не требует отдельной проверки или публикации на странице управления подключенными приложениями. Вместо этого Google проверяет версию подключенного приложения и автоматически публикует ее, когда вы выпускаете рабочую версию приложения Google Play, содержащую набор App Bundle для AppFunctions.
Когда вы завершите тестирование и будете готовы запустить агент для пользователей:
- В Google Connected Console откройте связанное приложение Google Play и в меню навигации слева выберите Выпуск > Рабочая версия (или переведите протестированный выпуск из тестовой версии в рабочую).
- Нажмите Создать выпуск (или измените существующий проект рабочей версии) и добавьте набор App Bundle, содержащий проверенные AppFunctions, с помощью кнопки Добавить из библиотеки или Загрузить.
- Перейдите в раздел В наборе App Bundle обнаружены функции приложения. Подтвердите версию подключенного приложения, количество инструментов, количество языков на странице приложения и таргетинг на страны в Google Play. Убедитесь, что автоматические проверки не выявили проблем, препятствующих публикации.
- Нажмите Отправить подключенное приложение и продолжить, укажите сведения о выпуске и отправьте рабочую версию приложения в Google Play на проверку и публикацию.
После того как рабочая версия приложения в Google Play будет одобрена и выпущена:
- Подключенное приложение MCP для Android станет доступно в Gemini на Android пользователям в странах и на языках, на которые настроен языковой таргетинг приложения в Google Play.
- На странице управления подключенным приложением (Подключенные приложения > Управление) в карточке Статус подключенного приложения появится статус Опубликовано, а также код версии набора App Bundle и дата публикации. На странице Версии в разделе Опубликовано появится версия приложения.
- Чтобы выпустить обновленные инструменты AppFunctions, создайте новый набор App Bundle с увеличенным кодом версии, протестируйте его с помощью тестового типа версии и опубликуйте новую рабочую версию в Google Play. Если вы также хотите обновить общедоступные метаданные подключенного приложения (например, возможности или примеры запросов), сохраните эти изменения в разделе Подключенные приложения > Управление > Сведения о приложении, прежде чем загружать новый набор App Bundle.
Обновите набор App Bundle, чтобы настроить AppFunctions
Если вы хотите доработать AppFunctions во время внутреннего тестирования, не увеличивая код версии приложения для Android, вы можете удалить неопубликованный черновик набора App Bundle, а затем загрузить его заново.
- Обновите реализацию AppFunctions в проекте для Android и создайте новый набор App Bundle для
.aab. - Удалите предыдущий набор App Bundle из всех выпусков, в которые вы его добавили:
- Откройте связанное приложение Google Play в Google Connected Console и в меню навигации слева выберите Внутреннее тестирование (или тип версии, содержащий ваш проект).
- В проекте выпуска выберите Изменить выпуск.
- Найдите нужный набор, нажмите на значок меню в виде трех точек (⋮) и выберите Удалить набор App Bundle.
- Выберите Сохранить проект.
- Удалите неиспользуемый набор App Bundle из библиотеки:
- В меню навигации слева в приложении Google Play выберите Последние выпуски и наборы. Если нужного набора нет в списке, нажмите Посмотреть все наборы App Bundle.
- Откройте сведения о наборе App Bundle и нажмите Удалить набор App Bundle, если эта кнопка доступна. Это освободит код версии, и вы сможете загрузить обновленный набор App Bundle, не увеличивая код версии.
- Если кнопка Удалить набор App Bundle недоступна (например, потому что выпуск уже опубликован в типе версии), увеличьте значение
versionCodeв конфигурации сборки приложения, сгенерируйте новый набор App Bundle, а затем загрузите и отправьте новую версию, как описано в шаге 4.
Устранение неполадок, связанных с AppFunctions
Ниже приведены инструкции по устранению ошибок, выявленных при автоматической проверке, и распространенных проблем с настройкой.
Как устранить ошибки, обнаруженные при автоматической проверке выпуска
Проблемы, выявленные в ходе автоматической проверки AppFunctions, появляются на странице подготовки выпуска (например, Создание выпуска для внутреннего тестирования) и в разделе Не удалось (со значком Исправьте ошибки, чтобы опубликовать) на странице Версии подключенного приложения.
Если автоматическая проверка выявила проблемы с набором App Bundle, выполните следующие действия:
- Устраните проблемы с AppFunctions в коде приложения Android и создайте обновленный набор App Bundle.
- Если предыдущий выпуск все ещё находится в статусе черновика и вы хотите использовать тот же код версии:
- В меню навигации слева в приложении Google Play выберите Внутреннее тестирование (или другой нужный трек) и нажмите Изменить выпуск в черновике.
- Нажмите на значок меню в виде трех точек (⋮) рядом с набором App Bundle и выберите Удалить набор App Bundle.
- Выберите Сохранить проект.
- В меню навигации слева выберите Последние выпуски и наборы (при необходимости нажмите Посмотреть все наборы App Bundle), выберите набор и нажмите Удалить набор App Bundle.
- Вернитесь к проекту выпуска, загрузите исправленный набор App Bundle и нажмите Отправить подключенное приложение и продолжить.
- Если предыдущий набор удалить нельзя, увеличьте значение
versionCodeв наборе App Bundle, загрузите новый набор в выпуск и нажмите Отправить связанное приложение и продолжить.
Распространенные проблемы с настройкой и интеграцией
В таблице ниже описаны распространенные проблемы, которые могут возникнуть при настройке подключенного приложения, загрузке пакета или тестировании, а также их причины и способы устранения.
| Проблема | Сообщение в консоли или признак проблемы | Причина | Разрешение |
|---|---|---|---|
| Набор App Bundle загружен до создания или подключения связанного приложения | На странице выпуска появится кнопка Создать или связать подключенное приложение. | Загруженный файл .aab содержит AppFunctions, но приложение Google Play ещё не связано с подключенным приложением Android MCP. |
Выполните шаги 1–3, чтобы создать подключенное приложение, выберите Android MCP, свяжите приложение Google Play и сохраните сведения о приложении. Затем удалите и повторно загрузите набор App Bundle или загрузите новый набор с увеличенным значением versionCode. |
| Набор App Bundle загружен до сохранения сведений о связанном приложении | На странице выпуска появится сообщение Необходимо указать сведения о подключенном приложении и кнопка Указать сведения о подключенном приложении. | Приложение Google Play связано с подключенным приложением MCP для Android, но обязательные поля на странице Сведения о приложении не были сохранены до загрузки набора App Bundle. | Выберите Указать сведения о связанном приложении (или перейдите в раздел Связанные приложения > Управление > Добавить сведения о приложении), заполните и сохраните все обязательные поля, а затем удалите и повторно загрузите пакет или загрузите новый пакет с увеличенным значением versionCode. |
| При установлении связи нельзя выбрать приложение Google Play | Целевое приложение Google Play помечено значком Связь уже установлена или не отображается в диалоговом окне Выберите приложение. | Каждое приложение Google Play можно связать только с одним подключенным приложением Android MCP. Также возможно, что приложение Google Play ещё не создано в этом аккаунте разработчика. | Проверьте существующие записи в разделе Связанные приложения, чтобы узнать, не связано ли другое приложение с вашим приложением Google Play. Если нет, сначала создайте приложение Google Play в Google Connected Console, а затем свяжите его. |
| Не удается создать подключенное приложение | Нет возможности создать подключенное приложение, или при попытке его создать появляется предупреждение о разрешениях или Условиях использования. | У вашего аккаунта пользователя нет разрешений на работу с подключенными приложениями, или владелец либо администратор аккаунта ещё не принял Условия использования подключенных приложений. | Попросите владельца аккаунта или администратора принять Условия использования подключенных приложений и предоставить вашему аккаунту разрешение Просмотр подключенных приложений или Создание подключенных приложений и управление ими на странице Пользователи и разрешения. |
| Версия связанного приложения застряла в статусе "Ожидает отправки" | На странице Подключенные приложения > Управление > Версии версия набора будет указана в разделе Ожидает отправки, а не Доступно тестировщикам. | Google Connected Console обнаружила AppFunctions в загруженном наборе, но версия подключенного приложения не была отправлена со страницы выпуска. | Откройте выпуск приложения в Google Play, содержащий этот набор, и выберите Отправить подключенное приложение и продолжить, чтобы тестировщики могли его проверить. |
| Ошибка проверки примеров запросов на странице сведений о приложении | Форма Общедоступная карточка приложения не сохраняется, и в разделе Примеры запросов появляется сообщение об ошибке. | Подсказки не соответствуют правилам форматирования или упоминания, или название приложения было изменено после написания подсказок. | Укажите от трех до четырех запросов. Начните хотя бы два из них с @<YourAppName>, упомяните <YourAppName> хотя бы в одном запросе (не начинайте его с @) и удалите нумерацию (1., 2.) или кавычки ("..."). |
| Подключенное приложение не видно тестировщикам в Gemini на Android | Тестировщики не могут найти подключенное приложение в разделе Подключенные приложения или с помощью упоминания @ в приложении Gemini для Android. |
Распространение ещё не завершено, аккаунт тестировщика не соответствует требованиям или установлена неподходящая версия приложения. | Подождите около 20 минут после отправки (и до 10 минут после сохранения тестировщиков). Убедитесь, что тестировщик использует личный аккаунт @gmail.com, адрес электронной почты которого есть в списке, а также телефон или планшет Android и что у него установлена именно та версия набора, которую вы отправили. |