Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Crea y administra apps conectadas con AppFunctions y Android MCP en Google Connected Console

Usa Google Connected Console para integrar las AppFunctions integradas en el dispositivo de tu app para Android con Gemini en Android. Si creas una app conectada con el tipo de conexión de MCP de Android y la vinculas a tu app de Play, habilitas a Gemini en Android para que active acciones y complete tareas directamente en tu app en nombre de los usuarios.

En esta guía, se explica el flujo de trabajo de autoservicio de extremo a extremo en Google Connected Console, incluida la creación de apps conectadas, la vinculación de apps de Google Play, la configuración de tarjetas de apps públicas, la carga y el envío de paquetes de aplicaciones, las pruebas de vista previa integrado en el dispositivo y la publicación en producción.

Requisitos previos

Antes de empezar, asegúrate de tener lo siguiente:

Acceso a una cuenta de desarrollador registrada en Google Connected Console:
- Aceptación de las Condiciones del Servicio: La primera vez que tu organización acceda a las Apps conectadas en Google Connected Console, un propietario de la cuenta o administrador deberá revisar y aceptar las Condiciones del Servicio de las Apps conectadas antes de que los miembros del equipo puedan crear Apps conectadas.
- Permisos del usuario: Si recibiste una invitación para unirte a una cuenta de desarrollador de Connected Console existente, pero no puedes crear apps conectadas, pídele al propietario o administrador de la cuenta que te otorgue el permiso Ver apps conectadas o Crear y administrar apps conectadas en la página Usuarios y permisos. También necesitas permisos de administración de versiones para tu app de Play correspondiente para subir paquetes de aplicación y administrar versiones.
Una app de Play existente en tu cuenta de Google Connected Console:
- Tu app de Play ya debe existir en la misma cuenta de desarrollador para que puedas vincularla a tu app conectada. Cada app de Play solo se puede vincular a una única app conectada de MCP para Android.
- Asegúrate de que tu app de Play tenga una ficha de Play Store predeterminada configurada con un ícono de la app y los idiomas admitidos. Los idiomas de la ficha de Play Store de tu app y la segmentación por país determinan dónde está disponible tu app conectada al MCP de Android.
Un Android App Bundle (.aab) con AppFunctions implementadas:
- Configura tu paquete de aplicación para que se oriente a dispositivos móviles Android, que es la plataforma compatible con la integración de la app de Gemini integrada en el dispositivo.
Categoría de app conectada y metadatos públicos: Prepara los recursos y los detalles que conforman la presencia pública de tu app conectada:
- Categoría de app conectada: Es la categoría de dominio o categoría de sector de tu app conectada. Cada categoría define los requisitos de capacidad de referencia y no se puede cambiar después de la creación.
- Nombre de la app: Es el nombre visible de tu app conectada que se muestra a los usuarios en los productos de Google y que se usa cuando los usuarios mencionan tu app con @ en Gemini.
- Ícono de la app conectada: Es un ícono de la app de 512 px x 512 px en formato JPEG o PNG, con un tamaño de archivo máximo de 1 MB (1,024 KB).
- Descripción de la app: Es un resumen conciso que describe lo que tu app conectada puede hacer por los usuarios.
- Funciones de la app: Al menos tres funciones personalizadas que les muestren a los usuarios lo que puede hacer tu app cuando decidan si conectarla o no, además de las funciones predeterminadas que defina la categoría de tu app.
- Instrucciones de ejemplo: Al menos tres instrucciones de ejemplo que enseñen a los usuarios a invocar tu app en Gemini y los ayuden a comprender qué pueden preguntar.
- URL de la política: Es una URL de acceso público para tu Política de Privacidad.
- URL de las Condiciones del Servicio: Es una URL de acceso público para tus Condiciones del Servicio.
- URL del sitio web (opcional): Es una URL de acceso público que dirige a tu sitio web para la atribución.

Registra, prueba y publica AppFunctions con Gemini

Una vez que cumplas con los requisitos previos, completa los siguientes pasos para registrar tu app conectada de MCP para Android, vincular tu app de Play, completar los detalles de la app, subir y enviar tus AppFunctions, probar integrado en el dispositivo y publicar en producción.

Paso 1: Crea una app conectada de MCP para Android y vincúlala a tu app de Play

Para crear una app conectada y vincularla a tu app de Play, sigue estos pasos:

Accede a Google Connected Console.
En la página Principal, selecciona Crear app.
En el diálogo Elige lo que quieres crear, haz lo siguiente:
- Si se te solicita que aceptes las Condiciones del Servicio de las apps conectadas, selecciona Ver condiciones, revisa y acepta el acuerdo y, luego, selecciona Crear. Solo un administrador de la cuenta puede aceptar el acuerdo.
- De lo contrario, selecciona Crear en la tarjeta App conectada.
En el cuadro de diálogo Asigna un nombre a tu app conectada, escribe un nombre para tu app conectada. Este es el nombre que muestra tu app conectada en los productos de Google y es la forma en que los usuarios mencionan tu app conectada con @. Selecciona Siguiente.
En el cuadro de diálogo Selecciona una categoría de app conectada, selecciona el dominio, la categoría o el sector de tu app en el menú Selecciona una categoría.

Nota: La categoría de tu app conectada define los requisitos de capacidad de referencia y no se puede cambiar más adelante. Para usar una categoría diferente más adelante, debes crear una nueva app conectada.
En el cuadro de diálogo Choose connection type, elige Android MCP.

Para obtener una explicación detallada sobre cómo configurar una app conectada al servidor de MCP, consulta la guía de integración de Google Play Console. Por el momento, solo puedes elegir un tipo de conexión por app conectada y no puedes cambiarlo más adelante.
Selecciona Crear app conectada.
En el diálogo Select app, busca la app de Play que contiene (o contendrá) tus AppFunctions y selecciónala. Puedes filtrar la lista con la búsqueda.
- No se pueden seleccionar las apps de Play que ya están vinculadas a otra app conectada.
- Asegúrate de seleccionar la app de Play correcta que quieres vincular. Una vez que seleccionas una app de Play, no se puede cambiar.

Se abrirá la página de resumen de administración de tu app conectada, en la que podrás seguir configurando los detalles de la app conectada, hacer un seguimiento de sus versiones y administrar los verificadores.

Paso 2: Proporciona los detalles de tu app conectada

Antes de subir paquetes de aplicación que contengan AppFunctions, configura cómo aparece tu app conectada para los usuarios en Gemini.

Sigue estos pasos para proporcionar los detalles de tu app conectada:

En la página de administración de la app conectada, dentro de la tarjeta MCP de Android, en Agrega detalles de la app conectada, selecciona Agrega detalles de la app (o Administrar si actualizas los detalles existentes).
En la parte superior de la página Detalles de la app, verifica el campo Nombre de la app conectada. Puedes actualizar el nombre si es necesario. Se muestra a los usuarios en los productos de Google y se usa cuando los usuarios mencionan tu app con @.
En la sección Detalles públicos, en Ícono, sube el ícono de la app (JPG o PNG, de hasta 1 MB y de 512 px x 512 px).
Completa los siguientes campos:
- Descripción: Ingresa un resumen conciso de una sola oración (menos de 30 palabras) en el que se describan las funciones principales de tu app conectada y lo que puede hacer. Este texto se muestra a los usuarios y no se usa como instrucciones del modelo.
- Funciones: Ingresa al menos tres tareas de alto valor que pueda realizar tu app conectada. Selecciona Agregar capacidad para agregar más entradas. No incluyas números al principio de tus capacidades. Incluye solo una capacidad por entrada. Si la categoría de tu app conectada incluye capacidades predefinidas, estas aparecerán en la parte superior de la lista y no se podrán modificar.
- Instrucciones de ejemplo: Ingresa al menos tres instrucciones de ejemplo que ayuden a los usuarios a comprender qué pueden preguntar. Selecciona Agregar instrucción de ejemplo para agregar entradas.
  - Comienza al menos dos instrucciones con @<YourAppName> (por ejemplo, @Order Tracker where is my last order?).
  - Menciona <YourAppName> de forma natural en al menos una instrucción sin comenzar con el nombre de tu app (por ejemplo, Track my recent order on Order Tracker).
  - No incluyas prefijos numerados (1., 2., 3.) ni encierres las instrucciones entre comillas ("...").
- Localización en varios idiomas: Para proporcionar traducciones de Descripción, Funciones y Instrucciones de ejemplo, une el texto de cada configuración regional en etiquetas de idioma dentro del campo de entrada. Por ejemplo:
```
<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 valida automáticamente tus etiquetas y muestra la configuración regional detectada en cada campo (por ejemplo, Found translations for 2 languages: en-US, es-ES).
- URL de las Condiciones del Servicio: Ingresa un vínculo válido de https:// o http:// a tus Condiciones del Servicio.
- URL de la política: Ingresa un vínculo https:// o http:// válido a tu Política de Privacidad.
- URL del sitio web (opcional): Ingresa un vínculo a tu sitio web para fines de atribución.

Paso 3: Sube un paquete de aplicación que contenga tus AppFunctions y envía tu app conectada

Después de guardar los detalles de la app conectada, sube un Android App Bundle que contenga tus AppFunctions a la app de Play vinculada y envía la versión de la app conectada para realizar pruebas.

Para subir un paquete de aplicación que contenga tus AppFunctions, sigue estos pasos:

En la página de administración de la app conectada, en la tarjeta Android MCP, en Sube un paquete de aplicación que contenga tus AppFunctions, selecciona Subir paquete de aplicación para ir a la descripción general de Prueba y lanza de la app de Play vinculada.
Como alternativa, abre tu app de Play vinculada directamente en Google Connected Console. En el menú de navegación de la izquierda de tu app de Play, ve a Pruebas > Pruebas internas (o a otro segmento de pruebas) y selecciona Crear una versión nueva (o Editar versión si ya tienes una versión en borrador).
En Paquetes de aplicación, selecciona Subir para subir tu paquete .aab con AppFunctions o selecciona Agregar desde la biblioteca si subiste el paquete después de completar el paso 2.
Una vez que finalice la carga, ve a la sección Se detectaron funciones de la app en el paquete de aplicación de la página de la versión. Confirma que el nombre de la app conectada, el código de versión del paquete, el recuento de herramientas detectadas, el recuento de idiomas y la segmentación por país de la app de Play aparezcan como se espera, y verifica que las comprobaciones automatizadas no informen problemas. (Si aparece algún error de validación, sigue las instrucciones que se indican en Cómo solucionar problemas relacionados con AppFunctions antes de continuar).
En la parte inferior de la página de la versión, selecciona Enviar app conectada y continuar.

Si seleccionas Enviar app conectada y continuar, se enviará tu versión de AppFunctions a Gemini para que se realicen pruebas de versión preliminar y se avanzará tu versión de Play a la página de vista previa de la versión. Si quieres iterar en AppFunctions con compilaciones locales sin incrementar el código de versión de tu paquete de aplicación, deja la versión de Play en estado de borrador y no selecciones Guardar y publicar. Cuando publicas una versión de Play, se bloquea el código de versión de ese paquete, por lo que ya no se puede borrar ni volver a subir. Cualquier cambio posterior requiere un código de versión del paquete de aplicación incrementado. (Si tus verificadores instalan la app directamente desde el segmento de pruebas internas de Google Play en lugar de realizar sideloading, completa el lanzamiento de la prueba interna y aumenta el código de versión en las cargas futuras).

Paso 4: Verifica la versión de la app conectada

Después de enviar tu app conectada desde la página de versiones de Play, verifica que la versión de la app conectada esté lista para la versión preliminar:

En la página de administración de tu app conectada, en la tarjeta Android MCP, junto a Versiones, selecciona Ver.
En la página Versiones, confirma que la versión que enviaste aparezca en la sección Disponible para verificadores (que muestra Version <N> • Submitted <Date> • Using AppFunctions from app bundle <versionCode>).
- Selecciona Ver en cualquier fila de versión para inspeccionar las AppFunctions detectadas y la instantánea de solo lectura de los detalles de la app capturada para esa versión.
- Las versiones creadas a partir de un paquete de aplicación subido en el que aún no seleccionaste Enviar la app conectada y continuar aparecen en Envío pendiente.

Paso 5: Prueba tu app conectada

Para que tu app conectada esté disponible para los verificadores, debes agregarlos en la página Administrar verificadores. Solo los usuarios que agregues a tu lista de verificadores podrán ver tu app conectada no publicada e interactuar con ella. Solo puedes agregar verificadores con una cuenta de @gmail.com.

En la página de resumen de tu app conectada, en la tarjeta Prueba tu app, selecciona Agregar verificadores (o Administrar verificadores si ya agregaste algunos).
En la página Administrar verificadores, selecciona las listas de direcciones de correo electrónico existentes o elige Crear lista de direcciones de correo electrónico para agregar las Cuentas de Google autorizadas para probar tu integración. Asegúrate de incluir tu propia dirección de correo electrónico si quieres probar la app.
Selecciona Guardar.

Nota: Una vez que agregues verificadores, tu app conectada puede tardar hasta 10 minutos en ser visible para esas cuentas.
Los verificadores en la app de Gemini pueden invocar tu app conectada escribiendo @ seguido del nombre de la app conectada y seleccionándola en el menú. También puedes ver y conectar tu app en Gemini navegando a Configuración y ayuda > Apps conectadas en la barra de navegación izquierda.

Antes de realizar pruebas integrado en el dispositivo, confirma que cada verificador cumpla con los siguientes requisitos:

Accede en un teléfono celular o una tablet Android con una Cuenta de Google incluida en la lista de correos electrónicos configurada en el paso 5.
Ejecutar la compilación exacta de la app para Android cuyo código de versión del paquete coincida con la versión enviada en el paso 4

Te recomendamos que pruebes tu integración de forma exhaustiva:

Prueba todas tus instrucciones de ejemplo.
Prueba las invocaciones explícitas de @<AppName> y las consultas en lenguaje natural.
Verifica la organización de parámetros de herramientas, las solicitudes de confirmación y la ejecución de extremo a extremo en tus AppFunctions.

Cuando estés conforme con las pruebas, podrás enviar tu app conectada a Google para que la revise.

Paso 6: Publica tu app conectada para los usuarios

A diferencia de las integraciones de MCP alojadas en servidores, una app conectada de Android MCP no requiere una acción de revisión o publicación independiente en la página de administración de apps conectadas. En cambio, Google revisa la versión de tu app conectada y la publica automáticamente cuando lanzas a producción la versión de la app de Play que contiene el paquete de aplicación de AppFunctions.

Cuando hayas completado las pruebas y todo esté listo para el lanzamiento a los usuarios, haz lo siguiente:

En Google Connected Console, abre tu app de Play vinculada y navega a Versión > Producción en el menú de navegación de la izquierda (o promueve tu versión probada de un segmento de pruebas a Producción).
Selecciona Crear nueva versión (o edita una versión de producción en borrador existente) y agrega el paquete de aplicación que contiene tus AppFunctions verificadas con Agregar desde la biblioteca o Subir.
Ve a la sección Se detectaron funciones de la app en el paquete de aplicación para confirmar la versión de la app conectada, el recuento de herramientas, el recuento de idiomas de la ficha de Play Store y la segmentación por país de la app de Google Play, y asegúrate de que las verificaciones automatizadas no muestren problemas de bloqueo.
Selecciona Enviar app conectada y continuar, completa los detalles de la versión y envía la versión de producción de tu app de Play para su revisión y lanzamiento.

Una vez que se apruebe y lance la versión de producción de tu app de Play, haz lo siguiente:

Tu app conectada de MCP para Android estará disponible en Gemini para Android para los usuarios de los países y los idiomas de segmentación de tu app de Play.
En la página de administración de tu app conectada (Apps conectadas > Administrar), la tarjeta Estado de la app conectada se actualiza a Publicada, y muestra el código de versión del paquete de aplicación publicado y la fecha de publicación. Además, la versión aparece en Publicada en la página Versiones.
Para enviar herramientas de AppFunctions actualizadas más adelante, compila un nuevo paquete de aplicación con un código de versión incrementado, pruébalo con un segmento de pruebas y publica una nueva versión de producción de Play. Si también quieres actualizar los metadatos públicos de tu app conectada (como las capacidades o las instrucciones de ejemplo), guarda esas ediciones en Apps conectadas > Administrar > Detalles de la app antes de subir el paquete de aplicación nuevo.

Actualiza tu paquete de aplicación para ajustar las AppFunctions

Si quieres iterar en AppFunctions durante las pruebas internas sin incrementar el código de versión de tu app para Android, puedes quitar y borrar un paquete de aplicación en borrador no publicado antes de volver a subirlo:

Actualiza la implementación de AppFunctions en tu proyecto de Android y genera un nuevo paquete de aplicación .aab.
Quita el paquete de aplicación anterior de cualquier versión en borrador en la que lo hayas agregado:
1. Abre tu app de Play vinculada en Google Connected Console y selecciona Pruebas internas (o el segmento que contiene tu versión en borrador) en el menú de navegación de la izquierda.
2. En la versión en borrador, selecciona Editar versión.
3. Busca el paquete de aplicación, selecciona el menú de tres puntos (⋮) y, luego, Quitar paquete de aplicación.
4. Selecciona Guardar como borrador.
Borra el paquete de aplicación sin usar de tu biblioteca:
1. En el menú de navegación izquierdo de tu app de Play, selecciona Versiones y paquetes más recientes (si no ves el paquete en la lista, selecciona Ver todos los paquetes de aplicaciones).
2. Abre los detalles del paquete de aplicación y, si el botón Borrar paquete de aplicación está disponible, selecciónalo. Esto libera el código de versión para que puedas subir el paquete de aplicación actualizado sin incrementar el código de versión.
Si la opción Borrar paquete de aplicación no está disponible (por ejemplo, porque la versión ya se publicó en un segmento), aumenta el versionCode en la configuración de compilación de la app, genera un paquete de aplicación nuevo, y sube y envía la versión nueva como se describe en el paso 4.

Cómo solucionar problemas relacionados con AppFunctions

Usa la siguiente guía para resolver errores de verificación automatizada y problemas comunes de configuración.

Cómo resolver errores de verificaciones automatizadas en un lanzamiento

Los problemas que se identifiquen con las verificaciones automatizadas de AppFunctions aparecen en la página de preparación de la versión (como Crear versión de prueba interna) y en la sección Con errores (con la insignia Corrige los problemas para publicar) en la página Versiones de la app conectada.

Si las verificaciones automáticas informan problemas con tu paquete de aplicación, sigue estos pasos:

Corrige los problemas subyacentes de AppFunctions en el código de tu app para Android y compila un paquete de aplicación actualizado.
Si tu versión anterior aún es un borrador y quieres volver a usar el mismo código de versión, haz lo siguiente:
1. En el menú de navegación de la izquierda de tu app de Play, selecciona Prueba interna (o el segmento correspondiente) y, luego, Editar versión en tu versión en borrador.
2. Selecciona el menú de tres puntos (⋮) junto al paquete de aplicación y, luego, Quitar paquete de aplicación.
3. Selecciona Guardar como borrador.
4. En el menú de navegación de la izquierda, selecciona Versiones y paquetes más recientes (selecciona Ver todos los paquetes de aplicación si es necesario), selecciona el paquete y, luego, Borrar paquete de aplicación.
5. Regresa a la versión en borrador, sube el paquete de aplicación corregido y selecciona Enviar la app conectada y continuar.
Si no se puede borrar el paquete anterior, incrementa el versionCode de tu paquete de aplicación, sube el paquete nuevo a tu versión y selecciona Enviar app conectada y continuar.

Problemas comunes de configuración y de integración

En la siguiente tabla, se describen los problemas habituales que podrías encontrar durante la configuración de la app conectada, la carga del paquete o las pruebas, junto con sus causas y soluciones:

Problema	Mensaje o síntoma de la consola	Causa	Solución
Se subió el paquete de aplicación antes de crear o vincular una app conectada	En la página de la versión, se muestra Crear o vincular una app conectada.	El archivo `.aab` que subiste contiene AppFunctions, pero la app de Play aún no está vinculada a una app conectada de MCP para Android.	Completa los pasos del 1 al 3 para crear una app conectada, selecciona Android MCP, vincula tu app de Play y guarda los detalles de la app. Luego, borra y vuelve a subir el paquete de aplicación, o sube un paquete nuevo con un `versionCode` incrementado.
Se subió el paquete de aplicación antes de guardar los detalles de la app conectada	En la página de la versión, se muestra el mensaje Se requieren detalles de la app conectada y el botón Proporcionar detalles de la app conectada.	La app de Play está vinculada a una app conectada de MCP para Android, pero los campos obligatorios de la página Detalles de la app no se guardaron antes de que se subiera el paquete.	Selecciona Proporcionar detalles de la app conectada (o ve a Apps conectadas > Administrar > Agregar detalles de la app), completa y guarda todos los campos obligatorios y, luego, borra y vuelve a subir el paquete o sube uno nuevo con un `versionCode` incrementado.
No se puede seleccionar la app de Play durante la vinculación	La app de Play de destino muestra una insignia de Ya vinculada o no aparece en el diálogo Seleccionar app.	Cada app de Play solo se puede vincular a una app conectada de MCP para Android, o bien la app de Play aún no se creó en esta cuenta de desarrollador.	Verifica las entradas existentes en Apps conectadas para ver si otra app conectada ya se vincula a tu app de Play, o bien crea la app de Play en Google Connected Console antes de vincularla.
No se puede crear una app conectada	No existe la opción para crear una app conectada, o bien, cuando se crea una, se muestra una advertencia de permisos o de las Condiciones del Servicio.	Tu cuenta de usuario no tiene permisos para las apps conectadas, o bien el propietario o administrador de la cuenta aún no aceptó las Condiciones del Servicio de las Apps conectadas.	Pídele al propietario o administrador de la cuenta que acepte las Condiciones del Servicio de las Apps conectadas y que le otorgue a tu cuenta el permiso Ver apps conectadas o Crear y administrar apps conectadas en la página Usuarios y permisos.
La versión de la app conectada se detiene en "Envío pendiente"	En Apps conectadas > Administrar > Versiones, la versión del paquete aparece en Envío pendiente en lugar de Disponible para verificadores.	Google Connected Console detectó AppFunctions en el paquete que subiste, pero la versión de la app conectada no se envió desde la página de la versión.	Abre la versión de la app de Play que contiene ese paquete y selecciona Enviar app conectada y continuar para que los verificadores puedan obtener una vista previa.
Ejemplo de error de validación de instrucciones en la página de detalles de la app	No se puede guardar el formulario de la tarjeta de la app pública y se muestra un error en Instrucciones de ejemplo.	Las instrucciones no cumplen con las reglas de formato o mención, o se editó el Nombre de la app después de escribir las instrucciones.	Proporciona entre tres y cuatro instrucciones en total: comienza al menos dos con `@<YourAppName>`, menciona `<YourAppName>` de forma natural sin `@` en al menos una y quita los prefijos numerados (`1.`, `2.`) o las comillas circundantes (`"..."`).
La app conectada no es visible para los verificadores en Gemini en Android	Los verificadores no pueden encontrar la app conectada en Apps conectadas ni usando una mención con `@` en la app de Gemini para Android.	La propagación aún está en curso, la cuenta de verificador no es apta o la versión de la app instalada no coincide.	Espera unos 20 minutos después del envío (y hasta 10 minutos después de guardar los verificadores). Confirma que el verificador use una cuenta personal de `@gmail.com` que esté en la lista de correos electrónicos guardada, que use un teléfono o una tablet Android, y que haya instalado la versión exacta del paquete enviado.