Las Acciones en apps permiten que los usuarios activen funciones existentes en tu app para Android con consultas a Asistente de Google. A continuación, se indican los cinco pasos principales que debes seguir para extender tu app para Android con las Acciones en apps:
- Identificar las funciones integradas de la app que se activarán
- Buscar un intent integrado (BII) que coincida con esas funciones
- Proporcionar detalles de entrega del BII
- Obtener una vista previa de tus Acciones en apps en un dispositivo de prueba
- Solicitar la revisión e implementación de Acciones en apps
Si deseas crear una Acción en la app con una app de ejemplo, sigue el codelab para extender una app para Android a Asistente de Google con Acciones en apps.
Requisitos
Antes de comenzar a desarrollar Acciones en apps, debes cumplir con los siguientes requisitos:
- Tener una Cuenta de Google con acceso a Google Play Console.
- Las Acciones en apps están disponibles solo para las apps que se hayan publicado en Google Play Store. Además, asegúrate de que tu app no esté diseñada para usarse en un perfil de trabajo, ya que las Acciones en apps no son compatibles con Google Play administrado.
- Contar con un dispositivo Android físico en el que se puedan probar tus Acciones en apps. La versión de SO recomendada es Android 8 (nivel de API 26) o una posterior, aunque las acciones se ejecutan en dispositivos con Android 5 (nivel de API 21) o versiones posteriores.
- Instalar la versión más reciente de Android Studio.
- Usar la misma Cuenta de Google para acceder a Android Studio, a Google app en tu dispositivo de prueba y a Google Play Console.
- Configurar y probar que Asistente funcione en el dispositivo de prueba; para esto, mantén presionado el botón de inicio.
Cómo identificar las funciones de la app
Primero, elige las actividades de tu app para las que sería bueno que Android acceda desde Acciones en apps. Estas actividades se deben configurar con las URLs de vínculos directos de Android y deben tener los filtros de intents correspondientes en el manifiesto de la app para Android. Las Acciones en apps usan URLs de vínculos directos que genera Asistente para llevar a los usuarios directamente a contenido específico de tu app.
Si deseas probar que tus actividades sean accesibles y que se puedan activar con Acciones en apps, ejecuta el siguiente comando adb:
adb shell am start -a android.intent.action.VIEW -d "AppLinksURL"
Esto se muestra en el siguiente ejemplo:
adb shell am start -a android.intent.action.VIEW -d "https://www.example.com/deeplink"
Si tu actividad no se inicia correctamente con el comando adb, verifica lo siguiente:
- En el archivo de manifiesto de la app, la actividad tiene el parámetro
android:exported=truede modo que se puede iniciar con intents de Asistente de Google. - Si usas URLs de App Links, sigue todos los pasos en el artículo sobre control de Android App Links.
Cómo buscar intents integrados que coincidan con las funciones de la app
Consulta la referencia de intents integrados para encontrar BIIs apropiados para tu caso de uso. Los BIIs modelan las consultas de los usuarios para las tareas que quieren realizar en tu app, por lo que debes buscar BIIs que coincidan con las funciones clave y los flujos de usuarios de tu app.
Por ejemplo, es más probable que una app de pedidos de comida use el BII actions.intent.ORDER_MENU_ITEM que una app de administración financiera. Las apps que implementan BIIs que no son temáticas o que son irrelevantes para las funciones de la app pueden crear una experiencia del usuario confusa y, por lo tanto, podrían no pasar la revisión de Acciones en apps.
Cómo proporcionar detalles de entrega para los BIIs
La mayor parte de la creación de una Acción en la app es crear el archivo actions.xml para la app, en el que se especifican los BIIs seleccionados y sus entregas correspondientes. Cuando un BII modela la consulta del usuario para una tarea, una entrega le brinda a Asistente información para realizar la tarea.
En tu archivo actions.xml, los BIIs se representan como elementos <action> y cada entrega se representa como un elemento <fulfillment>:
<actions>
<action intentName="actions.intent.ORDER_MENU_ITEM">
<fulfillment urlTemplate="exampleapp://browse{?food}">
<parameter-mapping intentParameter="menuItem.name" urlParameter="food" />
</fulfillment>
</action>
<action intentName="actions.intent.GET_THING">
<fulfillment urlTemplate="exampleapp://search{?query}">
<parameter-mapping intentParameter="thing.name" urlParameter="query"/>
</fulfillment>
</action>
</actions>
En la mayoría de los BIIs, debes extraer los parámetros del intent de la consulta del usuario en función de las entidades de schema.org. Luego, la app usa esos parámetros para dirigir a los usuarios a la función deseada. Por ejemplo, el código anterior asigna el parámetro del intent "thing.name" al parámetro de URL "query" en la plantilla de URL de vínculos directos.
Si deseas obtener detalles importantes sobre la creación de un archivo actions.xml, consulta la información sobre Cómo crear el archivo actions.xml. En la página del esquema, también se describe el modo en que debes especificar los valores de parámetros que espera tu app (conocido como inventario) y cómo actualizar el archivo AndroidManifest.xml para hacer referencia al recurso actions.xml.
Cómo obtener una vista previa de tus Acciones en apps
Prueba tu app en modo de borrador antes de enviarla a revisión. Para obtener más información, consulta Cómo preparar y lanzar una versión.
Durante las etapas de desarrollo y prueba, usa la herramienta de pruebas de Acciones en apps para comprobar que Acciones en apps funciona para tu app. Esta herramienta es un complemento de Android Studio que crea una vista previa de tus Acciones en apps en Asistente (para tu Cuenta de Google). Con esta herramienta, puedes probar las entregas en un dispositivo de prueba proporcionando BIIs con los parámetros de entrada que esperas recibir de los usuarios.
Durante la vista previa de tus Acciones en apps, también puedes activar consultas por voz en el dispositivo. Esta función solo está disponible para las consultas enumeradas en la referencia de BII de las Acciones en apps. Usa activadores de voz solo con fines demostrativos y no para pruebas periódicas.
Cómo solicitar la revisión y la implementación de Acciones en apps
Tus Acciones en apps no estarán disponibles para los usuarios hasta que se hayan revisado y aprobado. La revisión de Acciones en apps no afecta el estado de implementación y revisión de tu app para Android en Google Play. Incluso si se aprobara el envío de tu app, es posible que el archivo actions.xml todavía esté en proceso de revisión por parte de Google.
Luego, cuando implementes la app, las Acciones en apps permanecerán activadas. Sin embargo, Google revisa las versiones que se vuelven a implementar. Si la versión nueva no funciona correctamente o contiene incumplimientos de política, Google se reserva el derecho de desactivar las Acciones en apps para tu app.
Si deseas enviar tus Acciones en apps a revisión, haz lo siguiente:
- Cumple con los requisitos de implementación de Acciones en apps. Estos requisitos ayudan a optimizar tu app para Asistente y a garantizar que los usuarios disfruten de una experiencia fluida cuando usen Acciones en apps.
Acepta las Condiciones del Servicio de Actions on Google en Google Play Console (Precios y distribución > Consentimiento):
Sube la app (con el archivo
actions.xml) a Google Play Console como de costumbre para publicarla.Después de subir la app a Play Console, Google se comunicará contigo a través del correo electrónico que figura en Play Console con más información sobre el estado de la revisión de Acciones en apps.