Descripción general de Acciones en apps (obsoleto)

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Las Acciones en apps permiten a los usuarios iniciar funciones específicas en tu app con Asistente de Google. Si habilitas Acciones en apps para extender tu app, los usuarios podrán agregar vínculos directos a tus apps con facilidad a través de Asistente con solo pedírselo. Si el usuario ya instaló tu app, Asistente activará los vínculos directos cuando digan una frase de invocación que incluye el nombre de la app, como "Hey Google, pide pizza a PizzeríaDeEjemplo".

Para habilitar Acciones en apps, agrega un archivo actions.xml al proyecto de tu app para Android, que le indique a Google los intents integrados que se admiten. En algunos casos de uso, también puedes compilar Slices de Android y asociarlos en tu archivo actions.xml.

Las Acciones en apps son compatibles con Android 5 (nivel de API 21) y versiones posteriores. Los usuarios solo pueden acceder a Acciones en apps en teléfonos Android. Asistente, en Android Go, no las admite.

Casos de uso

Acciones en apps funciona mejor a los efectos de extender las funciones de tu app para Android a Asistente de Google:

  • Genera vínculos directos a las funciones de la app desde Asistente. Conecta tus vínculos directos existentes a las consultas de los usuarios que coincidan con los patrones predefinidos.
  • Muestra información de la app directamente en Asistente. Proporciona a los usuarios respuestas intercaladas y confirmaciones simples sin cambiar el contexto.

Cómo funciona Acciones en apps

Desde la perspectiva de un usuario, las Acciones en apps se comportan como atajos a partes de tu app para Android. Cuando un usuario invoca una Acción en la app, Asistente vincula su solicitud a un intent integrado registrado y a su entrega correspondiente. Esta coincidencia se basa en la información que proporcionas en el archivo actions.xml de la app.

Cuando la consulta de un usuario coincide con el patrón predefinido de un intent integrado, Asistente extrae parámetros de consulta en entidades de schema.org y genera una URL de vínculo directo de Android con las asignaciones que se encuentran en actions.xml.

Luego, Actions on Google usa la URL del vínculo directo, que se completó con los parámetros proporcionados por el usuario, a fin de llevarlo directamente al contenido específico de tu app para Android sin diálogo de conversación adicional. Para los intents integrados que usan una entrega de Slice de Android, Asistente responde al usuario de forma directa con la información solicitada.

Cuando un usuario proporciona una consulta al Asistente de Google, la respuesta se muestra en forma de un vínculo directo a la app o a un Slice de Android.
Figura 3: Ejemplo del flujo de consultas del usuario de Acciones en apps

Por ejemplo, un usuario invoca una Acción en la app con "Hey Google, solicita un viaje a SFO con AppDeViajesCompartidosDeEjemplo". Asistente asocia la consulta del usuario al intent integrado actions.intent.CREATE_TAXI_RESERVATION y extrae "SFO" como un parámetro del intent que coincide con una entidad de schema.org especificada en actions.xml. Asistente pasa el parámetro del intent a la entrega definida para ese intent integrado y, luego, genera el vínculo directo para el usuario en la app con el campo "SFO" que se completó previamente.

Acciones en apps usa vínculos directos de Android que ya implementaste en tu app para adelantar a los usuarios en ella desde Asistente. Con respecto a las Acciones en apps, también te recomendamos que admitas los vínculos directos con App Links, que asocia de manera digital URL HTTP/HTTPS con las apps y los sitios web de tu propiedad.

Cómo compilar Acciones en apps

Acciones en apps se compila sobre las funciones existentes de tu app para Android, y el proceso es similar para cada Acción en la app que implementes. Estas Acciones en apps llevan a los usuarios directamente a contenido específico de tu app con URLs de vínculos directos de Android, que puedes especificar con filtros de intents en el manifiesto de la app para Android.

Cuando creas una Acción en la app, el primer paso es identificar la actividad a la que quieres que los usuarios puedan acceder desde Asistente. Luego, con esa información, busca el intent integrado (BII) correspondiente más cercano en la referencia de BII de Acciones en apps.

Los intents integrados modelan algunas de las formas comunes en que los usuarios expresan las tareas que quieren realizar con una app o la información que buscan. Por ejemplo, los BIIs existen para realizar acciones como pedir una comida, reservar un viaje y consultar un saldo de cuenta.

Una vez que identifiques las funciones de la app y el BII que quieras implementar, debes crear un recurso actions.xml en tu app para Android que asigne el BII a las funciones de tu app. Las Acciones en apps definidas en actions.xml describen el modo en que cada BII resuelve su entrega, así como los parámetros que se extraen y se proporcionan a tu app.

Una parte significativa del desarrollo de las Acciones en apps asigna los parámetros de los intents integrados a los parámetros en tu entrega definida. Por lo general, este proceso consiste en considerar las entidades de schema.org en relación con las funciones de la app o crear un inventario de identificadores para tu intent integrado.

Cómo probar Acciones en apps

Durante las etapas de desarrollo y prueba, usa la herramienta de pruebas de Acciones en apps a fin de crear una vista previa de tus Acciones en apps en Asistente (para tu Cuenta de Google). Esta herramienta es un complemento de Android Studio que te ayuda a probar la forma en la que la Acción en la app controla varios parámetros antes de enviarlos para su implementación. Una vez que generes una vista previa de tu Acción en la app en la herramienta de pruebas, podrás activar una Acción en la app en el dispositivo de prueba directamente desde la ventana de herramientas de la prueba.

Próximos pasos

Sigue el codelab para extender una app para Android a Asistente de Google mediante Acciones en apps a fin de intentar compilar una Acción en la app con nuestra app para Android de muestra.

Luego, puedes consultar nuestras guías con el fin de compilar Acciones en apps para tu propia app. También puedes explorar estos recursos adicionales a los efectos de compilar Acciones en apps: