Les actions dans l'application permettent aux utilisateurs de déclencher des fonctionnalités existantes dans votre application Android en envoyant des requêtes à l'Assistant Google. Voici les cinq principales étapes à suivre pour étendre l'utilisation de votre application Android grâce à des actions dans l'application :
- Identifiez la fonctionnalité dans l'application à déclencher.
- Recherchez un intent intégré correspondant à la fonctionnalité intégrée dans l'application.
- Fournissez des détails de traitement pour l'intent intégré.
- Prévisualisez vos actions dans l'application sur un appareil de test.
- Demandez l'examen et le déploiement des actions dans l'application.
Pour essayer de créer une action dans l'application à l'aide d'une application exemple, suivez l'atelier de programmation Intégrer l'Assistant Google à une application Android grâce aux actions dans l'application.
Conditions requises
Avant de commencer à développer des actions dans l'application, assurez-vous de remplir les conditions suivantes :
- Vous devez disposer d'un compte Google ayant accès à la Google Play Console.
- Les actions dans les applications ne sont disponibles que pour les applications publiées sur le Google Play Store. Assurez-vous également que votre application n'est pas destinée à être utilisée dans un profil professionnel, car les actions dans les applications ne sont pas compatibles avec la version Google Play d'entreprise.
- Vous devez disposer d'un appareil Android physique pour pouvoir y tester les actions dans l'application. La version d'OS recommandée est Android 8 (niveau d'API 26) ou une version ultérieure, bien que les actions s'exécutent également sur les appareils fonctionnant sur Android 5 (niveau d'API 21) ou version ultérieure.
- Installez la dernière version d'Android Studio.
- Utilisez le même compte Google pour vous connecter à Android Studio, à l'appli Google sur votre appareil de test et à la Google Play Console.
- Configurer et tester le fonctionnement de l'Assistant sur votre appareil de test en appuyant de manière prolongée sur le bouton Accueil.
Identifier les fonctionnalités de l'application
Commencez par choisir les activités de votre application Android auxquelles il serait utile d'accéder via les actions dans l'application. Ces activités doivent être configurées avec des URL de liens profonds Android et doivent inclure des filtres d'intent correspondants dans le fichier manifeste de l'application Android. Les actions dans l'application utilisent des URL de liens profonds générées par l'Assistant pour rediriger les utilisateurs directement vers un contenu spécifique de votre application.
Pour vérifier que vos activités sont accessibles et qu'elles peuvent être déclenchées à l'aide des actions dans l'application, exécutez la commande adb suivante :
adb shell am start -a android.intent.action.VIEW -d "AppLinksURL"
Ce processus est illustré dans l'exemple suivant :
adb shell am start -a android.intent.action.VIEW -d "https://www.example.com/deeplink"
Si votre activité ne se lance pas correctement avec la commande adb, vérifiez les points suivants :
- Dans le fichier manifeste de votre application, l'activité contient
android:exported=trueafin que vous puissiez la lancer avec les intents de l'Assistant Google. - Si vous utilisez des URL de liens vers une application, suivez toutes les étapes de la section Gérer Android App Links.
Identifier les intents intégrés correspondant aux fonctionnalités de l'application
Consultez la documentation de référence sur les intents intégrés pour identifier les intents intégrés adaptés à vos cas d'utilisation. Les intents intégrés modélisent les requêtes des utilisateurs pour les tâches qu'ils souhaitent effectuer dans votre application. Vous devez donc rechercher ceux qui correspondent aux fonctionnalités clés et aux parcours utilisateur de votre application.
Par exemple, une application de commande de repas est plus susceptible d'utiliser l'intent intégré actions.intent.ORDER_MENU_ITEM. Les applications qui implémentent des intents intégrés n'ayant aucun rapport avec leur fonction peuvent créer une expérience utilisateur confuse et entraîner l'échec de l'examen des actions dans l'application.
Fournir les détails de traitement pour les intents intégrés
La création d'une action dans l'application consiste, en grande partie, à créer le fichier actions.xml pour votre application. Vous y spécifiez les intents intégrés sélectionnés et le traitement correspondant. Lorsqu'un intent intégré modélise la requête de l'utilisateur pour une tâche, le traitement fournit des informations à l'Assistant sur la manière d'effectuer la tâche.
Dans le fichier actions.xml, les intents intégrés sont représentés par des éléments <action>, tandis que chaque traitement est représenté par un élément <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>
Pour la plupart des intents intégrés, vous devez extraire les paramètres d'intent de la requête de l'utilisateur en fonction des entités schema.org. Votre application utilise ensuite ces paramètres d'intent intégré pour rediriger les utilisateurs vers la fonctionnalité souhaitée. Par exemple, le code ci-dessus mappe le paramètre d'intent "thing.name" avec le paramètre d'URL "query" dans le modèle d'URL de lien profond.
Pour vous familiariser avec certains points clés liés à la création d'un fichier actions.xml, consultez Créer le fichier actions.xml. La page de schéma explique également comment spécifier les valeurs de paramètre attendues par votre application (appelées "inventaire") et comment mettre à jour le fichier AndroidManifest.xml pour référencer la ressource actions.xml.
Prévisualiser les actions dans votre application
Testez votre application en mode brouillon avant de l'envoyer pour examen. Pour en savoir plus, consultez la page Préparer et déployer une version.
Lors du développement et des tests, l'outil de test des actions dans l'application permet de vérifier que ces actions fonctionnent dans votre application. Il s'agit d'un plug-in Android Studio qui génère un aperçu des actions dans l'application dans l'Assistant pour votre compte Google. Cet outil de test vous permet de tester vos traitements sur un appareil de test en fournissant des intents intégrés avec les paramètres d'entrée que vous attendez des utilisateurs.
Lorsque vous prévisualisez vos actions dans l'application, vous pouvez également déclencher des requêtes par commande vocale sur l'appareil. Cette fonctionnalité n'est disponible que pour les requêtes indiquées dans la documentation de référence sur les intents intégrés pour les actions dans les applications. N'utilisez le déclenchement vocal qu'à des fins de démonstration plutôt que pour des tests standards.
Demander l'examen et le déploiement des actions dans l'application
Les utilisateurs n'auront pas accès aux actions dans votre application tant qu'elles n'auront pas été examinées et approuvées. L'examen des actions dans l'application n'a pas d'incidence sur l'état de l'examen et du déploiement de votre application Android dans Google Play. Même si l'envoi de votre application est approuvé, il est possible que le fichier actions.xml soit toujours en cours d'examen par Google.
Lorsque vous déploierez votre application par la suite, les actions dans l'application resteront activées. Toutefois, les versions redéployées sont soumises à un examen de la part de Google. Si la nouvelle version ne fonctionne pas correctement ou qu'elle ne respecte pas les règles, Google se réserve le droit de désactiver les actions dans votre application.
Pour demander l'examen des actions dans votre application, procédez comme suit :
- Respectez les exigences concernant le déploiement d'actions dans les applications. Celles-ci contribuent à optimiser votre application pour l'Assistant et à offrir aux utilisateurs une expérience fluide lorsqu'ils ont recours aux actions dans l'application.
Acceptez les conditions d'utilisation d'Actions on Google dans la Google Play Console (Tarifs et disponibilité > Consentement) :
Importez normalement votre application (contenant
actions.xml) dans la Google Play Console pour la publier.Une fois votre application importée dans la Play Console, Google vous contactera à l'adresse e-mail associée à votre compte Play Console pour vous fournir des informations supplémentaires sur l'état de l'examen des actions dans votre application.