Cómo compilar Acciones en apps (obsoleto)

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

Las Acciones en apps permiten que los usuarios de tu app para Android activen funciones existentes de ella con consultas al Asistente de Google. A continuación, se indican los cinco pasos principales que debes seguir a fin de extender tu app para Android con las Acciones en apps:

  1. Identificar las funciones integradas de la app que se activarán
  2. Buscar un intent integrado (BII) que coincida con esas funciones
  3. Proporcionar detalles de entrega del intent integrado
  4. Obtener una vista previa de tus Acciones en apps en un dispositivo de prueba
  5. 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 paraextender 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 pueden ejecutar hasta la versión Android 5 (nivel de API 21).
  • 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 a 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 a fin de 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"

Por 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=true de 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 a fin de encontrar BII apropiados para tu caso de uso. Los intents integrados modelan las consultas de los usuarios para las tareas que quieren realizar en tu app, por lo que debes buscar BIIs que coincidan con la función clave y los flujos de usuarios de tu app. Por ejemplo, es más probable que una app de pedidos de comida use el intent integrado actions.intent.ORDER_MENU_ITEM, y no que lo haga 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, pueden fallar la revisión de Acciones en apps.

Cómo brindar detalles de entrega de intents integrados

La mayor parte de la creación de una Acción en la app consiste en crear el archivo actions.xml para la app, en el que se especifican los intents integrados que seleccionaste y la entrega correspondiente. Cuando un BII modela la consulta del usuario para una tarea, una entrega le brinda al Asistente información para realizar la tarea.

En el archivo actions.xml, los intents integrados 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 intents integrados, 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 de 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 para 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

Puedes usar una versión de borrador de la app para las pruebas. Si deseas obtener más información, consulta Cómo preparar y lanzar versiones. Te recomendamos que pruebes tu app en modo de borrador antes de enviarla para su revisión.

Durante las etapas de desarrollo y prueba, usa la herramienta de pruebas de Acciones en apps a fin de 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 que se muestran en la referencia de intents integrados de Acciones en apps. Te recomendamos que uses la activación por voz solo con fines de demostración y no para realizar pruebas periódicas.

Cómo solicitar la revisión e 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:

  1. 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.
  2. Acepta las Condiciones del Servicio de Actions on Google en Google Play Console (Precios y distribución > Consentimiento):

    Condiciones del Servicio de Actions on Google en Google Play Console.

  3. Sube la app (con el archivo actions.xml) a Google Play Console como de costumbre para publicarla.

  4. Después de subir la app a Play Console, nos comunicaremos contigo mediante el correo electrónico que figura en Play Console con más información sobre el estado de tu revisión de Acciones en apps.