Annuler votre action

En testant votre action auprès d'utilisateurs, vous pouvez obtenir des commentaires à l'avance et résoudre les problèmes techniques ou liés à l'expérience utilisateur avant de la publier à grande échelle.

La console Actions est compatible avec les environnements de release. Vous pouvez ainsi autoriser un nombre limité d'utilisateurs à tester une nouvelle action, ou une version plus récente de votre action existante, avant de la déployer publiquement.

Cycle de vie d'une version

Le schéma suivant montre les chemins potentiels que le cycle de vie d'une action peut emprunter:

Figure 1 : Cycle de vie d'une action avec les environnements de release.

La console Actions accepte deux types d'environnements de préproduction:

• Alpha: cette version permet de tester rapidement les premières versions de votre action.

  • Vous permet de distribuer votre action à un petit groupe d'utilisateurs sans passer par un examen Google complet.
  • Les utilisateurs reçoivent des avertissements indiquant que l'action n'a pas été examinée par Google pour vérifier qu'elle respecte le règlement.
  • Cette solution est idéale pour les tests internes.

• Bêta: ce canal vous permet de distribuer une action à un nombre limité d'utilisateurs après avoir passé un examen complet de la part de Google.

  • Vous devez l'utiliser pour permettre aux utilisateurs externes à votre organisation d'accéder aux versions préliminaires de l'action.
  • Les utilisateurs seront informés que l'action est une version preview.
  • La version bêta ayant été examinée par Google et ayant été approuvée par Google, vous pouvez choisir de la rendre publique à tout moment, sans nécessiter de nouvel examen par Google.

Remarque :Vous ne pouvez publier qu'une seule version alpha ou bêta de votre action.

Comparaison des environnements de publication

Le tableau ci-dessous récapitule les différences entre les canaux de déploiement.

	Simulateur	Alpha	Bêta	Production
Audience visée	Développeur uniquement	Les premiers testeurs de votre équipe, de vos amis et de votre famille	Testeurs extérieurs à votre équipe	Tous les utilisateurs de l'Assistant Google
Examen Google requis	Non	Non	Oui	Oui
Autorisations d'accès	Développeur uniquement	Liste d'utilisateurs définie par le développeur. Les utilisateurs doivent l'activer.	Liste d'utilisateurs définie par le développeur. Les utilisateurs doivent l'activer.	Disponible pour tous les utilisateurs de l'Assistant Google
Nombre maximal d'utilisateurs	1	20	200	N/A
Pays dans lesquels l'assistant Wi-Fi est disponible	Simulateur et tous les appareils dotés de l'Assistant	Tous les appareils dotés de l'Assistant	Tous les appareils dotés de l'Assistant	Tous les appareils dotés de l'Assistant
Actions Builder	Compatible	Compatible	Compatible	Oui
SDK Actions	Compatible	Compatible	Compatible	Oui
Dialogflow	Compatible	Compatible	Compatible	Oui
Maison connectée	Compatible (association de compte requise)	Non autorisé	Non autorisé	Oui
Modèles	Compatible	Incompatible	Non autorisé	Oui
Appel explicite	Compatible	Compatible	Compatible	Oui
appel implicite	Compatible	Compatible	Compatible	Oui
Associer des comptes	Compatible	Compatible	Compatible	Oui

Remarque :Si vous utilisez la gestion des versions de Dialogflow, vous pouvez déployer différentes versions sur différents environnements de publication. Pour en savoir plus, consultez Envoyer votre projet.

Gérer les tests pour les versions alpha ou bêta

Pour configurer vos tests alpha ou bêta, procédez comme suit:

1. Cliquez sur Gérer les testeurs alpha ou sur Gérer les testeurs bêta.

2. Saisissez les adresses e-mail des testeurs en les séparant par une virgule. Vous pouvez spécifier jusqu'à 20 testeurs pour les tests alpha et jusqu'à 200 testeurs pour les tests bêta.

   Remarque :Les testeurs doivent disposer d'un compte Google (@gmail.com) ou Google Workspace. Vous ne pouvez pas désigner plusieurs utilisateurs via un alias d'adresse e-mail de groupe Google.

   

3. Copiez le lien d'activation pour le partager avec vos testeurs.

4. Cliquez sur Enregistrer.

Vous devez leur envoyer un e-mail d'invitation contenant un lien vers la version alpha ou bêta de votre action (lien d'activation). Pour en savoir plus, consultez Obtenir des commentaires.

Lien d'activation

Le lien d'activation représente votre page de répertoire d'actions et ne change jamais. Le lien redirige les testeurs vers votre page d'annuaire et vers la fiche d'activation pour l'environnement éligible. Si vous avez listé les mêmes testeurs pour les versions alpha et bêta, ils sont éligibles pour les deux et voient d'abord une fiche d'activation pour la version alpha.

Implémenter le traitement pour une version alpha ou bêta

Les informations sur la version disponible ne sont pas incluses dans la requête HTTP envoyée par l'Assistant à votre traitement. Pour gérer les versions disponibles dans votre traitement, vous devez fournir différentes URL de traitement (par exemple, une URL pour la version bêta et une autre pour la version de production de votre action).

Obtenez des retours

Une fois que votre action est disponible en version alpha ou bêta, vous devez inviter les testeurs en partageant votre lien d'activation (identique à celui qui figure dans votre annuaire de l'Assistant).

Veillez à indiquer à vos testeurs qu'ils doivent:

• Télécharger l'application Assistant Google sur leurs appareils mobiles afin d'effectuer des tests alpha ou bêta.
• Connectez-vous à l'application Assistant Google avec le compte que vous avez désigné comme testeur alpha ou bêta.

Une fois votre action déployée, les nouveaux testeurs doivent attendre au moins trois heures avant de pouvoir y accéder à l'aide du lien d'activation.

Lorsque les utilisateurs cliquent sur ce lien, ils sont redirigés vers la page de répertoire de l'action correspondante. Il doit cliquer sur le bouton J'accepte en bas de la page d'annuaire de l'action pour s'inscrire en tant que testeur pour la première fois.

Une fois que le testeur l'a activée sur son téléphone, votre action est immédiatement disponible sur tous ses appareils. Les testeurs verront votre action dans la section Mes applications de l'application Assistant Google avec l'un des modes suivants: Alpha, Bêta ou Aucun test. L'option No testing (Aucun test) permet d'afficher la version de production de votre action, si elle est disponible. En l'absence de version de production, aucun contenu ne sera envoyé aux utilisateurs.

Remarque :Les utilisateurs ne peuvent pas évaluer votre action dans l'application Assistant Google s'ils utilisent des versions alpha ou bêta. À la place, vous devez fournir aux testeurs un moyen de fournir des commentaires par e-mail, via un site Web, un forum ou un autre mécanisme approprié.

Bonnes pratiques

• Assurez-vous que les utilisateurs peuvent participer aux tests. Vos testeurs doivent disposer d'un compte Google (@gmail.com) ou G Suite pour participer à un test.
• Choisissez le type de test approprié. Un groupe de test alpha doit être réduit et doit tester les versions expérimentales les moins stables de vos actions (par exemple, au sein de votre entreprise ou de votre équipe). Utilisez les tests bêta auprès d'un groupe d'utilisateurs plus important pour tester les versions stables de vos actions, proches du lancement.
• Fournissez aux testeurs un canal sur lequel ils peuvent vous envoyer leurs commentaires. Les versions alpha et bêta ne sont disponibles que pour vos propres testeurs. Assurez-vous de leur donner la possibilité de vous faire part de leurs commentaires par e-mail, via un site Web, dans un forum ou par tout autre mécanisme approprié.
• Exécutez des tests simultanés sur la même action. Vous pouvez exécuter des tests alpha et bêta simultanément.

Problèmes connus

• L'activation de la version alpha ou bêta n'est pas possible dans le répertoire de l'Assistant pour le Web. Assurez-vous que vos testeurs suivent le lien sur leur appareil mobile (Android ou iOS).
• Un délai de quelques heures peut être nécessaire avant que vos modifications ne soient prises en compte. Veuillez patienter un certain temps avant de partager le lien d'activation avec vos utilisateurs.

Créer une version alpha ou bêta

Pour déployer votre action dans la version alpha ou bêta, procédez comme suit:

1. Dans la console Actions, cliquez sur Déployer > Publier.

2. Cliquez sur Lancer une nouvelle version.

   

3. Sélectionnez Alpha ou Bêta, puis cliquez sur Envoyer.

4. Si vous y êtes invité, indiquez que vous avez terminé les étapes requises dans la checklist Exigences liées à l'examen des actions.

5. Le cas échéant, sélectionnez les langues de votre version.

6. Cliquez sur Envoyer.

Une fois la version alpha ou bêta envoyée, elle apparaît dans la section Gérer les versions.

Remarque :Une fois le déploiement effectué, votre version est associée à l'état Déployé pendant trois heures maximum avant d'être disponible pour vos utilisateurs. Une fois le déploiement terminé, les autres versions actives de cet environnement sont supprimées.

Remarque :Si vous êtes un développeur du projet, la version de test est activée par défaut sur votre appareil. Si vous souhaitez accéder aux versions alpha et bêta, désactivez l'option Test sur l'appareil dans le simulateur de la console Actions.

Mettre à niveau une version alpha ou bêta vers la version de production

Il peut s'agir d'un déploiement complet auprès de tous les utilisateurs de l'Assistant Google, ou d'un déploiement par étapes dans des régions spécifiques ou auprès d'un certain pourcentage d'utilisateurs. Les déploiements par étapes permettent de tester la stabilité de votre projet d'action. Il est préférable de limiter le nombre d'utilisateurs et d'augmenter progressivement le nombre d'utilisateurs jusqu'à atteindre 100% des utilisateurs. Cela vous permet de corriger les bugs avant de déployer l'application pour l'ensemble de la base d'utilisateurs.

Remarque :Qu'elle soit déployée sous la forme d'un déploiement complet ou par étapes, votre action doit passer un processus d'examen avant son déploiement en production. Un seul examen est requis. Toutefois, si votre action est modifiée, elle doit être réexaminée. Vous devez envoyer une nouvelle version de votre action en version bêta ou en production pour lancer un examen.

Déploiement par étapes

Les déploiements par étapes permettent aux développeurs de gérer leurs versions de production en les lançant à un sous-ensemble d'utilisateurs et en les généralisant progressivement à tous les utilisateurs. Vous pouvez augmenter progressivement le nombre de régions ou le pourcentage d'utilisateurs dans votre déploiement.

Remarque :Vous ne pouvez pas sélectionner de pourcentage d'utilisateurs dans une région sélectionnée. Vous ne pouvez pas passer d'un type de préproduction à l'autre (emplacement ou pourcentage d'utilisateurs) lors de la mise à niveau d'une version en cours. Vous devez annuler la version et en démarrer une nouvelle si vous souhaitez modifier le type de préproduction. Il ne peut y avoir qu'une seule version active dans le canal de déploiement par étapes.

Pour déployer votre action par étapes, procédez comme suit:

1. Sous Gérer les versions, sélectionnez la version à mettre à niveau vers le déploiement en production.
2. Cliquez sur Gérer les déploiements.
3. Sélectionnez Déployer en production.
4. Sélectionnez Déploiement par étapes.
5. Cliquez sur Sélectionner un type de déploiement.

6. Sélectionnez Zones géographiques spécifiées ou Pourcentage d'utilisateurs. Pour en savoir plus sur cette sélection, consultez Déployer selon les zones géographiques spécifiées ou Déployer par pourcentage de la base d'utilisateurs.

   

7. Cliquez sur Envoyer.

Pour avancer dans l'étape de déploiement, consultez Avancer l'étape de déploiement d'une version.

Déploiement complet

Si vous sélectionnez cette option, votre projet d'action sera disponible pour tous les utilisateurs dans tous les pays que vous ciblez.

Pour déployer votre action en tant que déploiement complet, procédez comme suit:

1. Sous Gérer les versions, sélectionnez la version à mettre à niveau vers le déploiement en production.

2. Cliquez sur Gérer les déploiements.

   

3. Sélectionnez Déployer en production.

4. Sélectionnez Déploiement complet.

5. Cliquez sur Envoyer.

Créer une version de production sans tests alpha ou bêta

Il peut s'agir d'un déploiement complet auprès de tous les utilisateurs de l'Assistant Google, ou d'un déploiement par étapes dans des régions spécifiques ou auprès d'un certain pourcentage d'utilisateurs. Les déploiements par étapes permettent de tester la stabilité de votre projet d'action. Il est préférable de limiter le nombre d'utilisateurs et d'augmenter progressivement le nombre d'utilisateurs jusqu'à atteindre 100% des utilisateurs. Cela vous permet de corriger les bugs avant de déployer l'application pour l'ensemble de la base d'utilisateurs.

Remarque :Qu'elle soit déployée sous la forme d'un déploiement complet ou par étapes, votre action doit passer un processus d'examen avant son déploiement en production. Un seul examen est requis. Toutefois, si vous modifiez votre action et la publiez en production, elle doit être réexaminée. Vous devez envoyer une nouvelle version de votre action en version bêta ou de production pour lancer un examen.

Déploiement par étapes

Les déploiements par étapes permettent aux développeurs de gérer leurs versions de production en les lançant à un sous-ensemble d'utilisateurs et en les généralisant progressivement à tous les utilisateurs. Vous pouvez augmenter progressivement le nombre de régions ou le pourcentage d'utilisateurs dans votre déploiement.

Remarque :Vous ne pouvez pas sélectionner de pourcentage d'utilisateurs dans une région sélectionnée. Vous ne pouvez pas passer d'un type de préproduction à l'autre (emplacement ou pourcentage d'utilisateurs) lors de la mise à niveau d'une version en cours. Vous devez annuler la version et en démarrer une nouvelle si vous souhaitez modifier le type de préproduction. Il ne peut y avoir qu'une seule version active dans le canal de déploiement par étapes.

Pour déployer votre action par étapes, procédez comme suit:

1. Dans la console Actions, cliquez sur Déployer > Publier.

2. Cliquez sur Lancer une nouvelle version.

   

3. Sélectionnez Production.

4. Si vous y êtes invité, indiquez que vous avez terminé les étapes requises dans la checklist Exigences liées à l'examen des actions.

5. Le cas échéant, sélectionnez les langues de votre version.

6. Sélectionnez Déploiement par étapes.

7. Cliquez sur Sélectionner un type de déploiement.

8. Sélectionnez Zones géographiques spécifiées ou Pourcentage d'utilisateurs. Pour en savoir plus sur cette sélection, consultez Déployer selon les zones géographiques spécifiées ou Déployer par pourcentage de la base d'utilisateurs.

   

9. Cliquez sur Envoyer.

Déploiement selon les emplacements spécifiés

Si vous sélectionnez cette option, votre projet Action est libéré dans les pays ou régions de votre choix.

Pour déployer votre action par zone géographique, procédez comme suit:

1. Cliquez sur Sélectionner des pays ou des régions, puis cochez les cases correspondant aux régions à cibler pour votre version.

2. Cliquez sur Envoyer.

   Remarque :Seules les régions que vous avez sélectionnées dans le ciblage géographique sont autorisées.

Déployer en fonction d'un pourcentage de la base d'utilisateurs

Cette option libère votre action auprès d'un pourcentage d'utilisateurs sélectionnés de manière aléatoire.

Pour déployer votre action auprès d'un certain pourcentage d'utilisateurs, procédez comme suit:

1. Cliquez sur Pourcentage d'utilisateurs.

2. Sélectionnez le pourcentage d'utilisateurs auprès desquels vous souhaitez libérer votre action.

   

3. Cliquez sur Envoyer.

   Remarque :Vous pouvez annuler ce type de version en définissant le pourcentage sur 0%.

Déploiement complet

Si vous sélectionnez cette option, votre projet d'action sera disponible pour tous les utilisateurs dans tous les pays que vous ciblez.

Pour déployer votre action en tant que déploiement complet, procédez comme suit:

1. Dans la console Actions, cliquez sur Déployer > Publier.

2. Cliquez sur Lancer une nouvelle version.

   

3. Sélectionnez Production.

4. Si vous y êtes invité, indiquez que vous avez terminé les étapes requises dans la checklist Exigences liées à l'examen des actions.

5. Le cas échéant, sélectionnez les langues de votre version.

6. Sélectionnez Déploiement complet.

7. Cliquez sur Envoyer.

Une fois la version de production envoyée, elle apparaît dans la section Gérer les versions.

Remarque :Une fois le déploiement effectué, votre version est à l'état Déployé pendant trois heures maximum avant d'être disponible pour vos utilisateurs. Une fois le déploiement terminé, le déploiement des autres versions actives dans cet environnement est automatiquement annulé.

Modifier une version ou annuler son déploiement

Une fois que vous avez soumis votre action à une version disponible, vous pouvez toujours la modifier. Vous pouvez tester la version actuelle, retirer la version pour examen, afficher ses détails, gérer les déploiements, annuler le déploiement et mettre à niveau le déploiement. Vous y trouverez également des informations sur les versions précédentes.

Afficher et modifier une version

Pour afficher les détails de la version ou modifier celle de votre action, procédez comme suit:

1. Sous Gérer les versions, sélectionnez la version sous Nom de la version.
2. Sélectionnez Modifier le déploiement, Gérer les déploiements ou Voir plus.

Avancer l'étape de déploiement d'une version

Pour avancer l'étape de déploiement de votre action, procédez comme suit:

1. Sous Gérer les versions, sélectionnez la version à mettre à niveau.
2. Cliquez sur le bouton Modifier le déploiement.
3. Apportez les modifications souhaitées à votre déploiement. Par exemple, vous pouvez faire passer la base d'utilisateurs de 5% à 20%.
4. Cliquez sur Envoyer.

Annuler le déploiement de la production

• Si vous devez déployer votre application par étapes hors connexion, cliquez sur Modifier le déploiement sous Gérer les versions. Vous pouvez effacer toutes les régions ou sélectionner 0%, selon que votre déploiement s'effectue par zone ou pourcentage de la base d'utilisateurs.
• Pour annuler le déploiement d'une action entièrement déployée (100% de la base d'utilisateurs), cliquez sur le bouton Gérer les déploiements sous Gérer les versions, puis sélectionnez Annuler le déploiement de la production.