Avant de publier votre action, vous devez la tester attentivement, spécifier les surfaces, les emplacements et les appareils cibles, et vérifier qu'elle respecte les règles de Google relatives aux actions. Cette page présente les tâches que vous devez effectuer lorsque vous préparez l'envoi de votre action pour examen, en vue de sa publication en version bêta ou de production.
Vérifier la conformité au règlement
Vérifiez que votre action respecte les règles d'Actions on Google. En règle générale, suivez ces consignes pour votre contenu:
- Soyez précis:les utilisateurs doivent être en mesure d'appeler votre action spécifique. Ne soyez pas trop large ni trop vague lorsque vous choisissez un nom à afficher ou une prononciation. Par exemple, utilisez "Parler à WeatherApp pour consulter la météo à [ville]" au lieu de "Consulter la météo pour [ville]" comme expression d'action. Suivez les consignes pour fournir de bonnes expressions d'action.
- Éviter les contenus interdits:les actions comportant un contenu explicitement sexuel, violent, illégal ou incitant à la haine enfreignent les règles d'Actions on Google, sauf si elles ont un objectif scientifique, artistique, documentaire ou éducatif. Les actions incitant à l'intimidation ou au harcèlement seront également refusées ou supprimées.
- Respectez les droits d'auteur et la propriété intellectuelle:assurez-vous de disposer des droits appropriés pour utiliser le contenu proposé par votre action.
- Soyez honnête:n'induisez pas les utilisateurs en erreur et ne les trompez pas.
- Protégez la confidentialité et la sécurité des utilisateurs:soyez transparent sur la gestion des données utilisateur, la transmission sécurisée des données utilisateur et la mise en place de règles de confidentialité.
- N'écoutez pas les utilisateurs non invités:les utilisateurs doivent savoir quand votre action attend leur entrée. Il est fréquent, comme indiqué dans nos Règles, de laisser le micro activé sans en informer l'utilisateur. Assurez-vous que votre action informe l'utilisateur lorsqu'elle attend une commande pour réduire le risque que votre action soit refusée.
- Vérifiez les noms à appeler et à afficher:assurez-vous que le nom d'appel est cohérent avec le nom à afficher, qui apparaît sur la page de votre répertoire Assistant. Assurez-vous que les deux noms sont suffisamment spécifiques pour que les utilisateurs puissent facilement appeler votre action. Les noms d'appel et les noms à afficher doivent également respecter les règles d'Actions on Google.
Consultez la liste complète des règles et assurez-vous de les respecter pour accélérer l'examen et l'approbation de votre action.
Définir le nom à afficher
Le nom à afficher définit la manière dont les utilisateurs appellent explicitement votre action. Ce nom est également utilisé dans le répertoire de l'Assistant.
Pour définir le nom à afficher:
- Accédez à Développer > Appel > Paramètres.
- Saisissez le nom à afficher de votre action.
- Cliquez sur l'icône Lecture play_circle_filled pour entendre la prononciation du nom.
Modifier votre nom à afficher
Vous pouvez modifier le nom à afficher de votre action à tout moment. Toutefois, votre action fera l'objet d'un autre examen complet avant que les utilisateurs ne puissent l'appeler à l'aide du nouveau nom.
Facultatif: spécifier le ciblage géographique
Par défaut, votre action est disponible dans toutes les régions tant que les paramètres régionaux de l'appareil de l'utilisateur sont définis sur une variante "anglaise" (par exemple, anglais américain ou anglais britannique).
Le paramètre Ciblage géographique détermine la disponibilité régionale de votre action.
En savoir plus sur la publication localisée
Facultatif: spécifier les capacités de la surface
Votre action peut apparaître sur différentes surfaces compatibles avec l'Assistant, telles que les téléphones (Android et iOS) et les écrans connectés.
Les fonctionnalités de surface vous permettent de contrôler si les utilisateurs peuvent appeler votre action en fonction de la surface qu'ils utilisent. Si les utilisateurs tentent d'appeler votre action sur une surface non compatible, ils reçoivent un message d'erreur indiquant que leur appareil n'est pas compatible.
En savoir plus sur les fonctionnalités de surface
Facultatif: spécifiez les options Interactive Canvas.
Si votre action utilise Interactive Canvas, vous devez activer et définir quelques options sous Develop > Interactive Canvas dans le panneau de navigation de gauche.
- Activez l'option permettant d'utiliser Interactive Canvas avec votre action.
- Saisissez l'URL de l'application Web qui héberge les éléments visuels de votre action.
Tester avec le simulateur
Avant de publier votre action, utilisez le simulateur pour tester l'expérience utilisateur de votre action et vous assurer que tout fonctionne correctement.
Recherchez les erreurs et problèmes courants suivants:
- Le transport du webhook doit être sécurisé:vérifiez que vous utilisez le chiffrement HTTPS (TLS) sur le transport de vos webhooks.
- Vérifier les requêtes de webhook:veillez à signer vos requêtes de webhook à l'aide du SDK Actions et à les valider dans votre webhook.
- Tester le nom de votre action:assurez-vous que le nom d'action que vous avez défini déclenche systématiquement votre action. Utilisez un appareil physique ou le simulateur Web et prononcez le nom de votre appel de façon répétée, dans différents scénarios réels (par exemple, avec du bruit de fond, ou à différentes distances de l'appareil). Si possible, demandez aux personnes de sexes différents ou ayant des accents différents d'appeler votre action. Si le nom de votre appel n'est pas toujours reconnu, vous pouvez le modifier.
- Tester sur des appareils physiques:bien que le simulateur Web soit idéal pour tester rapidement votre action pendant le développement, vous devez toujours tester les appels et les boîtes de dialogue sur des appareils réels. Il s'agit du meilleur moyen de comprendre comment votre action fonctionne concrètement et d'améliorer l'expérience utilisateur.
Pour tester votre brouillon de projet Actions actuel, accédez à Test dans la navigation principale. Cela garantit que la version actuelle de votre action est utilisée sur le simulateur, la console et les appareils avec Assistant Google intégré.
En savoir plus sur le simulateur Actions
Libérer votre projet
Une fois que vous avez testé votre brouillon de projet et que vous êtes satisfait des résultats, vous pouvez le déployer en version alpha ou bêta afin d'effectuer des tests supplémentaires. Vous pouvez également l'envoyer pour examen et la publier pour les utilisateurs de l'Assistant.
Dans la section Déployer > Version de la console, les options suivantes sont disponibles:
- Alpha: idéal pour les itérations de test rapide. Votre action est distribuée à un petit groupe d'utilisateurs que vous définissez sans passer par un examen complet de Google.
- Bêta: méthode recommandée pour distribuer votre action à un nombre limité d'utilisateurs après un examen complet par Google. Étant donné que l'action a passé l'examen complet, vous pouvez choisir de la rendre publique à tout moment.
- Production: votre action est envoyée pour examen complet par Google. Une fois approuvée, votre action sera disponible pour les utilisateurs de l'Assistant.
En savoir plus sur les versions
État du déploiement
Le tableau suivant décrit les différents états de déploiement d'un projet et les étapes supplémentaires requises:
| État du déploiement | Description |
|---|---|
| En cours d'examen |
Lorsque vous envoyez un nouveau déploiement, il passe par un processus d'approbation. Les examinateurs testent votre action et vérifient que vous n'avez enfreint aucune règle. Une fois l'examen terminé, vous recevrez un e-mail vous indiquant si votre déploiement a été approuvé ou non. |
| Refusé | L'état "Refusé" signifie que votre déploiement n'a pas été approuvé. Vous devriez recevoir un e-mail expliquant pourquoi votre déploiement a été refusé. Vous pouvez également cliquer sur Pourquoi ? à côté de l'état Refusé dans la console pour connaître la raison du refus. |
| Déployé | Action approuvée active et diffusée auprès des utilisateurs. Vous pouvez "retirer" une version déployée à tout moment dans la console. |
| Approuvé | Action qui a été examinée et n'est pas actuellement diffusée auprès des utilisateurs. Lorsqu'une action a déjà fait l'objet d'un examen, elle peut être publiée à tout moment dans la console, sans nécessiter d'examen supplémentaire. |
| Mauvais | Google envoie régulièrement des requêtes au point de terminaison de votre action et vérifie que nous obtenons une réponse appropriée. Si nous détectons que votre point de terminaison est indisponible ou ne répond pas, nous cessons temporairement de diffuser votre action auprès des utilisateurs. Dans ce cas, vous recevez un e-mail vous informant que votre point de terminaison n'est pas opérationnel et l'état de votre action passe à Non opérationnel. Dès que nous aurons détecté que votre point de terminaison sera de nouveau réactif, nous réactiverons la diffusion de votre action auprès des utilisateurs. Vous recevrez un e-mail lorsque l'état de votre déploiement indiquera Déployé. |
| Retiré | Si nous détectons un non-respect des règles après le déploiement, Google pourra supprimer votre action. Dans ce cas, vous recevez un e-mail. De plus, une bannière s'affiche dans la Play Console pour vous informer que votre action a été retirée. Vous pouvez cliquer sur Pourquoi ? pour connaître la justification et afficher les options permettant de corriger le non-respect des règles ou de faire appel de la décision. |
Gérer les versions de votre projet
Au fil du temps, vous pouvez actualiser les informations sur votre action. Les modifications apportées à une action entraînent la création d'une nouvelle version du projet. Chaque nouvelle version doit être soumise et soumise à un processus d'examen complet avant que l'action mise à jour soit publiée et diffusée auprès du public.
Pour effectuer l'une des modifications suivantes, vous devez renvoyer une action pour examen:
- Une modification est apportée à la console pour modifier la description, l'icône ou d'autres métadonnées du projet.
- Vous avez modifié votre projet Actions à l'aide d'Actions Builder ou du SDK Actions.
- Vous avez modifié votre package d'actions à l'aide de l'ancien SDK Actions.
- Avec Dialogflow, vous avez apporté des modifications à votre agent Dialogflow.
Vous n'avez pas besoin de renvoyer votre projet dans les cas suivants:
- Vous n'avez apporté des modifications à votre code que dans un webhook hébergé en externe, l'éditeur de webhook intégré dans Actions Builder ou l'éditeur intégré de Dialogflow.
- Vous utilisez des modèles et vous avez mis à jour les données de vos modèles en important du contenu dans Google Sheets.
Pour faire examiner votre action mise à jour, accédez à Déployer > Version et cliquez sur Créer une version. Si elle est approuvée, la version précédente sera annulée et les utilisateurs de l'Assistant auront accès à la dernière version de votre action.
Suivre et modifier les versions
Pour suivre et obtenir des informations sur vos versions, accédez à Déployer > Version et cliquez sur la version concernée.
Le tableau indique la date de la dernière modification et l'état actuel de la version. Vous pouvez apporter des modifications spécifiques à l'état, en fonction de l'état actuel de la version.
- Si une version est en cours d'examen, vous pouvez choisir de la retirer de l'examen.
- Si une version est déployée, vous pouvez sélectionner Annuler le déploiement en production pour annuler l'action.
- Lorsqu'une version précédente est annulée, vous pouvez sélectionner Déployer en production pour rétablir cette version.